If you find the node status is ERROR or OFFLINE on the xx network ProtoNet Dashboard, the first thing is to determine if any processes have stopped running and determine the cause of the crash. To do this run the following command on both the node and gateway computer:
$ ps -A | grep xxn
If you find any of the processes are
<defunct>, you should check the logs, which can be found in
You may be able to restart the service that has crashed to get the node back ONLINE. However, it is advised you take the following step to ensure it will recover properly.
If the only action is
Stop, you can proceed to the next step. Otherwise, depending on how long it has been offline, you may see the
Validatebutton beside the stash and controller accounts. Press the
Validatebutton and use the
hexNodeIDfrom the output of:
$ cat /opt/xxnetwork/cred/cmix-IDF.json
- Restart the chain services on the node and gateway computers:
$ sudo systemctl restart xxnetwork-chain
- The cmix and gateway processes require that chain be up to date with the current block. To check,
tailthe chain logs and wait until you see multiple
Importedmessages scrolling by in the logs on both the node and gateway computers.
$ tail -F /opt/xxnetwork/log/chain.log
The messages will look like so…
2021-09-20 09:16:48 ✨ Imported
2021-09-20 09:16:51 💤 Idle (48 peers), best:
`(0x87bc…53b6), finalized ` `#589137`
(0x452e…b48e), ⬇ 109.4kiB/s ⬆ 261.2kiB/s
`2021-09-20 09:16:54 ✨ Imported ` `#589140`
`2021-09-20 09:16:56 💤 Idle (47 peers), best: ` `#589140`
`(0x4169…43b5), ⬇ 115.9kiB/s ⬆ 155.9kiB/s`
2021-09-20 09:17:00 ✨ Imported
- Once multiple
Importedmessages are regularly appearing in both the chain.log files, restart the cmix and gateway services.
On the node computer run:
$ sudo systemctl restart xxnetwork-cmix
On the gateway computer run:
$ sudo systemctl restart xxnetwork-gateway
- If you had to press
Validatein Step 2, the validator may have been moved to the Waiting tab of the ProtoNet Explorer
You can check how long it must wait before joining the list of active validators by checking the amount of time remaining in the current era, on the Overview tab of the ProtoNet Explorer. It might be multiple hours.
- Once the validator is no longer listed on the
Waitingtab, the cmix and gateway processes will start. It might take a few minutes for the scheduling server to add the node to the NDF.