Install your node(s)
After preparing the user permissions, the script configurations and the keys, the actual node installation can begin. The Validator script is a multi-purpose tool for managing your node. For installation use
1 - install.
~/elrond-go-scripts/script.sh 1) install 2) observing_squad 3) upgrade 4) upgrade_squad 5) upgrade_proxy 6) remove_db 7) start 8) stop 9) cleanup 10) github_pull 11) add_nodes 12) get_logs 13) benchmark 14) quit Please select an action:1
- When asked, indicate the number of nodes you want to run, i.e.
- When asked, indicate the name for your validator, i.e.
- Quit the menu without starting (we need keys first) by using
14 - quit
Prepare your keys
Create a new folder "VALIDATOR_KEYS" to serve as local backup when updating:
cd ~ mkdir -p ~/VALIDATOR_KEYS
Generate a certificate file containing your Validator key by running the
Copy the generated
validatorKey.pem file to the
config folder of your node(s), repeat for each node.
cp validatorKey.pem ~/elrond-nodes/node-0/config/
Each node needs its unique
Then copy the
validatorKey.pem file - in ZIP form - to the
$HOME/VALIDATOR_KEYS/ folder . This is important for your node to be able to restart correctly after an upgrade.
zip node-0.zip validatorKey.pem mv node-0.zip $HOME/VALIDATOR_KEYS/
Repeat the above for all your “n” nodes. When complete, please refer to our Key management section for instructions about how to properly back up and protect your keys.
Start the node process
Run the script and select option
7 - start.
Start the node visual interface
Once the node has started, you can check how it’s doing, using the
TermUI interface. Navigate to your
$HOME/elrond-utils folder and start the
TermUI , one for each of your nodes:
$HOME/elrond-utils/termui -address localhost:8080
Your first node is called
node-0 and its REST API will run on port
8080 by default. The next node is
8081, and so on.
Update your node(s)
Upgrade your node by running the script and selecting options:
10 - github_pulldownloads the latest version of the scripts
3 - upgrade
7 - start
14 - quit
cd ~/elrond-go-scripts ./script.sh
Backup your keys
Your private keys are needed to run your node. Losing them means losing control of your node.
Find them in
$HOME/elrond-nodes/node-0/config [be mindful of your
Create a safe backup for them on storage outside the server running your node(s).
Notes regarding the migration from old scripts version to the unified one (elrond-go-scripts)
- the migration is possible while preventing the keys, DB, logs and the current node installation, in general
- just clone the
elrond-go-scriptsrepo near the old one (
elrond-go-scripts-devnet), configure it as stated and call the
migrateoperation on the scripts:
cd ~/elrond-go-scripts ./script.sh migrate
this will tell the scripts the current environment on which the previous installation was done. Be careful as to not mix the previous installation network with the new one. This might lead to unpredictable results
Choosing a custom configuration tag or branch
This option should be only used when debugging or testing in advance of a pre-release tag.
Use this on your own risk!
The power of the scripts set has been leveraged with a new addition: the possibility to tell the scripts a specified tag or branch (not recommended using a branch due to the fact that an unsigned commit might bring malicious code or configs)
To accomplish this, edit the variables.cfg file
cd ~/elrond-go-scripts/config nano variables.cfg
OVERRIDE_CONFIGVER option and input a value there, something like
tags/ prefix will tell the scripts to use the tag and not search a branch called
upgrade command on the scripts to install the desired configuration version.
Resetting the value to
"" will make the scripts to use the released version.
OVERRIDE_CONFIGVER is not backed up when calling