Backing Up and Restoring TREX Configuration Files

Use

·        Back up configuration files

You use the Python script configBackup.py to back up the TREX configuration files. You can find this script in the python_support directory in the TREX installation directory <TREX_DIR>:

¡        On UNIX: /usr/sap/<SID>/TRX<instance_number>

¡        On Windows: <disk_drive>:\usr\sap\<SID>\TRX<instance_nummer>\

·        Restore configuration files

There is no script for restoring the configuration files, instead you must do this manually.

Prerequisites

·        To be able to start the Python scripts for data backup and restore, you must ensure that the following prerequisites have been met:

¡        On UNIX: Make sure that the environment variables defined in TREXSettings.sh or TREXSettings.csh are set.

¡        On Windows: Choose Start ® Programs or All Programs ® SAP TREX ® Instance <instance_number> ® Tools ® TREX_<instance_number> Console. In the command prompt that appears, the environment variables have already been set accordingly.

·        Make sure that a backup directory is available at <backup_path> for the backup of the configuration files. SAP recommends that you use another hard disk or breakdown-proof host for the backup directory. If necessary, create a new directory for this purpose (for example, N:\Backup)

Back up configuration files

...

       1.      Log on with the user <sid>adm.

       2.      Go to the python_support directory that the configBackup.py script is located in.

       3.      To back up the TREX configuration files in a backup directory, enter the following:

python configBackup.py <backup_path>

In a distributed TREX system landscape, the configuration files for each host that TREX is installed on are saved in a separate directory:

¡        N:\Backup\config\<address_pc_1>

TREXAttributes.ini

...

TREXWebServer.ini

¡        N:\Backup\config\<address_pc_2>

TREXAttributes.ini

...

TREXWebServer.ini

python configBackup.py N:\Backup

For more information about using the Python script configBackup.py, see the help function python configBackup.py --help.

TREX Availability During Data Backup

During data backup for TREX configuration files, you can continue to run TREX in all TREX landscapes (TREX single-host installation and distributed TREX system with centralized and decentralized data storage):

·        All TREX servers and still available.

·        Searching and indexing is possible for all indexes.

Restoring Configuration Files

You must restore the configuration settings manually because otherwise all current configuration settings (including the configuration for existing indexes in the central configuration file topology.ini) would be overwritten and could be lost. This would lead to inconsistencies in the TREX configuration and unusable indexes and queues.

TREX Availability During Data Restore

When you manually restore the TREX configuration files, you must stop TREX in all TREX system landscapes (TREX single-host installation and distributed TREX system with centralized and decentralized data storage).