Administration and Maintenance > Back up the IDOL Server > Back up Content > Back up the Entire IDOL Server Data Index

Back up the Entire IDOL Server Data Index
You can back up the entire IDOL server data index in several ways:
*
Immediately, using a DREBACKUP action.
*
*
*
Related Topics 
*
*
*
*
Back up the Data Index Immediately
Issue a DREBACKUP action (case sensitive) from your Web browser to copy all the IDOL server data index *.DB files to a new location:
http://IDOLhost:indexPort/DREBACKUP?path
where,
 
is the IDOL server index port (specified by the IndexPort parameter in the IDOL server configuration file [Server] section)
is the path to the location where you want to create the 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 IDOL server data index on E:\Backup. The IDOL server whose data index is backed up is located on a machine with host name MyHost.
DREBACKUP also accepts the optional parameter HostDetails. Set HostDetails to true to write the backup to a subdirectory within the specified directory path. IDOL server name s 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 this procedure to back up the data index at regular intervals.
To back up the data index at regular intervals
1.
Open the IDOL server configuration file in a text editor and find the [Schedule] section. If the configuration file does not contain a [Schedule] section, add one.
2.
 
Set to true to enable a schedule backup.
Set to true to compress the IDOL server data index before backing it up.
Specify the time (hh:mm) when you want the backup to start.
Enter the path to the location where you want to create the data index backup. You must specify one directory for each of the NumberOfBackups.
Enter true to maintain the directory structure when the data index is backed up.
Specify the number of times you want to back up the 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 you specify). IDOL server executes multiple backups in the following way:
*
After the data index has been backed up as many times as you specified for NumberOfBackups, it overwrites the first backup the next time the specified BackupInterval elapses. This process means you always have a current set of data index backups.
Specify the number of times you want IDOL server to reattempt a backup if it fails. After this number of attempts, IDOL server cancels the operation.
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 this procedure to back up the data index automatically whenever you send a DRECOMPACT action .
To back up the data index automatically
1.
Open the IDOL server configuration file in a text editor and find the [Schedule] section. If the configuration file does not contain a [Schedule] section, add one.
2.
 
Type true to perform a backup of key files automatically whenever a DRECOMPACT action is sent (either from a Web broswer, or by an IDOL server schedule). 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 IDOL server directory structure. You can compress the backup by setting BackupCompression to true and setting BackupCompressionLevel.
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 IDOL server data directory.
If 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 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 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 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.
5.
After the snapshot completes, restart the indexing queue. Issue another IndexerGetStatus action, this time specifying a Restart action:
/http://IDOLhost:ACIport/action=IndexerGetStatus&index=indexNum&IndexAction=restart
where indexNum is the index ID (for example, 41) returned from DREFLUSHANDPAUSE.