As a best practice, you must back up all the data on the Client nodes within the Client group to perform operations such as restoring or cloning.

Backing up Client node data lets you retrieve the data if an operation fails, and you must restore the lost data.

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 AWS.
  • Verify that you have access to the latest version of VMware Blockchain.
  • Verify that you have captured the IP addresses of all the Client node VMs and have access to them. You can find the information in the VMware Blockchain Orchestrator descriptor file.

Procedure

  1. Stop all the applications that invoke connection requests to the Daml Ledger.
  2. Stop all the Client node components.
    curl -X POST 127.0.0.1:8546/api/node/management?action=stop
  3. Verify that all the containers except the agent and deployed Concord operator container are stopped.

    sudo docker ps -a

    If the sudo docker ps -a command shows that some containers, with the exception agent and deployed Concord operator container, are still running, then rerun the command or use the curl -X POST 127.0.0.1:8546/api/node/management?action=stop command to stop the containers.

  4. Back up the data on each of the Client nodes in the group.
    1. In the EC2 interface, select the VMware Blockchain node from the Amazon EC2 page and navigate to the Storage tab.
    2. In the EC2 interface, select the data volume ID, navigate to the EBS volumes, and select Actions > Create Snapshot.

      This step creates a snapshot of the EBS volume you can use for restoring your data.

  5. Save the snapshot ID and the node IP address.

    This information is used to map the snapshot and node during the Client node restore process.

  6. Start all the Client node components.
    curl -X POST 127.0.0.1:8546/api/node/management?action=start
  7. Start all the applications that invoke connection requests to the Daml Ledger.