Platform-level backups

IBM recommends to do platform-level backups to protect the system configuration files and log files from a physical or logical disaster event.

Note:
  1. Platform-level backups back up only configuration files but not Db2 data.
  2. Platform-level backup is only a part of disaster recovery recommendation.
  3. Platform-level backup is not IBM's disaster recovery strategy.
  4. IBM recommends to do a host backup before you use apupgrade.

Components supported for backup

  • Apnetworking
  • LDAP
  • NTP
  • Apsecurity
  • Call home
  • MTM and serial number
  • Web console
  • System history
  • Lift

The host backup command

Run the host_backup -h command as the apuser from any node on the system.

The destination path is /opt/ibm/appliance/storage/platform.

This path includes subdirectories of the tar files with the time stamp at the time when the backup is taken. The tar file includes the configuration files of all the nodes that are stored individually.

host_backup -h

usage: host_backup [-h] [--apnetworking] [--ldap] [--ntp] [--apsecurity]
                   [--callhome] [--mtm] [--webconsole][--systemhistory][--lift][--all]

Perform Host Backup

optional arguments:
  -h, --help      show this help message and exit
  --apnetworking  Backup network Configuration
  --ldap          Backup ldap Configuration
  --ntp           Backup ntp and timezone Configuration
  --apsecurity    Backup appliance security Configuration
  --callhome      Backup Callhome logs and Configuration
  --mtm           Backup mtm and serial number 
  --webconsole    Backup webconsole configuration
  --systemhistory Backup system history
  --lift          Backup lift Configuration
  --all           Backup all host Configurations
--apnetworking
Backs up the configuration file that contains the default gateway and DNS.
The configuration file defines the IP addresses and interfaces.
Example on a three-node system:
[apuser@node0101 home]$ host_backup --apnetworking
Host Backup is in Progress...
Successfully Finished Host Backup. 
Please find the tar file at /opt/ibm/appliance/storage/platform/host_backup_20180319145212.tar.gz
For more info see /opt/ibm/appliance/storage/platform/logs/host_backup_20180319145212.log
--ldap
Backs up configuration files of internal and external ldap, sssd, and group membership.
Example:
[apuser@node0101 home]$ host_backup --ldap
Host Backup is in Progress...
Successfully Finished Host Backup. 
Please find the tar file at /opt/ibm/appliance/storage/platform/host_backup_20180319145339.tar.gz
For more info see /opt/ibm/appliance/storage/platform/logs/host_backup_20180319145339.log
--ntp
Backs up the ntp configuration and the time zone configuration files.
Example:
[apuser@node0101 home]$ host_backup --ntp
Host Backup is in Progress...
Successfully Finished Host Backup. 
Please find the tar file at /opt/ibm/appliance/storage/platform/host_backup_20180319145510.tar.gz
For more info see /opt/ibm/appliance/storage/platform/logs/host_backup_20180319145510.log
--apsecurity
Backs up the root lockdown configuration file.
Example:
[apuser@node0101 home]$ host_backup --apsecurity
Host Backup is in Progress...
Successfully Finished Host Backup. 
Please find the tar file at /opt/ibm/appliance/storage/platform/host_backup_20180319145607.tar.gz
For more info see /opt/ibm/appliance/storage/platform/logs/host_backup_20180319145607.log
--callhome
Backs up the call home configuration file and the logs.
Example:
[apuser@node0101 home]$ host_backup --callhome
Host Backup is in Progress...
Successfully Finished Host Backup. 
Please find the tar file at /opt/ibm/appliance/storage/platform/host_backup_20180319145906.tar.gz
For more info see /opt/ibm/appliance/storage/platform/logs/host_backup_20180319145906.log
--mtm
Backs up the configuration files of the MTM system and serial number.
Example:
[apuser@node0101 home]$ host_backup --mtm
Host Backup is in Progress...
Successfully Finished Host Backup. 
Please find the tar file at /opt/ibm/appliance/storage/platform/host_backup_20180319145947.tar.gz
For more info see /opt/ibm/appliance/storage/platform/logs/host_backup_20180319145947.log
--webconsole
Perform the backup of the web console configuration files.
Example: 
[apuser@node0101 home]$ host_backup --webconsole
Checking GPFS Status and Mounts..
Host Backup is in Progress...
Please find the tar file at /opt/ibm/appliance/storage/platform/host_backup_20180626103945.tar.gz
For more info see /opt/ibm/appliance/storage/platform/logs/host_backup_20180626103944.log
--systemhistory
Perform the backup of the system history files.
Example: 
[apuser@node0101 home]$ host_backup --systemhistory
Checking GPFS Status and Mounts..
Host Backup is in Progress...
Please find the tar file at /opt/ibm/appliance/storage/platform/host_backup_20180626104349.tar.gz
For more info see /opt/ibm/appliance/storage/platform/logs/host_backup_20180626104349.log
--lift
Perform the backup of lift configuration files.
Example: 
[apuser@node0101 home]$ host_backup --lift
Checking GPFS Status and Mounts..
Host Backup is in Progress...
Please find the tar file at /opt/ibm/appliance/storage/platform/host_backup_20180720160047.tar.gz
For more info see /opt/ibm/appliance/storage/platform/logs/host_backup_20180720160045.log
--all
Backs up the host configuration files of all the included components.
Example:
[apuser@node0101 home]$ host_backup --all
Host Backup is in Progress...
Successfully Finished Host Backup. 
Please find the tar file at /opt/ibm/appliance/storage/platform/host_backup_20180319150024.tar.gz
For more info see /opt/ibm/appliance/storage/platform/logs/host_backup_20180319150024.log

Destination path

The destination path is /opt/ibm/appliance/storage/platform.

This destination path includes subdirectories of the tar files with the time stamp at the time when the backup was taken. The tar files include the configuration files for each node and are stored separately.

The following options are available:

Change the directory to opt/ibm/appliance/storage/platform
[apuser@node0101 platform]#ls
host_backup_20180319150024 host_backup_20180319150024.tar.gz logs
Change directory to the backup folder host_backup_20180319150024
[apuser@node0101 home]$ cd /opt/ibm/appliance/storage/platform/host_backup_20180319150024
The configuration files for each node are stored separately
[apuser@node0101 host_backup_20180319150024]$ ls
node0101  node0102   node0103
Change directory to node0104
[apuser@node0101 host_backup_20180319150024]$ cd node0101/

[apuser@node0101 node0101]$ ls
db  group  gshadow  ldap  localtime  callHome.json  MTM  ntp.conf  openldap     
patch-panel-config-default.json  SERIAL  sssd.conf request.log 
callHome.0.log web_console dsserversystem_history_node0101.txt dsweb persistent