Customizing the Archives Path

Changing the Archives path for a hive is generally done because of a serious problem, such as a drive failure. It must also be done with caution, or the results can be unexpected.

You must restart the server configuration for the new Archives path to take effect. The Server Administration tool saves the new path to the hive-index.xml file immediately; however, the changes take effect only after you restart the server configuration.

If accessing a remote server configuration or if a local server configuration has been added as a remote server, you can update the Archives path while that server configuration is running. If accessing a local server configuration locally, you must first shut down the server configuration before updating the Archives path.

To change the Archives path for a server configuration that is shut down
  1. Open the Server Administration tool and shut down the server configuration for which you want to modify the Archives path.
  2. Copy the Archives folder to its new location.
  3. Open the Hive Manager dialog box in the Server Administration tool by doing one of the following:
    • Click the Hive Manager shortcut button in the shortcut pane,
    • Select Tools > Administration > Hive Manager from the main menu.
  4. Update the Archive path field pointing to your new Archives path location.
  5. Click OK to confirm your choices. This action returns you to the Hive Manager dialog.
  6. Click OK to return to the main window of the Server Administration tool.
  7. Restart your server configuration.
Note: If you already have more than one hive for your server configuration, and you cannot quickly move the Archives folder to its new location, then you can disable any new archives from being added to the problematic Archives path by clearing the option to Allow new archives in the Hive Properties dialog. With this option cleared, StarTeam does not add any new archives to the designated Archives folder for the specified hive.
To change the Archives path for a server configuration that is running
  1. Open the Server Administration tool, and select the running server configuration containing the Archives path that you wish to update.
    Note: This must be a remote server configuration or a local server configuration that has been added as a remote server. You cannot access hive properties for local server configurations running locally.
  2. Open the Hive Manager dialog box in the Server Administration tool by doing one of the following:
    • Click the Hive Manager shortcut button in the shortcut pane.
    • Select Tools > Administration > Hive Manager from the main menu.
  3. Select the applicable hive in the Hive Manager dialog box, and click Properties.

    This opens the Hive Properties dialog box.

  4. Clear the Allow new archives check box in the Hive Properties dialog if at least one other hive exists for the server configuration.

    The files that are added or checked in will be sent to the other hive.

  5. Restart the server configuration.
  6. At an appropriate time, do the following:
    1. Shut down the server configuration.
    2. Copy the archive files to their new location.
    3. Change the Archive path field in the Hive Properties dialog to the new location, and check the option to Allow new archives.
    4. Restart the server configuration.
Parent topic: Data Storage Options