Backing up and Restoring a Node Database

The following procedure describes how to back up and restore the entire Redis database of a node. If your transfer server is an Aspera Files node, you can migrate Files data from one node to another by backing up the Redis database on the original node and restoring the database on a new node.

If you only need to back up and restore node usernames and passwords (the node user database), you can use asnodeadmin commands; see Backing up and Restoring the Node User Database Records.

These instructions assume that the node is using the default port for the Redis database, port 31415. If your deployment uses a different port for Redis, substitute it in the commands accordingly.

  1. Verify that the original node and new node are running the same version of Aspera software.
    Run ascp -A on a command line to view the Aspera product and version.
  2. On the original node, back up the database.
    Stop the Aspera Node D service by going to Control Panel > Administrative Tools > Computer Management > Services and Applications > Services, clicking Aspera NodeD, and clicking Stop. Create the backup file by running the following command:
    > asredis -p 31415 BGREWRITEAOF
    The backup is stored as appendonly.aof in the following location:
    C:\Program Files[ (x86)]\Aspera\Enterprise Server\var\appendonly.aof
  3. If migrating the database, move the appendonly.aof to the same location on the new node.
  4. On the new node, stop the Aspera NodeD service.
    Stop the Aspera Node D service by going to Control Panel > Administrative Tools > Computer Management > Services and Applications > Services, clicking Aspera NodeD, and clicking Stop.
  5. Flush existing data from the Redis database on the new node.
    >asredis -p 31415 FLUSHALL
  6. Load the backup database file into the new node database.
    > type appendonly.aof | asredis --pipe -p 31415
  7. On both nodes, restart the Aspera NodeD service.
    Start the Aspera Node D service by going to Control Panel > Administrative Tools > Computer Management > Services and Applications > Services, clicking Aspera NodeD, and clicking Start.
  8. In Files, confirm that the hostname matches the DNS entry for the new node.
    To view the node URL, go to Admin View > Nodes & Storage.
  9. Confirm the database restoration succeeded.
    Run the following command to the original and new nodes. If the database restoration succeeded, the output from each is identical.
    > curl -ki -u {node_username:node_password} http[s]://{hostname}:{http_port}access_keys
    Note: Curl is included in many Unix-based operating systems. To check if it is installed, enter curl on the command line. If it is not installed, download it from the Curl website: https://curl.haxx.se/download.html.