Replica node RockDB checkpoint-based backup can be used for operational recovery, creating a blockchain, disaster recovery, or auditing.

The RocksDB checkpoint-based backup does not require a maintenance window. You can create a backup when the system is running.

Note:

You can schedule either a RocksDB checkpoint-based backup or intermittent backup. You cannot configure both types of backup processes to run simultaneously.

A RocksDB checkpoint-based backup is enabled by default on all the Replica nodes with the following parameter values:

  • "NUM_DB_SNAPSHOTS": "2",

  • "DB_SNAPSHOT_INTERVAL_HOURS": "6"

Before deployment, you can configure these parameter values by updating them in the infrastructure_descriptor.json file. See the Advanced Features Parameters section for details, Configuring the Infrastructure Descriptor Parameters on vSphere.

You can also create an on-demand RocksDB checkpoint-based backup using the operator container.

Prerequisites

  • Verify that you have the deployed blockchain ID information.
  • Familiarize yourself with the backup and restore consideration for your VMware Blockchain nodes. See VMware Blockchain Node Backup and Restore Considerations on vSphere.
  • Verify that you have access to the latest version of VMware Blockchain.

  • Verify that you have captured the IP addresses of all the Client and Replica node VMs and have access to them. You can find the information in the VMware Blockchain Orchestrator descriptor file.

  • If the Concord operator containers were deployed, verify that the Concord operator container is running. See Instantiate the Concord Operator Container for vSphere.

Procedure

  1. After deployment, validate that the default or customized values appear in the deployment configuration file. 
    cat /config/concord/config-local/deployment.config | grep FEATURE_db_checkpoints
FEATURE_db_checkpoints: true

    The Concord container creates a database checkpoint when the listed default configuration is set to True.

    • FEATURE_db_checkpoints - True

    • db_checkpoint_duration - 21600

    • num_of_rocksdbcheckpoints - 2

    • dbcheckpoint_window - 30000

    • db_checkpoint_diskspace_threshold - 0.5

    • db_checkpoint_path - "rocksdbdata/checkpoints"

    The db_checkpoint_duration parameter sets the time since the last database checkpoint is greater than 21600 seconds and the sequence number 30000 or more have been executed since the last database checkpoint.

    The db_checkpoint_diskspace_threshold parameter defines the threshold factor to detect if RocksDB checkpoint disk usage is within the defined limit. This defined limit means that the free disk space available to the Concord container does not go under the threshold factor of 0.5 times of RocksDB size.

    The db_checkpoint_path parameter defines the path in the file system where database checkpoints are created.

  2. Verify that the database checkpoints are successfully created.
    1. SSH into a Replica node.
    2. Verify the newly created database checkpoints. 
      ls -lrt /mnt/data/rocksdbdata/checkpoints/

What to do next

If there is a Replica node failure, you can restore it from the RocksDB checkpoint backup data. See Restore Replica Nodes with RocksDB Checkpoint Data on vSphere.