contentACCESS documentation – version 4.2

What is a virtual drive?
It is a virtual file system that presents/virtualizes any data (files and folders of an actual disk) to the end-user. Virtual drive is a non-existing drive that does not physically exist in the computer, but it contains the exact structure of the items that have been processed by contentACCESS.

The contentACCESS Virtual Drive was developed by TECH-ARROW and serves as a key access point between the end user and the contentACCESS File Archive. Virtual Drive is a must-to application for user who has File system Archive and would like to use shortcutting. The user can view his archived files from here and if he has write access on the file(s), he can make changes to the file(s) – by simply opening, editing and saving with the associated application. The Virtual drive will detect the change and create a new version from the file(s) after a short delay (about 30 seconds).

By default, only the active items can be viewed on the virtual drive (active items = items in the archive, which have an original file or shortcut in the file system, too). To enable inactive view, the Show inactive items checkbox must be selected on the Virtual drive configuration page. This drive can be also shared with other users, so they can easily browse for their associated archived files in case of need. The original folder/ item permissions are also applied for the files/ folders in virtual drive. A user can access only the items on which he has access permissions in the original file system.

After the Virtual drive was installed (link to the Virtual drive setup is accessible in the Tools of the contentACCESS setup package), it is necessary to configure its settings on the Virtual drive configuration page.
In contentACCESS Central Administration navigate to System tab ⇒ Client Applications ⇒ Virtual drive configuration control to open this page:

Enter the server name – where virtual drive (henceforth “VD”) is installed – into the Virtual drive server name textbox. To load the actual settings of VD, click Load virtual drive settings button.

contentACCESS server connection
It is possible to connect the Virtual drive to contentACCESS either through net.pipe connection, through the contentACCESS proxy with a secure (HTTPS) or insecure (HTTP) connection, or directly, over HTTP connection.
The net.pipe communication is the fastest way of the communication between the Virtual drive and contentACCESS as it is using shared memory for the communication. The disadvantage is, that this type is possible only if the Virtual drive and contentACCESS server are both installed on the same. In such cases this is the reccommended communication type.
The connection through the proxy is recommended, if the virtual drive is installed somewhere in the cloud or on a server that differs from the contentACCESS server. It is recommended to use a direct connection (without using the proxy), if the virtual drive and contentACCESS are installed on the same server.

1. Virtual drive configurations, if secure communication should be used (over the proxy):
   The proxy must be installed over HTTPS connection (HTTPS connection must be selected during the installation process of the proxy);
   
   
   
   In Central Administration, on the Virtual drive configuration page: The connection of the Virtual drive to contentACCESS must be established over a HTTPS connection; port 443 must be entered into the connection URL.
   




2. Virtual drive configurations, if the virtual drive will connect to the contentACCESS server directly:
   In Central Administration, on the Virtual drive configuration page: If having a direct connection, select HTTP connection when specifying the contentACCESS server name URL. The virtual drive and contentACCESS are installed on the same server, so the “localhost” URL can be configured. Enter 8736 for the port number.
   
3. Virtual drive configurations using net.pipe for communication, if Virtual drive and contentACCESS are installed on the same machine:
   

In the next steps it is required to specify the user, over which VD will connect to contentACCESS.
To establish the connection with the contentACCESS server, the system user, or a Windows user can be used. The Virtual drive will connect to contentACCESS over these credentials. By default, the contentACCESS system user is used to this connection. If you do not want to change these connection settings, leave the “Use Windows authentication checkbox” unchecked. To enable the connection with Windows account the following steps must be performed:

• When installing the Virtual drive the Windows, user credentials should be specified. This VD service (GATE.contentAccess.VirtualDrive.Service) user will be taken to log in to contentACCESS.
  




• In contentACCESS, the corresponding Windows user login needs to be created (under System ⇒ Security ⇒ Users…double click on the user…add Windows user login in the User logins section…fill required fields in the Add new login dialog).

  




• On the configuration page of virtual drive, the “Use Windows authentication” checkbox must be selected:
  

The main advantage of a Windows user is: if the system user credentials are changed by the user and he forgot to change it in the Virtual drive settings, Virtual drive will be disabled to connect to contentACCESS. If a Windows user is used, such problems can be avoided.

To finalize the VD configuration continue with configuring the following settings. Some of them are set by default, these can be left as they are:

Root mount point: Here you can choose an available disk for the Virtual drive. By default it is disk “G”, but it is possible to change it.
Share for: The Virtual drive will be shared for this Active directory group only. It is recommended to specify a domain group that contains all the users who should have access to the Virtual drive. Usually, it is “Domain Users” or “Everyone”.
Show inactive items: the user may set here whether he wants to see the inactive items (items in the archive, which do not have an original or shortcut in the file system) in the virtual drive, or not. In default view only the active items are shown.
Download locally: contentACCESS data can be stored a) as files in the cache, or b) as content in the memory. If you check option “Download locally”, then files will be stored in the cache.
Folder refresh interval(s): The virtual drive folder will be refreshed in time intervals that are set here. During these intervals the newly archived files will become visible in the virtual drive folder.
Download cache: Virtual drive will save temporary files to this folder.
Permanent cache: Virtual drive will save all changes to this folder. When users are editing files, all changes are stored here until they are committed to the archive. This folder must have plenty of free space.

Cache size limit (MB): When opening the archived data, the processed data are cached to unburden Virtual drive from unnecessary operations and to shorten access time to this data. This function helps to unburden the VD server. Here we can define the maximum size of data, which will be downloaded and stored by the Virtual drive. In our case we set this limit to 1 MB.
Cache recalculation interval (ms): The time set here will define the intervals when the cache will be “cleaned”. At the intervals that are set here, the cache will check if the cache size limit has not been exceeded.
Timeout: The duration of running of all operations can be determined here. After this time period, the operation will be interrupted. Value “0” means that the operation will be waiting infinitely.
Read-only mode: If virtual drive is in read-only mode, the files can’t be edited and no new versions are created from them. After this setting is changed and saved, the Virtual drive needs to be restarted.
Debug: If you check this textbox, then all errors and warnings that have been noticed will be written into the .log file or into the debug view. It is recommended to turn on this function only if the user notices some problems with running of virtual drive, otherwise these notifications might slow down the operations.

Virtual drive status: This will show the current state of the virtual drive. With the buttons below you can start/stop the virtual drive. To connect to the G drive and start the virtual drive, click on Start virtual drive.

Do not forget to save the configuration.