Conflict Resolution Rules

A conflict can occur when the entry that you want to import from the deployment archive already exists in the target content store.

When this happens, one of the following conflict resolution rules is used, depending on the entry and the advanced settings that you have used.

Table 1. Conflict resolution rules

Rule

Description

Replace

Replaces the entry and its children.

The entry and all its children are removed from the source content store. The new entry and all its children are added to the source content store.

Keep

Keeps the entry.

The properties of the entry and all its children are not updated. Existing children of the entry are kept. New children may be added.

Update

Updates the entry.

The properties of the entry and its children are updated. Existing children of the entry are kept. New children may be added.

Merge

Merges the properties of the entries with existing entries.

If an entry has no children, replace and update have the same end result.

Content

All the objects in the content area of the content store are included and replaced when you import the entire content store.

Directory

If you include data sources, connections, and signons, and you keep existing entries, the associated objects from the archive are merged with the objects in the target environment. Even though the objects are merged, the retention rules still apply. A full merge may not occur because some objects may be discarded.

Note that when you want to include Cognos® groups and roles, and distribution lists and contacts, these items must be stored in a folder within the namespace in order to be deployed.

The members of distribution lists, groups, and roles in the archive are not merged with the contents in the target environment. Instead, the set of distribution lists, groups, and roles are merged with the set already existing in the target environment. However, the members of the System Administrators group are always merged when this group is imported. For more information, see Including Cognos Groups and Roles.