Skip to content

Setup

Jump to bottom
Wouter den Bakker edited this page Feb 28, 2020 · 8 revisions

Setup:

  • See also: System requirements
  • You need to provide the SIGNPREFIX, public key, host, PROCESSORPORT (default 56789), whether you use TLS or not and the used ENCRYPTIONKEY (if any) to all nodes that want to join. So make note of those values.
  • For a quick test setup docker-compose is properly easiest, however Windows Home does not support docker.

Setup processor, database, server and node using docker-compose:

  • Download and install docker (Windows Pro/Education, Mac, Linux, you can ignore the popup asking you to create an account).
  • Download the docker-compose.yml file.
  • In case you want to target specific versions, rather then latest, modify the context for all services.
  • Fill in the variables in the docker-compose file. You can also modify any other settings.
  • Run docker-compose build.

Setup processor using docker:

  • Download and install docker (Windows Pro/Education, Mac, Linux, you can ignore the popup asking you to create an account).
  • Start a postgres server and setup the database using the setup script. It is recommended to run this on the same system as the processor to reduce latency, as all reads/writes need to be done in sequence.
  • Download the Processor.Dockerfile file.
  • In case you want to target a specific version, rather then latest, modify the git clone command to point to a specific version.
  • Fill in the variables in the docker file. (Alternately you can provide them when starting the docker using -e VARNAME=VALUE flags.)
  • Run docker build -f Processor.Dockerfile -t vprocessor . where the processor was downloaded.
  • If you haven't done so yet now is a good time to setup Validana Server and optionally Validana Node.

Setup processor standalone:

  • Start a postgres server and setup the database using the setup script. It is recommended to run this on the same system as the processor to reduce latency, as all reads/writes need to be done in sequence.
  • Clone this repository.
  • Download and install node.js and yarn.
  • Run yarn install and yarn build in the folder you cloned this repository to.
  • Create a config file for the processor. (Alternately use environment variables.)
  • If you haven't done so yet now is a good time to setup Validana Server and optionally Validana Node.

Starting:

Start processor, database and node using docker-compose:

  • The first time or after making changes to the docker-compose.yml file use docker-compose up -d (From the folder the docker file is in.)
  • Subsequent times use docker-compose start (From the folder the docker file is in.)
  • Log can be viewed using docker-compose logs (From the folder the docker file is in.)

Start processor using docker:

  • The first time or after making changes to the Processor.Dockerfile file use docker run --name vprocessor -d vprocessor.
  • Subsequent times use docker start vprocessor.
  • Log can be viewed using docker logs vprocessor.

Start processor standalone:

  • Run yarn start path/to/config.json (From the folder the processor is downloaded to.)
    • Everything will be logged to the standard output, most notably watch the first few seconds to see if there are problems with the setup.

Shutdown:

Shutdown processor, database and node using docker-compose:

  • Run docker-compose stop (From the folder the docker-compose file is in.)

Stop processor using docker:

  • Run docker stop vprocessor.

Shutdown processor standalone:

  • Send a SIGINT for a graceful shutdown, send a SIGTERM for an attempted graceful shutdown, but a hard shutdown after 10 seconds, send a SIGKILL for an immediate shutdown.

See also

Clone this wiki locally