Export and import spaces

You can export a space and re-import it to the same or a different OpenText Software Delivery Management instance.

In this topic:

Export and import spaces

You can export and import spaces along with their settings and data. All of the information is saved to a self-contained file with an osa extension. The export allows you to back up and share your previously configured spaces.

When you export or import a space, you can indicate whether or not to include the space's data. If you do not include data, only the site users and their relations are exported. If you include data, the space's tables and file system are also included.

If you are working with a very large space, you may choose to exclude the data, and migrate the data and file system manually using database utilities such as Oracle DUMP. This method takes less time than exporting and importing via OpenText Software Delivery Management and does not affect performance.

Note that the some optional tables can be extremely large, and their migration can take a long time. When exporting, you can choose whether to include search and run history, trends, and audit information.

Prerequisites and considerations:

• The OpenText Software Delivery Management environments from which a space is exported and to which the space is imported need to be of the same version.

• Export and import are only supported for the same database vendor. For example, a space exported from Oracle can only be imported into Oracle.

• If the OpenText Software Delivery Management database user does not have permission to create a schema in the database, a new space must be created beforehand and then used as the target space for importing.

• To prevent data inconsistency, the exported space is deactivated during the export operation. The space is reactivated automatically after the operation is completed.

• You cannot import a space from a non-LDAP environment to an LDAP environment.

To export a space: 

1. Open the Settings menu , click Site, and select the Spaces sub-tab.

2. Select the checkbox adjacent to the space that you want to export, and click the Export Space button .

3. In the Export Space dialog box, indicate if you want to export Site users only or DB, and select the data export options.

   Option	Exported contents
   Storage	Full file system, including images and attachments.
   Elastic	Search and run history, trends, and audit information. For details, see Enable export and import of Elastic data.
   Audit	Historical tables.

4. Click Export. Wait for the status message to indicate Exported Successfully and for the dialog box to show the Download link and MD5 ID number.

5. Click Download to save the .osa file to your default Download folder. The file name contains the tenant string and the version of OpenText Software Delivery Management.

6. To clean up the export files, deselect all spaces, click the More button , and select Delete Export Files.

   Note: OSA files of deleted shared spaces are not deleted.

To import a space: 

1. Open the Settings menu , click Site, and select the Spaces sub-tab.

2. Make sure that no spaces are selected.

3. Click the More button and select Import Space. The Import Space dialog box opens.

   1. Indicate whether to import All data or Site users only.

      • When All data is selected, importing a space into an existing space overwrites the data in the target space. Merging data from two spaces is not supported.

      • If you import into an existing space using Site users only, OpenText Software Delivery Management does not modify the space data, but rather creates missing site users and connects them to the space. This option is intended for duplicating space data using manual tools, rather than the export/import tool. When importing Site users only, make sure that the space data of the existing space is aligned with the space data of the exported space.

   2. Click Browse and locate a .osa file that was exported from the same version of OpenText Software Delivery Management.

   3. Choose the space to import.

4. Click Import.

   If new users were added to the destination site during the space's import, the users are assigned a default password: NewSiteUser1.

Back to top

Enable export and import of Elastic data

Create a physical repository in the Elastic server that stores the snapshots of exported OpenText Software Delivery Management spaces, and then register this repository by its name.

If you already have an Elastic repository that you can use for this purpose, or if you have your own guidelines to create it, skip steps 1-3, and register the repository using step 4.

If you are importing from one environment to another (for example from staging to production), perform this procedure in both the export and import environments.

To create a repository in Elastic and register it in OpenText Software Delivery Management:

1. In the elasticsearch.yml file (under the config folder) add the following property. Download cURL for Windows if you don't have it installed.

   Copy code

   Windows:

   path.repo: ["c:\\mqm\\site\\storage\\site"]

   Copy code

   Linux:

   path.repo: ["/opt/octanerepo/storage/site"]

   Replace this with any folder in your environment where index backups will be stored by the Export space tool.

2. Restart the Elastic server.

3. Register a new Elastic repository using a REST call to the Elastic server. Download cURL for Windows if you don't have it installed.

   Copy code

   Windows:

   curl -X PUT localhost:9200/_snapshot/octane_migrate -H "Content-Type: application/json" -d "{\"type\": \"fs\", \"settings\": { \"location\": \"C:\\mqm\\site\\storage\\site\\migrate_ssp\"}}"

   Copy code

   Linux:

   curl -X PUT <server>:9200/_snapshot/octane_migrate -H "Content-Type: application/json" -d '{"type": "fs", "settings": { "location": "/opt/octanerepo/storage/site/migrate_ssp"}}'

   where:

   • octane_migrate is an arbitrary logical name of the new repository which is used to identify it.

   • location should be any folder under the path that you specified in the yml file.

4. Define the MIGRATION_ELASTIC_REPOSITORY site parameter.

   This should be defined as the name of the repository you registered in the previous step. In the above example, the value of the parameter would be octane_migrate.

Back to top

Notes and limitations

You cannot duplicate a space. Instead, you can export a space and then re-import it. After the space has been re-imported, you can register its name and URL in the baseline repository. Keeping a list of the baselines that you created on your space enables you to reliably recreate the space in the future. For details, see Baselines.

Back to top

See also:

• Import from Excel