Removing a Depot from the AccuRev Repository

This section describes a procedure for removing a depot completely from the AccuRev repository. Removing a depot:

  • Deletes every version of every file and directory in the depot.

  • Deletes the entire history of the depot all transactions involving the depot and its elements.

    Removing a depot does not affect any of the workspaces or reference trees that contain copies of the depot's elements.

Before You Begin

We strongly recommend that you preserve a backup copy of the AccuRev data repository before deleting any depots. See Backing up the repository. Much of a depot's data is stored in its slice of the repository. Use the command accurev show slices to determine the pathname of a depot's slice; you'll need it in Step 4 below.

Back to top

Depot Removal Procedure

The following procedure must be performed on the machine where the AccuRev repository resides.

  1. Stop the AccuRev Server:

    • UNIX/Linux: use the acserverctl utility, located in the AccuRev bin directory:

      acserverctl stop

    • Windows: use the Services control panel, or enter the command net stop accurev in a Command Prompt window.

  2. Remove the depot using the maintain command, which is located in the AccuRev bin directory.

    maintain rmdepot <depot-name>

    For safety, the rmdepot command goes through two confirmation steps, including having you retype the depot name.

    The rmdepot command removes the depot's records from the repository database (everything except its name and slice information). If you want to rename the deleted depot to reuse the name, see Step. It will only appear in an accurev show –fi depots command listing (the –fi option includes removed items)

  3. Restart the AccuRev Server:

    • UNIX/Linux: use the acserverctl utility, located in the AccuRev bin directory:

      acserverctl start

    • Windows: use the Services control panel, or enter the command net start accurev in a Command Prompt window.

  4. Remove the depot's directory from the AccuRev storage directory tree. Be careful not to remove any other depot's directory! If you are not sure where this information is located, use the commands accurev show depots and accurev show all slices to determine the pathname. (These commands require the AccuRev Server to be running.)

Back to top

Reusing a Depot's Name

If you want to reuse the depot's name with accurev mkdepot, you must first rename the deleted depot with accurev chdepot -p <depot-name> <new-name>.

Back to top