Best practices for EOS node availability

Many BP nodes were down on July 8th, because the default setting of “chain-state-db-size-mb” is 1GB, and this is the moment when the EOS database has reached this limit. This parameter specifies the amount of virtual, disk-backed shared memory, that is used by nodeos daemon at its runtime, and if the database exceeds this limit, the node crashes.

At the start, nodeos creates a sparse file that represents its virtual memory, and the size is as specified in “chain-state-db-size-mb”. “du” and “df” utilities show the actual usage on the file system, so the sparse file will be shown as occupying a very little place.

Once you realize that the available database memory is scarce, you can stop the daemon, increase the DB size setting, and start again. As long as the daemon stops and starts gracefully, this operation is safe.

Not all utilities understand sparse files, and scp will produce a dense file on the target system if you make a copy.

If nodeoscrashes, it leaves the memory database in a dirty state, and a full replay of the blockchain is required. This may take up to a half a day or longer for the server to re-build its state database.

The best approach for running a production EOS server, is to have a second server in the background, stop it periodically and make a backup of its database. In this case, should the production node crash, you can quickly restore its database from the snapshot, and it will quickly re-sync with the network, as the backlog would only be worth few hours.

Also there’s an RPC plugin that reports the actual memory usage:

plugin = eosio::db_size_api_plugin

With this plugin, you get the total database memory, current use, and free amount:

curl http://127.0.0.1:8888/v1/db_size/get | json_pp -json_opt canonical,pretty  | less

The production nodes need to be monitored periodically for memory usage, and the administrators should be alerted should the memory consumption get above 80%.

Written by

Telegram: cc32d9, EOS account: "cc32dninexxx"

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store