Host maintenance
Transaction costs
As mentioned in System requirements, you need to keep a sufficient XAH balance in the host account to cover the transaction fees for your host. Transaction feed originates from Heartbeat transactions sent to the hook as well as instance creation replies sent back to tenants.
Updating the Evernode software
You can run evernode update to check and install updates to Evernode.
Note: For the Evernode 0.8.2 update evernode update command would not show any pending updates for your Sashimono. To update to v0.8.2, run the below command. It is recommended to use the following command for an independent Evernode update.
curl -fsSL https://raw.githubusercontent.com/EvernodeXRPL/evernode-test-resources/main/sashimono/installer/evernode.sh | sudo bash -s update
Recovering from a Failed Update
In the event of a failure, the secret will not be deleted and will remain at the default secret file location or the custom location you have specified. If you wish to reinstall, use the following command and transfer the registration using the same account on a separate machine. Then try re-installing on your machine.
curl -fsSL https://raw.githubusercontent.com/EvernodeXRPL/evernode-test-resources/main/sashimono/installer/evernode.sh | sudo bash -s transfer
Purging bad actors
It cannot be avoided that some DApp instances running on your host will misbehave or perform malicious activities across the internet. They cannot harm the operation of other DApps or your Host but they can utilize your network bandwidth or may engage in unethical behavior. When you identify such DApp instances You can use evernode list and evernode delete CLI commands to purge them from your host. See evernode CLI.
Transfer the host registration
If you need to transfer existing registration to another Xahau account or replace your host, you can use this. This is useful in several scenarios: - Upgrading the hardware of your host - Moving your registration to a different host - Reinstalling the host OS - Replacing a damaged host. - Transferring the ownership to a different Xahau account.
In the above cases, you can initiate an evernode transfer from your original account and then install Evernode on the new Host using the transfer information. The re-installation will not cost the regular host registration fee. It will just be a 1 Now(1*10-8 EVRs)).
You can use the below command to initiate a transfer of the registration NFT.
evernode transfer
However, if you have lost access to your original host (eg. a damaged host), you can use the following command in any Linux terminal. You are required to possess the Xahau account address and secret of your original host.
curl -fsSL https://raw.githubusercontent.com/EvernodeXRPL/evernode-test-resources/main/sashimono/installer/evernode.sh | sudo bash -s transfer
Deregister a host
curl -fsSL https://raw.githubusercontent.com/EvernodeXRPL/evernode-test-resources/main/sashimono/installer/evernode.sh | sudo bash -s deregister
Note: If you have already installed evernode, you cannot use the deregister command. Use evernode uninstall to uninstall Evernode.
Recovering EVRs from a failed Installation
In the event of a failure, you can use deregister command from a separate machine where evernode is not installed to recover your EVRs. Then try re-installing on your machine.
Diagnostics
Here we have documented some solutions for some possible issues that you might come across on Installation, Update or Transfer.