Changing the Location of the Index Log Cache Directory

You can change the location of the index log cache directory on a MediaAgent, in order to help distribute the MediaAgent's disk resources.

By default, the IndexCache directory stores all index databases and all index action logs.

After you change the location of the index log cache directory, content is stored as follows:

• IndexCache directory: Stores only the index databases

• New index log cache directory: Stores the index action logs and other non-essential index data

Before You Begin

• If the new index log cache directory will reside on the same volume as the IndexCache directory, verify that the volume has enough free space to hold two complete copies of the index action logs. This amount of free space is required because, when you change the location of the index log cache directory, the system copies the index action logs from the IndexCache directory to the new index log cache directory.

• When you change the location of the index log cache directory, note the following:

  • Use a file system that is dedicated to index data, so that non-index data does not consume index capacity.

  • Do not place the index log cache directory on a compressed drive.

  • Do not place the index log cache directory directly under the software_installation_directory.

  • The index log cache directory path must meet the following requirements:

    • The path cannot contain more than 75 characters.

    • The path cannot contain special characters.

    • The path cannot contain Unicode characters.

    • The path cannot contain the word "temp". For example, the path cannot be C:\Indexlogcache_temp.

  • Do not place the index log cache directory on the CommServe computer, unless you have only one MediaAgent and that MediaAgent is located on the CommServe computer.

  • For UNIX, do not specify root as the index log cache directory.

Procedure

1. From the CommCell Browser, expand Storage Resources > MediaAgents.

2. Right-click MediaAgent_name, and then select Properties > Catalog.

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

3. Select Use alternate path for Index Log.

4. Specify the new location for the index log cache directory by either selecting an existing location or creating and then selecting a new folder.

   Important

   The length of the complete path to the index log cache directory, including the name of the directory itself, cannot contain more than 75 characters.

5. Click OK.

What to Do Next

• The system copies the log cache directories and files to the newly specified index log cache directory, and then directs the system to write all subsequent log cache files 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.

• The system does not delete the contents of the original index log cache directories and files after copying them to the newly specified directory. Therefore, if desired, you can manually delete the original index log cache directories and files, in order to free up the disk space that it originally occupied.