Loading...

Indexing: Moving the Index Directory

Use the procedure on this page to move the Index Directory to a new location on a local drive.

Table of Contents

Before You Begin

  • Before configuring or changing your Index Directory, confirm that the hardware requirements given on the Indexing: Planning page have been addressed for the destination location.
  • You will have the option of copying the contents of the existing Index Directory. If you will be copying the contents to the same volume, make sure the volume has enough free space to hold two complete copies of the Index Directory's contents.

Procedure

This process begins with an automated procedure, but may end with some manual steps if appropriate. The procedure will help you decide whether to use the manual steps.

The automated procedure changes the MediaAgent properties to point to a new directory, and will copy it there if you select that option.

Follow these steps:

  1. From the CommCell Browser, expand Storage Resources > MediaAgents.
  2. Right-click the MediaAgent_name > Properties > Catalog.
  3. The current location of the index data appears in Index Directory.
  4. To change the location of the Index Directory, click Browse.
  5. Navigate to the directory where you want to host the index data, or use the New Folder button.

    Important: The length of the complete path to the Index Directory, including the name of the directory itself, cannot be more than 75 characters total.

  6. Click OK twice to set the MediaAgent to point to the new Index Directory location.
  7. In the Confirm dialog box, click Yes or No to perform the operation. The index data will be copied, moved or left in place without copying it, depending on the Copy or Move Setting.

    Note: If you do not move or copy to the index data to the new location, subsequent jobs that require a prior index will get it by restoring it from backup media. The first time after you have changed the Index Directory location, this restore operation will make each job take longer, especially if your primary backup medium is tape.

  8. To see the status of the job, look for a Catalog Migration job in the Job Controller.
  9. To move the index data manually to the new Index Directory location, follow these steps:
    1. Stop the NetApp services on the MediaAgent.
    2. Move the subfolders contained in the current Index Directory folder to new Index Directory location. Do not move the files located in the current Index Directory.
    3. Start the NetApp services on the MediaAgent.

Copy or Move Setting

The nRemoveIndexCacheAfterMigration Additional Setting controls whether the automatic procedure moves or copies the index data to the new location, and what it does with the old folder. These are its supported values and behaviors:

Value   Behavior Description
0 Copy mode. In the Confirm dialog box:
  • If you click Yes, the process copies the index data to the new location and leaves the old index data intact in the old location.
  • If you click No, the process leaves the old directory in place, with its data intact, and creates the new, empty Index Directory in the location you gave.
1 Move mode. In the Confirm dialog box:
  • If you click Yes, the process deletes the old Index Directory when the copy operation has completed.
  • If you click No, the process deletes the index data from the old location without copying it to the new location, and deletes the old directory. Use with caution!
2 Move with Time Stamp mode. In the Confirm dialog box:
  • If you click Yes, the process deletes the index data from the old location when the copy operation has completed, then renames the empty directory by adding a timestamp to the folder name.
  • If you click No, the process renames the old directory by adding a timestamp to the folder name, and leaves its content intact.

Note: The time stamp indicates the system time when the move operation completed.

Note: If this setting has not been added, the behavior is that described for the value of 0. To add this new setting, perform the Add or Modify an Additional Setting procedure, using the Name of nRemoveIndexCacheAfterMigration and Category of MediaAgent.