Skip to content
You are reading GoQuorum development version documentation and some displayed features may not be available in the stable release. You can switch to stable version using the version box at screen bottom.

Backup and Restore of GoQuorum Nodes

GoQuorum supports export and import of chain data with built in tooling.

This is an effective node backup mechanism adapted for the specific needs of GoQuorum such as private transactions, permissioning, and supported consensus algorithms.

Note

GoQuorum chain data import and export must run after geth process is stopped.

Node Backup (Export)

Backup functionality mimics original geth export command. GoQuorum export accepts 3 arguments:

  1. Export file name required
  2. First block
  3. Last block are optional but must be provided together when used
geth export <export file name> --datadir <geth data dir>

Node Restore (Import)

Restore functionality mimics original geth import command but requires transaction manager environment variable.

GoQuorum import must run on a new node with an initialized --datadir after geth init has been executed.

Restore supports arbitrary number of import files (at least 1).

Warning

If private transactions are used in the chain data, Private Transaction Manager process for the original exported node must be running on the PTM ipc endpoint during import chain. Otherwise, nil pointer exceptions will be raised.

Sample command

PRIVATE_CONFIG=<PTM ipc endpoint> geth import <import file names...> --datadir <geth data dir>

Special Consensus Considerations

IBFT

IBFT block data contains sealer information in the header, to restore a copy of exported chain data, the new node must be initialized use an IBFT genesis file with exact same validator set encoded in extra data field as original exported node’s genesis.

Raft

Raft backup do not account for current Raft state. An exported chain data from a Raft cluster can only be used by new nodes being added to that same cluster only.

ConsenSys has acquired Quorum from J.P. Morgan. Please read the FAQ.
Questions or feedback? You can discuss issues and obtain free support on GoQuorum Slack channel.
For paid professional support by ConsenSys, contact us at quorum@consensys.net