Creating a new export deployment specification

An export deployment specification defines the content that must be exported.

For information about exporting content in a multitenant IBM® Cognos® Analytics environment, see Tenant content deployment.

Before you begin

If you want to preserve data source access accounts when you export a content store, then you must select Include user account information. If you want to preserve configuration information when you export, then you can set the CM.DEPLOYMENTINCLUDECONFIGURATION advanced setting to TRUE. For more information, see Including configuration objects and their children in deployments.


  1. In the source environment, open IBM Cognos Administration.
  2. On the Configuration tab, click Content Administration.
  3. On the toolbar, click the New Export icon New export icon. The New Export wizard appears.
  4. Type a unique name and an optional description and screen tip for the deployment specification. Select the folder where you want to save it and click Next.
  5. Choose whether to export the entire content store or to do a partial export of specific content:
    • To export specific content, click Select public folders, directory and library content. Click Next and proceed to step 7.
    • To export the entire content store, click Select the entire content store and select whether to include user account information. Click Next and proceed to step 15.
  6. In the Select the Public folders content page, click Add.
  7. In the Select entries page, in the Available Entries box, select one of the following entries or their contents:
    • Public Folders

      Contains packages and folders. Select the packages and folders that you want to export.

    • Directory

      Contains namespaces, namespace folders, groups and roles, and individual user accounts. When you select a user account, all content associated with the user, including the content of the user's My Folders, is included in the export.

    • Library

      Contains library resources, such as visualizations.

  8. Click the arrow icon Right arrow icon to move the selected items to the Selected entries box, and click OK.
  9. For each entry that you are exporting, do one of the following:
    • If you want the entry to have a different name in the target environment, or if you want to change the target location or add multilingual names, click the Edit icon Edit icon, make your changes, and click OK.
    • If you do not want users to access the entries and their contents, select the check box in the Disable after import column. This is useful, for example, when you want to test the reports before you make them available in the target environment.
  10. Under Options, select whether you want to include the report output versions, run history, and schedules and what to do with entries in case of a conflict.
  11. In the Select the directory content page, select whether you want to export Cognos groups and roles, distribution lists and contacts, and data sources and connections and what to do with the entries in case of a conflict.
  12. In the Specify the general options page, select whether to include access permissions and references to namespaces other than IBM Cognos, and who should own the entries after they are imported in the target environment.
  13. Specify the Recording Level for the deployment history. For more information, see Recording Deployment Details.
  14. In the Specify a deployment archive page, under Deployment archive, select an existing deployment archive from the list, or type a new name to create one.

    If you are typing a new name for the deployment archive, do not use spaces in the name. If the name of the new deployment specification matches the name of an existing deployment archive, the characters _# are added to the end of the name, where # is a number such as 1.

  15. Under Encryption, click Set the encryption password, type a password, and click OK.
  16. Click Next.
    The summary information appears.
  17. Review the summary information and click Next.
    If you want to change the information, click Back and follow the instructions.
  18. Specify how to run the export deployment specification:
    • To run 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 at a recurring time, click Save and schedule and click Finish. Then, select frequency, start and end dates, and click OK.

      To temporarily disable the schedule, select the Disable the schedule check box. To view the schedule status, see Managing scheduled activities.

    • To save without scheduling or running, click Save only, and click Finish.


After you run the export, you can move the deployment archive. You can also see the export run history Viewing the run history of entries.