Troubleshoot the dHealth Node
This page will help you maintain your dHealth Node and troubleshoot any failures.
This document illustrates several maintenance events including:
- Lost node keys (Remote, VRF, Voting)
- Unlink your account keys
- Link your account
- Recover voting keys
- Re-use keys for harvesting
Some of the actions listed here may potentially disrupt the normal functioning of your node software. Please, only execute the listed commands if you understand the consequences.
Lost keys
In case you have lost any combination of Remote, VRF and/or Voting keys which are linked to your main account, you must first unlink your account.
:white_check_mark: If you have already unlinked your account, jump here.
If you do not have access to the container/server anymore, you must create a new account for harvesting on the new container. It is only possible to unlink your account voting keys from the original node on which they were generated. If you own a backup of your voting keys, you can try recovering from here.
Unlink your account keys
If you unlink your account, it will not be elligible for harvesting on this container/server anymore. Please, use this with caution.
This process will cost up to 0.1
of the network currency.
You can unlink your account keys by executing the following command:
yourdlt link -t dual-node --url http://dual-01.dhealth.cloud:3000 --maxFee=100000 --unlink
:white_check_mark: You can now proceed to the setup of your new container/server.
Link your account
This process will cost up to 0.1
of the network currency.
You can link your account keys by executing the following command:
yourdlt link -t dual-node --url http://dual-01.dhealth.cloud:3000 --maxFee=100000
Recover voting keys
If you own an encrypted archive with the voting keys, you can use them to continue/restart harversting with the same accounts.
Uncompress the archive in the /opt/dhealth
folder with unzip votingkeys.zip
. After uncompressing, you can list the files and it should produce an output similar to the following:
$ ls -la votingkeys/
total 48
drwxrwxr-x 2 ubuntu ubuntu 4096 Apr 1 18:24 ./
drwxrwxr-x 9 ubuntu ubuntu 4096 Apr 1 18:28 ../
-rw-rw-r-- 1 ubuntu ubuntu 139 Apr 1 18:24 metadata.yml
-rw------- 1 ubuntu ubuntu 34640 Apr 2 10:19 private_key_tree1.dat
:whitecheck_mark: You can verify that you have the correct voting key with cat votingkeys/metadata.yml
which will display the _voting public key.
Before you execute on the next step, make sure that to not overwrite an existing votingkeys folder.
- First stop your node with
yourdlt stop -t dual-node
- Then add the uncompressed voting keys to your node, please make sure any other private_key would not get overwritten.
# first "backup" the active key
$ mv dual-node/nodes/dhealth-full-node/votingkeys dual-node/nodes/dhealth-full-node/bk.votingkeys
# then place in your recovered key
$ mv votingkeys dual-node/nodes/dhealth-full-node/votingkeys
This is it, when you startup your node again, it will be using your recovered voting keys:
$ yourdlt run -t dual-node -d
Re-use keys for harvesting
If you issued the account keys link from a different client application (wallet, CLI), you must use a custom configuration preset to run your node using those keys.
Following is an example custom configuration preset that you can use to harvest with a specific account which was already linked to supplemental keys:
nodes:
-
host: ''
friendlyName: 'your-awesome-node'
maxUnlockedAccounts: 40
enableDelegatedHarvestersAutoDetection: true
enableAutoHarvesting: true
beneficiaryAddress: INPUT_HERE
mainPrivateKey: INPUT_HERE
remotePrivateKey: INPUT_HERE
vrfPrivateKey: INPUT_HERE
Updated almost 2 years ago