Usage

Deploying to an offline Process Server

1. To deploy a process application snapshot to an offline Process Server, create a resource that represents the Process Center, and then define the following properties for the resource:
   • profile.root.directory: The profile root directory of the managed node running the Process Center application. For example, /opt/IBM/BPM/profiles/processCenterNode01.
   • websphere.user: The WebSphere Application Server administrator user.
   • websphere.password: The WebSphere Application Server administrator password.
   • websphere.connType: The connection protocol for WebSphere Application Server. The connection protocol is SOAP, RMI, or NONE.
   • websphere.port: The port to use with the specified connection type for communication with the application server that is running the Process Center application.
   • offline.server.name: The name of the offline Process Server, which is set in the Process Center console.
2. Add the agent that is installed on the system that hosts the Process Center to the resource group.
   • Hover over the row for the resource group, click Actions, and then select Add agent.
3. Create a resource that represents the Process Center, and then define the following properties for the resource:
   • profile.root.directory: The profile root directory of the managed node that runs the Process Center application. For example, /opt/IBM/BPM/profiles/processCenterNode01.
   • websphere.user: The WebSphere Application Server administrator user.
   • websphere.password: The WebSphere Application Server administrator password.
   • websphere.connType: The connection protocol for WebSphere Application Server. The connection protocol is SOAP, RMI, or NONE.
   • websphere.port: The port to use with the specified connection type for communication with the application server that runs the Process Center application.
4. Add the agent that is installed on the system that hosts the Process Center to the resource group.
   • Hover over the row for the resource group, click Actions, and then select Add agent.
5. Create components for the resources. Create a component for each resource to deploy. In this case, create two components, one for the Process Center resource and one for the Process Server resource.
6. Create the deployment process for each component. The Process Center component process must be of the Operational (without version) type. The Process Server component process must be of the Deployment type.
7. Include the Generate offline package step from this plugin and the Create Version step from the HCL Launch Versions plugin in the Process Center component process. The Create Version step uploads the generated offline process package as a new version to the component created for the Process Server.
8. Include the Deploy offline package step from this plugin in the Process Server component process.
9. Add the components to the resources.
   • Navigate to the resource.
   • Click Actions > Add Component
   • Select the component to use.
10. Create an application.
    • Navigate to the Applications page.
    • Click Create New Application. You can also use an existing application that is
      attached to the cell to manage.
    • Enter an application name, and then click Save.
    • Click the Components tab, and then add the component that you created in step 5.
11. Create an application environment.
    • On the Resources page, click Create New Environment.
    • Enter an environment name, and then click Save.
    • Navigate to the environment editor.
    • Click on the environment name, and then click Add Base Resource. Select the group for your Process Center environment.
12. Create an application process of the deployment type.
    • Click the Processes tab.
    • Add a deployment step.
    • Drag and drop the Install Component step onto the process editor.
      • Select the component that you created for the resource. For example, the component to contain the process application to be deployed.
      • Select the process for the component. For example, select Online snapshot deployment process.
    • Click Save.
13. Run the process to test the new component.

Deploying to an online Process Server

1. To deploy a process application snapshot to an online Process Server, create a resource that represents the Process Center, and then define the following properties for the resource:
   • profile.root.directory: The profile root directory of the managed node that runs the Process Center application. For example, /opt/IBM/BPM/profiles/processCenterNode01.
   • websphere.user: The WebSphere Application Server administrator user.
   • websphere.password: The WebSphere Application Server administrator password.
   • websphere.connType: The connection protocol for WebSphere Application Server. The connection protocol is SOAP, RMI, or NONE.
   • websphere.port: The port to use with the specified connection type for the application server that runs the Process Center application.
2. Add the agent that is installed on the system that hosts the Process Center to the resource group.
   • Hover over the row for the resource group, and then click Actions > Add agent.
3. Create components for the resources. Create a component for each resource to deploy. The component processes must be of the Deployment type and must include the Deploy process application snapshot plugin step.
4. Add the components to the resources.
   • Navigate to the resource.
   • Click Actions > Add Component.
   • Select the component.
5. Create the application.
   • Navigate to the Applications page.
   • Click Create New Application. You can also use an existing application that is
     attached to the cell to manage.
   • Enter an application name, and then click Save.
   • Click the Components tab, then add the component that you created in step 3.
6. Create an application environment.
   • On the Resources page, click Create New Environment.
   • Enter an environment name, and then click Save.
   • Navigate to the environment editor.
   • Click the environment name, and then click Add Base Resource. Choose the group for your Process Center environment.
7. Create an application process of the Deployment type.
   • Click the Processes tab.
   • Add a deployment step.
   • Drag and drop the Install Component step onto the process editor.
     • Select the component that you created for the resource. For example, select a component to contain the process application to deploy.
     • Choose the process for the component. For example, choose Online snapshot deployment process.
   • Click Save.
8. Run the process to test the new component.

Steps

The following process steps are available in the WebSphere BPM plugin.

• Create Generic Install Package
• Deactivate Snapshot
• Deploy Offline Package
• Deploy Process Application Snapshot
• Export Process Application
• Extract Migration Policy
• Generate Offline Package
• Import Process Application
• Install Process Application Snapshot
• Migrate Instances
• Set Default Snapshot
• Stop Snapshot
• Sync Values, Variables, and Team Bindings
• Update Installation Information

Create Generic Install Package

Creates a generic installation package for a process application or toolkit snapshot that is not targeted to a specific Process Server. (BPMExportInstallPackage)

Deactivate Snapshot

Deactivates an activate snapshot. (BPMDeactivate)

Deploy Offline Package

Deploys the process application snapshot package to an offline Process Server. (BPMInstallOfflinePackage and BPMSetDefaultSnapshot)

Deploy Process Application Snapshot

Deploys the process application snapshot to an online Process Server. (BPMInstall)

Export Process Application

Exports a process application from a Process Center server. (BPMExport)

Extract Migration Policy

Extracts the migration policy from Process Center. Use this step to extract them information used to migrate instances from other snapshots to the newly installed snapshot. (BPMExtractMigrationPolicy)

Generate Offline Package

Creates a .zip file on Process Center that contains a process application snapshot package. (BPMCreateOfflinePackage and BPMExtractOfflinePackage)

Import Process Application

Imports a process application into a Process Center server. (BPMImport)

Install Process Application Snapshot

Installs a process application snapshot from Process Center to a Process Server. (BPMInstallPackage)

Migrate Instances

Migrates all instances on all nodes in the network deployment environment. Equivalent to clicking Migrate Inflight Data in the Process Admin Console. (BPMMigrateInstances)

Set Default Snapshot

Designates a default snapshot on the Process Center or the Process Server. (BPMSetDefaultSnapshot)

Stop Snapshot

Stops a deactivated snapshot on a Process Server. (BPMStop)

Sync Values, Variables, and Team Bindings

Synchronize team bindings, environment variables, and exposed process values between a source and target snapshot. (BPMSyncEnvironmentVariables, BPMSyncEPVValues, and BPMSyncTeamBindings). Do not run this step using the deployment manager profile.

Update Installation Information

Associates an installation package with a specific server, to enable installing the snapshot installation on the server. (BPMUpdateInstallationInformation)