Backing up an offline i2 Analyze system

An offline back up is taken when the system is not in use. The advantage in taking a backup when the system is not in use is that you have confidence that the

About this task

For a deployment that uses the Analysis Repository, back up the Analysis Repository database, and the Lucene index directory.

For a deployment that uses the Information Store, back up the Information Store database, and the Solr and ZooKeeper directories.

Regardless of which data stores that you are using, your backup procedure might also include backing up the following items:
  • The data directory for i2 Analyze.
  • The i2 Analyze deployment toolkit configuration files.
  • The home directory for WebSphere Application Server Liberty profile.
  • The configuration files for the HTTP reverse proxy.

The environment.properties files in the configuration contain the locations for many of these items. Each application that is defined in your topology file has an associated folder in the toolkit\configuration\environment\ directory that stores information about the environment that is specific to that application.

Procedure

  1. Ensure that any application servers are stopped.
    To stop the application server for the Analysis Repository, run the following command:
    setup -s onyx-server -t stop
    To stop the application server for the Information Store, run the following command:
    setup -s opal-server -t stop
  2. Create a backup of the databases in your system by following the instructions for your database management system.
    Note: If you are using IBM DB2 as your database management system, the root location of DB2 database file storage is specified by the db.database.location.dir.db2 property in the environment.properties file.
  3. Make a copy of the data directory for i2 Analyze.

    The default directory is C:\IBM\i2analyze\data. The data directory is specified by the apollo.data property in the environment.properties file.

    By default the Lucene index, Solr, and ZooKeeper directories are located within this directory.
  4. Optional: If your Lucene index, Solr, and ZooKeeper directories are not in the default locations, make a copy of the directories.
    The directory locations are specified in the topology.xml file, which is stored in the toolkit\configuration\environment directory.
    The following elements in the topology.xml file contain the directory locations:
    • For the Lucene index directories, the locations of each index are specified in a <lucene-index> element as the values of the main-index-location and alternatives-location attributes.
    • For the Solr directories, the locations are specified in the <solr-node> element as the value of the data-dir attribute.
    • For the ZooKeeper directories, the locations are specified in the <zkhost> element as the value of the data-dir attribute.
  5. Make a copy of the i2 Analyze deployment toolkit directory that contains the configuration files. The default directory is toolkit\configuration\.
  6. Make a copy of the home directory for WebSphere Application Server Liberty profile.

    The default directory is C:\IBM\i2analyze\deploy\wlp\usr.

    The directory name is specified in the wlp.home.dir property in the environment.properties file.

  7. Make copies of the HTTP reverse proxy configuration files.

    Copy the httpd.conf file that is stored in the C:\IBM\HTTPServer\conf directory, and the plugin-cfg.xml file that is stored in the C:\IBM\HTTPServer\plugins\iap\config directory.

  8. When your backups are complete, restart the application servers for your system.
    To start the onyx application server, run the following command:
    setup -s onyx-server -t start
    To start the opal application server, run the following command:
    setup -s opal-server -t start

© Copyright IBM Corporation 2012, 2020.