Move or Remove a Project

Users with the appropriate permissions can move or remove an existing Project .

You can have projects in your repository that are not currently managed by Polarion: projects not currently under active development, for example. Removing such projects from management by Polarion does not remove any artifacts from the repository. If you want to restore a removed project (if development resumes, for example), you can do so.

Move a Project

There may be time when you want to move the location of a Project within the repository. For example, the project might be finished, and you want to archive it and keep it out of the list of projects still in progress.

Polarion provides the possibility to move projects to another location in the repository. Moving preserves the project history.

Tip:

If you want to move an existing Project to a new Project Group, you can create the Project Group on the fly while moving the Project just by adding its name in the path.

(You cannot create an empty Project Group, then fill it with Projects.)

There are a couple of caveats to keep in mind when moving projects for any reason:

  • The target location must not have been occupied by any other Project in the past or have an existing Project in the same folder.

    (You'll have to create a folder for the Project if you're moving it to a Project Group that already contains Projects.)

  • Future new projects cannot reuse the Project ID of any previously existing project in the repository, even if the location has been unmarked as a project.

  1. Log on to Polarion with global administrator permissions.

  2. In the Open Project or Project Group dialog box, select the Repository node. (See: Access Projects.)

  3. Enter Administration and click Projects.

    A table of accessible Projects in the repository appears.

  4. Select the Project that you want to move and click Move.

    The Move existing project to new location dialog box appears.

  5. Enter a new Project Group name (optional) and folder name in the Location field.

    For example: http://url/repo/group_name/project_name

    (A new Project Group is created automatically if you add its name followed by / before the Project ID in the Location field.)

    Caution:

    You cannot have two projects in the same folder, so do not select a location using the icon.

  6. Click Next. Polarion begins to move the project.

    Project moved appears when the operation is successful.

  7. Click Finish.

    The Project appears where you moved it in the Open Project or Project Group dialog box.

Note:

  • The settings for the project in the Subversion access file are not updated by the process. Be sure to change these settings manually.

  • The project will be unavailable to users during the move. If the project is large, the move could take several minutes or even longer. It is advisable to alert users about the move ahead of time.

  • You are prevented from renaming a project's ID when moving it, so that its History is not lost.

  • You can't use special characters (/\©:*?"˂˃|;ˋ~'# etc.) in the Location field.

Remove a Project

  1. Log on to Polarion with global administrator permissions.

  2. In the Open Project or Project Group dialog box, select the Repository node. (See: Access Projects.)

  3. Enter Administration and click Projects.

    A table of all the Projects in the repository appears on the right.

  4. Select the Project you want to stop managing with Polarion.

  5. Click on one of the following buttons:

    1. Click Unmark and OK to confirm to stop Project from appearing in the portal.

      (Its files will remain in the repository.)

    2. Click Delete and OK to confirm to remove the Project from the portal and delete its files from the repository.