Appreciations accepted

Vladlen Litvinov, the author: If you have some job offer for me, I'm ready to discuss it. View Vladlen Litvinov's profile on LinkedIn

Password

Monday, December 16, 2013

How to install a stand-alone installation in IBM BPM 8.5 (Part 1)


I use the environment Linux - Oracle in the main, but, I think, the same way in others environments.

BTW I never use a "standard" installation, but "custom" only because it is more flexible and as a result, saves a lot of time. It is my first rule of an installation WAS/BPM.
At first, in 8.5 you can install BPM stand-alone in Express edition only.
1. Install the BPM's binary files using Installation Manager. It is usual way, I need not stop here.

2. You cannot use PMT for stand-alone profile, you have to use BPMConfig.sh command for this.

2.1. Before create the properties' file. You can use someone from the folder <WAS_HOME>/BPM/samples/config/express/
I chose Express-PC-Standalone-Oracle.properties and edited it (you can use my file with your settings):

##############################################
# Deployment environment basic properties.   #
##############################################
bpm.de.name=BPMEXP
# Options: true, false If this is set false, database tables are created during deployment environment creation when BPMConfig is run with the create de action . If set to true, the tables need to be created manually.
bpm.de.deferSchemaCreation=true
# Type of product configuration: Express, Standard, Advanced or AdvancedOnly
bpm.de.type=Express
# Type of deployment environment: Process Center or Process Server
bpm.de.environment=Process Center
################################################################
# Deployment environment administrator authentication alias.   #
################################################################
bpm.de.authenticationAlias.1.name=DeAdminAlias
bpm.de.authenticationAlias.1.user=wasadmin
bpm.de.authenticationAlias.1.password=wasadmin
#############################################################
# Database user authentication alias for common database.   #
#############################################################
bpm.de.authenticationAlias.2.name=BPM_DB_CMN_ALIAS
bpm.de.authenticationAlias.2.user=EXPCMNDB
bpm.de.authenticationAlias.2.password=Password
#####################################################################
# Database user authentication alias for process server database.   #
#####################################################################
bpm.de.authenticationAlias.3.name=BPM_DB_PS_ALIAS
bpm.de.authenticationAlias.3.user=EXPBPMDB
bpm.de.authenticationAlias.3.password=Password
#################################################################################
# Database user authentication alias for performance data warehouse database.   #
#################################################################################
bpm.de.authenticationAlias.4.name=BPM_DB_PDW_ALIAS
bpm.de.authenticationAlias.4.user=EXPPDWDB
bpm.de.authenticationAlias.4.password=Password
####################################################################################
# Deployment Environment Administrator role and authentication alias association   #
####################################################################################
# bpm.de.roleMapping.DeAdmin.name
bpm.de.roleMapping.1.name=DeAdmin
bpm.de.roleMapping.1.alias=DeAdminAlias
#####################
# Cell properties   #
#####################
bpm.cell.name=PCCellExp
####################################################
# Cell (WAS) administration authentication alias   #
####################################################
bpm.cell.authenticationAlias.1.name=CellAdminAlias
bpm.cell.authenticationAlias.1.user=admin
bpm.cell.authenticationAlias.1.password=admin
####################################################
# Cell role and authentication alias association   #
####################################################
# Role mapping names are pre-defined. Do not modify this value. Specify the user name in the authentication alias corresponding to this role.
bpm.cell.roleMapping.1.name=CellAdmin
bpm.cell.roleMapping.1.alias=CellAdminAlias
##############################
# Properties for each node   #
##############################
bpm.de.node.1.name=Node1
# If the hostname is the same as deployment manager, this node will be created on the same computer. Do not use localhost for environments that are spread across multiple machines.
bpm.de.node.1.hostname=server
bpm.de.node.1.installPath=/opt/ibm/BPM85Exp
bpm.de.node.1.profileName=ProcCtr01
bpm.de.node.1.initialPortAssignment=
bpm.de.node.1.server.db=ProcessServerDb,SharedDb,PerformanceDb
#########################
# Database properties   #
#########################
# Keyword to use to  refer to this set of database properties. This is not the database name.
bpm.de.db.1.name=SharedDb
# List of components that are configured on this database. For Advanced configurations the options are: Messaging, BusinessSpace, CommonDB, BPC and CellScopedDB. For Standard and Express configurations, the options are: Messaging, BusinessSpace, ProcessServer, EmbeddedECM and PDW.
bpm.de.db.1.dbCapabilities=Messaging,BusinessSpace
# Database name.
bpm.de.db.1.databaseName=BPM8
# Database type. Options: DB2, DB2zOS, Oracle or SQLServer
bpm.de.db.1.type=Oracle
# Database hostname. Do not use localhost for environments that are spread across multiple machines.
bpm.de.db.1.hostname=server
bpm.de.db.1.portNumber=1521
bpm.de.db.1.sqlServerWinAuth=false
########################################################
# Database role and authentication alias association   #
########################################################
# Role mapping names are pre-defined. Do not modify this value. Specify the user name in the authentication alias corresponding to this role.
bpm.de.db.1.roleMapping.1.name=DbUser
bpm.de.db.1.roleMapping.1.alias=BPM_DB_CMN_ALIAS
########################################################
# Database role and authentication alias association   #
########################################################
# Role mapping names are pre-defined. Do not modify this value. Specify the user name in the authentication alias corresponding to this role.
bpm.de.db.1.roleMapping.2.name=DbUserXAR
bpm.de.db.1.roleMapping.2.alias=BPM_DB_CMN_ALIAS
bpm.de.db.1.schema=EXPCMNDB
#########################
# Database properties   #
#########################
# Keyword to use to  refer to this set of database properties. This is not the database name.
bpm.de.db.2.name=ProcessServerDb
# List of components that are configured on this database. For Advanced configurations the options are: Messaging, BusinessSpace, CommonDB, BPC and CellScopedDB. For Standard and Express configurations, the options are: Messaging, BusinessSpace, ProcessServer, EmbeddedECM and PDW.
bpm.de.db.2.dbCapabilities=ProcessServer,EmbeddedECM
# Database name.
bpm.de.db.2.databaseName=BPM8
# Database type. Options: DB2, DB2zOS, Oracle or SQLServer
bpm.de.db.2.type=Oracle
# Database hostname. Do not use localhost for environments that are spread across multiple machines.
bpm.de.db.2.hostname=server
bpm.de.db.2.portNumber=1521
bpm.de.db.2.sqlServerWinAuth=false
########################################################
# Database role and authentication alias association   #
########################################################
# Role mapping names are pre-defined. Do not modify this value. Specify the user name in the authentication alias corresponding to this role.
bpm.de.db.2.roleMapping.1.name=DbUser
bpm.de.db.2.roleMapping.1.alias=BPM_DB_PS_ALIAS
########################################################
# Database role and authentication alias association   #
########################################################
# Role mapping names are pre-defined. Do not modify this value. Specify the user name in the authentication alias corresponding to this role.
bpm.de.db.2.roleMapping.2.name=DbUserXAR
bpm.de.db.2.roleMapping.2.alias=BPM_DB_PS_ALIAS
bpm.de.db.2.schema=EXPBPMDB
#########################
# Database properties   #
#########################
# Keyword to use to  refer to this set of database properties. This is not the database name.
bpm.de.db.3.name=PerformanceDb
# List of components that are configured on this database. For Advanced configurations the options are: Messaging, BusinessSpace, CommonDB, BPC and CellScopedDB. For Standard and Express configurations, the options are: Messaging, BusinessSpace, ProcessServer, EmbeddedECM and PDW.
bpm.de.db.3.dbCapabilities=PDW
# Database name.
bpm.de.db.3.databaseName=BPM8
# Database type. Options: DB2, DB2zOS, Oracle or SQLServer
bpm.de.db.3.type=Oracle
# Database hostname. Do not use localhost for environments that are spread across multiple machines.
bpm.de.db.3.hostname=server
bpm.de.db.3.portNumber=1521
bpm.de.db.3.sqlServerWinAuth=false
########################################################
# Database role and authentication alias association   #
########################################################
# Role mapping names are pre-defined. Do not modify this value. Specify the user name in the authentication alias corresponding to this role.
bpm.de.db.3.roleMapping.1.name=DbUser
bpm.de.db.3.roleMapping.1.alias=BPM_DB_PDW_ALIAS
########################################################
# Database role and authentication alias association   #
########################################################
# Role mapping names are pre-defined. Do not modify this value. Specify the user name in the authentication alias corresponding to this role.
bpm.de.db.3.roleMapping.2.name=DbUserXAR
bpm.de.db.3.roleMapping.2.alias=BPM_DB_PDW_ALIAS
bpm.de.db.3.schema=EXPPDWDB


