Server Admin Guide | 2019.2

Moving project directories

By default, project files are located in the TTServDb\TTDbs directory in the Helix ALM application directory. The project directory includes attachments and report stylesheets. For Helix ALM native projects, the directory also includes the project database file.

You can move project files to any directory on the server computer’s local hard drive or a mapped network drive.

Note:  The following steps explain how to move native projects and project data stored on the Helix ALM Server for both native and RDBMS projects. See Moving RDBMS projects for information about moving RDBMS projects to a different database or different server.

1. Inactivate the project to move. See Inactivating and activating projects.

2. Make a backup copy of the project directory to move including all subdirectories.

By default, project directories are in the following locations:

  • Windows—C:\Program Files\Perforce\Helix ALM\TTServDb\TTDbs
  • Linux—/var/lib/HelixALM/TTServDb/TTDbs

3. Copy the project directory and all subdirectories to the new location.

4. Select the inactive project to move in the projects list and click Edit.

The Edit Project dialog box opens.

5. Enter the new Project Directory name or the full path to the project directory.

The path cannot exceed 247 characters, including the drive specifier (e.g., C:\) and names of subdirectories that Helix ALM creates in the specified directory. The default directory path for projects and the ability to enter fully qualified pathnames is controlled using the Helix ALM Registry Utility. See the Registry Utility help for information.

Note:  If a 'Directory name cannot contain any of the following characters' error is returned when you save the project changes, you do not have permission to enter the full path.

6. Select Project is active to reactivate the project.

7. Make any other changes to the project information.

8. Click OK.

You are prompted to move the project directory to the new location. Copy the project directory to the new location if you have not already.

9. Click Save Changes.

The project is moved.

10. Optionally delete the project directory in the old location.