Share this page

# Remove and restore projects

This topic describes how to remove and restore projects.

In this topic:

## About removing and restoring projects

You can temporarily remove projects from the Projects list. This does not delete the database nor the project repository from the server and you can restore the project if necessary.

When you create a project, a dbid.json file (containing different properties related to the project) is created in Project's repository folder. When you remove a project, the dbid.json file is downloaded by your browser to the client's Downloads folder.

You can also restore access to a project that is not in your current Projects list. For example, you may want to access a project from another server. After you restore access to a project, it is added to the Projects list in Administration.

Note:

- Before restoring the project, make sure that the database where the project resides exists in Administration (Servers > DB Server tab) on your server. The OpenText Enterprise Performance Engineering server needs to access the contents of the restored project from the project's database. For details, see Migrate projects.

- When restoring a project, select the dbid.json file located in the project repository. This ensures that the project retains its original Project UID. If a project does not have its original Project UID, for example if it was duplicated or the Project UID was changed, its corresponding Lab data (for example, runs and timeslots) is not associated with the project.

Back to top

## Remove a project

This task describes how to remove a project from the Projects list.

Note: When removing a project created with a custom Oracle user, make sure that you keep a record of the Oracle user password because it is not stored in the dbid.json file. For details, see Remove and restore a project with a custom Oracle user.

1. On the Administration sidebar, select Management > Projects.

2. Select the project you want to delete from the Projects list, and click More > Remove Project. If there are active users connected to the project, you are prompted to disconnect them.

   You can remove only one project at a time.

3. Click Remove to confirm.

Back to top

## Restore access to a project

This task describes how to restore access to a project.

Note: For details on restoring a project created with a custom Oracle user, see Remove and restore a project with a custom Oracle user.

1. On the Administration sidebar, select Management > Projects.

2. Click More > Restore Project . The Restore Project dialog box opens.

3. Click the browse button. The Open File dialog box opens.

4. Locate the dbid.json file that includes the project that you want to restore. When you restore a project, you can either restore it from the json file that was downloaded to the client's Download folder, or from the project's root folder.

5. Select the dbid.json file and click Open. The Restore Project dialog box opens and displays the selected file.

6. Click Restore. The Restore Project dialog box closes and you can view the restored project in the Projects list.

Back to top

## Field mappings for dbid files

Details of what to provide in the dbid.json file differ between 202x and 12.6x.

For 12.6x, there are differences in the `DatabaseConnectionString`, the repository path, and the `ProjectVersion`. Also pay attention to the double // or \\.

Example of dbid.json file restoring projects from 202x (schema on MS-SQL database):

Copy code

    {"ProjectUid":"f3e147de-f71c-4fa9-ba8f-c72331bd316b",
    "DomainName":"ORA",
    "DatabaseName":"lre_ult_pc_aut_orcl_db",
    "DatabaseType":"mssql",
    "DatabaseNativeAuthentication":"N",
    "DatabaseServerName":"mydp0369.infra.net",
    "DatabaseConnectionString":"server=mydp0369.infra.net",
    "ProjectDirectory":"f3e147de-f71c-4fa9-ba8f-c72331bd316b",
    "ProjectIsActivated":"Y",
    "ProjectType":"Standard",
    "ProjectVersion":"v2021",
    "ProjectDescription":"Project restored the 3/1/2021 9:57:33 PM.\r\nCreated on 7/30/2018 9:57:02 AM",
    "Name":"PC_AUT_ORCL",
    "ID":1073}

Example of dbid.json file restoring projects from 12.6x (schema on Oracle database):

Copy code

    {"ProjectUid":"f3e147de-f71c-4fa9-ba8f-c72331bd316b",
    "DomainName":"ORA",
    "DatabaseName":"default_pc_aut_orcl_db",
    "DatabaseType":"oracle",
    "DatabaseNativeAuthentication":"N",
    "DatabaseServerName":"my-vm1234",
    "DatabaseConnectionString":"jdbc:mercury:oracle://my-vm1234:1521;servicename=orcl.mylab.net",
    "ProjectDirectory":"C:\\ProgramData\\OpenText\\ALM\\repository\\qc\\ORA_2\\PC_AUT_ORCL\\",
    "ProjectIsActivated":"Y",
    "ProjectType":"Standard",
    "ProjectVersion":"v12x",
    "ProjectDescription":"Created on 7/30/2018 9:57:02 AM",
    "Name":"PC_AUT_ORCL",
    "ID":11}