My second rule is: I never create DB and DB's objects during profile creation.
The reason - if you get some error with DB, you have to delete the profile and have to create it again. Save your time. I choose the parameter bpm.de.deferSchemaCreation=true (do you remember -dbCreateNew false -dbDelayConfig true manageprofiles' properties?)

2.2. Run BPMConfig.sh using your properties' file.

[root@server bin]# ./BPMConfig.sh -create -de Express-PC-Standalone-Oracle.properties
Logging to file /opt/ibm/BPM85Exp/logs/config/BPMConfig_20131216-112402.log.
Validating the profile registry.
[]
Configuring stand-alone profile.
Creating stand-alone profile.
INSTCONFSUCCESS: Success: Profile ProcCtr01 now exists. Please consult /opt/ibm/BPM85Exp/profiles/ProcCtr01/logs/AboutThisProfile.txt for more information about this profile.
Generating SQL files.
Provisioning cell.
Configuring the cell.
XL TXE-J compiling stylesheet: null
XL TXE-J compiling stylesheet: null
XL TXE-J compiling stylesheet: null
XL TXE-J compiling stylesheet: null
Provisioning deployment environment.
Generating database configuration files to /opt/ibm/BPM85Exp/profiles/ProcCtr01/dbscripts/BPMEXP.
Performing security configuration.
Configuring data sources.
Configuring the database(s).
Operation completed successfully
The HTTP and HTTPS ports are added to the virtual hosts list.
Configuring the node.
Configuring the REST services end points.
Saving configuration changes, please be patient...
BPMConfig completed successfully.


3. Create the script for Oracle users creating:

CREATE USER EXPCMNDB IDENTIFIED BY Password;
grant connect, resource, unlimited tablespace to EXPCMNDB;
grant create view to EXPCMNDB;
grant javauserpriv to EXPCMNDB;
grant execute on dbms_lock to EXPCMNDB;

CREATE USER EXPBPMDB IDENTIFIED BY Password;
grant connect, resource, unlimited tablespace to EXPBPMDB;
grant create view to EXPBPMDB;
grant javauserpriv to EXPBPMDB;
grant execute on dbms_lock to EXPBPMDB;

CREATE USER EXPPDWDB IDENTIFIED BY Password;
grant connect, resource, unlimited tablespace to EXPPDWDB;
grant create view to EXPPDWDB;
grant javauserpriv to EXPPDWDB;
grant execute on dbms_lock to EXPPDWDB;


4. Execute this script and all the others from /dbscripts in this order:

/dbscripts/BPMEXP/Oracle/BPM8/EXPCMNDB/createSchema_Express.sql
/dbscripts/BPMEXP/Oracle/BPM8/EXPCMNDB/createSchema_Messaging.sql
/dbscripts/BPMEXP/Oracle/BPM8/EXPBPMDB/createSchema_Express.sql
/dbscripts/BPMEXP/Oracle/BPM8/EXPBPMDB/createProcedure_Express.sql
/dbscripts/BPMEXP/Oracle/BPM8/EXPPDWDB/createSchema_Express.sql

5. Run bootstrapProcessServerData as usual (from <Profile_HOME>/bin):

[root@server bin]# ./bootstrapProcessServerData.sh
Bootstraping data for server at /opt/ibm/BPM85Exp/profiles/ProcCtr01
WASX7357I: By request, this scripting client is not connected to any server process. Certain configuration and application operations will be available in local mode.
importFile: /opt/ibm/BPM85Exp/BPM/Lombardi/imports/system-toolkit.twx
deploy: false
latestSystemToolkit: true
activateSnapshot: false
importFile: /opt/ibm/BPM85Exp/BPM/Lombardi/imports/system-coaches.twx
deploy: false
latestSystemToolkit: false
activateSnapshot: false
importFile: /opt/ibm/BPM85Exp/BPM/Lombardi/imports/system-dashboards.twx
deploy: false
latestSystemToolkit: false
activateSnapshot: false
importFile: /opt/ibm/BPM85Exp/BPM/Lombardi/imports/governance-toolkit.twx
deploy: false
latestSystemToolkit: false
activateSnapshot: false
importFile: /opt/ibm/BPM85Exp/BPM/Lombardi/imports/content-integration-toolkit.twx
deploy: false
latestSystemToolkit: false
activateSnapshot: false
importFile: /opt/ibm/BPM85Exp/BPM/Lombardi/imports/process-portal.twx
deploy: true
latestSystemToolkit: false
activateSnapshot: false
importFile: /opt/ibm/BPM85Exp/BPM/Lombardi/imports/saved-search-admin.twx
deploy: true
latestSystemToolkit: false
activateSnapshot: false
importFile: /opt/ibm/BPM85Exp/BPM/Lombardi/imports/standard-hiring-sample.twx
deploy: true
latestSystemToolkit: false
activateSnapshot: false
'BootstrapProcessServerData admin command completed.....'


6. At last

[root@server bin]# ./startServer.sh server1
ADMU0116I: Tool information is being logged in file
           /opt/ibm/BPM85Exp/profiles/ProcCtr01/logs/server1/startServer.log
ADMU0128I: Starting tool with the ProcCtr01 profile
ADMU3100I: Reading configuration for server: server1
ADMU3200I: Server launched. Waiting for initialization status.
ADMU3000I: Server server1 open for e-business; process id is 26890


That all.
 

21 comments:

  1. Hi

    I want to install BPM 8.5 on my PC so I can use Process Designer. Does this guide works for that?
    Any tip on how to install it without issues?

    ReplyDelete
  2. Finally I'd managed to Install IBM BPM Advanced v8.5 in my windows machine using Oracle XE.

    Thanks, your post help me a lot.

    ReplyDelete
  3. Hi,

    I want to install BPM 8.5 PC for dev. I have installed WAS/DB2/BPM 8.5 Now when I want to create profile using BPMConfig command and the properties file for DB2. I am getting following:

    C:\Program Files (x86)\IBM\WebSphere\AppServer\bin>BPMConfig -create -de "C:/Pro
    gram Files (x86)/IBM/WebSphere/AppServer/BPM/samples/config/advanced/Advanced-PC
    -SingleCluster-DB21.PROPERTIES"
    Logging to file C:\Program Files (x86)\IBM\WebSphere\AppServer\logs\config\BPMCo
    nfig_20140806-013412.log.
    CWMCB0713I: Node Dmgr is not a local node, skipping.
    CWMCB0713I: Node Node1 is not a local node, skipping.
    Validating the profile registry.
    []
    BPMConfig completed successfully.

    So its not creating the profile. One thing to add that I already had a WAS on this machine which the current setup may have upgraded to WAS8.5 Please give why I am not able to create the profile ? Thanks

    ReplyDelete
    Replies
    1. First of all, never use Program Files folders for WebSphere installations.
      You can meet a lot of surprises.
      And check the properties named InstallPath in your properties file.

      Delete
    2. Ok thanks, i think InstallPath should have been:

      C:\Program Files (x86)\IBM\WebSphere\AppServer\

      instead of:

      C:\Program Files (x86)\IBM\WebSphere\AppServer\BPM

      Delete
  4. I have installed IBM BPM Advanced (Process Center) in my local Windows environment. Do I need to install IBM BPM Advanced (Process Server) in my local environment also for deployment of BPEL Processes? Or the IBM BPM Advanced (Process Center) will also facilitate BPEL processes? What is the best practice of product installation either Process Center or Process Server if you have more BPEL processes in project? Anyone can help on product topology like what to install in local machine and then SIT, UAT and Production environment ?

    ReplyDelete
    Replies
    1. Yes, Process Center has the full functional of Process Server. You need not install PS for development.
      If you have even 1 percent of BPMN against 99 BPEL - you have to install Process Center.
      In a couple of words - good product topology is:
      1. DEV - PCenter (standalone for 7.5-8 and one node cluster for 8.5 and later)
      2. DEVTEST - PServer online (cluster)
      3. TEST - PServer offline (cluster)
      4. STAGE or HOTFIX - PServer offline (cluster)
      5. PRODUCTION - PServer offline (cluster)

      Delete
    2. When I was installing Process Server from IBM BPM Advanced setup, It gave me four options: Development,Test,Staging and Production.

      Could you please tell me why there is a development environment of Process Server? As you mentioned earlier there is no need to install Process Server for local Windows environment(development).

      Also you stated above DEVTEST- PServer online (cluster), Is it separate environment ? Why we need this as we have separate Test environment. What do you mean by DEVTEST environment?

      Delete
    3. Tell you the truth - all these options (Development,Test,Staging and Production) do not mean anything :)
      It is just a way to mark your servers and do not mix up each other.
      You can think that DEVTEST is Development. Its preference is the fact it is online and you can deploy your PA very quickly (frequent changes of PA). It is used by developers.
      On the contrary, the real Test is used by QA team and it is not for frequent changes of PA.
      Welcome to https://developer.ibm.com/answers/topics/bpm/ It is specially for such questions.

      Delete
    4. By the way it is not very polite to take part in conversation as Anonymous.
      It is not a confession :) I would prefer to talk with a real man.

      Delete
    5. Thanks Vladlen. Well I am confused a bit about Development environment. As we discussed earlier we don't need any Process Server in development environment as Process Center Server have the all capability to serve BPEL components.

      What do you suggest for installation in local environment(windows machine) for me as a developer. and I need other environments like Development (unix machine), SIT(unix machine) and Production(unix machine). Which components should I need to install where like Process center and Process Server and also which server should I keep online and offline?

      Thanks,
      Ismat Kamal

      Delete
    6. Look at my first answer.
      As a minimum, you should have installed:
      Process Center as Development on Unix plus Process Designer and Integration Designer on Windows,
      Process Server as Test on Unix,
      Process Server as Production on Unix.

      Delete
    7. Don't mix up Development Process Server (I named it DEVTEST) and Process Center as development environment.

      Delete
    8. Thanks Vladlen for detailed answer.

      Well As you said Process Center as Development on Unix plus Process Designer and Integration Designer on Windows. So my question to you is I can't download Process Designer in windows environment unless I have installed Process Center in my local machine Windows. According to you Process Center should be installed once in unix environment so how can I get the copy of Process Designer in local windows environment?

      Thanks,
      Ismat Kamal

      Delete
    9. Process Designer is not independent product and can be installed only on Windows from Process Center either Windows or Unix.

      Delete
  5. Thank you for your posting it will help me lot by lombardi bpm

    ReplyDelete
  6. Hi Every one,
    I have installed IBM BPM 8.5 on my local machine.Everything is fine, i can do work on Process Designer.I am unable to see control Center in IBM DB2 folder.Can any one please help in configuring control center. In 7.5.1 Control center is directly present in IBM DB2

    ReplyDelete
    Replies
    1. Hello Jadarish,
      Unfortunately, IBM has removed CC and another useful utilities from the latest versions of DB2.
      So you would have to install IBM Data Studio 4.1 and use it.

      Delete
  7. Hi

    I need to create the Process Center profile on BPM v8.5.6 on advanced version. PMT does not show the option to create this profile. Should I use BPMConfig ? Any link or document for reference would be helpful.

    Thanks,Pramod

    ReplyDelete
  8. First of all you need install WAS and BPM from appropriate disributive.
    If you have already done this, check your installation on running the command versionInfo from the folder bin.
    On Advanced Edition you must have two additional profiles with some standard WAS. The first is BPM deploy manager. And the second - managed node. Then install your deployment environment as you want.

    ReplyDelete
  9. Also probably you have chosen Process Server feature for your installation. Then you need update the feature using Installation Manager.

    ReplyDelete