The Valsight Platform is a standalone server application. It is recommended to install the Valsight application on a dedicated (virtual) machine.
The Valsight Platform has the following minimum hardware and software requirements:
at least 2GHz, 4 Cores
more than 10 parallel users: 8 Cores
at least 8 GB
more than 10 parallel users: 16 GB
Debian/Ubuntu LTS, SLES 12 or later
Red Hat 7.1, Windows Server 2012 (64 bits) or later
|Java Runtime (Linux Only)|
Oracle JDK 1.8, 64 bit
OpenJDK 1.8 64 bit, See also https://adoptopenjdk.net/
Valsight for Windows Operating Systems ships with an integrated AdoptOpenJDK.
|Model Database |
(optional, see below)
Postgresql 9.5 or later, MSSQL Server 2016+, others possible on request.
Windows, Mac, Linux
Google Chrome, Firefox, Edge - see Supported Browsers
|Connection||HTTPS & Secure Websockets to Valsight Cloud or On-Premise Server|
Intermediate Proxys & Loadbalancers
Proxy Support for Websockets
Install the requirements listed above on the target machine. Make sure the
JAVA_HOME environment variable is set.
Extract the supplied ZIP file (e.g. valsight-server-1.4.zip) to the desired install location, without spaces in the name. On Linux, this could be
/opt/valsight and on Windows
In the conf/ directory: copy config.yml.default to config.yml and edit the file accordingly. While the standard settings work, consider to setup a production database.
Launching the Server
The Valsight application is launched using the supplied scripts, depending on the operating system:
Execute the script
bin/valsight-server from the command line.
You may set up an initscript to run the service repeatedly or on system startup.
Make sure to set the service's working dir to the installation dir (and not bin/).
Execute the script
bin\valsight-server.bat from a command line or by double-clicking in Windows Explorer.
The Valsight application is now running on port 8080 and you can access it using a browser by entering
into the address bar. The default username and password is "admin" and "admin".
Adding a License File
The license file needs to be put into the main directory of the application as "license.pem" (i.e. at the same level as the conf, lib and bin folders.) Alternativly, the license can be uploaded on the first start of the server.
Opening the URL above will bring you to the configuration page (
) after starting the server for the first time. Before using the server, you need to add a valid license file.
- In the file upload form in the upper part of the configuration dialog, select the license file which was provided to you
- Press "Update License Key" to submit the form
- The server should respond "License file uploaded successfully" and the license key information should be visible under "Current License"
Configuring a Model Database
By default, the Valsight application will use a file-based internal database to store model configurations (the database files are located under
db/*.db). For a growing production setup, it is recommended to use a dedicated database to store model configurations. The exact steps necessary will vary depending on the chosen database, but the general process is as follows:
- Set up a supported database system
- Create a dedicated database user for use by the Valsight application
- Create a dedicated database and grant permissions to the user created in the previous step.
- In the Database Configuration form on the system configuration page (see above), enter the details to access your database
- Press "Update Database Configuration" to save the configuration (it is stored in the config file
- Re-start the Valsight application server to use the newly configured database. You will start with an empty database (information from the previously configured model database is not copied over).
Troubleshooting, hints & tips:
- Postgresql of many distributions is often not configured for TCP/IP access and allowance of password based authentication. Make sure that psql -h 127.0.0.1 -U username allows you to connect to the database.
- If you like to configure SSL, you can do so by adding the correct parameters to the JDBC string, e.g. for Postgresql extend the URL with ?ssl=true and enable SSL in the server settings.
Configuring an HTTPS proxy
The application requires the support of websockets, please make sure that any used proxy is able to forward requests accordingly.
In a production setup, it is recommended to add HTTPS protection to the Valsight application. In a typical setup, an HTTP server such as Apache 2.0 would be set up "in front of" the Valsight application with a reverse proxy setup to port 8080. The exact steps necessary will vary depending on the chosen HTTP server, but a sample Apache 2.0 configuration could look like this:
Please add at least one default data source with an empty xlsx file before using the software. See Data Upload for the basic steps.
To get started with the software visit Valsight Help.
- Stop the running Valsight application service (Ctrl-C when running from the command line, or using an initscript)
- Unpack the supplied ZIP file (e.g. valsight-server-1.5.zip) to a temporary location
- Move the new application content to the previous install location, overwriting existing files. Runtime files such as your configuration (
conf/config.yml), license file (
license.pem) or database (
db/*.db) should not be overwritten.
- Start the Valsight application service as before
- Optional: Remove old version from install-dir/lib/rest-service-(old-version).war