Additional services deploy

The additional services set needs the apps Docker CE and Docker-compose for the fully running. You can check the full list of environment requirements for the Waves Enterprise platform in the System requirements page.

The additional services set is offered as a Docker container with the following list of services:

  • The corporate web client.

  • The data service.

  • The data crawler.

  • The authorization service.

  • PostgreSQL DB.

  • Nginx-proxy.

Follow these steps to deploy the additional services set:

  1. Download and unzip the file frontend-deployment.zip.

  2. Specify the path to REST API and node hostname in the configuration file of the application frontend-deployment/config/nginx-proxy.env:

    // nginx-proxy.env listing

WE_NODE_ADDRESS=http://yournet.wavesenterprise.com:6862
WE_NODE_HOST=http://node-1:6862

  3. Specify the path to REST API and authorization service hostname in the configuration file of the application frontend-deployment/config/crawler.env:

    // crawler.env listing

VOSTOK_AUTH_SERVICE_ADDRESS=http://auth-service:3000
VOSTOK_NODE_ADDRESS=http://yournet.wavesenterprise.com:6862

  4. The following PostgreSQL DB access parameters are used in the configuration files of frontend-deployment/config/postgres.env and frontend-deployment/config/auth-service.env applications:

    // postgres.env listing

POSTGRES_HOST=crawler-db
POSTGRES_DB=blockchain
POSTGRES_USER=postgres
POSTGRES_PASSWORD=wenterprise

// auth-service.env listing

POSTGRES_HOST=db
POSTGRES_DB=auth_db
POSTGRES_USER=postgres
POSTGRES_PASSWORD=wenterprise
POSTGRES_PORT=5432

  5. You must generate an RSA key pair for the RSA_PUBLIC_FILE_PATH and RSA_PRIVATE_FILE_PATH parameters. Run these commands sequentially:

    ssh-keygen -t rsa -b 4096 -m PEM -f jwtRS256.key

openssl rsa -in jwtRS256.key -pubout -outform PEM -out jwtRS256.key.pub
cat jwtRS256.key
cat jwtRS256.key.pub

  6. Specify the following parameters in the configuration file of the application frontend-deployment/config/auth-service.env:

    • The REST API path and the node URL:

    API_URL=http://yournet.wavesenterprise.com:3000
SITE_URL=http://yournet.wavesenterprise.com:8080

    • The data string, which is passed to the hash function along with the password.

    PASSWORD_HASH_SALT='X7ZAhlIVpqajPXVVAZusGBCOcWaGZ1DY'

    • Parameters of the mail account which will be used by the authorization service for letters.

    IS_MAIL_TRANSPORT_ENABLED=true
MAIL_HOST=mail.example.com
[email protected]
MAIL_PASSWORD=3hSsgt3!8wr5
MAIL_PORT=587
IS_MAIL_SECURE=false

Important

After registration each user must confirm his account by the following the link from the letter with account activation.

  1. Specify the path to the authorization service REST API and URL-address in the configuration file of the application frontend-deployment/config/we-data-service.env.

    VOSTOK_AUTH_SERVICE_ADDRESS=http://yournet.wavesenterprise.com:3000

  2. Run docker-compose with the command docker-compose -f docker-compose-frontend.yml up -d. Before starting the frontend service and all additional services a running node must be deployed.

  3. Open the browser and go to localhost:8080 to check if the system client is successfully deployed.