Set a depot location

You can set the location of a depot both when you first create it, and later on, if you want to move it to a different location.

If you want all the depot data to be moved to a single new file system, see Single new file system.

If you want the depot data to be spread over multiple file systems or multiple directory paths, see Multiple file systems or directory paths.

In any case, Consider symlinks.

Single new file system

This section assumes that you want all the depot data to be located on a single new file system.

By default, the base directory for depot file storage for depots with relative Map fields is the server root directory (P4ROOT). For example, if the P4ROOT is /p4/1/root, the depot files for the eng depot are located at /p4/1/root/eng/...

p4 -ztag depot -o eng
... Depot eng
... Date 2022/11/16 15:03:40
... Description Default depot
... Type local
... Map eng/...

Depot Map fields can also be specified as an absolute path:

p4 -ztag depot -o system
... Depot system
... Owner sysop
... Date 2023/04/13 14:34:30
... Description Created by sysop.
... Type local
... Map /p4/depot_data/system/...

The server.depot.root configurable

The server.depot.root configurable is an alternative to the default of depot directory paths being relative to the P4ROOT directory. You can set this configurable to assign an absolute path, with respect to which a relative address given in the Map: field of a depot form is evaluated. Setting the configurable takes effect immediately.

Absolute paths in the depot Map field are unaffected by the server.depot.root setting. Check all depot Map field settings by running p4 -ztag depots before reconfiguring.

In multi-server environment with replica and edge servers, set server.depot.root so it only applies to those servers you want it to.

Any backup process must take the server.depot.root location into account and not assume depot files exist in the default P4ROOT location.

Changing the depot file directories

To change the depot file directories by using the server.depot.root configurable:

(1) Make a backup all depot directories.

(2) Prevent users from accessing the depots while moving them. Set protections to prevent write access by entering the p4 protect command: Add the following mappings at the end of the Protections field: list user * * -//... list group * * -//... super user usernameOfSuperUser * //...

(3) Get a list of all existing depots: p4 -ztag depots

(4) For each depot reported with a relative Map path, copy the depot directory from its existing location under P4ROOT to its new location under the chosen server.depot.root directory.

(5) Set the server.depot.root configurable. Isolate the server.depot.root setting to a specific server. To do that, the server must have a configured serverName. See p4 serverid in Helix Core Server Administrator Guide.

(6) Run the p4 verify -q //... command.

Multiple file systems or directory paths

If you want the depot data to be spread over multiple file systems or multiple directory paths, be aware that this involved more work because:

• each depot must have the Map field changed

• file system management is more complex and there is risk of one or more file systems not being mounted

• replica, edge and standby servers must have the directory structures denoted in the depot's Map field

The filesystem path where a depot's versioned files are stored is specified by the Map field in that depot's specification.

$ p4 -ztag depot -o depot
... Depot depot
... Date 2011/05/16 15:03:40
... Description Default depot
... Type local
... Map depot/...

By default, the depot directory location is given as a path relative to the P4ROOT directory and is named the same as the depot. However, this location can be changed and mapped to either a different path relative to P4ROOT, or to an absolute path outside of P4ROOT.

Changing a depot directory

(1) Make a backup all depot directories.

(2) Prevent users from accessing the depots while moving them. Set protections to prevent write access by entering the p4 protect command: Add the following mappings at the end of the Protections field: list user * * -//... list group * * -//... super user usernameOfSuperUser * //...

(3) Get a list of all existing depots: p4 -ztag depots

(4) For each depot reported, the map field gives the current location of the depot directory.

(5) Copy each depot directory from its existing location to its new location.

(6) Update the map field of each depot specification by running the p4 depot depotName command. Replace the value of the Map field depotName/... by path/depotName/... (where path is the full path of the new location where the depotName directory is located. For example: Map: depot1/... To: Map: E:\Users\perforce\depot1\... If the Helix Server is being run under WIndows, include the drive letter as a part of the path and make sure that the path ends in with a forward or backslash (/) and the Perforce ellipses wildcard (...) of three dots.

(7) Run the command p4 verify -q //depot1/... where depot1 is replaced by the depot moved.

(8) Use p4 protect to remove the mapping protections you added in Step (2).

(9) Restart Helix Core Server.

Consider symlinks

Make sure all file systems are mounted correctly on source and target, and take into account any depots referenced using symlinks. Symlinks are outside the control of the Helix Server and need to be considered when changing the location and copying of depots.

If using tiny.db

If the lightweight document-oriented database, tiny.db, is being used to store any file revisions, take a checkpoint of the tiny.db file, correct the content to match the changes to the depot spec's Map field or server.depot.root, and restore using this manually-updated tiny.db checkpoint.