Deploy changes to an existing application
Sample scenario of how an administrator can take steps to update application assets that are already deployed.
This sample scenario takes you through the steps of updating application assets that were initially deployed in the First-time deployment of an application scenario. The first-time scenario shows how to deploy a set of sample FileNet® P8 assets from a source environment to a destination environment where the assets do not currently exist. In this scenario, the previously deployed assets now existing in the destination environment must be updated with subsequent changes made to the assets in the source environment. This update scenario assumes that the deployment configuration created in the First-time deployment of an application procedure exists, and that both the source and destination systems are available to the administrator.
The following sample scenario provides high-level deployment steps and illustrates each step with the actions of a third-person administrator.
Assets to be deployed
The following tables identify the authorized LDAP users for the source and destination systems, the source and destination object stores, and the FileNet P8 assets to be deployed.
LDAP users
Except for the Admin user, the authorized LDAP users for the source and destination environments are different. When the application was initially deployed, the administrator mapped the source security principals to the destination security principals.
LDAP Source | Object Name |
---|---|
SourceGroup1 |
SourceGroup1 |
Admin | Admin |
SourceUser1 |
SourceUser1 |
LDAP Destination | Object Name |
---|---|
DestinationGroup1 |
DestinationGroup1 |
Admin | Admin |
DestinationUser1 |
DestinationUser1 |
Object stores
The source and destination environments each contain two object stores. In the First-time deployment of an application scenario, assets on SourceOS1 were deployed to DestinationOS1. In this scenario, the assets on DestinationOS1 must be updated with the modified assets on SourceOS1. The P8Demo object stores are not used for deployment.
Source Object Store | Destination Object Store |
---|---|
P8Demo | P8Demo |
SourceOS1 | DestinationOS1 |
FileNet P8 assets
The following FileNet P8 assets are stored on the source Content Platform Engine, unless otherwise noted. The Location column specifies the navigation path to the asset that uses Add Asset dialog box in FileNet Deployment Manager.
The assets are grouped by the FileNet P8 system that they support. Included in a Content Platform Engine installation are the core Content Platform Engine assets. The other assets support IBM® Content Navigator and workflow systems, which integrate with Content Platform Engine.
In this sample scenario, the assets to be deployed are customer invoice-related objects, most of which were previously deployed in the First-time deployment of an application scenario. As described in the following table, these objects were updated in the source environment. Security principals were removed for some of the objects. The deployment updates objects in the destination environment, and creates a property template added to the application since the initial deployment.
After the assets are imported to the destination environment, the assets in the list are deployed, except for the workflow definition and the workflow subscription. After you import the workflow definition and workflow subscription to the destination Content Platform Engine, the administrator must manually transfer the workflow definition to the destination workflow system. Then, the administrator must modify the workflow subscription configuration to use the transferred workflow definition.
FileNet Deployment Manager is used to deploy this sample set of assets.
Content Platform Engine Core | Object Name | Content Platform Engine Object Type | Source LDAP Assignment | Destination LDAP Assignment | Location |
---|---|---|---|---|---|
1 new property template (which is displayed on the Invoice class definition) | InvoiceCustNameChar_PropTemplate | Property Template | SourceGroup1 |
DestinationGroup1 |
Object Stores > SourceOS1 > Data Design > Property Templates |
Updated Invoice document class definition with new property from InvoiceCustNameChar_PropTemplate | Invoice_DocClass v2 | Document Class | SourceGroup1 |
DestinationGroup1 |
Object Stores > SourceOS1 > Data Design > Classes > Document |
Updated folder of type CustomerInvoices with new title | Customer Invoices Folder v2 | Folder | SourceGroup1 |
DestinationGroup1 |
Object Stores > SourceOS1 > Browse > Root Folder > Customer Invoices Folder v2 |
Changed document of type Invoice (in-place property value change - new title, not a new version) | Invoice Document | Document | SourceGroup1 |
DestinationGroup1 |
Object Stores > SourceOS1 > Browse > Root Folder > Customer Invoices Folder v2 |
Updated workflow definition document, with workflow step name changed from Activity to Activity (v2) - new version of document | InvoiceWorkflowDefinition v2 | Workflow Definition | SourceGroup3 |
DestinationGroup3 |
Object Stores > SourceOS1 > Browse > Root Folder > Customer Invoices Folder v2 |
1 workflow subscription, which is updated to point to the new version of the workflow definition | InvoiceWorkflowSubscription v2 | Workflow Subscription | SourceGroup3 |
DestinationGroup3 |
Object Stores > SourceOS1 > >Events, Actions, Processes > Events > Subscriptions |
Workflow system | Object Name | Content Platform Engine Object Type | Source LDAP Assignment | Destination LDAP Assignment | Location |
---|---|---|---|---|---|
Updated workflow queue definition - added F_StepName to the list of System fields | WorkflowQueueDefinition | Workflow Queue Definition | SourceGroup3 SourceGroup4 Admin |
DestinationGroup3 DestinationGroup4 Admin |
The workflow system asset is not stored in the object store. It is referenced by the workflow definition document in Object Stores > SourceOS1 > Root Folder > Customer Invoices Folder v2. |
IBM Content Navigator | Object Name | Content Platform Engine Object Type | Source LDAP Assignment | Destination LDAP Assignment | Location |
---|---|---|---|---|---|
Updated stored search - changed document content, which creates a new document version object; not a change to the properties of the existing object. | StoredSearch v2 | Stored Search | SourceGroup3 SourceGroup4 Admin |
DestinationGroup3 DestinationGroup4 Admin |
Object Stores > SourceOS1 > Root Folder > Customer Invoices Folder v2 |