Backing up and restoring the Information Server microservices tier
Back up and restore the InfoSphere® Information Server microservices tier by running a script.
About this task
- Enterprise Search
- IBM® Watson Knowledge Catalog
- Information Governance Catalog
- InfoSphere Information Analyzer
- Failure of disk or systemIn this scenario, the microservices system is in a failed state. Problems might include:
- kubectl command not working
- Base operating system in a failed state and system must be re-built
In this scenario, before the Backup/Restore utility can be successfully used, the microservices system must be setup or re-installed on a system that has the same host name as the original microservices tier. Once the microservices stack is re-installed successfully,you can run the Backup/Restore utility to restore data, sts/deployment state, and so forth, onto the system.
In the cases noted previously, to achieve the desired starting state for a restore, the re-installation or re-addition of the microservices tier should be performed according to the following documentation, starting with step 4: https://www-01.ibm.com/support/docview.wss?uid=ibm10882766
- Data corruption or system in an undesired state
In this scenario, data is corrupted in one or more of the persistent volumes. Changes or issues might be present with the Kubernetes configuration that is stored in the etcd database.
Provided that the “failed state” items in the first scenario are not met, you can run the Backup/Restore utility to restore the system.
- Revert versions
Example: A cold, offline backup of all tiers (microservices, services, engine, repository) is performed on an installed version of InfoSphere Information Server. Service Pack 1 is applied on top of version 11.7.1, but you now want a way to revert back to version 11.7.1. You can use the Backup/Restore procedure to help restore the microservices tier to the “point in time” that backup was taken. All other tiers (services, engine, repository), must be restored to the same “point in time” backup.
This utility supports only single-node installations of the microservices tier.
- Download the back up and restore package from Fix Central and save it in the installation_directory/UGInstall installation directory on the microservices tier.
- Run the following command to extract the tar file:
tar –xvf UGI-Backup-Restore-11.7.1.tar
- Run the Backup/Restore utility by running the script backup-restore-ugi.sh, which is located in the Backup-Restore directory. (Default: /opt/IBM/UGInstall/Backup-Restore)
What to do next
You can run the command ./backup-restore-ugi.sh -help to list all available options for the utility. Additional configurable options such as non-default installation directories can be controlled by using utils/common.env.
./backup-restore-ugi.sh -backup -listSteps
./backup-restore-ugi.sh -restore -listSteps
For more information on backing up the InfoSphere Information Server traditional components such as the services, engine, and repository tiers, see Backing up and restoring IBM InfoSphere Information Server.
- Backup the microservices tier
- Restore the microservices tier
./backup-restore-ugi.sh -restore /full/path/to/archive/UGI-Backup-TIMESTAMP.tar.gz
- Stop the microservices tier services
- Start the microservices tier services
- Restart (stop/start) the microservices tier services
By default, the archive is saved in the installation_directory/UGInstall/Backup-Restore directory, unless you specify a -location option when you use -backup.