Creating New Hives

You can use the Hive Manager dialog for creating new hives to increase the amount of available space, or for viewing and updating the properties of an existing hive.

If accessing a remote server configuration or if a local server configuration has been added as a remote server, you can create new hives while that server configuration is running. If accessing a local server configuration locally, you must first shut down the server configuration before creating a new hive.

  1. Open the Server Administration tool and select the server configuration from the Server Pane.

    If you are not logged on, the Server Administration tool requires you to do so before continuing.

    Note: If accessing a local server configuration locally, you must shut down the server configuration before proceeding to the next step.
  2. Do one of the following:
    • Click the Hive Manager shortcut button in the shortcut pane.
    • Select Tools > Administration > Hive Manager from the main menu.

    The Hive Manager dialog opens.

  3. Click New in the Hive Manager dialog box.

    This opens the New Hive dialog box.

    Note: The location of the hive-index.html file, which contains the properties for each hive used by the server configuration, displays at the top of the dialog.
  4. Type information about the new hive in the following fields:
    • Name: Unique name for the hive. DefaultHive is the default.
    • Archive path: Path to the Archives folder for the new hive. The default path is <repository path>\DefaultHive\Archives .
    • Cache path: Path to the Cache folder for the new hive. The default path is <repository path>\DefaultHive\Cache .
    • Maximum cache size: Maximum number of megabytes of hard disk space that the Cache can use. The default is 20% of the disk space available. In the Server Administration tool, you can calculate the correct default maximum size for the cache. However, if you are using the Server Administration tool and it is not running on the same computer as the Server, you cannot calculate the maximum size. In this situation, type 100MB, as a default size.
    • Cache cleanup interval: Seconds between cache cleanup/refresh operations. The default value is 600. The range is 60 (1 minute) to 3153600 (1 year).
    • Storage limit threshold: Percentage of total disk space allowed for hive. When this percentage has been reached, StarTeam does not add any more archives to the hive. The default is 95% of total disk space.
    Tip: You can use UNC paths for the Archives and Cache paths.
  5. Select or clear the option to Allow new archives. The default is selected. If no other hives exist for the server configuration, this check box must be selected.
    Note: If you are adding a hive because the original hive was low on space, you should also use the Hive Manager dialog to display the properties of that hive and clear the Allow new archives check box. This action allows the original hive to remain a check-out location, but keeps it from acquiring any new files. Files that are added go to the new hive.
  6. Fill the Root Cache Agent archive path text box if you are using Cache Agent, and the Root Cache Agent is not on the same computer as the Server. Provide the path to the cache from the point of view of the Cache Agent.

    For example, suppose you create a new hive whose archive path is C:\ProdServer\Hives\NewHive\Archives, but the Root Cache Agent runs on a computer that has H:\ mapped to C:\ProdServer\Hives on the StarTeam Server computer. The Root Cache Agent would see the new hive archive path as H:\NewHive\Archives, so in this situation, you would type H:\NewHive\Archives in the Root Cache Agent archive path text box.

  7. Click OK to confirm your choices. This action returns you to the Hive Manager dialog.
  8. Click OK to return to the main window of the Server Administration tool.
    Note: If accessing a local server configuration locally, you can now restart the server configuration.
Parent topic: Data Storage Options