Deploying WebViewer without Docker

As an alternative to the WebViewer Server Docker container we also offer a similar package as a standalone installer for Windows systems. This package should only be used if Docker cannot be supported by your system.

Get started

Setting up the server

  1. The WebViewer Server Installer is a version of our Server only designed to work on Windows. This is offered to alleviate concerns for some customers on certain Windows setups. We reccommend using the Docker container if possible. Using the container rather than the installer will prevent many system specific issues.
  2. Download the WebViewer Server Installer.

  1. Ensure that you have at least 2GB of disk space available and are running on Windows 7 and above before proceeding. Double click the installer and execute the process. The installer will guide you through this process.
  2. Once the server has been installed there will be a few ways to use the server. An entry titled WebViewer Server will be in your windows Services. You can start WebViewer Server by enabling this service.

There will also be an entry in your start menu titled WebViewer Server, you may start WebViewer Server by double clicking this entry.

Alternatively, you can run the startup.bat directly in your rootdirectory/apache-tomcat/bin folder.

You should be up and running at this point.

Performing a silent install

You may need to execute a silent install with WebViewer Server in deployment situations. We offer the option to do so with the installer as of version 1.5.0. You need only execute the installer from a command line with the following flags.

sh

1wvs_installer.exe /VERYSILENT /SUPPRESSMSGBOXES /DIR=YOUR_INSTALL_PATH

Accessing the demo

Once the server is running, the demo viewer app is accessible at http://<HOST_IP_ADDRESS or localhost>:8090/demo/?s

Configuring the Server

On windows, the server configuration is handled differently compared to the Docker container. During the installer you will be prompted to put in configuration options. The options you placed during the installer are copied to a file in the root directory/apache-tomcat of WebViewer Server titled wvs-config.json. The options in this file can be found in our configuration documentation. This configuration should be modified so that it is still a valid JSON file.

If you wish to update your config, shut down your WebViewer Server and modify the configuration. On next server start the settings will take effect.

If there is a JSON formatting issue within the configuration file, the server will fail to start and fail with a message regarding JSON parsing. Ensure that your configuration file is well formed before running the server.

Logs

The server stores all log output in the root_wvs_directory/apache-tomcat/logs folder. These logs will also be printed to standard out when WebViewer Server is run normally. Any issues with the server will output errors here.

Uninstalling

The WebViewer Server comes with an uninstaller that can be called through the control panel or start menu of Windows. This will remove all files and the associated service.

Did you find this helpful?

Trial setup questions?

Ask experts on Discord

Need other help?

Contact Support

Pricing or product questions?

Contact Sales