Importing tenant content to a target environment

The tenant content can be imported from the deployment archive into the target environment.

About this task

When you import from the deployment archive, you select from entries that were exported. If user account information was included with the public content, you can keep this information or exclude it.

When you import content, you can replace the content in the target environment with the content in the deployment archive.

The entire tenant content in the target environment is not replaced, but any content in the target environment that conflicts with the content in the archive is replaced.

Some entries in the target content store might contain references to public content that was excluded from the tenant deployment. If the public content is not already in the target content store, this results in broken references between the entries. Administrators are notified about the broken references through the deployment details. To repair the broken references, you can either deploy the public content separately or re-export the tenant content with the public content included.

Procedure

In IBM Cognos Administration, on the Configuration tab, click Content Administration.
On the toolbar, click the new import icon . The New Import wizard appears.
In the Deployment archive section, select the deployment archive that you want to import.
Type the password that was used to encrypt the archive, and click OK.
Type a unique name, an optional description, and a screen tip for the deployment specification, select the folder where you want to save it, and click Next.
Verify that the tenant ID is correct.
If user account information is included with the public content in the deployment archive, you can decide to include or exclude this information now by selecting or clearing the check box Include user account information. This selection is not available when user account information is not included in the archive.
Choose one of the Conflict resolution options. The Replace existing entries option replaces objects in the target environment with objects in the deployment archive. The Keep existing entries option merges objects from the deployment archive with associated objects in the target environment.
Click Next.
Review the summary information and click Next.
Decide what to do with the import deployment specification:
- To run it now or later, click Save and run once, and click Finish. Specify the time and date for the run. Then click Run. Review the run time and click OK.
- To schedule it at a recurring time, click Save and schedule and click Finish. Then, select frequency and start and end dates, and click OK.
  Tip: To temporarily disable the schedule, select the Disable the schedule check box. To view the schedule status, see Manage Scheduled Activities.
- To save it without scheduling or running, click Save only, and click Finish.
  When you run the import, you have the option of selecting to upgrade the report specification. If you choose not to upgrade the deployment specification at this time, you can upgrade it later. For more information, see Upgrading report specifications. You also have the option to select Store ID. Choose Assign new IDs during import.
When you run the import, you have the option of selecting to upgrade the report specification. If you choose not to upgrade the deployment specification at this time, you can upgrade it later. For more information, see Upgrading report specifications. You also have the option to select Store IDs. When you run an import, content store IDs are deleted and new IDs are assigned. If the content store IDs must be retained, you can choose to preserve them. For more information, see Content ID assignment.

Results

The import deployment specification is saved in IBM Cognos Administration, on the Configuration tab, in Content Administration. From this location, you can update and run the deployment specification.