Below are the field mappings for 202x and 12.6x dbid files.

12.6x dbid.xml fields | 202x dbid.json fields | 12.6x dbid.xml values | dbid.json values for restoring 12.6x project | LRE 202x dbid.json values
--- | --- | --- | --- | ---
<PROJECT_NAME> | Name | None | None | None
<DB_TYPE> | DatabaseType | 2 - for MSSQL 3 – for Oracle | mssql oracle | mssql oracle
<DESCRIPTION> | ProjectDescription | None | None | None
<DB_CONNSTR_FORMAT> | DatabaseConnectionString | MS-SQL: jdbc:mercury:sqlserver://<DB server name/IP>:<port> Oracle:jdbc:mercury:oracle://<DB server name/IP>:<port>; servicename=< Oracle service name> | MS-SQL: jdbc:mercury:sqlserver://<DB server name/IP>:<port> Oracle:jdbc:mercury:oracle://<DB server name/IP>:<port>; servicename=< Oracle service name> | server=<server name/IP>,<port>
<DB_NATIVE_AUTHENTICATION> | DatabaseNativeAuthentication | N – Oracle, MS-SQL (SQL Auth) Y - MS-SQL (Win Auth) | N – MS-SQL (SQL Auth), Oracle Y - MS-SQL (Win Auth) | N – MS-SQL (SQL Auth) Y - MS-SQL (Win Auth) null - Oracle
<DB_NAME> | DatabaseName | None | Source ALM 12.6x schema name | Schema name
<DBSERVER_NAME> | DatabaseServerName | None | None | None
<DB_USER_PASS> | None | None | None | None
<PR_HAS_VCSDB> | None | None | None | None
<PHYSICAL_DIRECTORY> | ProjectDirectory | Example:Z:\ProgramData\DBs\repository\qc\DEFAULT\TEST\ | Source project’s repository folder, having \\ instead of \ in the path. Example:Z:\\ProgramData\\DBs\\repository\\qc\\DEFAULT\\TEST\\ | <project UID>
<USERS_QUOTA>- | None | None | None | None
<PR_IS_ACTIVE> | ProjectIsActivated | Y N | Y N | None
<SAQ_IS_ACTIVE> | None | None | None | None
<VM_REPOSITORY> | None | None | None | None
<PR_LANGUAGE> | None | None | None | None
<PROJECT_TYPE> | ProjectType | Standard for Performance Center project | Standard | None
<IS_TEMPLATE> | None | None | None | None
<PROJECT_UID> | ProjectUid | None | None | None
<PR_IS_UNICODE> | None | None | None | None
<PR_SMART_REPOSITORY_ENABLED> | None | None | None | None
<PR_IS_QPM_AUTO_CALC_ENABLED> | None | None | None | None
| DomainName | None | None | None
| ProjectVersion | None | v12x | 2020–2020 SP3: v2020 v2020p1 v2020p2 v2020p3 2021–2021 R2: v2021 v2021r1 v2021r2 2022–2022 R2: v2022 v2022r1 v2022r2 2023: v2023
| ID | None | Provide an integer here to restore a project (it is overwritten when the project is restored). | Represents the project ID. Provide an integer here to restore a project (it is overwritten when the project is restored).
| TenantName (Available in 2020 SP2 and later only) | None | None | None

Back to top

See also:

- Manage projects
- Delete domains and projects
- Deactivate or activate a project

https://admhelp.microfocus.com Enterprise Performance Engineering,LoadRunner Enterprise 8942
Tips to improve your search results...OpenText™ Enterprise Performance Engineering Help Center OpenText™ Enterprise Performance Engineering Help 26.1 All View Local Help Center View Online Help Center Version: