Friday, September 11, 2015

Offline Deployment at Process Server

Offline deployment
Offline deployment is the way to deploy process applications onto process server when process server environment not connected to process center environment.
Offline deployment process involves series of 'wsadmin' commands
  1. BPMCreateOfflinePackage @ Process Center
Parameters required by "BPMCreateOfflinePackage" determined by the following commands
$AdminTask BPMListProcessApplications
$AdminTask BPMShowProcessApplication {-containerAcronym XXXX}
$AdminTask BPMListServers
  1. BPMExtractOfflinePackage @ Process Center

3. BPMInstallOfflinePackage @ Process Server

BPMCreateOfflinePackage & BPMExtractOfflinePackage
As the command name implies, you'll use this command to create installation packages of a process application snapshot from the process center server
The BPMCreateOfflinePackage command is run using the AdminTask object of the wsadmin scripting client and wsadmin scripting client should run in connected mode and beware of the following condition
Note: In a network deployment environment, you must run this command on the node containing the application cluster member on the Process center server. Do not run this command from the deployment manager profile.
  • Login to process center server and make sure the user account is part of tw_admins group
  • Navigate to bin directory of BPM installation
  • Launch 'wsadmin' client and connect to SOAP port of App Target cluster; where the team works application is running






Syntax of create offline package
$AdminTask BPMCreateOfflinePackage {-containerAcronym value1 -containerSnapshotAcronym value2 -containerTrackAcronym value3 -serverName value4}
We'll find out the values of following parameters
  1. containerAcronym -  
  2. containerSnapshotAcronym
  3. containerTrackAcronym
  4. serverName
1.containerAcronym
found by running
($AdminTask BPMListProcessApplications)
Below screen shot shows the list of process applications on Process Center server and their corresponding container Acronym
Note:each process apps will have an Acronym
2. containerSnapshotAcronym
3. containerTrackAcronym
found by running
($AdminTask BPMShowProcessApplication {-containerAcronym XXXX})
Note: each process apps have no of snapshots associated
Here I've chosen the Process Application with acronym as MYS
$AdminTask BPMShowProcessApplication {-containerAcronym MYS}
Command output shows the list of snapshots for the process application chosen
Make sure the snapshot is in Active state
containerTrackAcronym is Main and it's common for all snapshots in a process application
containerSnapshotAcronym vary based on the snapshot name
4. serverName
found by ($AdminTask BPMListServers)
Note: The server need to configured as offline to be listed here
wsadmin>$AdminTask BPMListServers
Servers:
       Name: Process Server Test
                        URL: corbaname:iiop:bpmprocessserver.local.com:9810
Now, we know values of all 4 parameters required to create Offline Package
Create offline package
Extract offline package
Here you'll mention the package name and the directory where it should get extracted
Make sure the offline package is generated on the out put directory


