Changing the HTTP data directory

1. Create a static_data directory in your new data location.

1a. Windows only & Docker <=1.5.6 Modify the file at WEBVIEWER_INSTALL/apache-tomcat/conf/server.xml and look Context docBase argument for /data, replace it with this.

<Context docBase="[YOUR NEW DATA PATH]:/static_data" path="/data" />

2. Modify the file at WEBVIEWER_INSTALL/apache-tomcat/wvs_config.json, change the next line into the following line:

   "TRN_DATA_STORAGE_DIR":"WEBVIEWER_INSTALL/apache-tomcat/static_data",

3. Start WebViewer Server, it should now write its cache to your networked drive.

To use a networked drive on Windows, follow the same steps as above except specify your network path.

When using WVS with the Windows installer, it is possible to run its cache on a shared network drive. There can be many complications and considerations when using a network drive. The following are some things you should consider.

• Is the networked drive fast enough to keep WebViewer Server performant?
• Does the network drive maintain good cache consistency? A common symptom of this issue is WebViewer Server being unable to find files it just wrote when making a call on one server and accessing the result with another
• Does the network drive have correct permissions?

This is because the System user that WVS is running as does not have access to the network drive map. We must force the drive to be mapped on system startup so that the System user has access to it. The following steps detail that process. It may be possible to change the service user and get the mapped drives working, however, this is the only way we were able to get the networked drive to work with a service.

1. Write a batch file that can be used to mount your networked drive on startup.

echo %time% >> c:\mount_nfs_log.txt
net use Z: \\{your ip}\{netdisk folder} /USER:username password >> C:\mount_nfs_log.txt 2>&1

2. Open your Task Scheduler and create a new task. This task should run as the NT SYSTEM user. The trigger should be system startup and the action should call the batch script you created in the previous steps.

3. Restart your system, when WebViewer Server next starts, it will have access to this drive.