Node Installation

Currently we support Unix-like systems (for example, popular Linux distributives and MacOS). However Waves Enterprise platform can be run under the Windows natively in experimental mode. Also you can you Unix virtual machines or the Docker environment for the installation and running the platform under the Windows.

You can use the integrated Waves cryptography module or the GOST-cryptography based on the “CryptoPro JCP” software. The list of node supporting packages depends on the cryptography scheme.

Important

Waves Enterprise node is installing separately to different machines from Waves blockchain platform nodes.

Node Installation

../_images/lin.png ../_images/mac.png

Linux (Ubuntu)

  1. Download the latest release of the node in the deb-package format and the config file template from the GitHub.

  2. Edit the node configuration file according with the Node configuration section.

  3. Install the node using the downloaded deb package corresponding to the Linux distributive. An example below is for the .deb package. The installation command is:

    sudo dpkg -i WE.deb
    
    • Directory for configuration file - /etc/we/we.conf
    • Directory for jar-file and libraries - /usr/share/we/
    • Directory for blockchain data - /var/lib/we/

Important

When you use .deb-package, the node configuration file should have only we.conf name.

  1. Launch the node using the command:

    sudo systemctl start we.service
    
  2. Stop the node using the command:

    sudo systemctl stop we.service
    

Mac

  1. Download the latest release of the node in the deb-package format and the config file template from the GitHub. The latest version is on the top:
../_images/latest.png
  1. Edit the node configuration file according with the Node configuration section.

  2. Run the node using the following command:

    java -jar node-x.x.x.jar nodeName.conf
    

You can use the ctrl + C keys to stop the node.

GOST cryptography

Hint

You do not need to install the CryptoPro JCP software if you want to use only the Waves cryptography.

  1. Preinstalled Java packages check

The correctness of the installation can be checked by the command java -version. If you see the following result, you can proceed to the next step - the CryptoPro installation.

Java version "1.8.0_74"
Java(TM) SE Runtime Environment (build 1.8.0_74-b02)
Java HotSpot(TM) 64-Bit Server VM (build 25.74-b02, mixed mode)

If Java packages are not installed, you should download and install JRE 1.8 (64-bit), which is fit to your OS. Also you need to register on the Oracle website before downloading the installation package.

  1. CryptoPro Installation
../_images/lin.png ../_images/mac.png

Download and install CryptoPro JCP 2.0.39014 according with the your OS type. You need to register on the CryptoPro website before downloading the installation package.

Warning

The Waves Enterprise platform only supports 2.0.39014 version!

The installation guide is included into the CryptoPro JCP 2.0.39014 distributive. You can find the installation guide in the Doc/ЖТЯИ.00091-01-JCP directory. Also you need to ensure the execution JRE package path is correct. Use the following option list:

  • Crypto-option for JSP.
  • Crypto-app.
  • Pakages: CAdES, XAdES, have a dependencies install bcpkix-jdk15on-1.50.jar and bcprov-jdk15on-1.50.jar. After installation, please, copy files jcp-2.0.39014.zip/dependencies/bcpkix-jdk15on-1.50.jar and jcp-2.0.39014.zip/dependencies/bcprov-jdk15on-1.50.jar into the directory $JAVA_HOME/jre/lib/ext.

Linux

Write environment variables for Java JDK for all users by default typing the following command in the terminal:

sudo vi /etc/profile.d/oracle.share

Enter the following values of the environment variables into this file:

export JAVA_HOME=/opt/jdk1.8.0_xxx
export JRE_HOME=/opt/jdk1.8.0_xxx/jre
export PATH=$PATH:/opt/jdk1.8.0_xxx/bin:/opt/jdk1.8.0_xxx/jre/bin

If you have several Java JDK versions than register the alternatives for the new one.

sudo alternatives --install /usr/bin/java java /opt/jdk1.8.0_xxx/bin/java
sudo alternatives --install /usr/bin/jar jar /opt/jdk1.8.0_xxx/bin/jar
sudo alternatives --install /usr/bin/javac javac /opt/jdk1.8.0_xxx/bin/javac
sudo alternatives --set jar /opt/jdk1.8.0_xxx/bin/jar
sudo alternatives --set jar /opt/jdk1.8.0_xxx/bin/jar
sudo alternatives --set javac /opt/jdk1.8.0_xxx/bin/javac
sudo alternatives --config java

Provide users with corresponding rights:

sudo chmod 777 -R /opt/jdk1.8.0_xxx/jre/.systemPrefs

Use this command for the “CryptoPro JCP” installation:

./setup_console .sh </opt/jdk1.8.0_xxx/bin/java>

Follow all the steps of the “CryptoPro JCP” installation script.

Mac

Use the official Oracle website to install Java JDK. Follow the instructions of the site to install “1.8.X_XXX” package - version. You can use OpenJDK.

brew install adoptopenjdk/openjdk/adoptopenjdk-openjdk8

Set the value for JAVA_HOME as /usr/local/Cellar/adoptopenjdk-openjdk8/jdk8u172-b11.

Use this command for the “CryptoPro JCP” installation:

./setup_console .sh </usr/local/Cellar/adoptopenjdk-openjdk8/jdk8u172-b11>

Follow all the steps of the “CryptoPro JCP” installation script.