You can back up and restore the following items:

• Entire projects, either single-user or multi-user.

• ComponentFolders, if you have a large project and want to break it down into multiple smaller projects.

A backup includes objects, project settings and properties, and - optionally - versioning data.

Back up single-user projects

If you want to back up a single-user project, export a subset of your workspace. You can then import it again to restore the workspace.

Back up multi-user projects

A multi-user project backup includes all workspace objects, project settings and properties, and - optionally - versioning data (object history).

Requirements

Before you perform the backup, consider the following:

• The backup file is about 20% of the size of the backed-up repository. Ensure that you have enough disc space.

• To restore database repositories, you need CREATE and DROP rights.

Backup process

To back up a multi-user project, follow the steps below:

1. Open the workspace as an admin user.

2. Ensure that all objects are checked in.

3. Go to Project->Info and click on Backup.

4. In the subsequent window, specify whether you want to include versioning data.

5. In the next window, select a storage location for the backup and click OK.

Tricentis Tosca generates the backup, which has the file extension .tdp, and saves it to the specified directory.

Back up a ComponentFolder

A ComponentFolder backup includes all objects in the ComponentFolder, as well as their project settings and properties.

It does not include the following:

• Versioning data.

• External references to the objects in the ComponentFolder.

  For instance, if the ComponentFolder only contains the TestCase, but not the corresponding Modules, the backup will only contain the TestCase.

Backup process

To back up a ComponentFolder, follow the steps below:

1. Open the workspace as an admin user.

2. Ensure that the ComponentFolder that you want to back up is checked in.

3. Right-click the ComponentFolder and select Backup Folder from the context menu.

4. In the subsequent dialog, specify whether Tricentis Tosca should check for external references.

   • Select No if you do not want a check.

   • Select Yes if you do want to check for external references.

5. Tricentis Tosca then runs a search.

   If it finds external references, you need to specify whether you want to cancel or continue the backup.

   • Click Yes to cancel the backup process. Tosca Commander displays all external references. You can then clean them up manually (see chapter "Purge missing references").

   • Click No to continue the backup. If you do continue, the restored backup will have broken references.

6. In the next dialog, select a storage location for the backup and click OK.

Tricentis Tosca generates the backup, which has the file extension .tdp, and saves it to the specified directory.

Restore a backup

Tricentis recommends that you restore a backed-up repository in a newly created repository. If you restore your backup in an existing repository, Tricentis Tosca overwrites all existing data. If you restore into an existing repository, you also have to create new workspaces. The existing ones will not work anymore, as Tricentis Tosca creates a new Common ID during the backup process.

To restore your backup, follow the steps below:

1. Start Tosca Commander, but don't open any workspace.

2. Go to Project->Info and click on Restore.

3. In the subsequent window, select your backup file and click Open.

4. In the next window, define the repository in which you want to restore your backup:

   • Type: Select the repository type from the drop-down menu.

   • Schema (optional): If you created tables with a user-defined schema when you prepared your database, enter the schema name of the tables.

   • Connection string: Enter a valid connection string to connect to the database.

     For SQLite, enter the path to the repository.

     For all other databases, use the following parameters:

Database type	Connection string parameter	Description
MS SQL Server and DB2	Server	IP address or network name of the server
	Database	Name of the database instance
	Uid	User ID for database access
	Pwd	Password of the user ID
Oracle	Data Source	Path to the Oracle Host
	User Id	User ID for database access
	Password	Password of the user ID

5. If you want to test the connection, click Test Connection.

6. Click OK.