Loading...

Moving the Index Cache Directory (Indexing Version 1 and Indexing Version 2)

You can move the index cache directory to a new location on a local drive.

Note: You can change the location of index caches on multiple MediaAgents by running the Change Index Cache Configuration workflow.

Before You Begin

  • Before configuring or changing the index cache directory, confirm that the hardware requirements listed on the Indexing Planning page have been addressed for the destination location.
  • When moving the index cache directory, the system copies the contents of the original index cache directory to the new index cache directory. If the new index cache directory will reside on the same volume as the original index cache directory, ensure that the volume has enough free space to hold two complete copies of the index cache directory's contents.

Notes

When moving the index cache directory, note the following:

  • Use a file system dedicated to index data, so that non-index data does not consume index capacity.
  • Estimate your Index Cache space requirements with a sufficient margin of safety by allocating more space rather than less. If you are maintaining backward-compatible content indexes generated by a previous software version, the index cache directory may require more space.
  • For best performance, locate the index cache directory on a solid state drive (SSD).
  • Do not locate the index cache directory on a compressed drive.
  • For Windows, do not place the index cache directory directly under the software_installation_directory.
  • For UNIX, do not specify root as the index cache directory.
  • The index cache directory path:
    • May not exceed a total of 75 characters.
    • May not contain the "!" character.
    • May not contain Unicode characters.
  • Do not host the index cache directory on your CommServe computer, unless you only have one MediaAgent and that MediaAgent is located on that computer.

Procedure

Important: While the moving the index cache directory process is running, all backup jobs that use the index are automatically suspended.

  1. From the CommCell Browser, expand Storage Resources > MediaAgents.
  2. Right-click the MediaAgent_name > Properties > Catalog.

    The current location of the index data appears in Index Directory.

  3. Follow either substep a or substep b, below, to specify a new index cache directory:

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

    1. To specify a folder that already exists: Follow either substep i. or substep ii, below:
      1. Type an existing path name in the Index Directory. Skip to Step 4, below.
      2. Click the Browse button, browse to and click an existing folder, and then click the OK button. Skip to Step 4, below.
    2. To create and specify a new folder: Click the Browse button, browse to and click an existing folder under which you wish to create the new folder, click the New Folder... button, enter a name for the new folder, and then click the OK button twice. Skip to Step 4, below.
  4. Click OK.
  5. The system will copy the contents of the original index cache directory to the newly specified index cache directory, and then direct the system to write all subsequent index entries to the new directory. To see the status of the job, look for a Catalog Migration job in the Job Controller tab of the Commcell Console.
  6. The system does not delete the contents of the original index cache directory after copying them to the newly specified index cache directory. Therefore, if desired, you can manually delete the original index cache directory and its contents, in order to free up the disk space that it originally occupied.

Last modified: 5/17/2019 7:34:23 PM