Setup

Setup:

• See also: [System requirements](System requirements)

Setup server with database using docker-compose:

• (processor) See the Validana Processor for instructions.
• (non-processor) See the Validana Node for instructions.

Setup server using docker:

• Use the database setup for the Node or Processor.
• Download the Dockerfile file.
• 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 Dockerfile -t vserver . where the server was downloaded.

Setup server standalone:

• Use the database setup for the Node or Processor.
• Create a config file for the server. (Alternately use environment variables.)

Starting:

Start server using docker:

• The first time use docker run --name vserver -d vserver.
• Subsequent times use docker start vserver.
• Log can be viewed using docker logs vserver.

Start server standalone:

• Run node dist/app.js path/to/config.json (From the folder the server 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 server using docker:

• Run docker stop vserver.

Shutdown server 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.
  • If the shutdown was not graceful it may be in the middle of processing a block, which won't be finished processing till it is started again.