Running the Node
In this section we will explain how to configure and manage a node.
It is assumed that Docker, and the vantage6 Python package have been successfully installed. If not, have a look at previous steps described in What to install? and Dockerized installation.
An organisation runs a node for each of the collaborations it participates in.

πŸ†• (Re-)Configuring a (New) Node

After having a server up and running, we need to create and configure the nodes.
Similar to the server, nodes are created from a configuration file. This file can be generated through the command vnode newor manually from a YAML file manually, as explained in this section. ​

πŸ”‘ Creating a private key

If you're running any node in a collaboration that requires end-to-end encryption, you'll need to setup a private key for your organisation. This can be done through the command vnode create-private-key.
Running this command without any arguments, will perform the following steps:
    prompt for a node configuration to use
    prompt for a username/password
    retrieve the name of the organisation from the server
    create a public/private key pair
    update the node's configuration to point to the (new) private key
    upload the public key to the server
If a key already exists (in step 4), the existing key is reused. This way, it's easy to configure multiple nodes to use the same key. All nodes within an organisation should use the same private key! Otherwise at least one of the nodes will not be able to process its tasks!
All nodes within an organisation should use the same private key! Otherwise at least one of the nodes will not be able to process its tasks!

🏎 Starting the Node

Once a configuration is created you can start this instance by using vnode start and select the configuration you wish to start. Or in the case you already know the name of the configuration you can use vnode start --name [config_name] . It is also possible to use a configuration file that is in a non-default location by using vnode start --config /path/to/config . All other options will be overwritten when using this option.
Node configurations are assumed to be in the user-folder. However if you have a configuration stored in the system-folder you should add the flag system: vnode start --system .

✍ Logging

The easiest way to read the logs from a node is using vnode attach and select the node from which you want to read the logs from.

πŸ’»Node Commands

As a reference, these are the sub-commands available to manage the node(s). These commands can also be found by simply calling vnode .
vnode new
Create a new configuration file
vnode list
List all available configurations (both system/user)
vnode files
List file locations of the node instance
vnode start
Start a node configuration
vnode attach
Connect the console to the node's stdout
Creates and uploads a new public key
Last modified 1yr ago