Moving the Index Cache Directory

Table of Contents

You can move an existing index cache to a different directory. If your index cache is very large and the directory you are moving it to is on the same volume (disk), we recommend using the Manual Procedure described below.

SnapProtect Version 10 now supports locating the index cache only on a local drive. You must move an old shared index cache to a local drive if you make any changes to its configuration. To set up a local index cache, see Index Cache - Configuration.

Before You Begin

Before configuring or changing your index cache, confirm that the recommendations and requirements for the destination location that are given on the Index Cache - Prerequisites page have been addressed.

Automatic Procedure

This procedure automatically moves index cache data to a new directory that you specify, by copying it to that new location and changing the MediaAgent to point to it there.

When to Use this Procedure

Moving the index cache to another location using this procedure does not require manual steps. However, if the index cache is very large, and the destination and source volumes are the same, you can save time by using the Manual Procedure instead.

Steps

Use these steps to automatically move the index cache to a different directory:

  1. Verify that there is sufficient space on the destination drive to hold a complete copy of all the data in the current index cache folder. If the destination directory is on the same physical volume (drive) that volume must have enough free space to hold two complete copies of the index cache data.
  2. From the CommCell Browser, expand Storage Resources > MediaAgents.
  3. Right-click the MediaAgent_name > Properties.
  4. In the MediaAgent Properties dialog box, click the Catalog tab. The current location of the index cache appears in Index Cache Directory.
  5. To change the location of the index cache, click the Browse button.
  6. Navigate to the volume, then select the folder where you want to host the index cache. Click New Folder if the folder you are copying the index cache to doesn't already exist.
  7. Click OK. The new location appears in Index Cache Directory.
  8. Click OK to close the MediaAgent Properties dialog box.
  9. Click Yes to close the Confirm message, and copy the index cache data to its new location.
  10. Click OK.

Manual Procedure

Use this procedure to move index cache data to a new directory by manually moving it using operating system tools.

When to Use this Procedure

If you are moving the index cache to another directory on the same volume that it is currently on, this procedure has the advantage of not making a complete copy of the index data at the destination location. Rather, it moves the data from the old location to the new, thus removing the need for enough free space on the volume to hold two complete copies of the index cache data. This operation is also much faster than a copy operation.

You may need to manually relocate the index cache when:

  • The index cache folder is very large (that is, if there is not sufficient performance or volume capacity to support copying the complete contents of the current index cache directory).
  • The automatic index moving procedure did not complete, such as when there was not sufficient space to hold a complete copy of the data on the same volume as the source folder, and the data must be moved to the new location rather than copied.

Steps

To manually relocate the index cache, follow these steps:

  1. If you are performing this procedure because a previous attempt to automatically move the index cache did not succeed, begin by manually deleting the incomplete copy from the new location using operating system tools.
  2. In the CommCell Browser, expand Storage Resources > MediaAgents.
  3. Right-click the MediaAgent_name >Properties.
  4. Click the Catalog tab.
  5. In the Index Cache Directory box, click Browse, then navigate to the new index cache directory and click OK.
  6. Ensure that Enable this Access Path is selected, then click OK.
  7. In the Confirm window, click No. (Clicking Yes would copy the index cache data to the new location, which is what you are trying to avoid by using this manual procedure. Even though you clicked No, the new folder is still created if it did not already exist.)
  8. Stop the NetApp services on the MediaAgent.
  9. Move the subfolders contained in the current index cache folder to new index cache folder. Do not move the files located in the current folder.
  10. Start the NetApp services on the MediaAgent.

Related Reports

Description

The CommCell Configuration Report provides information on index cache disk usage for each MediaAgent in the CommCell. This information is useful to identify index cache growth and manage disk space. The report shows:

  • The total amount of space available in the index cache location.
  • The amount of space used by index cache entries.

This report is described on the CommCell Configuration Report page.

Steps

  1. On the CommCell Console menu bar, click the Reports tab.
  2. Click Configuration.
  3. In the Report Selection dialog box, on the General tab, select Index Cache Content.
  4. Click Run. The report appears in your web browser.