How do I back up the NSP cluster databases?
Purpose
Steps
1 |
Open a terminal session to the NSP deployer VM. |
2 |
Log in as the root or NSP admin user. |
3 |
If a common backup storage location is defined in the NSP configuration, go to Step 8. |
4 |
Open the following file with a plain-text editor such as vi: /opt/nsp/NSP-CN-DEP-release-ID/NSP-CN-release-ID/config/nsp-config.yml |
5 |
If the clusterProvider in the NSP configuration is set to ‘customer’ as shown below, perform one of the following. kubernetes: clusterProvider: "customer"
|
6 |
If required, configure the backups to be stored on an NFS server.
|
7 |
If you made any changes to the nsp-config.yml file in Step 5 or Step 6, enter the following to apply the changes to the cluster: Note: If the NSP cluster VMs do not have the required SSH key, you must include the --ask-pass argument in the nspdeployerctl command, as shown in the following example, and are subsequently prompted for the root password of each cluster member: nspdeployerctl --ask-pass install --config --deploy # /opt/nsp/NSP-CN-DEP-release-ID/bin/nspdeployerctl install --config --deploy ↵ |
8 |
Enter the following: # cd /opt/nsp/NSP-CN-DEP-release-ID/NSP-CN-release-ID/tools/database ↵ |
9 |
Enter one or more of the following, as required, to back up system data and databases: Note: It is recommended that you back up all system data and databases. Note: You must not proceed to the next step until each backup job is complete. Note: The system performs the backup of the index detail and user-related configured data in OpenSearch, such as dashboard, saved OpenSearch filters, visualise and other data configured by the user. The backup of the logs is available through the logCollector tool.
where backup_dir is the directory in which to store the backup The backup script displays messages like the following as a backup job proceeds: ---------------- BEGIN : Backing up database-backup ---------------- job.batch/backup_job created timestamp LOG: Waiting for job backup_job at namespace namespace to finish... timestamp LOG: backup done successfully timestamp LOG: Removing job backup_job at namespace namespace job.batch "backup_job" deleted timestamp LOG: Job backup_job at namespace namespace deleted ----------------- END : Backing up database_backup ----------------- ----------------- BEGIN : Fetching backup database ----------------- timestamp LOG: Fetching database backup from pod nsp-backup-storage-0 at namespace namespace timestamp LOG: Latest database backup is database_backup_timestamp.tar.gz tar: removing leading '/' from member names timestamp LOG: Latest database backup fetched successfully ----------------- END : Fetching backup database ------------------- A backup filename has the following format: database_backup_timestamp.tar.gz where database is the database name, for example, nspos-neo4j timestamp is the start time of the database backup Note: This step applies only starting with Release 25.8. The OpenSearch database is excluded from the backup operation if the system has been upgraded from a release earlier than Release 25.8. |
Safeguard backup files | |
10 |
Transfer the files in backup_dir to a secure location for safekeeping. Note: It is strongly recommended that you transfer each backup file to a secure facility that is outside the local data center. |
11 |
Close the console window. End of steps |