Open topic with navigation

# Back up the Entire HPE IDOL Server Data Index

You can back up the entire HPE IDOL Server data index in several ways:

- Immediately, using a `DREBACKUP` index action.

- At regular intervals, by setting up a scheduled backup.

- Automatically, whenever you send a `DRECOMPACT` index action.

- Dynamically, by taking a snapshot of the data.

Related Topics

- Back up the Data Index Immediately

- Back up the Data Index at Regular Intervals

- Back up the Data Index Automatically

- Back up the Data Index Dynamically

## Back up the Data Index Immediately

Issue a `DREBACKUP` action (case sensitive) from your Web browser to copy all the HPE IDOL Server data index `*.DB` files to a new location:

    http://IDOLhost:indexPort/DREBACKUP?path

where:

`IDOLhost` | is the IP address or host name of the HPE IDOL Server machine.
`indexPort` | is the HPE IDOL Server index port (specified by the `IndexPort` parameter in the `[Server]` section of the HPE IDOL Server configuration file).
`path` | is the path to the location where you want to create the HPE IDOL Server backup. In Windows, you can use a Unicode path.

For example:

    http://MyHost:20001/DREBACKUP?E:\Backup

This action uses port `20001` to create a backup of the HPE IDOL Server data index on `E:\Backup`. The HPE IDOL Server whose data index is backed up is located on a machine with the host name `MyHost`.

You can set the optional parameter `CheckIndexUpdates` to `True` if you want to check for updates to the index since the last backup. In this case, HPE IDOL Server skips the backup if the index has not been modified.

`DREBACKUP` also accepts the optional parameter `HostDetails`. Set `HostDetails` to `True` to write the backup to a subdirectory in the specified directory path. HPE IDOL Server names this directory using its host and port. In this way, a series of servers under a Distributed Index Handler (DIH) can all accept the same directory as input, and they write to a subdirectory named with their own host and port.

## Back up the Data Index at Regular Intervals

Use the following procedure to back up the data index at regular intervals.

To back up the data index at regular intervals

1. Open the HPE IDOL Server configuration file in a text editor.

2. Find the `[Schedule]` section. If the configuration file does not contain a `[Schedule]` section, add one.

3. Specify the following parameters in the `[Schedule]` section:

`Backup` | Set to `True` to enable a schedule backup.
`BackupCheckIndexUpdates` | Set to `True` to check for updates to the index before HPE IDOL Server runs a backup. When the index has not changed, IDOL Server skips the scheduled backup.
`BackupCompression` | Set to `True` to compress the HPE IDOL Server data index before the backup.
`BackupTime` | Specify the time (`hh:mm`) when you want the backup to start.
`BackupInterval` | Specify the number of hours that elapse between individual backups. Set to `0` (zero) to back up daily.
`BackupDirN` | Set to the path to the location where you want to create the data index backup. You must specify one directory for each of the `NumberOfBackups`.
`BackupMaintainDirStructure` | Set to `True` to maintain the directory structure when the data index is backed up.
`NumberOfBackups` | Specify the number of times that you want to back up the HPE IDOL Server data index. You can cycle the backing up procedure by specifying multiple backups (the number of backups you specify must correspond to the number of `BackupDirN` directories that you specify). HPE IDOL Server runs multiple backups in the following way: It creates the first backup at the specified `BackupTime`. It creates the next one after the specified `BackupInterval`, and so on. After the data index has been backed up as many times as you specified for `NumberOfBackups`, it overwrites the first backup the next time that the specified `BackupInterval` elapses. This process means that you always have a current set of data index backups.
`BackupRetryAttempts` | Specify the number of times that you want HPE IDOL Server to reattempt a backup if it fails. After this number of attempts, HPE IDOL Server cancels the operation.
`BackupRetryPause` | The number of seconds that you want HPE IDOL Server to wait between backup attempts.

For example:

    [Schedule]
    Backup=True
    BackupCompression=True
    BackupTime=00:00
    BackupInterval=24
    BackupMaintainStructure=True
    BackupRetryAttempts=3
    BackupRetryPause=5
    NumberOfBackups=3
    BackupDir0=E:\DataIndex_Backup0
    BackupDir1=E:\DataIndex_Backup1
    BackupDir2=E:\DataIndex_Backup2

## Back up the Data Index Automatically

Use the following procedure to back up the data index automatically whenever you send a `DRECOMPACT` action.

To back up the data index automatically

1. Open the HPE IDOL Server configuration file in a text editor.

2. Find the `[Schedule]` section. If the configuration file does not contain a `[Schedule]` section, add one.

3. Specify the following parameters in the `[Schedule]` section:

   `PreCompactionBackup` | Set this parameter to `True` to perform a backup of key files automatically whenever a `DRECOMPACT` action is sent (either from a Web browser, or by an HPE IDOL Server schedule). HPE IDOL Server backs up the files before it compacts the data index, so that you can restore them. `True` is the default value. The backup maintains the HPE IDOL Server directory structure. You can compress the backup by setting `BackupCompression` to `True` and setting `BackupCompressionLevel`.
   `PreCompactionBackupPath` | If you set `PreCompactionBackup` to `True`, you can use `PreCompactionBackupPath` to specify the path to the directory where you want to back up files. By default, it uses the `internalbackup` directory in the HPE IDOL Server data directory. If HPE IDOL Server shuts down without completing a compaction, it uses the contents of this directory to restore itself.

## Back up the Data Index Dynamically

If your HPE IDOL storage is a SAN with disk-snapshot capabilities, you can perform a hot backup (snapshot) of the data index.

To back up the data index dynamically

1. Send the `DREFLUSHANDPAUSE` action to prepare HPE IDOL Server for the hot backup by flushing all files to disk and pausing indexing:

       http://IDOLhost:indexPort/DREFLUSHANDPAUSE?

2. Note the index ID returned from this action (for example, `INDEXID=41`); you need this ID later to restart the paused indexing queue.

3. Poll HPE IDOL Server with the `IndexerGetStatus` action to view the status of the flush and pause process:

       <autnresponse>
       <action>INDEXERGETSTATUS</action>
       <response>SUCCESS</response>
       <responsedata>
       <item>
           <id>41</id>
           <origin_ip>127.0.0.1</origin_ip>
           <received_time>2006/10/06 13:47:15</received_time>
           <start_time>2006/10/06 13:47:16</start_time>
           <end_time>Finished</end_time>
           <duration_secs>0</duration_secs>
           <percentage_processed>0</percentage_processed>
           <status>-16</status>
           <description>Indexing Paused</description>*
           <index_command>/DREFLUSHANDPAUSE? HTTP/1.1</index_command>
       </item>
       </responsedata>
       </autnresponse>

   When the returned status is `–16` (`Indexing Paused`), you can perform the hot backup.

4. Take the snapshot according to the procedures defined by your SAN.

5. After the snapshot completes, restart the indexing queue. Issue another `IndexerGetStatus` action, this time specifying a `Restart` action:

       action=IndexerGetStatus&Index=indexNum&IndexAction=restart

   where `indexNum` is the index ID (for example, `41`) returned from `DREFLUSHANDPAUSE`.

© 2016 Hewlett Packard Enterprise Development LP | Send documentation feedback to HPE Close Send Documentation Feedback To open the configured email client on this computer, open an email window. Otherwise, copy the information below to a web mail client, and send this email to AutonomyTPFeedback@hpe.com. We appreciate your feedback! Product: Topic Title: Help Topic: Feedback:

_HP_HTML5_bannerTitle.htm