Publishing packages

In IBM® Cognos® Framework Manager, you can publish a package to any folder in Content Manager so your users can access it.

You can also publish a package to a network location. A package on a network location cannot be used by your users. Publishing to a network location is useful for backing up a package. When you publish to a LAN location, be careful that you do not over-write any existing files, particularly Framework Manager models and the model that is currently open.

Objects that are excluded or hidden, but are necessary in a query path, are included but marked as hidden in a published package.

The governor settings that take precedence are the ones that apply to the model that is currently open (whether it is a parent model or a child model).

To avoid problems, troubleshoot the package before publishing it by using the Verify the Package Before Publishing check box in the publishing wizard to ensure that it is complete and does not contain errors.

When you publish a package, you can

Set the number of model versions to retain on the server. For more information about model versions, see Updating reports to use the latest version of a model.
Note: To see the number of model versions set for a package, select a package and, in the Property pane, find the Max Versions property.
Externalize query subjects and dimensions so that you can use them with Transformer Externalized query subjects and dimensions.
Specify whether a package will use dynamic query mode.

For more information about dynamic query mode, see Enabling Framework Manager models and packages to use the dynamic query mode.

Note: You can create packages directly in IBM Cognos Administration for IBM Cognos PowerCubes and SAP BW cubes and queries. For more information, see the section about packages in the IBM Cognos Analytics Administration and Security Guide.

Procedure

Select the package that you want to publish.
From the Actions menu, click Package, Publish Packages.
Choose where to publish the package:
- To publish the package to the report server, click IBM Cognos Content Store, and select an existing folder or create a new folder in the content store.
- To publish the package to a network location, click Location on the network. Ensure that you select a different location than the directory where the project files are stored. In general, avoid saving to the same location as a model as the model could be overwritten.
To enable model versioning when publishing to the IBM Cognos content store, select the Enable model versioning check box, and type the number of model versions of the package to retain.

Note: To delete all but the most recently published model version on the server, select the Delete all previous model versions check box.

For more information, see Updating reports to use the latest version of a model.
Click Next.

In the Add Security window, define security for the package (optional):

Goal	Actions
Create, add, or remove a user, group, or role.	On the User Access tab, click Add. In the Select Users and Groups window, define user security. For information about how to use the Select Users and Groups window, see the Administration and Security Guide. Users, groups, or roles defined in the user Access Tab have Read, Write, Execute, and Traverse permissions.
Grant administrative access to a user, group, or role.	On the Administrator Access tab, click Add. In the Select Users and Groups window, define administrator security. For information about how to use the Select Users and Groups window, see the Administration and Security Guide. Users, groups, or roles defined in the Administrator Access Tab have Read, Write, Set Policy, and Traverse permissions.

Goal

Actions

Create, add, or remove a user, group, or role.

On the User Access tab, click Add.

In the Select Users and Groups window, define user security. For information about how to use the Select Users and Groups window, see the Administration and Security Guide. Users, groups, or roles defined in the user Access Tab have Read, Write, Execute, and Traverse permissions.

Grant administrative access to a user, group, or role.

On the Administrator Access tab, click Add.

In the Select Users and Groups window, define administrator security. For information about how to use the Select Users and Groups window, see the Administration and Security Guide. Users, groups, or roles defined in the Administrator Access Tab have Read, Write, Set Policy, and Traverse permissions.

Note: The Add Security window in the Publish Wizard is only available the first time you publish a package. If you re-publish the package to the same location, you cannot override the existing security. To change security for published packages, see Modifying package security.

Click Next.
If you want to externalize query subjects, select the Generate the files for externalized query subjects check box.
By default, the package is verified before it is published. If you do not want to verify your model prior to publishing, clear the Verify the package before publishing check box.
If the package contains data sources supported by dynamic query mode, you have the option to enable dynamic query mode for the package. Select the Use Dynamic Query Mode check box. You will be asked to confirm this selection when you click Publish. This step applies when the Query Mode property of the project is set to Compatible.

Note: If a package containing both supported and unsupported data sources is published with the dynamic query mode enabled, users see an error when opening the package in Reporting and other components.

For information on data sources supported by dynamic query mode, see the IBM Cognos Administration and Security Guide.
Click Publish.

If you chose to externalize query subjects, Framework Manager lists which files were created.
Click Finish.