Transfer the offline deployment package to Process Server environment
BPMInstallOfflinePackage @ Process Server
Navigate to bin directory BPM installation
Launch wsadmin client and connect to SOAP port of Process Server application cluster member
C:\IBM\WebSphere\AppServer\bin>wsadmin -conntype SOAP -port 8882 -host bpmprocessserver.local.com -user psadmin -password psadmin
WASX7209I: Connected to process "PSDE1.SingleCluster.processserverlocalNode03.0" on node processserverlocalNode03.0 using SOAP connector;  The type of process is: Man
agedProcess
WASX7029I: For help, enter: "$Help help"
wsadmin>
Execute "BPMInstall OfflinePackage" as shown below
What's happening in SystemOut logs while offline deployment is performed
[9/11/15 15:49:46:022 EDT] 00000199 CommandServic I PALAdminCommands processServerOfflineDeploy Entering
[9/11/15 15:49:51:865 EDT] 00000199 InstallmentSt I   CWLLG3547I: Process Application: MySample, Snapshot: SS11SEP : The snapshot with ID Snapshot.493b4fae-5cd6-43ff-b1da-9d58f681f578 is being installed. The following toolkits are being installed: [8.5.5.0,8.5.5.0,8.5.5.0,8.5.5.0]
[9/11/15 15:49:52:062 EDT] 00000199 InstallMessag I   CWLLG3579I: [BEGIN]  Starting the installation of process application MySample(MYS), snapshot SS11SEP(SS11SEP) as user psadmin.
[9/11/15 15:49:52:110 EDT] 00000199 InstallMessag I   CWLLG3579I: [END]  Starting the installation of process application MySample(MYS), snapshot SS11SEP(SS11SEP) as user psadmin.
[9/11/15 15:49:52:122 EDT] 00000199 InstallmentSt I   CWLLG3533I: Process Application: MySample, Snapshot: SS11SEP : The snapshot is being imported.
[9/11/15 15:49:52:365 EDT] 00000199 InstallMessag I   CWLLG3580I: [BEGIN]  Installing the library items and assets for the process application and referenced toolkits.
[9/11/15 15:49:52:595 EDT] 00000199 InstallMessag I   CWLLG3581I: [BEGIN]  Installing toolkit System Data(TWSYS), snapshot 8.5.5.0(8.5.5.0).
[9/11/15 15:50:02:104 EDT] 00000140 RepositoryHea W   CWLLG0098W: Unable to connect to Process Center.
[9/11/15 15:50:09:142 EDT] 00000199 InstallMessag I   CWLLG3581I: [END]  Installing toolkit System Data(TWSYS), snapshot 8.5.5.0(8.5.5.0).
[9/11/15 15:50:10:187 EDT] 00000199 InstallMessag I   CWLLG3581I: [BEGIN]  Installing toolkit Coaches(SYSC), snapshot 8.5.5.0(8.5.5.0).
[9/11/15 15:50:22:131 EDT] 00000199 InstallMessag I   CWLLG3581I: [END]  Installing toolkit Coaches(SYSC), snapshot 8.5.5.0(8.5.5.0).
[9/11/15 15:50:23:189 EDT] 00000199 InstallMessag I   CWLLG3581I: [BEGIN]  Installing toolkit Content Management(SYSCM), snapshot 8.5.5.0(8.5.5.0).
[9/11/15 15:50:33:419 EDT] 00000199 InstallMessag I   CWLLG3581I: [END]  Installing toolkit Content Management(SYSCM), snapshot 8.5.5.0(8.5.5.0).
[9/11/15 15:50:34:464 EDT] 00000199 InstallMessag I   CWLLG3581I: [BEGIN]  Installing toolkit Dashboards(SYSD), snapshot 8.5.5.0(8.5.5.0).
[9/11/15 15:51:02:066 EDT] 00000199 InstallMessag I   CWLLG3581I: [END]  Installing toolkit Dashboards(SYSD), snapshot 8.5.5.0(8.5.5.0).
[9/11/15 15:51:03:093 EDT] 00000199 InstallMessag I   CWLLG3582I: [BEGIN]  Installing process application MySample(MYS), snapshot SS11SEP(SS11SEP).
[9/11/15 15:51:03:145 EDT] 00000140 RepositoryHea W   CWLLG0098W: Unable to connect to Process Center.
[9/11/15 15:51:05:757 EDT] 00000199 InstallMessag I   CWLLG3582I: [END]  Installing process application MySample(MYS), snapshot SS11SEP(SS11SEP).
[9/11/15 15:51:05:865 EDT] 00000199 InstallMessag I   CWLLG3580I: [END]  Installing the library items and assets for the process application and referenced toolkits.
[9/11/15 15:51:05:997 EDT] 00000199 InstallmentSt I   CWLLG3534I: Process Application: MySample, Snapshot: SS11SEP : The snapshot was successfully imported.
[9/11/15 15:51:05:998 EDT] 00000199 InstallmentSt I   CWLLG3536I: Process Application: MySample, Snapshot: SS11SEP : The installation service for the snapshot is being started.
[9/11/15 15:51:06:002 EDT] 000001a3 JMSClassifica W   XJMS0021E: Unable to map destination and bus to workclass. Aborting the xd classification filter for the current request. Request context information is com.ibm.ws.xd.jms.proxy.impl.AsynchJMSServiceContextImpl@3b0dd4c7<bus=BPM.PSDE1.Bus,destination=PortalWebMessagingTopicSpace.PSDE1.SingleCluster>.
[9/11/15 15:51:06:002 EDT] 000001a5 JMSClassifica W   XJMS0021E: Unable to map destination and bus to workclass. Aborting the xd classification filter for the current request. Request context information is com.ibm.ws.xd.jms.proxy.impl.AsynchJMSServiceContextImpl@4061ae12<bus=BPM.PSDE1.Bus,destination=TWServerTopicDestination.PSDE1.SingleCluster>.
[9/11/15 15:51:06:008 EDT] 000001a4 JMSClassifica W   XJMS0021E: Unable to map destination and bus to workclass. Aborting the xd classification filter for the current request. Request context information is com.ibm.ws.xd.jms.proxy.impl.AsynchJMSServiceContextImpl@27a95a31<bus=BPM.PSDE1.Bus,destination=cacheTopicDestination.PSDE1.SingleCluster>.
[9/11/15 15:51:06:020 EDT] 00000199 InstallMessag I   CWLLG3583I: [BEGIN]  Running installation services.
[9/11/15 15:51:06:806 EDT] 00000199 InstallMessag I   CWLLG3584I: [BEGIN]  Running installation service for toolkit Coaches(SYSC), snapshot 8.5.5.0(8.5.5.0).
[9/11/15 15:51:06:883 EDT] 00000199 InstallMessag I   CWLLG3584I: [END]  Running installation service for toolkit Coaches(SYSC), snapshot 8.5.5.0(8.5.5.0).
[9/11/15 15:51:06:967 EDT] 00000199 InstallMessag I   CWLLG3584I: [BEGIN]  Running installation service for toolkit Content Management(SYSCM), snapshot 8.5.5.0(8.5.5.0).
[9/11/15 15:51:07:000 EDT] 00000199 InstallMessag I   CWLLG3584I: [END]  Running installation service for toolkit Content Management(SYSCM), snapshot 8.5.5.0(8.5.5.0).
[9/11/15 15:51:07:043 EDT] 00000199 InstallMessag I   CWLLG3584I: [BEGIN]  Running installation service for toolkit Dashboards(SYSD), snapshot 8.5.5.0(8.5.5.0).
[9/11/15 15:51:07:094 EDT] 00000199 InstallMessag I   CWLLG3584I: [END]  Running installation service for toolkit Dashboards(SYSD), snapshot 8.5.5.0(8.5.5.0).
[9/11/15 15:51:07:140 EDT] 00000199 InstallMessag I   CWLLG3585I: [BEGIN]  Running installation service for process application MySample(MYS), snapshot SS11SEP(SS11SEP).
[9/11/15 15:51:07:160 EDT] 00000199 InstallMessag I   CWLLG3585I: [END]  Running installation service for process application MySample(MYS), snapshot SS11SEP(SS11SEP).
[9/11/15 15:51:07:185 EDT] 00000199 InstallMessag I   CWLLG3583I: [END]  Running installation services.
[9/11/15 15:51:07:221 EDT] 00000199 InstallmentSt I   CWLLG3537I: Process Application: MySample, Snapshot: SS11SEP : The installation service for the snapshot finished successfully.
[9/11/15 15:51:07:221 EDT] 00000199 InstallmentSt I   CWLLG3539I: Process Application: MySample, Snapshot: SS11SEP : The data for the snapshot is being migrated.
[9/11/15 15:51:07:244 EDT] 00000199 InstallMessag I   CWLLG3586I: [BEGIN]  Migrating global data.
[9/11/15 15:51:07:253 EDT] 00000199 wle_migration I   Migrating instances & data to snapshot: Snapshot.493b4fae-5cd6-43ff-b1da-9d58f681f578
[9/11/15 15:51:07:254 EDT] 00000199 wle_migration I   Source snapshots to be migrated: []
[9/11/15 15:51:07:254 EDT] 00000199 wle_migration I   Source snapshots to be deleted: []
[9/11/15 15:51:07:351 EDT] 00000199 wle_migration I   Wrapping up data migration...
[9/11/15 15:51:07:351 EDT] 00000199 wle_migration I   Destination Snapshot- Name: SS11SEP ID: Snapshot.493b4fae-5cd6-43ff-b1da-9d58f681f578
[9/11/15 15:51:07:351 EDT] 00000199 wle_migration I   Source Snapshots:
[9/11/15 15:51:07:352 EDT] 00000199 InstallMessag I   CWLLG3586I: [END]  Migrating global data.
[9/11/15 15:51:07:382 EDT] 00000199 InstallmentSt I   CWLLG3540I: Process Application: MySample, Snapshot: SS11SEP : The data for the snapshot was migrated successfully.
[9/11/15 15:51:07:382 EDT] 00000199 InstallmentSt I   CWLLG3541I: Process Application: MySample, Snapshot: SS11SEP : The instances of the snapshot are being migrated.
[9/11/15 15:51:07:411 EDT] 00000199 InstallMessag I   CWLLG3587I: [BEGIN]  Migrating process instances.
[9/11/15 15:51:07:431 EDT] 00000199 InstallMessag I   CWLLG3587I: [END]  Migrating process instances.
[9/11/15 15:51:07:440 EDT] 00000199 InstallmentSt I   CWLLG3542I: Process Application: MySample, Snapshot: SS11SEP : The instances of the snapshot were migrated successfully.
[9/11/15 15:51:07:448 EDT] 00000199 InstallMessag I   CWLLG3588I: [BEGIN]  Sending tracking definitions to the Performance Data Warehouse server.
[9/11/15 15:51:07:455 EDT] 00000199 ProgrammaticT W   CWLLG2100W: A timeout of 14400 was explicitly requested in ProgrammaticTransactionSupport for transaction definition PROPAGATION_REQUIRED,ISOLATION_DEFAULT,timeout_14400.  No new transaction is started.
[9/11/15 15:51:11:441 EDT] 00000199 InstallMessag I   CWLLG3588I: [END]  Sending tracking definitions to the Performance Data Warehouse server.
[9/11/15 15:51:11:503 EDT] 00000199 InstallmentSt I   CWLLG3545I: Process Application: MySample, Snapshot: SS11SEP : The tracking definitions for the snapshot were updated successfully.
[9/11/15 15:51:11:519 EDT] 00000199 UCASchedulerH I   CWLLG3550I: Process Application: MySample, Snapshot: SS11SEP : The scheduled UCAs for the snapshot are being activated.
[9/11/15 15:51:11:768 EDT] 00000199 UCASchedulerH I   CWLLG3551I: Process Application: MySample, Snapshot: SS11SEP : The scheduled UCAs for the snapshot were activated successfully.
[9/11/15 15:51:11:784 EDT] 00000199 UCASchedulerH I   CWLLG3550I: Process Application: MySample, Snapshot: SS11SEP : The scheduled UCAs for the snapshot are being activated.
[9/11/15 15:51:11:784 EDT] 00000199 UCASchedulerH I   CWLLG3551I: Process Application: MySample, Snapshot: SS11SEP : The scheduled UCAs for the snapshot were activated successfully.
[9/11/15 15:51:12:407 EDT] 00000199 InstallmentSt I   CWLLG3548I: Process Application: MySample, Snapshot: SS11SEP : The snapshot was installed successfully.
[9/11/15 15:51:12:499 EDT] 00000199 CommandServic I PALAdminCommands processServerOfflineDeploy Exiting


Login to Process Admin console of process server to verify the process application installed
The installed snapshot is shown under installed Apps tab

1 comment:

  1. Interesting Article. Hoping that you will continue posting an article having a useful information. Human Resource Workflow

    ReplyDelete