Skip to main content

Running Validata as a process

Note

Before installing Validata, verify that the system meets the System requirements.

For development and testing, it can be useful to run Validata as a process, so you can easily restart with different options or switch between various releases. We do not recommend running Validata as a process in a production environment. If you do not need to run Validata as a service, you can install simply by extracting a Validata-<version>.tgz or .zip archive. For example, to extract to the /opt directory (the typical location, though you may install wherever you like):

tar zxvf Validata-1.1.0-.tgz -C /opt

Caution

Known issue (DEV-22317): do not put the validata directory under a directory with a space in its name.

Once you have extracted the package, set the server properties:

  1. Open a terminal or command prompt, change to the validata directory, and enter:

    • sudo su - validata ./bin/sksConfig.sh

    When prompted, enter passwords for the Validata keystore and the admin and sys users. If hosting Validata Historian on Oracle or PostgreSQL, enter that password as well (see Configuring Validata Historian). If you are using a Bash or Bourne shell, characters other than letters, numbers, and the following punctuation marks must be escaped: , . _ + : @ % / -

  2. Edit /opt/validata/conf/startUp.properties, edit the following property values (removing any # characters and spaces from the beginning of the lines), and save the file:

    • ValidataClusterName: a name for the Validata cluster

    • CompanyName: If you specify keys, this must exactly match the associated company name. If you are using a trial license, any name will work.

    • ProductKey and LIcenseKey: If you have keys, specify them, otherwise leave blank to run Validata on a trial license.

    • Interfaces: If the system has more than one IP address, specify the one you want Validata to use, otherwise leave blank and Validata will set this automatically.

  3. Save the file.

Once you have specified the necessary server properties, start the server with validata/bin/validata-server.sh.

When the server has started, you will see a message indicating the URL where you can access its web UI.

When running as a process, SysOut output will be written to the terminal running the server process rather than to validata-node.log.

To stop the server, press Ctrl-C in the terminal window.

To restart after stoppingt, run validata-server.sh. Optionally you may specify a startup properties file as an argument, which can save time if you need to run Validata with various settings for testing or development purposes.

Note

If installing a new release of Validata, delete the validata directory and empty the trash before extracting the new .tgz or .zip archive, and clear your browser cache before logging in to the web UI.