Loading...

Changing the Location of the Index Cache Directory (Indexing Version 1 and Indexing Version 2)

You can change the location of the index cache directory.

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

Before You Begin

  • Confirm that the hardware requirements listed on the Indexing Planning page have been addressed for the new index cache directory.
  • When changing the location of 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 changing the location of 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.
  • When entering the index cache directory path, note the following:
    • The path may not exceed a total of 75 characters.
    • The path may not contain special characters.
    • The path may not contain Unicode characters.
    • The path may not contain the word "temp" (for example, c:\Indexcache_temp)
  • Do not locate the index cache directory on your CommServe computer, unless you only have one MediaAgent and that MediaAgent is located on that computer.

Procedure

Important: During this procedure, all backup jobs that use the index are automatically suspended.

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

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

  3. To specify a new index cache directory, follow either substep a or substep b, as follows:

    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 select a folder that already exists: Follow either substep i. or substep ii, below:
      1. Type an existing path name in 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 a new folder and then select it: 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: 11/2/2020 7:51:16 PM