Home

Interstage BPM Server and Console Installation Guide

1. E interstage Business Process Manager Deployment and Configuration I xj Console Configuration Page Enter Following Console Configuration parameters J interstage Console Configuration Parameters NamingProvider com ibm websphere naming WsninitialContextFactory UserAgentServiceName iFlow ejb UserAgentService HostName it hw 132157d NamingProviderURL J liop fitl hw 132157d M Properties Configuration Parameters ServerBaseURL J http fitl hw 132157d 9080 console ServerEmailBaseURL http fitl hw 132157d 9080 console Finish Cancel Figure 24 Console Configuration page a In the Console Configuration Parameters area depending on your application server the values for the following fields are auto populated NamingProvider UserAgentServiceName NamingProviderURL and ServerBaseURL ServerEmailBaseURL if deploying Interstage BPM Server and Console together Interstage BPM Server and Console Installation Guide WebSphere Application Server 65 7 4 7 5 7 5 1 7 Deploying only the Interstage BPM Console b In the Properties Configuration Parameters area the value for ServerBaseURL is auto populated in the format http lt ConsoleHost gt lt ConsolePort gt console Example http docone 49950 console This is the base URL to access Interstage BPM Console Console related functions are accessed by appending appropriate values to this base URL ote This parameter does not appear
2. ecceceeeesteeeeeeees 122 Deploying Interstage BPM Data Sources and Resources To the Cluster 122 Configuring Service Integration BUSES 0 0 0 eceeeeee teeter eee seeeeeeeeteeeaeeeeeeeaaees 123 Contiguring AN Seaan a hein ened ea eee 124 Configuring the JDBC Driveri reiini inienn eri dae ia i ei 125 Delning a Virtual Host oacsinonimon ee ar eed 126 Setting Up the Interstage BPM Environment for the Cluster 126 Updating the Interstage BPM Server Configuration ccccccecieeeeeeeeeeeeeerenee 127 Updating the Interstage BPM Client Configuration ccceeeceeeeeeeeeieeeerenee 129 Configuring the Shared Resource Root cccccceecceeeeeeceeeeeseeeeeeeeseeeneeeeeeeenaaees 130 Configuring JVM Parametar Soressi anaren e anene R OEE 132 slanting the CUStel se T AT A sadtageeaedidees 133 Implementing Falloveriacevdin cei een ee 133 TROUBIESH OOM Ges 2555 o2sc cone ee a sescecicaceccacicc can teiaa dees icecteree eee 136 Log File InfOrmation cccccecesseneeeeeeeeeeeeeeeeeeeeeeeeeeeeeeenseeeeeeeeeaseneeeseeeseeeeeeeseeenees 136 Resolving Specific Error Situations cccccssseeceeseeeneeeeeeeeeeeenseeeeeenseeeeeeeenes 136 Interstage BPM Server Fails to Start cc ceeececeeeeeeeeeeeeeeeceeeeeeeenaeeeeeeenaeeeeeeeaas 136 Error n IBPMServer lois eciee ce elie oien a i ei ee teenie dees 137 Interstage BPM Server and Console Installation Guide WebSphere Application Server 6 Table of Conten
3. 006 12 Minimum Configuration All Systems on the same Computel ccsesseee 12 Database on Remote Compute sccscceeeeenceeeeeeeeeeeeeeesneeeeeseeeeeeeeeeeeeseeeneeeees 13 System Configurations for Interstage BPM Console 14 Minimum Configuration All Systems on the same Computel ccsesseeee 14 System Requirements for Interstage BPM Server and Console 15 Hardware Requirements for Interstage BPM Server and Console 15 Minimum Software Requirements for Server and Console 0eee 16 Hardware Requirements for BrowSe cccceeeeeeeeeeeeseeneeeeeeeeeeeneeeeeeeeeeanes 16 Minimum Software Requirements for Web Browser Clients 2 ccee 16 Overview of Integrated Deployment of Interstage BPM Server and CONS OO ners See tenon Mose a a a a nen aN en eee ene 17 Preparing for Installation and Deployment of Interstage BPM Server and CONSOME 2 s1ssesscssescscscssecssccscccssssnsnnsesesesrsedesseceensecees 18 Database Server Preparation 2 ccccccececeseesseeeeeeceeeceeeeneeeaseaneeeseeeeeeseseeeseeeneeeees 18 Configuring Microsoft SQL Servel ccccccccscsssccscsscsessessesscesecscsecsessesseseeesseeaeens 18 Configuring Oracles oie ae a eee 19 Starting the Database Servel cccceeeeeeeeeeeeeeeeneeeeeeeeneeeeeeseeeaeeeeeeeaaeeeseeeaeees 20 Installing and Starting WebSphere Application Servet s s sseeeeeeeeeees 21 Installi
4. Event Target Event Data Node A XYZ Node B ABC Node A EFG Node A ABC Node B XYZ Figure 39 All Server Nodes are Up and Running If Node A goes down events remain assigned to that node and are waiting to be processed Event Target Event Data Node A XYZ Node B ABC Node A EFG Node A ABC Node B XYZ Figure 40 Server Node Goes Down Interstage BPM Server and Console Installation Guide WebSphere Application Server 134 Appendix D Clustering Load Balancing and Failover After executing recoverEvents Node A all remaining events of Node A are transferred to and processed by Node B recoverEvents Node A Event Target Event Data Node B XYZ Node B ABC Node B EFG Node B ABC Node B XYZ Figure 41 Events are Transferred to Another Node Interstage BPM Server and Console Installation Guide WebSphere Application Server 135 Appendix E Troubleshooting E 1 E 2 E 2 1 Interstage BPM Server and Console Installation Guide WebSphere Application Server Log File Information Appendix E Troubleshooting If Interstage BPM does not seem to be working properly check the following log files IBPMServer 1log all errors from the server and the Interstage BPM adapters are logged in this file This log file is often very helpful in troubleshooting For example it may indicate that the database server is down AnalyticsError 1log all analytics errors are logged in this file T
5. Cancel Figure 14 Database Configuration 1 In the Interstage Business Process Manager Database User area define the user name and password for a non administrative database user account An example of the user name is ibpmuser Interstage BPM will use this account to log into the database 2 Inthe Oracle Settings area enter the following information DB Host This field is set by the Deployment tool It is the name of the computer on which Oracle is installed e Connect Identifier This field is set by the Deployment tool It is the connection identifier for the Oracle database that you are using The connection identifier usually corresponds to the database name unless the database name is longer than eight characters In this case a trunkated version of the database name is used You can verify the actual connection identifier in the tnsnames ora file located in the lt ORACLE_HOME gt network admin directory Interstage BPM Server and Console Installation Guide WebSphere Application Server 47 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server e Port This field is set by the Deployment tool It is the Oracle port number typically 1521 You can check the actual port number in the targets xm1 file located in the lt ORACLE_HOME gt lt hostname gt lt SID gt sysman emd directory e DB Driver This field is set by the Deployment tool It is the full pack
6. db_ibpmpassword ibpmuserpassword Password for the non administrative database user account db _ host localhost Name of the computer on which Oracle is installed oracle sid orcl Connection identifier for the Oracle database oracle dbadminpassword oracleadminpassword Password of the SYSTEM user db_driverclassname oracle jdbc driver Full package name of the JDBC OracleDriver driver class used to create the database connection db _connectionurl jdbc oracle thin URL of the Oracle database to localhost 1521 ORCL connect to db jdbclibrarypath On Windows c Absolute path of the Oracle JDBC driver ojdbc14 jar for Oracle 10g ojdbc5 jar for Oracle 11g oracle product 10 2 0 db_1 jdbc lib ojdbcl4 jar On Solaris opt oracle product 10 2 0 db_1 jdbc lib ojdbcl4 jar On Linux 9 opt oracle product 10 2 0 db_1 jdbc lib ojdbcel4 jar db_databasehome On Windows c Absolute path to the top level directory of your Oracle oracle product 10 2 0 installation db 1 On Solaris opt oracle product 10 2 0 db 1 On Linux opt oracle product 10 2 0 db 1 Interstage BPM Server and Console Installation Guide WebSphere Application Server 113 Appendix C Silent Mode Deployment Parameter Sample Value without Description spaces oracle _dbdatafilelocation On Windows c Absolute path to the directory oracle product 10 2 0 db 1 where the Interstage BPM database resides da
7. 4 interstage FUJITSU interstage Business Process Manager V11 0 d Server and Console Installation Guide WebSphere Application Server J2U3 0061 01 00 October 2009 Publication Date Revision Trademarks All Rights Reserved Copyright FUJITSU LIMITED 2005 2009 October 2009 3 Interstage is a trademark of Fujitsu Limited ARIS is a registered trademark of IDS Scheer AG Saarbruecken Microsoft Windows Windows NT and Windows Server are registered trademarks of Microsoft Corporation in the United States and other countries UNIX is a registered trademark of the Open Group in the United States and in other countries Java all Java based trademarks and Solaris are trademarks of Sun Microsystems Inc in the U S or other countries AIX is a trademark of IBM Corp Linux is a registered trademark of Linus Torvalds in the USA and other countries Red Hat the Red Hat Shadow Man logo RPM Maximum RPM the RPM logo Linux Library PowerTools Linux Undercover RHmember RHmember More Rough Cuts Rawhide and all Red Hat based trademarks and logos are trademarks or registered trademarks of Red Hat Inc in the United States and other countries All other trademarks and trade names mentioned have been registered by their respective manufacturer All rights reserved including those of translation into other languages No part of this manual may be reproduced in any form whatsoever by means of
8. 23 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server Interstage BPM Server Settings Installation directory of Interstage BPM Default on Windows C Fujitsu InterstageBPM Default on Solaris opt FISVibpm Default on Linux opt FISVibpm Location of the J2SE Development Kit JDK or Java Runtime Environment JRE top level directory WebSphere Application Server Settings Location of the application server profile Example lt webSphere Installation Directory gt AppServer profiles AppSrv01 Node name Example lt computer Name gt Node01 Cell name Example lt computer Name gt Node01Cell Interstage BPM Server name Example serverl Username of the application server administrator Password of the application server administrator Location of the JDK shipped with WebSphere Example lt WebSphere Installation Directory gt AppServer java Interstage BPM Console Settings ServerBaseURL in the format http lt ConsoleHost gt lt ConsolePort gt console Example http docone 49950 console Interstage BPM Server and Console Installation Guide WebSphere Application Server 24 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server ServerEmailBaseURL in the format http lt ConsoleHost gt lt ConsolePort gt console Example http docone 49950 console Database Settings Microsoft SQL Server Da
9. Adding managed nodes Adding a cluster Configuring the required environment variables Deploying Interstage BPM applications to the cluster Deploying Interstage BPM data sources and resources to the cluster Configuring service integration buses Configuring JMS settings Configuring the JDBC driver 10 Defining a virtual host 11 Setting up the Interstage BPM environment 12 Updating the Interstage BPM Server configuration 13 Updating the Interstage BPM Client configuration 14 Configuring the Shared Resource Root 15 Configuring JVM parameters 16 Starting the cluster 17 Implementing failover if you require this feature The next sections provide step by step instructions on how to set up the cluster OMNAARWHN D 1 1 Preparing the Cluster Prerequisite All cluster nodes can reach each other via IP multicast For you to check whether multicasts are available in the target environment perform the following steps 1 Run the following script on each node of the cluster Operating System Multicast Receiver Script Solaris startMulticastReceiver sh Linux This script file is located in lt Interstage BPM Server Installation Directory gt server deployment bin 2 Run the following script on one node of the cluster and check whether all nodes in the cluster are receiving the multicasts Operating System Multicast Sender Script Solaris startMulticastSender sh Linux Interstage BPM
10. This could take several minutes Please wait while it is being installed When the deployment has completed Step 1 Select installation options will appear 13 Accept all defaults and click Next Step 2 Map modules to servers page appears 14 Select WebServiceProxy and click Next Step 3 Map virtual hosts for Web modules appears 15 Select WebServiceProxy and click Next Step 4 Summary appears Kindly ensure that the port that will be available for running the deployed application is the same as of Pre V11 application 16 Click Finish to complete the installation An installation status page appears along with a pop up asking you to Please Wait This could take several minutes Status messages will begin to appear The Interstage BPM Console is being deployed Please wait while the Console is being deployed When the deployment has completed the message Application fujitsu console ear installed successfully appears 17 Click the Save directly to Master Configuration link to save your changes The War file will be saved as a new Web Application in the WebSphere Application Server When saving is completed the Preparing for the application installation page will re appear 18 Select war file installed and click Start to start the WebServicesProxy application A pop up asking you to Please Wait appears This could take a few minutes When the Interstage BPM Console has started the Enterprise Applications page appears with a me
11. URL for WebDAV Repository Name of a user that has administrative rights to publish to the WebDAV Password of that user UDDI Business Name URL to which UDDI Registry information will be published Name of a user that has administrative rights to publish UDDI Registry information to the organization specified as UDDI Business Name Password of that user URL that allows to search the UDDI Registry Interstage BPM Server and Console Installation Guide WebSphere Application Server 28 6 2 6 3 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server Permissions Required for Installation and Deployment Permissions Required for Installation You must have read write and execute permissions on the installation directory of the Interstage BPM Server and Console ote On Solaris if you are installing as a non root user Interstage BPM Server will not be installed as a package Permissions Required for Deployment When Using Oracle e You must have execute permissions for the sqlplus file located in the lt oRACLE_HOME gt bin directory You must have write permissions for the directory in which the Interstage BPM database will reside The ORACLE HOME environment variable must be set to the installation directory of the database server if you are deploying on Solaris e Linux Example ORACLE _HOME opt oracle app oracle product 10 2 0 db_1
12. User Accounts and Groups Every user that is to work with Interstage BPM needs a user account and must be assigned to one or more groups A group is a collection of users who share a function within an organization For example a Manager group might contain the first line managers in an organization Any Interstage BPM user may be made a member of any group In Interstage BPM groups are used to determine who is responsible for carrying out a task in a process Activities in process definitions are assigned to so called Roles which are equivalent to groups The advantage of assigning activities to Roles rather than individuals is that if personnel changes occur only the Role definition needs to be updated and not all the processes that use the Role Interstage BPM Server and Console Installation Guide WebSphere Application Server 56 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server To set up an Interstage BPM user account you create an account with appropriate user rights You must make sure that the user names for the Interstage BPM users and the group members are identical ote Tocreate user accounts and groups that are valid for Interstage BPM use only alphanumeric characters hyphens and underscore characters _ User names and group names must not begin with an at character as this is used to identify Agents in Interstage BPM The default group used by Interstage
13. a page appears that lists the following services e urn POClientListener e urn HRClientListener 2 Update your Client authentication by making the following changes in the file lt Interstage BPM Console gt web soap clientlisteners xml e lt servertype gt EE for Enterprise Edition e lt servername gt lt Server Host gt Flow e lt userid gt userid to be used to log in to the Server e lt password gt password to be used to log in to the Server 3 Update the log file location by replacing lt Interstage BPM Console Installation Directory gt web soap with path to the SOAP directory in the 10944 properties file 4 Make sure that the following files are in the CLASSPATH of the Web Container in which the Console is deployed ote Ifyou are installing the Console on the Interstage Application Server this step is unnecessary e iFlow jar 5 Restart the Web Container Interstage BPM Server and Console Installation Guide WebSphere Application Server 68 8 1 8 Undeploying and Uninstalling Interstage BPM Server and Console Undeploying and Uninstalling Interstage BPM Server and Console This chapter explains how to undeploy Interstage BPM Server and Console from an application server and how to uninstall Interstage BPM Undeploying Interstage BPM Server and Console from the Application Server You can undeploy an instance of the Interstage BPM Server and or Interstage BPM Console from the application server using the I
14. lt Password gt Linux The script imports the configuration file into the database During import the string lt Hostname gt lt Server Name gt s appended to some of the parameter names in order to make those names unique in a cluster environment For example when importing the configuration file on 1BPMHST1 the entry ServerLogFile lt Path gt is transformed into ServerLogFile IBPMHST1 ibpmhst1Node01 lt Path gt Likewise when importing the configuration file on IBPMHST2 the entry is transformed into ServerLogFile IBPMHST2 ibpmhst2Node01 lt Path gt D 1 13 Updating the Interstage BPM Client Configuration Interstage BPM Server comes with a client configuration file which is used by Interstage BPM Clients to connect to the server You need to update the client configuration file so that the client connects to one of the cluster servers Interstage BPM Server and Console Installation Guide WebSphere Application Server 129 Appendix D Clustering Load Balancing and Failover To update the client configuration e On each cluster node update the following parameters in the configuration file iFlowClient properties located in lt Interstage BPM Server Installation Directory gt client JmsFactory iFlow jms TopicDistConnectionFactory java naming provider url corbaname lt HOSTNAME 1 gt lt BootstrapPort gt lt HOSTNAME n gt lt BootstrapPort gt cell clusters lt ClusterName gt NamingProviderURL corban
15. B Silent Mode Installation B 1 A Silent Mode installation is a non interactive type of installation i e you start the installation program and Interstage BPM is installed If you have to perform multiple installations of Interstage BPM and the installations are essentially the same you might want to consider installing Interstage BPM in Silent Mode as you can save a significant amount of time How It Works Silent Mode installations involve the use of an installation script You perform the first installation interactively using a special installation option that records the installation into an installation script in ASCII text format You then run subsequent installations in silent mode using this script Minor installation variations can be handled by editing the script Setting Up a Silent Mode Installation of Interstage BPM To set up a Silent Mode Installation 1 Create a new directory on your computer 2 Copy the following files from the engine directory on your CD ROM to the directory that you created on your computer e setup jar setupwin32 exe on Windows setupSolaris bin on Solaris setupLinux bin on Linux 3 Open a Command Prompt window and navigate to the directory on your computer containing the copied files 4 Start the installation program for Interstage BPM by entering the following command On Windows setupwin32 exe r f1 lt Absolute Installation Script Path gt lt Installation Script Name gt I
16. BPM is Role Interstage BPM administrator accounts must be members of a special group named by default AdminRole If you have configured the Interstage BPM Server to use a Directory Service you need to configure the Directory Service before starting the Interstage BPM Server The Interstage BPM Deployment Tool has created an Interstage BPM LDIF file which contains default users default groups and the default Interstage BPM object class for the Directory Service You can import the LDIF file into your Directory Service in order to configure it For details refer to chapter Setting Up a Directory Service on page 82 If you have configured the Interstage BPM Server to use its local user store the Interstage BPM Super User account has already been created in the user store There is no need to perform further configuration steps before starting the Interstage BPM Server For details on creating additional user accounts and groups refer to the Interstage Business Process Manager User s Guide 6 10 Switching on Java Security This section is applicable for SaaS mode only In the SaaS mode it is critical that each tenant has access to only their own resources and no other tenant s resources To achieve this security you need to manually switch on Java security as follows For WebSphere Application Server 1 In the WebSphere Administration Console navigate to Security gt Secure administration applications and infrastructure 2 In the Jav
17. Configuring Interstage BPM for WebSphere Application Server 6 1 and Starting Interstage BPM Server on page 58 e Starting Interstage BPM Console and Tenant Management Console on page 61 9 Ifneeded migrate application owners as described in Migrating Application Owners from Previous Versions to Interstage BPM v11 0 on page 78 Interstage BPM is now upgraded to the latest version 9 2 Migrating Application Resources from Previous Versions to Interstage BPM v11 0 Pre requisites You have completed the following steps as described in Upgrading from Previous Versions of Interstage BPM on page 75 e You have uninstalled the previous version of Interstage BPM e You have installed the new version of Interstage BPM e You have upgraded the database e You have deployed an instance of Interstage BPM Server and if required Console in non SaaS mode To migrate application resources from previous versions to Interstage BPM v11 0 1 Copy the DmsCollections xml file of the previous version to the lt Interstage BPM Installation Directory gt server instance default tenants Default resources folder 2 Copy the apps folder from lt Interstage BPM Installation Directory gt server instance default tenants Default to the DMSRoot lt Path gt you choose to specify in DmsCollections xml ote For Solaris and Linux environments while specifying the DMSRoot ensure you use the correct case in the file path Interstage BPM Server and C
18. Console System Requirements for Interstage BPM Server and Console Overview of Integrated Deployment of Interstage BPM Server and Console Preparing for Installation and Deployment of Interstage BPM Server and Console Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server Deploying only the Interstage BPM Console Description Description of the typical system configurations for the installation of Interstage BPM Server Description of the typical system configurations for the installation of Interstage BPM Console Description of the minimum system requirements by platform An overview of using the new integrated Deployment Tool Instructions for preparing external systems like the database or the application server Instructions for performing installation of Interstage BPM Server with Console or only Interstage BPM Server Instructions for performing deployment of only Interstage BPM Console Interstage BPM Server and Console Installation Guide WebSphere Application Server 8 About this Manual Chapter Title Description 8 Undeploying and Uninstalling Interstage Instructions for removing an BPM Server and Console instance of Interstage BPM Server and Console from the application server and for uninstalling Interstage BPM 9 Upgrading Interstage BPM Server from Instructions for performing an Previous Versions upgrade 10 Setting Up a Directory Servic
19. If you are migrating from an Interstage BPM Advanced Edition select the Upgrade from AE to EE Version check box b ote Ifyou are upgrading from an Interstage BPM Enterprise Edition do not select the Upgrade from AE to EE Version check box Otherwise your database may get incorrectly updated Interstage BPM Server and Console Installation Guide WebSphere Application Server 75 9 Upgrading Interstage BPM from Previous Versions g Click Next h Make sure that all the information displayed on the Review Information screen is correct i Click Finish to start upgrading the database At the end of the process a message is displayed notifying you that the database has been upgraded j Click OK to exit the Deployment Tool 6 Deploy the Interstage BPM Server and or Console according to the instructions in section Deploying Server Instances with Console OR only Server Instances on page 39 ote Onthe lt Application Server gt Configuration screen do not select the Configure Database on this Machine option Otherwise the old database will be overwritten and you will lose all of the previous work that is stored in the database ote On the Interstage BPM Super User screen ensure you select the Non SAAS mode 7 Migrate application resources as described in Migrating Application Resources from Previous Versions to Interstage BPM v11 0 on page 76 8 Start the Interstage BPM Server and Console Refer the following topics
20. Installation Guide WebSphere Application Server 140 Appendix E Troubleshooting An error occurred during the execution of importap bat Cause One of the following values provided during deployment were wrong e Active Directory Key e Active Directory Organizational Unit Action Remove Interstage BPM from the application server and deploy it again using the Deployment Tool E 4 Errors during Starting the Interstage BPM Server The following tables explain the possible causes of errors during server startup and the appropriate action s to take Errors Pertaining to Active Directory Cause The Active Directory Server is remote and Active Directory is not running Action Start the Active Directory Server and then start the Interstage BPM Server Cause One of the following values provided during deployment was wrong e Username for the Directory Service Login account e Password for the Directory Service Login account These values are used in the importAD bat file as arguments of the net user command Action Remove Interstage BPM from the application server and deploy it again using the Deployment Tool Interstage BPM cannot connect to the Active Directory Server because one of the following values provided during deployment was wrong e Active Directory Key e Active Directory Organizational Unit Interstage BPM cannot connect to the LDAP Server because one of the following values provided during deployment was wr
21. JDBC driver with Microsoft SQL Server so you must obtain the latest service pack of the SQL Server Driver for JDBC from the Microsoft Web Site and install it using the instructions provided on the download page For information about supported versions of the driver refer to the Release Notes The sqljdbc jar file is the actual driver You will need to specify the driver location later when deploying the Interstage BPM Server 5 If you are running your database on a remote computer copy the JDBC driver sqljdbc jar into a new directory on the application server computer Create a directory with an identifiable name because you must specify it as the driver location during the deployment of the Interstage BPM Server 6 On the computer where Microsoft SQL Server is installed make sure that a J2SE Development Kit JDK or Java Runtime Environment JRE is installed For information about supported versions refer to the Release Notes Microsoft SQL Server is now configured ote If you change the default datapath for the Microsoft SQL Server instance make sure that you specify a directory on a local disk The default datapath is the location where new databases will be stored 5 1 2 Configuring Oracle Prerequisite Oracle is installed To configure Oracle for Interstage BPM 1 On the computer where Oracle is installed make sure that a J2SE Development Kit JDK or Java Runtime Environment JRE is installed For informa
22. Servers gt lt ServerName gt gt that any bootstrap address information Ports in the URL is correct and that the target 2 Update the value of the BOOTSTRAP ADDR name server is running A bootstrap port for the following entries in the address with no port specification iflowClient properties ibpm properties defaults to port 2809 Possible causes files as well as Interstage BPM properties in other than an incorrect bootstrap address the database or unavailable name server include the JMSNamingProviderURL in the format network environment and workstation iiop lt Host Name gt lt BOOSTRAP ADDRESS gt network configuration NamingProviderURL in the format iiop lt Host Name gt lt BOOSTRAP ADDRESS gt E 2 2 Error in IBPMServer log Check the IBPMServer log in the lt Interstage BPM Server Installation Directory gt server instance default logs directory Look for What to do getGroupMembersByDN Could not retrieve Possible cause of this error A user has been the user groups LDAP error code 32 deleted from the Directory Server LDAP Server No Such Object but the reference of it is still there in one of the groups E 2 3 Timeout During JavaScript Execution When executing large JavaScripts the transaction timeout currently set for WebLogic and WebSphere application servers 120 seonds is insufficient Due to this setting script execution may fail with a transaction timeout
23. Setting Up an Interstage BPM Cluster on WebSphere Application Server 6 1 This section provides instructions for configuring a cluster of Interstage BPM Servers on WebSphere Application Server 6 1 Interstage BPM for WebSphere is installed as a WebSphere Application Server Therefore when you cluster instances of Interstage BPM for WebSphere you must cluster them as you would any set of WebSphere Application Servers You must use the WebSphere Application Server 6 1 Network Deployment ND Edition to cluster WebSphere Application Servers The WebSphere Deployment Manager and the clustered Application Servers form a cell When Application Servers are part of a cell they are called managed nodes The sample system used to illustrate the instructions in this section consists of three computers It has two managed nodes IBPMHST1 and IBPMHST2 and a Deployment Manager that resides on a separate computer with hostname DMGRuHST The following figure shows the sample system IBPMHST1 Managed Node IBPMHST2 Managed Node Figure 37 Sample Cluster Interstage BPM Server and Console Installation Guide WebSphere Application Server 117 Appendix D Clustering Load Balancing and Failover Setting up the cluster consists of the following major steps 1 Preparing the cluster This involves installing the WebSphere Application Servers and the Deployment Manager as well as installing Interstage BPM on the Deployment Manager
24. The installation program launches the Deployment Tool in graphical mode This option does not make sense when running a silent mode installation On Linux w bean2223 deploymenttool because it requires some user interaction after installation The installation program does not launch the Deployment Tool Like the installation program the Deployment Tool can be run in Silent Mode For details refer to appendix Silent Mode Deployment on page 108 Example The following sample script performs a new installation of the Interstage BPM without launching the Deployment Tool at the end of installation Sample script for e Solaris e Linux W bean1 destinationPath opt FJSVibpm W bean11 jdkHome usr java W bean2223 deploymenttool Interstage BPM Server and Console Installation Guide WebSphere Application Server 107 Appendix C Silent Mode Deployment Appendix C Silent Mode Deployment C 1 C 2 Like the installation program the Deployment Tool can be run in Silent Mode Silent Mode deployment allows you to configure the database and deploy or undeploy Interstage BPM Server without user interaction This is an efficient way to perform multiple deployments if the deployments are essentially the same Silent Mode deployments require the use of a Silent Mode script You perform an interactive deployment using a special option that records your choices into a Silent Mode script You then run subsequent de
25. Tool instantly after be leaked the deployment For a list of files refer to section Password Protection on page 56 10 Virus or worm injection As a rule always use anti virus software Password Encryption The Interstage BPM Deployment Tool encrypts the passwords entered during deployment and writes the encrypted passwords into the database The ibpm properties file which is generated by the Deployment Tool as a backup copy of the initial configuration also contains encrypted passwords only The Interstage BPM Server decrypts all passwords at startup If decryption fails a warning message is printed in the IBPMServer 1og file If you need to change the user passwords after deployment an Encryption Utility is provided so that you can encrypt the passwords and overwrite them in the server s configuration The Encryption Utility does not provide for decryption of passwords It can only be used for encryption Interstage BPM Server and Console Installation Guide WebSphere Application Server 97 Appendix A Security Initially a default key is used to encrypt and decrypt the passwords If you want to use a different key for security reasons you must add this key to the server s configuration The default key is not published it is hardcoded in the server code The Encryption Utility provided is com fujitsu iflow utilities TextEncrypter class To call the Encryption Utility use the encryption script located in lt I
26. WebSphere Application Server 41 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server On the WebSphere lt Version gt Application Server screen you provide the settings for your application server lox WebSphere 6 1 Application Server Configuration Enter the following settings for performing the selected operation on a WebSphere 6 1 0 9 server All fields are mandatory and must not be left blank 4 interstage r WebSphere Settings Path to Profile Browse Cell o Node P Server within Node LOO m WebSphere Security E Security Enabled Administrator Username J Administrator Password m Java Home Directory Java home directory Browse The deployment requires JRE version 1 5 preferably the JRE version that was shipped with the application server M Interstage Business Process Manager Database J Configure Database on this Machine Next gt Finish Cancel Figure 12 WebSphere Settings 1 Inthe WebSphere Settings area enter the following information about the WebSphere Application Server profile you will be using for the Interstage BPM Server and Console Path to Profile Enter the root directory of the WebSphere Application Server profile Example for Windows c IBM WebSphere AppServer profiles AppSrv01 Example for Solaris opt IBM WebSphere AppServer profiles AppSrv01 Example for Linux opt IBM WebSphere AppServer prof
27. before actually deploying the Interstage BPM Server with Console or only the Server to an application server Interstage BPM Server and Console Installation Guide WebSphere Application Server 39 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server 6 7 1 Operation Mode and Application Server Selection 1 On the Welcome screen of the Deployment Tool select Server Console Instance Setup and click Next E leterstage Business Process Manager Deployment and Configuration Welcome to the interstage Business Process Manager Deployment Tool Select he operae you wart to perform Based on your selection the Deployment Tool gades you through the requred steps Server Console Instance Setup Cortigures and deploys interstage Dusness Process Manager Server andjor Console Y1 1 0 to an apgiication server and optionally configures the database instance associated with Interstage Business Process Server Console Instance Removal Undegiloys an instance of Interstage Business Process Manager Server and or Console V1 1 0 from an application server Database Setup Sets up a new database Pukanca to be aneccisted wih Interstage Business Process Manager 11 0 Database Upgrade Upgrades an existing Database inetance of Interstage Business Process Manager Server 11 0 Figure 10 Welcome 2 On the Application Server Selection screen a Select the type of application server on which you inte
28. changes The Enterprise Applications page is displayed InterstageBPMConsole appears on the list with a red icon indicating that it has not been started Integrated Solutions Console Welcome Help Logout Applications Close page wal Enterprise Applications m Guided Activities Enterprise Applications Hh aan l iF For field help informatic E Servers Use this page to manage installed applications A single application can be deployed onto multiple servers select a field label or lis marker when the help E Applications E Preferences cursor appears Enterprise Applications Start _Stop Install Uninstall Update _ Rollout Update Remove File Export Export DDL _ Export File Page help Install New Application More information about E eae this pag E Resources aije E Security Select Name Application Status 9 Command Assistance View administrative En o DefaultApplication gt scripting command for action System administration vw InterstageBPMConsole eeu D InterstaqeBPMServer gt E Monitoring and Tuning oO ivtapp gt E Troubleshooting B Service integration ml avery gt upor Total 5 Figure 22 Enterprise Applications Page with Console Not Started 7 Select InterstageBPMConsole and click Start to start the Interstage BPM Console application Interstage BPM Server and Console Installation Guide WebSphere Application Server 62 6 Installing and Deploying Interstage BPM Se
29. choices are written to the installation script In the example the installation script record install txt record install iss for Windows is created in the RMI directory You can now use the installation script to install Interstage BPM on other computers in Silent Mode B 2 Installing Interstage BPM in Silent Mode Prerequisite You have set up your Silent Mode installation as instructed in section Setting Up a Silent Mode Installation of Interstage BPM on page 104 To install Interstage BPM using Silent Mode 1 Create a directory on the computer where you want to install Interstage BPM in Silent Mode In the example below RMI is used as the directory s name 2 Copy the following files from the computer where you recorded the installation script to the directory that you created in the previous step e the installation script that you recorded e g record install txt e setup jar setupwin32 exe on Windows setupSolaris bin on Solaris setupLinux bin on Linux 3 Make a note of the drive and directory to which you copied the files 4 Open the installation script in a text editor and make any changes necessary to make it run properly in the different environment Refer to section Silent Mode Installation Options on page 106 for allowed changes For example you might have your J2SE Development Kit JDK installed on a different drive and in a different directory than on the computer where you recorded the installation script Y
30. definition information will be published Name of the user used for publishing UDDI registry information Password of the user specified iN UDDIPublisherUserName URL of the UDDI registry used for searching Interstage BPM Server and Console Installation Guide WebSphere Application Server 116 Appendix D Clustering Load Balancing and Failover Appendix D Clustering Load Balancing and Failover D 1 This appendix provides you with an effective means of increasing the scalability and reliability of your Interstage Business Process Manager system Configuring your system for load balancing can increase scalability Configuring your system for failover can increase reliability This appendix provides guidelines for setting up a cluster of Interstage BPM Servers It also provides guidelines for configuring that cluster for load balancing and failover In an Interstage BPM Cluster multiple Interstage BPM Servers are deployed to work in concert with each other In other words they work together as a unit The default Interstage BPM Cluster is configured for load balancing in a round robin configuration and for failover For Interstage BPM Clusters in a round robin configuration requests sent to the cluster are distributed evenly among the servers in the cluster If the cluster is configured for failover a working server in the cluster automatically takes over for a server in the cluster that has just failed for some reason
31. domain controller machine with the IBPMADAdd Idif file Importing the LDIF file generated by the Interstage BPM installation program results in the following e The IflowGroups and IflowUsers Groups are added to the Organizational Unit ou specified during the installation of Interstage BPM e The Organizational Units people and groups are added to Active Directory e The default Interstage BPM Roles Role and AdminRole are added to the Organizational Unit groups e The default user typically ibpm_server1 is added to the Organizational Unit people e The default Groups Role and AdminRole are added to the members of I flowGroups e The default user typically ibpm_server1 is added to the members of IflowUsers Interstage BPM Server and Console Installation Guide WebSphere Application Server 82 10 1 2 10 1 3 10 Setting Up a Directory Service To import the IBPMADAdd ldif file 1 Log on as an Administrator to the computer containing the Active Directory domain controller 2 Ensure that the Password Policies of the Domain Security Policy are set as follows e Minimum password length 0 characters e Password must meet complexity requirements Disabled If you changed these settings remember the current settings so you can restore them later 3 If the Active Directory server is installed on a computer different from the Interstage BPM Server copy the IBPMADAdd 1dif file and the importAD bat file located in lt Interstage BPM Serve
32. in the Console Configuration page when deploying only Interstage BPM Console c In the Properties Configuration Parameters area the value for ServerEmailBaseURL is auto populated in the format http lt ConsoleHost gt lt ConsolePort gt console Example http docone 49950 console Console Web Services are accessesed by appending appropriate values to this base URL ote This parameter does not appear in the Console Configuration page when deploying only Interstage BPM Console d If you are deploying only Console 1 Click Finish 2 For further steps refer Overview of Installation and Deployment of Interstage BPM Console on page 64 e If you are deploying Console together with Interstage BPM Server click Next For further steps refer Database Selection on page 44 Starting Interstage BPM Console Prerequisites You have finished deploying Console on your application server To start Interstage BPM Console refer section Starting Interstage BPM Console and Tenant Management Console on page 61 interstage BPM Console Other Configurations This section describes other configurations for Interstage BPM Console after you have deployed it on an application server Configuring Interstage BPM Console to work with Interstage Analytics Pre requisites Make sure that you have installed Interstage Analytics and Interstage BPM including Interstage BPM Console on the same machine To configure Interstage BPM console to display
33. items are restricted to the specific people who need to use them The following are examples of people who need to use them e Only members of the Role specified in the TemplatePublishers parameter of the Interstage BPM Server can create new process definitions e Only the process instance owners current assignees and Interstage BPM Administrators can view any specific process instances Current assignees are those who have active task assignments This does not include people who will have task assignments later in the process Interstage BPM Server and Console Installation Guide WebSphere Application Server 99 A 4 A 5 Appendix A Security e Only the process instance owners current assignees and Interstage BPM Administrative Users can edit their specific process instances This means they can change User Defined Attributes and add or delete attachments However they are not allowed to edit the process structure To set up Security Mode e Add the following parameters to the server configuration SecuritySwitch true This setting enables Security Mode TemplatePublishers lt Registered Role gt This Role must be registered in Interstage BPM s local group store or in your Directory Service For example if you have defined a Role of pubRole you would type TemplatePublishers pubRole Be aware that this key takes effect only if the Security Mode is switched on For information on how to add parameters refer to section Usin
34. nse deeyctact A syunyy sraeeeses 76 Migrating Application Owners from Previous Versions to Interstage BPM WAV O occcedic neti cnsecedaieesscnccnnzcecusdencerguceculnestsvcustaacessussdeiaystercccctevencergetk Chassadquiaitcssencess 78 Migrating WebDAV Repository and UDDI Registry from Previous Versions to interstage BPM VITO icc icc c ects cetcecedeetteweeeth egeecetecelenceh scdcdiceusceteuceeecedeievenscecencenss 78 Additional Steps for Handling Pre 11 0 Console URLS cceccsssseeeeeeeeseeees 78 Steps to Overcome the URL incompatibility Problem cccceeeeeeeeteeeees 79 Setting Up a Directory Service ccccceeeeeeeeeeeeeeeeeeeeeeeeeneeeees 82 Setting Up Microsoft Active DireCtory cscsssscssececsssesseeseeieseeeeeneeneees 82 Importing the IBPMADAdGd Idif File ccccecceeeesceeeeeeeeeeseeeeeeeeesaaeeeeeeeeseaeeeeaeees 82 Using Existing Active Directory Users and GroupS 0 c ccecceeeeeeeeeeeeeeeteeeeeeeaes 83 Adding New Users with an LDIF File eeeececceeeecneeeeeeeeneeeeeeeeceeeeeeenaeeeeeeenaees 83 Adding New Users Using the GUI eeeceee eee ente eee eeenneeeeeeeeaeeeeeeenaeeeeeneaaes 84 Adding New Groups with an LDIF File 0 eecceeeeeseeeeeeeeeeneeeeeeeteeeeeeenaeeeeeeeaees 87 Adding New Groups Using the GUI cece ee eecne terre eee eeeeetaeeeeeeeaeeeeeeeaaes 88 Adding Members to a Group Using LDIF 0 eee eeeeeeeeeeeenneeeeeeeneeeeeeenaeeeeeneaas 89 Addi
35. on a remote computer To configure the database 1 If the Deployment Tool is not running start it For details refer to section Starting the Deployment Tool on page 37 Interstage BPM Server and Console Installation Guide WebSphere Application Server 38 6 7 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server oun WN On the Welcome screen of the Deployment Tool select Database Setup Click Next On the Database Selection screen select the database system you wish to use Click Next On the Database Configuration screen enter the settings for your database If you are using Oracle refer to section Oracle Settings on page 47 for a detailed explanation If you are using Microsoft SQL Server refer to section Microsoft SQL Server Settings on page 44 for a detailed explanation Click Next Make sure that all the information displayed on the Review Information screen is correct Click Finish to start configuring the database At the end of the process a message is displayed notifying you that the database has been configured 10 Click OK to exit the Deployment Tool Deploying Server Instances with Console OR only Server Instances Prerequisite If you are using a remote database you must have configured it as explained in section Configuring the Remote Database on page 38 After you have started the Deployment Tool you perform initial configuration steps
36. page 58 5 Start Interstage BPM Console Refer section Starting Interstage BPM Console on page 66 6 If required perform further configurations for Interstage BPM Console Refer section nterstage BPM Console Other Configurations on page 66 Interstage BPM Server and Console Installation Guide WebSphere Application Server 64 7 Deploying only the Interstage BPM Console 7 3 Deploying interstage BPM Console Using the Deployment Tool Prerequisites e You have already installed and deployed Interstage BPM Server OR are in the process of deploying Server and Console together e The application server is running If you are deploying only Interstage BPM Console start from step 1 If you are in the process of deploying Interstage BPM Server and Console together start from step 4 To deploy Interstage BPM Console using the Deployment Tool 1 Start the Deployment Tool Refer section Starting the Deployment Tool on page 37 2 On the Welcome page select the mode of operation On the Application Server Selection screen select the application server and components to be deployed that is Console For details refer section Operation Mode and Application Server Selection on page 40 3 On the application server configuration page provide settings for your application server Refer section WebSphere Application Server Settings on page 41 4 On the Console Configuration page provide your settings for Interstage BPM Console
37. photocopying microfilming or any other process without the written permission of Fujitsu Limited High Risk Activity The Customer acknowledges and agrees that the Product is designed developed and manufactured as contemplated for general use including without limitation general office use personal use household use and ordinary industrial use but is not designed developed and manufactured as contemplated for use accompanying fatal risks or dangers that unless extremely high safety is secured could lead directly to death personal injury severe physical damage or other loss hereinafter High Safety Required Use including without limitation nuclear reaction control in nuclear facility aircraft flight control air traffic control mass transport control medical life support system missile launch control in weapon system The Customer shall not use the Product without securing the sufficient safety required for the High Safety Required Use In addition Fujitsu or other affiliate s name shall not be liable against the Customer and or any third party for any claims or damages arising in connection with the High Safety Required Use of the Product Table of Contents Table of Contents 1 1 1 2 2 1 3 1 3 2 3 3 3 4 5 1 5 1 1 5 1 2 5 1 3 5 2 6 1 6 2 6 3 6 4 6 5 About this Manual cccccceeeeeeeeeeeeeeeeeeeeeeeeeeeeseeeessesseeneaenneeeeeeeeed 8 System Configurations for Interstage BPM Servev
38. system e Solaris e Linux If you intend to use Oracle 11g make sure that Oracle s JDBC driver version is V11 1 0 7 or higher If not get the JDBC driver having version V11 1 0 7 or higher and use it Oracle is now configured 5 1 3 Starting the Database Server Since configuration information must be written to the database during deployment ensure that the database server is running prior to deploying Interstage BPM Server Start the database server according to the documentation provided with your database server Interstage BPM Server and Console Installation Guide WebSphere Application Server 20 5 Preparing for Installation and Deployment of Interstage BPM Server and Console 5 2 Installing and Starting WebSphere Application Server You must have full administrative privileges on the system upon which you are installing WebSphere to perform any of the instructions described in this section Your operating system user name must be 12 characters or less in length Interstage BPM for WebSphere will not work properly on a computer with a hyphen or white space in its computer name Do not install WebSphere under a directory containing blanks in its name If you do you will not be able to properly configure your Java Plug in so your Interstage BPM Clients will not work properly For example on Windows do not install WebSphere under the c Program Files directory Refer to the Release Notes for the exact WebSphe
39. the JDBC driver class Example oracle jdbc driver OracleDriver Database connection URL Example jdbc oracle thin localhost 1521 ORCL Location of the database JDBC driver ojdbc14 jar for Oracle 10g ojdbc5 jar for Oracle 11g Example lt ORACLE BASE gt product 10 1 0 db_1 jdbc lib Database top level directory Example lt ORACLE BASE gt product 10 1 0 db_1 This directory is also referred to as lt ORACLE HOME gt Database directory Example on Windows C Oracle Product 10 2 0 oradata lt Database Name gt Example on Solaris u01 oradata lt Database Name gt Example on Linux u01 oradata lt Database Name gt Location of a JDK or JRE installation on the database server computer Interstage BPM Server and Console Installation Guide WebSphere Application Server 26 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server Interstage BPM Super User Account User name Example ibpm_ serverl Password Interstage BPM Tenant Owner Account The following information is not needed if you choose the SaaS mode but choose not to set up a default tenant Tenant Owner name Example default tenant Password Directory Service Settings Microsoft Active Directory The following configuration information is only needed if using Microsoft Active Directory Directory Service host name or IP address local or remote Dir
40. the other computers of your cluster as managed nodes Example If you are following the example add the computer IBPMHST2 as node ibpmhst2Node01 D 1 3 Adding a Cluster Prerequisite You have added the managed nodes that will be part of your cluster To add a cluster 1 In the Administrative Console for the WebSphere Deployment Manager expand Servers and click Clusters Click New Enter a name for your new cluster for example IBpMCluster Click Next Enter a name for the cluster member and select one of your nodes from the drop down list If you are following the example enter IBPMMember1 and select ibpmhst1Node01 ND 6 1 0 9 Change the weight to 1 and click Next Add the other nodes as members of your cluster For each member set the weight to 1 Then click Next If you are following the example enter IBPMMember2 and select ibpmhst2Node01 ND 6 1 0 9 On the Summary page check to make sure that the actions displayed are correct then click Finish to create the cluster Interstage BPM Server and Console Installation Guide WebSphere Application Server 120 Appendix D Clustering Load Balancing and Failover 8 In the message at the top of the page click Review Select Synchronize changes with Nodes and click Save to save the configuration D 1 4 Configuring Environment Variables To configure the required environment variables 1 Edit the environment variable script located in lt Interstage B
41. 0g 0jdbc5 jar for Oracle 11g on the local computer Example on Windows C Oracle Product 10 2 0 db_1 jdbc lib ojdbc14 jar Example on Solaris opt oracle product 10 2 0 db_1 jdbc lib ojdbcl4 jar Example on Linux opt oracle product 10 2 0 db_1 jdbc lib ojdbcl14 jar The Interstage BPM Server needs access to this driver to set up a connection to the database 3 If you are configuring a database on the local computer provide the following information e SYSTEM User s Password Enter the password of the SYSTEM user The system user is one of the administrative user accounts maintained by Oracle e Oracle Home Directory Specify the top level directory of your Oracle installation Example on Windows C Oracle Product 10 2 0 db_1 Example on Solaris opt oracle product 10 2 0 db_1 Example on Linux opt oracle product 10 2 0 db_1 Path to Store Data Files Specify a directory in which you want the Interstage BPM database to reside Example on Windows C Oracle Product 10 2 0 oradata lt Database Name gt Example on Solaris u01 oradata lt Database Name gt Example on Linux u01 oradata lt Database Name gt Interstage BPM Server and Console Installation Guide WebSphere Application Server 48 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server ote You must specify an existing directory and have write permissions for the specified directory JRE Home Directory Specify the to
42. 1 13 D 1 14 D 1 15 D 1 16 D 1 17 Appendix E E 1 E 2 E 2 1 E 2 2 Table of Contents Using the Configuration Export and Import Scripts cccsseseeeeeeeeeees 100 Silent Mode Installation cccceceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeees 104 Setting Up a Silent Mode Installation of Interstage BPM ccccsssseeeeees 104 Installing Interstage BPM in Silent Mode cccesssseceessseneeeeeseeeneeenseeneeeenees 105 Silent Mode Installation Options cccccceceeecesseeecee cess eee eeeeeeeseeeeeeeeeeeeeeneeeeees 106 Silent Mode DeployMe ntt cccceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeenenenes 108 Setting Up Silent Mode Operation c ccccceseeeeeee cece eee eeeeeneeeeneeeeeeeeeeeeeeeeees 108 Running Silent Mode Operations cccccccceessnneeeeeeeeeeeeeseeeeeeenseeeeeeensesneeeens 108 Silent Mode Deployment Options csceeecesseeeeeeeeee eee eeeeeeeeeaeeeeeeeeeeeeeeeeeees 109 Clustering Load Balancing and Failovel cccccceseeeeeeeeees 117 Setting Up an Interstage BPM Cluster on WebSphere Application Server 6 1 117 Preparing the Clustetiic ccc ce Ailend eee eee 118 Adding Managed Nodes i ciieescctveiccnctie tests fetes cette R ad tien tee 119 Adding ia CIU AE N avila Jacesdl A TE A 120 Configuring Environment Variables c ccccccccceecceeeseeneeeeeeeeeeeeeeseenaaeeeeeeenaees 121 Deploying Interstage BPM Applications To the Cluster
43. Agents in Interstage BPM To add a new Group using the GUI 1 Launch the Active Directory Console if you haven t already done so by selecting Start gt Settings gt Control Panel gt Administrative Tools gt Active Directory Users and Computers Expand the host name and the domain name to find the groups Organizational Unit 2 Right click groups 3 From the popup menu select New and then select Groups to open the New Object Groups dialog 4 Add the new Group s information and then click OK to add your new Group In the example below the Group Role is added New Object Group x 8 Create in example com groups Group name Role Group name pre Windows 2000 Role M Group scope Group type Domain local Security Global C Distribution Universal cme Figure 32 Adding New Groups Interstage BPM Server and Console Installation Guide WebSphere Application Server 88 10 Setting Up a Directory Service 5 Confirm the adding of the new Group by clicking Finish in the confirmation dialog box Use the New Object Groups dialog to create as many new user profiles as you want For each Group Active Directory requires you to provide a unique name for your Group 6 Add the new Group to IflowGroups so that the new Group is recognized by Interstage BPM To do so a Inthe Active Directory Users and Computers window expand the host name and the domain name to fi
44. Analytics information 1 Update the following parameters in console conf file e InterstageAnalyticsHostName e InterstageAnalyticsPort 2 Delete the ibpmaApiIF jar from WEBINF 1ib directory of the Console deployment directory Interstage BPM Server and Console Installation Guide WebSphere Application Server 66 7 Deploying only the Interstage BPM Console ote The location of this file can be different for different application servers e For WAS lt Interstage BPM Deployment Directory gt client InterstageBPMConsole ear console war WEB INF lib 3 Copy the following JAR files from WEB INF 1ib of the Analytics installation directory to WEBINF 1ib of the Console deployment directory e ibpmm jar e json lib 2 1 jdk13 fj jar e jakarta oro jar e ezmorph 1 0 4 Jjar e commons beanutils jar e commons collections 3 1 jar e commons lang 2 1 jar e commons logging jar 4 Restart the Application Server or the Console Web Application ote Only the user registered in Interstage Analytics can access analytics information from Console Ensure that your Interstage BPM Console username is also a registered Interstage Analytics username 7 5 2 Configuring the SOAP Listener Before you can configure the SOAP Listener you must make sure that your Interstage BPM Server and Console are running properly and that you are logged in to the Console For instructions refer Configuring Interstage BPM for WebSphere Ap
45. C driver refer to section Configuring Microsoft SQL Server on page 18 Example c MicrosoftSQLServer2005JDBCDriver sqljdbc_1 2 enu sqljdbc jar 4 If you are configuring a database on the local computer provide the following information e SQL Server Database Instance The default instance of Microsoft SQL Server is represented by a lt blank gt If you are using a named instance of Microsoft SQL Server enter the instance name e Database Host This field is set by the Deployment tool It is the host name or IP address of the computer that hosts the Microsoft SQL Server instance you are using e Database Port This field is set by the Deployment tool It is the port number of the Microsoft SQL Server instance you are using If you are using the default instance the port number is 1433 e Database Administrator Password Enter the password for the Microsoft SQL Server Administrator user account e SQL Server Home Directory Specify the top level directory of your Microsoft SQL Server installation typically c Program Files Microsoft SQL Server e Path to store Data files Specify a directory on a local disk in which the Interstage BPM database will reside typically c Program Files Microsoft SQL Server MSSQL 1 MSSQL Data The specified directory must already exist e JRE Home Directory Specify the top level directory of your J2SE Development Kit JDK or Java Runtime Environment JRE installation Example c Java jdk5 F
46. Console Installation Guide WebSphere Application Server 125 D 1 10 D 1 11 Appendix D Clustering Load Balancing and Failover Example If you are following the example select Node ibpmhst1Node01 Server IBPMMemberl 3 Click iFlowJDBCProvider 4 Check the classpath and make sure that the JDBC driver is in the path on that node If it is not in the specified location either change the path or copy the driver file to that location For more information about the required driver files refer to section Database Server Preparation on page 18 5 Repeat steps 2 4 for all servers of your cluster Defining a Virtual Host You need to define a virtual host in order to access the Interstage BPM Configuration Tool To define a virtual host 1 In the Administrative Console for the WebSphere Deployment Manager expand Environment and click Virtual Hosts Click New to create a virtual host Enter a name of your choice for example IBPMHost Click the name of the new virtual host then click Host Aliases Create a new alias with as the host name and a free port number for example 9081 Inthe message at the top of the page click Review Select Synchronize changes with Nodes and click Save to save the configuration Expand Applications and click Enterprise Applications Click InterstageBPMClusterApplication 8 On the Configuration tab click Virtual hosts Assign the virtual host that you created to the IBPMConfigSe
47. Create a file named ibpm uninst under the tmp location b Run the command pkgrm FJSVibpm to delete the Solaris package c Run the command pkginfo 1 FJSVibpm once more to ensure that the Solaris package has been deleted successfully If no information is displayed then it confirms that the Solaris package has been completely deleted from the Solaris platform For Linux Manually delete the RPM package information as follows Open the Command Prompt window and run the command rpm qi FUSVibpm from any location of the Linux machine to check if the RPM package still exists Ifthe RPM package information is displayed then delete the package information using the command rpm e FUJSVibpm Run the command rpm qi FJSVibpm once more to ensure that the RPM package has been deleted successfully If no information is displayed then it confirms that the RPM package has been completely deleted from the Linux platform The Interstage BPM installation program was unable to launch on Linux Cause The 1ibXp 1 0 0 8 i1386 rpm package is not installed on the Linux machine Interstage BPM Server and Console Installation Guide WebSphere Application Server 139 Appendix E Troubleshooting Action On the Linux machine do the following 1 Download the 1ibxp 1 0 0 8 1386 rpm package from your Red Hat Enterprise Linux CD or the Red Hat Network website 2 Install the package using the rpm i libXp 1 0 0 8 i386 rpm command 3 Retry l
48. Database Server and the Directory Server are configured correctly Use firewall configuration to block illegitimate requests 4 Cookie wiretap Use secure cookies if you are using cookies for session management Internal message Keep the Web Server Interstage BPM Server the Directory interception Server and the Database Server machines in a secure location Alternation of config file or Keep the Web Server Interstage BPM Server Directory Server database and Database Server machines in a secure location Set the operating system database permissions such that file database access is possible only by authorized people Take special care for the directories database of Interstage BPM Interstage Application Server Active Directory and Oracle Password suspectible to _ All guessed passwords should be changed to something that brute force attack is less vulnerable Passwords should not be proper nouns e g a person s name a word found in a dictionary or the same string as the user name Ideally a password should contain a minumum of 6 characters in a mixture of upper case lower case numeric digits and other characters In addition it should not contain more than two identical consecutive characters and more than two ascending or descending consecutive characters Password peep during the Install under the condition that no one is around you installation Remaining passwords could Secure the files created by the Deployment
49. Deployment Manager expand Resources gt JMS and click JMS providers From the scope list select a node of your cluster Example If you are following the example select ibpmhst1Node01 Click Default messaging provider On the Configuration tab click Connection factories Click New to create a new connection factory Enter the following settings Name If you are following the example use iFlowDistFactory e JNDI name If you are following the example use iFlow jms TopicDistConnectionFactory Bus name Select the bus that you previously created Interstage BPM Server and Console Installation Guide WebSphere Application Server 124 Appendix D Clustering Load Balancing and Failover If you are following the example select IBPMDistBus Provider endpoints Enter the nodes of your cluster as a comma separated list using the following syntax lt Hostname_1 gt lt Port gt BootstrapBasicMessaging lt Hostname_n gt lt Port gt BootstrapBasicMessaging If you are following the example enter IBPMHST1 7278 BootstrapBasicMessaging IBPMHST2 7278 BootstrapBasicMessaging ote To determine the correct port number go to Servers gt Application Servers gt lt Server Name gt gt Ports Check the port number of the StB_ ENDPOINT ADDRESS port For the other settings use the default values 6 Make sure that each JMS topic is mapped to the correct bus To do so a Return to the JMS providers gt Default messag
50. Failover During operation events are created and written to the database by each server node Events are tied to the server node that created them and will be processed by this server node If a server node goes down remaining events tied to this node will not be processed The processing of such events is resumed only when the server node is available again You can implement a failover mechanism such that events that cannot be processed are transferred to other server nodes in the load balancing system To do so you create a custom Java application that performs the following operations e Create an administration session that is a WrAdminSession object e Call recoverEvents serverName to transfer events from the server node that is passed as an argument to the other server nodes For general information on how to create a Model API application refer to the Interstage Business Process Manager Developer s Guide Details on WFAdminSession and recoverEvents can be found in the API Javadoc documentation Example This example demonstrates the processing of events in case one of two server nodes fails Interstage BPM Server and Console Installation Guide WebSphere Application Server 133 Appendix D Clustering Load Balancing and Failover A sample load balancing system with two server nodes has been set up While all of the server nodes are up and running events are created and written to the database by each server node
51. Fujitsu InterstageBPM on all computers in the cluster Example on Solaris If you install Interstage BPM in opt FISVibpm on the Deployment Manager computer it will be deployed to opt FJSVibpm on all computers in the cluster Example on Linux If you install Interstage BPM in opt FISVibpm on the Deployment Manager computer it will be deployed to opt FJSVibpm on all computers in the cluster On the WebSphere lt Version gt Application Server Configuration screen specify a node a cell and a server that do not exist Example dummyNode01 dummyNode01Cell dummyserverl When specifying a non existent node cell and server the Interstage BPM Deployment Tool creates a directory structure containing the Interstage BPM applications to be deployed to the cluster In a later step you will configure these applications before deploying them ote Do not specify an existing node cell or server If you do so the Deployment Tool deploys Interstage BPM to the specified location which is wrong for a cluster installation 3 Start the WebSphere Application Server on all computers that will be part of the cluster To do so use the following commands cd lt WebSphere Installation Directory gt AppServer profiles AppSrv lt Number gt bin startServer lt server gt Example startServer serverl D 1 2 Adding Managed Nodes To prepare for clustering your computers into a cell you must add your computers as managed nodes Intersta
52. Handling Pre 11 0 Console URLs In version 11 0 of Interstage BPM Console the Interstage BPM Console URL has been changed making older versions of URLs such as those of Remote SubProcesses Service Registry and so on incompatible when called from previous versions of Interstage BPM To overcome this problem deploy the Compatibility Proxy WAR provided in this release using the steps listed in this section Interstage BPM Server and Console Installation Guide WebSphere Application Server 78 9 Upgrading Interstage BPM from Previous Versions ote 1 Fora remote subprocess perform the steps listed here only in the following cases e When both the Parent and child process instances are running and you upgrade Interstage BPM on the parent server to v11 0 When the parent process is running but the child process instance has not yet started and you upgrade Interstage BPM on the child server to v11 0 2 Support for HTTPS is not available in this release In order to use the Compatibility Proxy for supporting pre V11 0 URLs the following requirements must be met When a pre V11 0 server is upgraded to V11 0 the Non SaaS mode should be selected during upgrade e The Compatibility Proxy should be deployed at the original pre V11 context root and the V11 Console should be deployed at a different context root For example if the pre v11 0 Console was deployed at the context root ibpmconsole then you should install the compatibi
53. If Microsoft SQL Server is already installed you may have to run the setup program again if the default selection from the prior installation enabled Named Pipes Run the Microsoft SQL Server setup again and add TCP IP However do not disable Named Pipes Both must be selected 2 Confirm that TCP IP is selected under Network Operations 3 Determine the port number of the Microsoft SQL Server instance that Interstage BPM will connect to To do so a Select Start gt Programs gt Microsoft SQL Server 2005 2008 gt Configuration Tools gt SQL Server Configuration Manager b Navigate to SQL Server Network Configuration gt Protocols for lt MSSQLInstance gt For the default instance the value of lt MSSQLInstance gt iS MSSOLSERVER c Confirm that TCP IP is enabled Then go to the TCP IP properties and click the IP Addresses tab The IPAII section displays the TCP port and TCP Dynamic Ports parameters d If you are using the default Microsoft SQL Server instance note down the value of TCP Port If you are using a named instance note down the value of the TCP Dynamic Ports You will need to specify the port number later when deploying the Interstage BPM Server 4 Install the SQL Server Driver for JDBC Interstage BPM Server and Console Installation Guide WebSphere Application Server 18 5 Preparing for Installation and Deployment of Interstage BPM Server and Console Microsoft does not provide a
54. Interstage BPM Server and Console Installation Guide WebSphere Application Server 137 E 2 4 E 3 Appendix E Troubleshooting Your application server administrator can increase the transaction timeout depending on your usage requirements for example to 200 seconds This setting can be changed in the following location e WebLogic application server lt WebLogic install dir gt config config xml lt jta gt lt timeout seconds gt e WebSphere application server In the WebSphere Console Servers gt ApplicationServers gt server1 default name gt Container Services gt Transaction Services gt Total Transaction lifetime timeout Failure in Writing to an Oracle Database When the updting of an Oracle database table fails for example when you try to archive a process instance check the Oracle alert log file located in the lt oracle Installation Dir gt admin lt DB instance name gt bdump directory for example C ProgramFiles Oracle admin orcl bdump alert orcl log The following error may be observed Database add create request failed ORA 08103 object no longer exists This failure may be due to the fact that the Datafile size reached the file size limit on the hard disk of the database server The system administrator of the database server needs to increase the file size on the database server hard disk Errors During Installation Deployment and Configuration This section lists several errors th
55. Java VM Donot launch Deployment Tool InstallShield Figure 8 Start Deplyment Tool For Windows Interstage BPM Server and Console Installation Guide WebSphere Application Server 36 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server For Solaris or Linux On the Start Deployment Tool screen select the Launch Deployment Tool check box and click Next 1O x Start Deployment Tool To start the Deployment Tool now select the check box below and click Next to continue To start the Deployment Tool later make sure that the check boxis not selected and proceed with the installation I Launch Deployment Tool 4S interstage InstallShield Cancel Figure 9 Start Deployment Tool For Solaris Linux If you want to configure and deploy Interstage BPM Server or Console at a later time make sure that you select the Do not launch Deployment Tool radio button Click Next and then Finish Refer Starting the Deployment Tool on page 37 for more information about launching the Deployment Tool at a later time The installation program exits If you selected to launch the Deployment Tool the Deployment Tool is started 6 5 Starting the Deployment Tool Prerequisites e You have prepared the database server and the application server as explained in chapter Preparing for Installation and Deployment of Interstage BPM Server and Console on page 18 e You
56. Java net SocketPermission target action connect resolve gt 6 11 Configuring Interstage BPM for WebSphere Application Server 6 1 and Starting Interstage BPM Server Prerequisite e Ifyou are using a Directory Service you must have configured that Directory Service for Interstage BPM For details refer to chapter Setting Up a Directory Service on page 82 e If you opted for SaaS mode during Server deployment you have switched on Java security For details refer Switching on Java Security on page 57 To configure Interstage BMP for WebSphere Application Server and to start WebSphere Application Server and Interstage BPM Server 1 Perform this step if the following applies e You are using WebSphere Application Server Network Deployment ND Edition e You have installed the Deployment Manager profile e You have added an application server node to the Deployment Manager s cell Change the Interstage BPM configuration as follows a In the WebSphere Administrative Console go to Servers gt Application Servers gt lt Server Name gt gt Ports Note down the port number of the BooTSTRAP_ADDRESS port b In the Interstage BPM configuration files that are listed below find the NamingProviderURL and JmsNamingProviderURL parameters and add the BOOTSTRAP ADDRESS port NamingProviderUrl iiop lt HOSTNAME gt lt BootstrapPort gt JmsNamingProviderUrl iiop lt HOSTNAME gt lt BootstrapPort gt Interst
57. L Server 2005 e Set this to false for Microsoft SQL Server 2008 sql_dbinstance Database instance of Microsoft SQL Server to be used The default instance is represented by a blank value db port 1433 Port on which Microsoft SQL Server is running sql _dbadminpassword adminpassword Password for the administrative database user account db_driverclassname com microsoft sqlserver Full package name of the JDBC jdbc SQLServerDriver driver class used to create the database connection db _connectionurl jdbc URL of the database to connect sqlserver localhost to 1433 databaseName teamf lowdb db _jdbclibrarypath C MicrosoftSQLServer Absolute path of the JDBC driver 2005JDBCDriver sqljdbc jar sqljdoc_1 2 enu sqljdbc jar db _databasehome C Program Files Absolute path to the top level Microsoft SQL Server directory of your Microsoft SQL Server installation sql dbdatafilesdir C Program Files Absolute path to the directory Microsoft SQL Server where the Interstage BPM MSSQL 1 MSSQL Data database resides db_javahome C dava jdk5 Absolute path to the top level directory of your JDK or JRE installation Interstage BPM Server and Console Installation Guide WebSphere Application Server 112 Appendix C Silent Mode Deployment Database Parameters Oracle Parameter Sample Value without Description spaces db_ibpmusername ibpmuser User name for a non administrative database user account
58. L Server Home Directory Bros Path to store Data files Browse Java Runtime Environment JRE Home Directory EEE o Cancel Figure 13 Database Configuration 1 In the Interstage Business Process Manager Database User area define the user name and password for a non administrative database user account An example of the user name is ibpmuser Interstage BPM will use this account to log into the database ote As a default Microsoft SQL Server enforces a password policy that prevents users from using simple passwords Make sure that you enter a password that meets the password policy requirements Otherwise the deployment will fail For details on the password policy refer to the Microsoft SQL Server documentation 2 Select the version of your SQL Server database 3 In the SQL Server Settings area enter the following information e DB Driver This field is set by the Deployment tool It is the full package name of the JDBC driver class used to create the database connection If you are using the JDBC driver provided by Microsoft the package name is com microsoft sqlserver jdbc SQLServerDriver If you are using another JDBC driver than the one provided by Microsoft refer to the driver documentation for information about the name of the driver class DB Connection URL This field is set by the Deployment tool This is the URL of the database to connect to If you are using the JDBC driver provided by Microsoft the database
59. M Server and Console Installation Guide WebSphere Application Server 70 8 Undeploying and Uninstalling Interstage BPM Server and Console b Select the checkbox es for the Interstage BPM component Server and or Console you want to undeploy W interstage Business Process Manager Deployment and Configuration aa Application Server Selection 10 x Select the application server on which the operation is to be performed 4 interstage Supported Application Servers Fujitsu Interstage Application Server 9 configured For SQL Serve wal Redhat JBoss 4 0 5 configured for Oracle and SQL Server Datasources BEA WebLogic Server 9 2 IBM Websphere Server 6 1 0 15 configured for Oracle and SQL Server Datasources Select the components I Interstage BPM Server J Interstage BPM Console Finish Cancel Figure 26 Application Server and Component selection sample screen 6 Click Next 7 On the WebSphere 6 1 Application Server Configuration screen specify the server instance that you want to remove Interstage BPM Server and Console Installation Guide WebSphere Application Server 71 8 2 8 Undeploying and Uninstalling Interstage BPM Server and Console Provide the information that you entered when creating the server instance For more information refer to section WebSphere Application Server Settings on page 41 W interstage Business Process Manager Deployment and Configuration 7 p oj xj WebSp
60. M as Interstage BPM Roles add them as members of the IflowGroups Group Adding New Users with an LDIF File You can add new users to Active Directory by manually editing the LDIF file then importing it To add new users with an LDIF File 1 Log on as an Administrator to the computer where the Active Directory domain controller is located 2 The Domain Security Policy is an administrative tool provided by Microsoft Access the Domain Security Policy for that computer e To display the Domain Security Policy on Windows Server 2003 navigate to Start gt Administrative Tools e To display the Domain Security Policy on Windows Server 2008 navigate to Start gt Administrative Tools gt Group Policy Management In the Group Policy Management Console navigate to Forest gt Domains gt lt DomainName gt gt Group Policy Objects Then right click Default Domain Policy and click Edit 3 Inthe Domain Security Policy Password Policy is an option in the respective tree view Windows Settings gt Security Settings gt Account Policies Ensure that the Password Policies of the Domain Security Policy are set using the following instructions Interstage BPM Server and Console Installation Guide WebSphere Application Server 83 10 Setting Up a Directory Service Make sure to remember the current settings to restore them in a later step e Minimum password length 0 characters e Password must meet complexity requirements Disabled 4 Co
61. Object User dialog New Object User Figure 29 Adding a New User 4 Enter the new user s information and click Next For each user Active Directory requires you to provide a first name last name full name and user login name Interstage BPM requires both a user login name and password to log in Interstage BPM Server and Console Installation Guide WebSphere Application Server 85 10 Setting Up a Directory Service 5 Enter the user s password and then click Next New Object User a Ej a E Figure 30 Adding a New User Interstage BPM Server and Console Installation Guide WebSphere Application Server 86 10 Setting Up a Directory Service 6 Confirm the adding of the new user by clicking Finish in the confirmation dialog New Object User x e Create in example com people When you click Finish the following object will be created Full name usert usert User logon name userl example com gi Figure 31 Adding a New User Use the New Object User dialog to create as many new user profiles as you want 7 Add the new user to IflowUsers so that the new user is recognized by Interstage BPM To do so a Inthe Active Directory Users and Computers window expand the host name and the domain name to find the main Organizational Unit that you specified during Interstage BPM installation b Right click the flowUsers Group and select Properties from t
62. PM Server Installation Directory gt server deployment WAS Cluster Operating System Environment Variable Script Solaris setIBPMenv sh Linux 2 Provide the appropriate values for the following variables CLUSTERNAME Cluster name that you defined in the Administrative Console for the WebSphere Deployment Manager Example CLUSTERNAME IBPMCluster E PASSWORD Password of the database user account that you defined during deployment of the Interstage BPM Server Note The password is required to deploy the Interstage BPM data sources and to import the updated server configuration into the database When the cluster setup is complete you can remove the password from the file Symbolic name of a cluster server The specified name will be appended to the name of some server parameters in order to make those names unique in a cluster environment You will configure this name later Server name that you defined in the Administrative Console for the WebSphere Deployment Manager You will configure this name later Node name that you defined in the Administrative Console for the WebSphere Deployment Manager You will configure this name later Interstage BPM Server and Console Installation Guide WebSphere Application Server 121 Appendix D Clustering Load Balancing and Failover Name of the cell to which the Deployment Manager and the clust
63. Server and Console Installation Guide WebSphere Application Server 118 Appendix D Clustering Load Balancing and Failover This script file is also located in lt Interstage BPM Server Installation Directory gt server deployment bin 3 Stop the execution of the multicast sender script If there are any remaining nodes that were not tested repeat step 2 for them In case of any problems contact your network administrator to make sure that the network is IP multicast enabled To prepare the cluster 1 Install the WebSphere Application Server on all computers that you want to include as managed nodes in your cluster Also install the WebSphere Deployment Manager For installation instructions refer to the WebSphere product documentation Example If you want to set up the sample cluster install WebSphere Application Server on computer IBPMHST1 and IBPMHST2 On DMGRHST install the WebSphere Deployment Manager 2 Install Interstage BPM for WebSphere on the computer where the WebSphere Deployment Manager has been installed Use the installation instructions in chapter Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server on page 23 with the following exceptions e Specify an installation path that can be used on all computers in the cluster Example on Windows If you install Interstage BPM in c Fujitsu InterstageBpM on the Deployment Manager computer it will be deployed to c
64. You can either set the environment variable in your profile file or in the shell before starting the Deployment Tool ote If you set the environment variable in the shell run the set a command so that the environment variable is set for all subshells created from the parent shell Overview of the Installation and Deployment Procedure This section summarizes the steps required to install and deploy the Interstage BPM Server with the Console or just the Server The installation and deployment procedure depends on whether the database and the application server are installed on the same or on different computers To connect to a Directory Service and log into Interstage BPM except for the default Interstage BPM user created during deployment you must configure and start the Directory Service before starting the Interstage BPM Server The best time for configuration is after deploying and before you start the Interstage BPM Server because the Deployment Tool creates an Interstage BPM LDIF file that you need to import into the Directory Service ote Ifyou are upgrading from a previous version of Interstage BPM refer Upgrading Interstage BPM from Previous Versions on page 75 Running the Database and Interstage BPM Server on the Same Computer 1 Prepare the database and make sure that the database server is running Refer to section Database Server Preparation on page 18 2 Prepare the application server and make sure that it is runnin
65. a 2 Security section ensure all checkboxes are selected 3 To the app policy file located in the lt webSphere Installation Directory gt config cells lt cell_name gt nodes lt node_name gt directory add the following grant permission java security AllPermission hy 4 Add the following permission to the policy xml file Refer the Interstage BPM Administration Guide for details about its location and how to edit this file lt permission className jJava lang RuntimePermission target modifyThread gt Interstage BPM Server and Console Installation Guide WebSphere Application Server 57 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server 5 Additionally in case the Server will output anything to the Systemout 1log and SystemErr log files add the following permissions for these files to policy xml lt permission className jJava io FilePermission target lt Path of SystemOut log gt action read write gt lt permission className jJava io FilePermission target lt Path of SystemErr log gt action read write gt Additional Settings for Custom Adaptors In case you intend to use Custom Directory Adapters to connect to remote server you need to add the following permission in the policy xml file Refer the nterstage BPM Administration Guide for details about its location and how to edit this file lt permission className j
66. add the IDs of all Interstage BPM users who will access administration functions in the Interstage BPM Console or create WFAdminSession objects through Java This Group should at least include the Interstage BPM Administrator account that you defined during deployment typically ibpm_serverl1l Interstage BPM Server and Console Installation Guide WebSphere Application Server 94 10 3 10 4 10 Setting Up a Directory Service Group Caching When the Interstage BPM Server starts up Interstage BPM connects to the Directory Service and copies all of the user and Group information defined in LDAPUsersDN and LDAPGroupsDN to a cache on the Interstage BPM Server This increases Interstage BPM performance because user and Group information no longer has to be retrieved from the Directory Service which might be running ona separate network computer It retrieves it from the LDAP Cache that is on the local computer in memory If the cache is not updated users added since the start of the Interstage BPM Server would not be able to login to or use Interstage BPM To avoid this the cache has to be updated periodically The LDAPGroupCacheAgeSec parameter of the Interstage BPM Server specifies how often the LDAP Cache is updated Groups that have been in service for longer than the period of time specified in the LDAPGroupCacheAgeSec parameter are checked and new user and Group information is retrieved from the Directory Service The default value for
67. age BPM Server and Console Installation Guide WebSphere Application Server 58 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server These are the configuration files that you need to check ibpm properties lt Interstage BPM Server Installation Directory gt server instance default iFlowClient properties lt Interstage BPM Server Installation Directory gt client 2 In the WebSphere Administrative Console go to Servers gt Application Servers gt lt Server Name gt gt Configuration gt General Properties gt Server specific Application Settings Ensure Classloader policy is set to Multiple This step is required to make Interstage BPM Console work correctly 3 This step is required only if you use Oracle 11g as a local or remote database In the WebSphere Administrative Console go to Resources gt JDBC gt JDBC Providers gt iFlowJDBCProvider gt General Properties In the Class path change the name of the JAR file from ojdbc14 jar to ojdbc5 jar 4 This step is required only if the WebSphere administrative security is on When WebSphere administrative security is on it causes Bus security to be on which in turn causes IBPM to function incorrectly Use the following steps to switch off Bus security a Log on to the WebSphere admin console and navigate to Service Integration gt Buses b On the Buses page in the IBPM bus row click the Enabled link c On the Confi
68. age name of the JDBC driver class used to create the database connection If you are using the JDBC driver provided by Oracle the package name is oracle jdbc driver OracleDriver If you are using another JDBC driver than the one provided by Oracle refer to the driver documentation for information about the name of the driver class e DB Connection URL This field is set by the Deployment tool It is the URL of the database to connect to If you are using the JDBC driver provided by Oracle the database connection URL has the following format jdbc oracle thin lt Hostname gt lt Database Port gt lt Database Name gt Here lt Hostname gt is the name of the computer on which Oracle is installed If the database and the application server are running on different computers make sure that you specify the actual hostname instead of localhost lt Database Port gt is the Oracle port number typically 1521 lt Database Name gt is exactly the same Oracle database name as specified when you created it Example jdbc oracle thin localhost 1521 ORCL ote You must specify thin as the protocol in the database connection URL If you are using another JDBC driver than the one provided by Oracle refer to the driver documentation for information about the database connection URL that you need to specify for that driver Path of the JDBC Driver JAR File Specify the path of the Oracle JDBC driver 0jdbc14 jar for Oracle 1
69. allation ote If you need to uninstall Oracle or require recovery from a failed installation contact Oracle Technical Support for instructions before reinstalling 5 Make sure that you know the TCP IP port number of the database The port number is typically set to 1521 6 On the database server computer create a directory in which the Interstage BPM database will reside Later when running the Interstage BPM Deployment Tool you will specify this directory as the location of the data files ote The user who will perform the database setup using the Deployment Tool must have write permissions for this directory 7 Ifyou are running your database on a remote computer you are recommended to make Oracle s JDBC driver 05dbc14 jar for Oracle 10g 0jdbc5 4ar for Oracle 11g available on the application server computer To do so Copy the JDBC driver file typically located in the lt oRACLE_HOME gt jdbc 1ib directory into a new directory on the application server computer Create a directory with an identifiable name because you must specify it as the driver location during the deployment of the Interstage BPM Server Example on Windows C myOracleJDBCJar Example on Solaris usr lib myOracleJDBCJar Example on Linux usr lib myOracleJDBCJar In the directory into which you copied the driver file change the file permission of the driver file to 666 ugo rw if you are installing on the following operating
70. ame lt HOSTNAME 1 gt lt BootstrapPort gt lt HOSTNAME n gt lt BootstrapPort gt cell clusters lt ClusterName gt JmsNamingProviderURL corbaname lt HOSTNAME 1 gt lt BootstrapPort gt lt HOSTNAME n gt lt BootstrapPort gt cell clusters lt ClusterName gt HostName lt HOSTNAME gt Serve rName lt HOSTNAME gt For java naming provider url NamingProviderURL and JmsNamingProviderURL specify the addresses of all nodes in your cluster Specify the BooTSTRAP_ADDRESS port as the port number Example If you are following the example on IBPMHST1 set the parameters to JmsFactory iFlow jms TopicDistConnectionFactory java naming provider url corbaname IBPMHST1 2809 IBPMHST2 2809 cell clusters IBPMCluster NamingProviderURL corbaname IBPMHST1 2809 IBPMHST2 2809 cell clusters IBPMCluster JImsNamingProviderURL corbaname IBPMHST1 2809 IBPMHST2 2809 cell clusters IBPMCluster HostName IBPMHST1 ServerName IBPMHST1 On IBPMHST2 set the parameters to JmsFactory iFlow jms TopicDistConnectionFactory java naming provider url corbaname IBPMHST1 2809 IBPMHST2 2809 cell clusters IBPMCluster NamingProviderURL corbaname IBPMHST1 2809 IBPMHST2 2809 cell clusters IBPMCluster JImsNamingProviderURL corbaname IBPMHST1 2809 IBPMHST2 2809 cell clusters IBPMCluster HostName IBPMHST2 ServerName IBPMHST2 D 1 14 Configuring the Shared Resource Root The ResourceRoot is a directory on a central s
71. ame gt nodes lt NodeName gt servers lt ServerName gt Example serverl The Deployment Tool does not check whether the provided names node name cell name server name are correct Make sure that you specify them correctly As node names cell names and server names are case sensitive make sure that the spelling is correct You can verify the names using the First steps script located in lt webSphere Installation Directory gt AppServer profiles AppSrv01 firststeps On Windows firststeps bat e On Solaris firststeps sh e On Linux firststeps sh 2 If you enabled administrative security during WebSphere installation do the following a Select Security Enabled b Enter the username and password of the administrator for your WebSphere Application Server 3 Inthe Java Runtime Environment area enter the top level directory of your J2SE Development Kit JDK or Java Runtime Environment JRE installation Example on Linux usr IBM WebSphere AppServer java jre ote You are recommended to use the JDK or JRE that is shipped with the application server e The JDK or JRE installation path must not contain blanks 4 If your database is running on the same computer as the application server you can configure the database and deploy the server with a single run of the Deployment Tool To do so select Configure Database on this Machine ote When selecting this option make sure that you have the required permissions to con
72. ase Notes Contains an overview of Interstage Business Process Manager installation tips and late breaking information that could not make it into the manuals Interstage Business Process Manager Server and Console Installation Guide Describes software and hardware requirements installation procedure for Interstage Business Process Manager Server and Console Interstage Business Process Manager Server Administration Guide Explains how to configure and administrate Interstage Business Process Manager Server This guide also describes the configuration parameters of the Interstage BPM Server Interstage Business Process Manager Developer s Guide Describes how to use the Interstage Business Process Manager API to customize and extend Interstage BPM to fit the unique needs of your organization Interstage Business Process Manager Studio User s Guide Explains how to model processes using the Interstage Business Process Manager Studio Interstage Business Process Manager Tenant Management Console Online Help Explains how to use the Interstage Business Process Manager Tenant Management Console user interface Interstage Business Process Manager Console Online Help Explains how to use the Interstage Business Process Manager Console user interface Interstage Business Process Manager ARIS Process Performance Manager Integration Guide Describes how to install and configure the PPM adapter and the PPM autoConfig tool With both programs process d
73. at could occur during the installation deployment and configuration of Interstage BPM and describes the required action s to take Installation of IBPM fails when trying to install a new build The build directory of the exisitng installed build was deleted without un installing the build or un installation failed Interstage BPM Server and Console Installation Guide WebSphere Application Server 138 Appendix E Troubleshooting Action For Windows Manually delete the earlier build s registry entry as follows Go to Start gt Run type regedit click OK In the Registry Editor screen go to HKEY_LOCAL_MACHINE gt SOFTWARE gt Fujitsu gt Install gt Interstage BPM Server Delete the Interstage BPM Server registry entry under Install key 4 Go to HKEY_LOCAL_MACHINE gt SOFTWARE gt Microsoft gt Windows gt CurrentVersion gt Uninstall gt Interstage Business Process Manager xx x Delete the Interstage Business Process Manager xx x registry entry under Uninstall key This will ensure complete deletion of the registry entry for Windows platform For Solaris Manually delete the Solaris package information as follows 1 Open the Command Prompt window and run the command pkginfo 1 FJSVibpm from any location of the Solaris machine to check if the Solaris package information still exists Ifthe Solaris package information is displayed then delete the package information using the following steps a
74. ata can be transferred from Interstage Business Process Manager to ARIS Process Performance Manager API Javadoc Documentation This HTML documentation provides the API and syntax of the packages interfaces and classes for developing custom applications or embedding Interstage Business Process Manager into other products Abbreviations The products described in this manual are abbreviated as follows e ARIS Process Performance Manager is abbreviated as ARIS PPM Interstage Business Process Manager is abbreviated as Interstage BPM Microsoft Windows Server 2003 is abbreviated as Windows Server 2003 Solaris Operating System is abbreviated as Solaris Microsoft SQL Server 2005 Standard Edition and Microsoft SQL Server 2005 Enterprise Edition Microsoft SQL Server 2008 Standard Edition and Microsoft SQL Server 2008 Enterprise Edition are abbreviated as Microsoft SQL Server Microsoft SQL Server or SQL Server Interstage BPM Server and Console Installation Guide WebSphere Application Server 10 About this Manual e Oracle 10g R2 Standard Edition Oracle 10g R2 Standard Edition One Oracle 10g R2 Enterprise Edition Oracle 11g Standard Edition Oracle 11g Standard Edition One Oracle 11g Enterprise Edition are abbreviated as Oracle e WebSphere Application Server is abbreviated as WebSphere Interstage BPM Server and Console Installation Guide WebSphere Applica
75. aunching the Interstage BPM installation program for Linux An error occurred during Interstage BPM database creation update Cause One of the following values provided during deployment were wrong e Database Administrator user name e Database Administrator password Action Restore the database from the backup of the database made before deploying Interstage BPM Run the Deployment Tool again and select Database Configuration on the Welcome screen In this way the database is configured without deploying Interstage BPM again j One of the following values provided during deployment were wrong Host name of the database server e Database SID database instance name e Database port Restore the database from the backup of the database made before deploying Interstage BPM Remove Interstage BPM from the application server and deploy it again using the Deployment Tool Cause Database server is not running Action Start the database server Run the Deployment Tool again and select Database Configuration on the Welcome screen In this way the database is configured without deploying Interstage BPM again An error occurred during the execution of importLpaP bat Cause One of the following values provided during deployment were wrong e LDAP Key e LDAP Organizational Unit Action Remove Interstage BPM from the application server and deploy it again using the Deployment Tool Interstage BPM Server and Console
76. connection URL has the following format Interstage BPM Server and Console Installation Guide WebSphere Application Server 45 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server jdbc sqlserver lt Hostname gt lt Database Port gt databaseName teamflowdb Here lt Hostname gt is the name of the computer on which Microsoft SQL Server is installed If this computer does not have a name use its IP address If the database and the application server are running on different computers make sure that you specify the actual hostname instead of localhost lt Database Port gt is the port number of the database server instance typically 1433 For instructions on verifying the port number refer to section Configuring Microsoft SQL Server on page 18 Example jdbc sqlserver localhost 1433 databaseName teamf lowdb ote Do not change the name of the database If you are using another JDBC driver than the one provided by Microsoft refer to the driver documentation for information about the database connection URL that you need to specify for that driver e Path of the JDBC Driver JAR File sqljdbc jar Specify the path of the JDBC driver sqljdbc jar on the local computer The Interstage BPM Server needs access to this driver to set up a connection to the database For information about supported versions of the JDBC driver refer to the Release Notes For more information about the JDB
77. d navigate to it JDK Directory cajasdk Browse 87 interstage InstallShield _ Cancel Figure 7 JDK JRE Directory for Solaris Linux 7 Click Next 8 Make sure that the information displayed on the Pre Installation Summary screen is correct 9 Click Next to start the installation The installation program starts copying files to your computer Once the files have been copied the Start Deployment Tool screen is displayed 10 To launch the Deployment Tool do one of the following For Windows On the Deployment Tool Option Screen screen if you want to proceed with the initial configuration select Launch Deployment Tool check box A 64 bit JVM specific Deployment Tool and a 32 bit JUVM specific Deployment Tool are provided for Windows Server 2003 and Windows Server 2008 1 Select the appropriate radio button to launch the 32 bit specific or 64bit specific Deployment Tool Interstage BPM Server and Console Installation Guide WebSphere Application Server 35 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server 2 Click Next Deployment Tool Option Screen To launch the Deployment Tool now select the appropriate radio button and click Next The radio button to be selected depends on the version of the JDK you specified in the Select Java Home Directory Screen Launch Deployment Tool with 32 bit Java VM Launch Deployment Tool with 64 bit
78. dapter 2 Inthe Interstage Business Process Manager Tenant Owner Account area enter a user name and password for the tenant owner The tenant owner role is the administrator for the default tenant account If you selected a Directory Service by default the user account defined on this screen is also used to log into the Directory Service You can also use a different user To do so you must change the LDAPAccessUserID and LDAPAccessUserPassword configuration parameters of the Interstage BPM Server Refer to the nterstage Business Process Manager Server Administration Guide for more information 3 Click Next Interstage BPM Server and Console Installation Guide WebSphere Application Server 51 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server The screen appearing next depends on the type of Directory Service you selected 6 7 9 Sun Java System Directory Settings On the LDAP Configuration screen you provide the settings for Sun Java System Directory W interstage Business Process Manager Deployment and Configuration 10 x LDAP Configuration The Following field s are either empty or not of expected type LDAP Host LDAP Key 4 interstage LDAP Host LDAP Key LDAP Organizational Unit OU ou Groups LDAP Port 389 Finish Cancel Figure 17 LDAP Settings 1 Enter the following information LDAP Host Enter the name of the computer on which your LDAP server is r
79. ddress in the range 224 0 0 0 to 239 255 255 255 inclusive It is used to identify the members of a multicast group Each member of the group uses the same multicast group address The address 224 0 0 0 is reserved and must not be used If you want to change the default settings add the relevant parameters to the configuration file on one of the cluster nodes ClusterMulticastPort lt Multicast Port Number gt ClusterMulticastTopic lt Multicast Group Address gt ote If already present in the configuration file ensure these parameters are not empty ote As the multicast parameters are identical for all cluster servers you only need to add them to the configuration file on one of the cluster nodes 5 Oneach cluster node make sure that all of the parameters listed below are set in the configuration file and have the values specified below If a parameter is not present in the configuration file you need to add it to the file ImsNotificationTopic iFlow jms TopicDistConnectionFactory iFlow jms NotificationTopic JImsSQNotificationTopic iFlow jms TopicDistConnectionFactory iFlow jms sq SQNotificationTopic JmsNamingProviderURL corbaname lt HOSTINAME 1 gt lt BootstrapPort gt lt HOSINAME n gt lt BootstrapPort gt oel1 clusters lt ClusterName gt ServerHost lt HOSTNAME gt Example If you are following the example on IBPMHST1 set the parameters to JmsNotificationTopic iFlow jms TopicDistConnectionFactory iFlow jms No
80. ding and update detection link The class loader details page appears Integrated Solutions Console welcome Help Logout view All tasks z Welcome E Guided Activities E Servers E Applications Enterprise Applications Install New Application E Resources E Security E Environment E System administration E Users and Groups E Monitoring and Tuning E Troubleshooting E Service integration E uUDDI e Applicatior Enterprise Applications Enterprise Applications gt InterstageBPMConsole gt Class loader Use this page to configure the reloading of classes when application files are updated Configuration General Properties Field help Specifies whether there is one class loader for all WAR files in the application or a separate class loader for each WAR file in the application Page help M Reload classes when application files are updated Polling interval for updated files 3 Seconds Class loader order Classes loaded with parent class loader first C classes loaded with application class loader first WAR class loader policy class loader for each WAR file in application E single class loader for application Apply OK Reset Cancel More information about this page Figure 21 Enterprise Application Class Loader Details Page 6 In the WAR class loader policy section select the Single class loader for application option and click Apply Save your
81. dows Server 2003 and Windows Server 2008 e Use the 64bit Deployment Tool only if both your Operating System as well as Java Environment JVM is 64bit If used otherwise the Deployment Tool will fail to start e When both Operating System and JVM is 64bit do not launch the Deployment Tool through the final screen of the Installation Wizard using the Launch Deployment Tool checkbox Doing so launches the 32bit Deployment Tool causing a failure in the launch of the Deployment Tool e Irrespective of your Operating System if your JVM is 32bit use the 32bit Deployment Tool e 32bit Operating Systems and 64bit JVM are incompatible and using this combination will cause launch of Deployment Tool to fail irrespective of the version of Deployment Tool To start the 64bit JVM specific Deployment Tool do one of the following e Run the run windows x64 bat Startup script located in lt Interstage BPM Installation Directory gt server deployment tool e Onthe Windows Start menu navigate to All Programs gt Interstage Business Process Manager and click Launch Deployment Tool 64 bit Configuring the Remote Database Prerequisite You have prepared the database server as instructed in section Database Server Preparation on page 18 This section describes how to run the Deployment Tool on the database server computer to configure the database You will typically perform the instructions in this section only if your database is installed
82. e Instructions for setting up your Directory Service Appendix A Security Instructions for security implementation on Interstage BPM Appendix B Silent Mode Installation Instructions for using the Silent Mode installation feature of Interstage BPM Appendix C Silent Mode Deployment Instructions for running the Interstage BPM Deployment Tool in Silent Mode Appendix D Web Services Interfaces Information about Command Interface Web Services Appendix E Clustering Load Balancing and Instructions for setting up a Failover cluster of Interstage BPM Servers Appendix F Troubleshooting Information to help you troubleshoot problems associated with using Interstage BPM Screenshots of the products that appear in this manual are approximations only What you see when using the product may differ in appearance due to platform or product version differences Typographical Conventions The following conventions are used throughout this manual Example Meaning command Text which you are required to type ata command line is identified by courier font screen text Text which is visible in the user interface is bold Reference Reference material is in italics Parameter A command parameter is identified by courier font Interstage BPM Server and Console Installation Guide WebSphere Application Server 9 About this Manual Other References The following references for Interstage Business Process Manager are also available Rele
83. e default Interstage BPM users and Groups The IBPMLDAPAdd 1dif file also contains information about access permissions required to run Interstage BPM e Add users and Groups to the Directory Service Interstage BPM Server and Console Installation Guide WebSphere Application Server 92 10 Setting Up a Directory Service 10 2 1 Starting the Sun Java System Directory Server Prerequisite e Install the Sun Java System Directory Server e Create a Directory Server Instance You can start the directory server using Directory Service Control Center through JavaWeb Console By default the URL to access Java Web Console is https hostname 6789 For details refer Sun Java SystemDirectory Server Enterprise Edition 6 3 Installation Guide 10 2 2 Importing the IBPMLDAPAdd Idif File Prerequisites Create a suffix for the Directory Server Instance The IBPMLDAPAdd 1dif file contains the default Interstage BPM users and Groups The IBPMLDAPAdd 1dif file also contains information about access permissions required to run Interstage BPM To import the IBPMLDAPAdd 1dif file 1 Make sure that you have the IBPMLDAPAdd 1dif file in the lt Interstage BPM Server Installation Directory gt client samples configuration directory 2 Copy the IBPMLDAPAdd 1dif file to a computer in which the Directory Server is running 3 Run the ldapmodify command on the computer in which the Directory Server is running The ldapmodify command is ty
84. e following the example use the following values in the environment variable script E NAME ibpmhst2Node01 ERVER NAME IBPMMember2 5 In the Administrative Console for the WebSphere Deployment Manager resynchronize all nodes with the Deployment Manager repository To do so use System administration gt Nodes gt Full Resynchronize D 1 7 Configuring Service Integration Buses To configure service integration buses 1 Inthe Administrative Console for the WebSphere Deployment Manager delete some local topic destinations that are not used in a cluster To do so a Expand Service integration and click Buses A list of buses appears on the Buses page b Click the bus that is configured for one of your nodes Example If you are following the example click ibpmhst1Node01IBPMBuss c On the Configuration tab click Destinations d Delete the following topics from the Destinations page e JmsNotification Topic Space Interstage BPM Server and Console Installation Guide WebSphere Application Server 123 Appendix D Clustering Load Balancing and Failover e SQNotification Topic Space e In the message at the top of the page click Review Select Synchronize changes with Nodes and click Save to save the configuration f Return to the Buses page and repeat substeps b e for all nodes of your cluster Return to the Buses page and click New to create a new bus Enter a name of your choice for e
85. ectory search string Example dc fujitsu dc com Organizational unit Example ou Groups Directory Service port number not the admin port number Example 389 Directory Server Settings Sun Java System Directory Server The following configuration information is only needed if using Sun Java System Directory Server Directory Server host name or IP address local or remote Directory search string Example dc fujitsu dc com Interstage BPM Server and Console Installation Guide WebSphere Application Server 27 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server Organizational unit Example ou Groups Directory Server port number not the admin port number Example 389 Mail Server Settings SMTP server host name Note If you do not enter a SMTP server host name Interstage BPM s email notification feature will be disabled Consult your system administrator and your email Administrator for the correct host names since the Interstage BPM Server will not start if the SMTP server host name is incorrect If you are in doubt leave this field blank and change the configuration of the Interstage BPM Server later Refer to the Interstage Business Process Manager Server Administration Guide for details Interstage BPM Tenant Owner s email address can be any active email address WebDAV and UDDI Server Settings WebDAV and UDDI Server Setting Your Value
86. elete the folders listed above from the other server nodes 4 On Windows on each server node update the lt Path gt tag of DmsCollections xm1 file located IN lt Interstage BPM Server Installation Directory gt server instance default tenants Default resources to specify the attachments directory on the file server Use one of the following formats to specify the directory s path lt Remote Computer Name gt lt Directory Name gt lt Remote Computer Name gt lt Directory Name gt Example lt DmsCollections gt lt Dms gt lt Path gt MyFileServer InterstageBPMShared tenants Default attachments lt Path gt lt ImplementationClass gt com fujitsu iflow dmsadapter impl FileSystemDmsSessionImpl lt ImplementationClass gt lt Name gt Attachments lt Name gt lt Dms gt lt DmsCollections gt ote Do not use a network drive in the path specification For example like in lt Path gt P InterstageBPMShared tenants Default attachments lt Path gt Network drives cannot be accessed by the Interstage BPM Server 5 Perform the subsequent steps if you are installing on the following operating system e Solaris e Linux a On each server node mount the attachments directory that you copied on the file server b On each server node update the DmsCollections xml file located in lt Interstage BPM Server Installation Directory gt server instance default tenants Default resources to specify the attac
87. ent Manager computer where you installed Interstage BPM update your environment a Edit the environment variable script located in lt Interstage BPM Server Installation Directory gt server deployment WAS Cluster On Windows set IBPMenv cmd On Solaris setIBPMenv sh On Linux set IBPMenv sh b Set the NODE NAME and SERVER_NAME parameters to the values of one of your nodes Interstage BPM Server and Console Installation Guide WebSphere Application Server 122 Appendix D Clustering Load Balancing and Failover You can determine the correct values in the Administrative Console for the WebSphere Deployment Manager Go to Servers gt Clusters gt lt Name of Your Cluster gt gt Cluster members The Cluster members page displays the node name and the member name which corresponds to the server name Example E NAME ibpmhst1Node01 ER NAME IBPMMember1 2 On the Deployment Manager computer run the relevant datasource deployment script located in lt Interstage BPM Server Installation Directory gt server deployment WAS Cluster 3 On the Deployment Manager computer run the resource installation script located in lt Interstage BPM Server Installation Directory gt server deployment WAS Cluster On Windows installResources bat On Solaris installResources sh On Linux installResources sh 4 Repeat steps 1 3 for the other nodes of your cluster If you ar
88. er Installation Directory C FujitsuilnterstageBP M Browse 8 interstage InstallShield Cancel Figure 5 Server Installation Directory for Solaris Linux 5 Click Next 6 On the Java Development Kit JDK Location screen specify the top level directory of your J2SE Development Kit JDK or Java Runtime Environment JRE installation If the default directory is not the top level directory of your JDK or JRE installation click Browse and navigate to it For information on the supported JDK and JRE version refer to the Release Notes Interstage BPM Server and Console Installation Guide WebSphere Application Server 33 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server ote The JDK or JRE installation path must not contain blanks interstage Business Process Manager InstallShield Wizard Select Java JDKAJRE 1 5 Home Directory Please mention the path to the top level directory of your JDKAJRE installation or click Browse and navigate to it Browse Cancel Figure 6 JDK JRE Directory for Windows Interstage BPM Server and Console Installation Guide WebSphere Application Server 34 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server O x Ix at Java Development Kit JDK Location Enter the path to the top level directory of your JDK JRE installation or click Browse an
89. er nodes belong To determine the cell name in the Administrative Console for the WebSphere Deployment Manager go to System administration gt Cell Example CELL _NAME dmgrhstCell01 D 1 5 Deploying Interstage BPM Applications To the Cluster Prerequisites e You have defined a cluster and added the members to the cluster using the Administrative Console for the WebSphere Deployment Manager e You have configured the required environment variables as explained in section Configuring Environment Variables on page 121 To deploy Interstage BPM to the cluster 1 On the Deployment Manager computer run the deployment script located in lt Interstage BPM Server Installation Directory gt server deployment WAS Cluster On Windows Deploy bat On Solaris Deploy sh On Linux Deploy sh The script deploys the server application to the cluster 2 Resynchronize all nodes with the Deployment Manager repository To do so a Open the Administrative Console for the WebSphere Deployment Manager b Expand System administration and click Nodes c Select all nodes of your cluster and click Full Resynchronize D 1 6 Deploying Interstage BPM Data Sources and Resources To the Cluster Prerequisite You have configured the required environment variables as explained in section Configuring Environment Variables on page 121 To deploy the Interstage BPM data sources and resources to the cluster 1 On the Deploym
90. er the directory sub tree where groups and users to be used with Interstage BPM are stored Active Directory Organizational Unit OU Enter the organizational unit where groups to be used with Interstage BPM are stored Active Directory Port Enter the port number of your Active Directory server After deployment you need to configure your Directory Service for Interstage BPM Refer to section Setting Up Microsoft Active Directory on page 82 for more information 2 Click Next 6 7 11 Other Settings On the Other Settings for Default Tenant screen you specify settings for the following external systems Specifying these settings is optional e Interstage BPM Analytics Interstage BPM Server and Console Installation Guide WebSphere Application Server 53 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server Interstage BPM Analytics can be used for analyzing and evaluating the process data from the Interstage BPM Server e WebDAV Repository Interstage BPM can be integrated with any WebDAV compliant repository in order to publish metadata for process definitions to that repository The examples used below are for CentraSite If you do not know the settings for your particular WebDAV repository refer to the instructions for using your WebDAV repository software e UDDI Registry Interstage BPM can be integrated with any UDDI compliant registry in order to publish process definition in
91. eration there are additional variations depending on the application server database and Directory Service you are using ote Only use the Silent Mode script for the type of operation that you recorded You can customize the script to make it run properly in a different environment For example you might have your database installed on a different drive and in a different directory than on the computer where you recorded the script The following tables list the parameters that you may change in the script A short description of the parameters is also provided For detailed information about the parameters refer to chapter nstalling and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server on page 23 Interstage BPM Server and Console Installation Guide WebSphere Application Server 109 Appendix C Silent Mode Deployment ote Only change parameters that are described below Do not change any other parameters Do not not add or delete parameters Otherwise your script might not work properly e Any backslashes colons or equal signs used in parameter values must be escaped by backslashes For example a server address is specified like this ibpmhost 49950 WebSphere Application Server Parameters Parameter Sample Value without Description spaces websphere profilehome On Windows C IBM WebSphere Absolute path to the root directory of the WebSphere AppServer pr
92. erver the key needs to be present in the server s configuration Therefore before starting the server use the configuration export and import scripts to add the following parameter to the server s configuration Encryptionkey lt Key gt For details on the procedure refer to section Using the Configuration Export and Import Scripts on page 100 For security reasons the key can be removed again from the configuration file that you imported into the database Alternatively you can encrypt all passwords in the configuration file at the same time before importing it into the database To do this substitute all passwords in the configuration file with actual text passwords and encrypt the configuration file by running the script with the following options On Windows EncryptPassword bat f lt Path of Configuration File gt lt Key gt On Solaris EncryptPassword sh f lt Path of Configuration File gt lt Key gt Interstage BPM Server and Console Installation Guide WebSphere Application Server 98 A 3 Appendix A Security On Linux EncryptPassword sh f lt Path of Configuration File gt lt Key gt YP ote Make sure to enclose the file path and the encryption key in double quotes Otherwise the encryption process might fail As double quotes are delimiters do not use double quotes in the encryption key The following parameters in the configuration file are encrypted using this method e DBALoginpas
93. erver configuration refer to the interstage Business Process Manager Server Administration Guide All files from the previous agents folder e All files from the previous calendar folder e The resources DataSourceDefinition xml file e The resources fileListenerConf xml file e The DmsCollections xml file and the directories specified in it these directories contain data that users have previously uploaded 2 Uninstall the previous version of Interstage BPM according to the instructions for that version 3 Make sure that you have the required permissions for installation and deployment For details refer to section Permissions Required for Installation and Deployment on page 29 4 Install Interstage BPM Server according to the instructions in section Installing Interstage BPM on page 31 5 Upgrade your database as follows a If the Deployment Tool is not running start it using the instructions in section Starting the Deployment Tool on page 37 On the Welcome screen of the Deployment Tool select Database Upgrade c Click Next d On the Database Selection screen select the database system you are using e Click Next f On the Database Configuration screen specify the settings for your database If you are using Oracle refer to section Oracle Settings on page 47 for a detailed explanation If you are using Microsoft SQL Server refer to section Microsoft SQL Server Settings on page 44 for a detailed explanation
94. erver containing resources such as workflow applications file listeners shared classes and so on In a load balancing system the ResourceRoot directory must be located on a central server that can be accessed by all server nodes all server nodes must use the same ResourceRoot directory Each server node must be configured to access the ResourceRoot directory on that central server The server nodes are allowed to map those directories to different physical paths as long as they use the same symbolic name for the directory To configure your ResourceRoot 1 Onacentral server create a ResourceRoot directory Make sure that all server nodes have read and write access to this directory Example In the sample system a file server is used to host the ResourceRoot directory You could create a directory named InterstageBPMShared 2 Create the tenants Default folders under the ResourceRoot directory For example MyFileServer InterstageBPMShared tenants Default Interstage BPM Server and Console Installation Guide WebSphere Application Server 130 Appendix D Clustering Load Balancing and Failover 3 Do the following a From the WebSphere Deployment Manager computer s lt Interstage BPM Installation Directory gt server instance default tenants Default directory move the following folders to the tenants Default folder under the ResourceRoot directory apps e attachments e classes e dmsroot lib b Also d
95. ervice mode and also choose whether you want to create a default tenant or not If you select the SaaS mode you will be set up as a Super User and be allowed to create multiple tenant users to whom you can provide the Interstage BPM as a software service over Interstage BPM Server and Console Installation Guide WebSphere Application Server 49 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server a network However your functionality will be limited to only managing tenants and the Interstage BPM Server if you also need to use Interstage BPM just as a tenant would and also work with the default System application you can choose to set up a default tenant b Select Non SAAS Mode if you intend to use Interstage BPM in the non SAAS mode ote Ensure you select Non SAAS Mode if you are upgrading from previous versions of Interstage BPM In the non SaaS mode the default tenant tenant owner with the default System application will be set up you will not be allowed to create any further tenants nor provide Interstage BPM as a software service All Interstage BPM functionality will be accessible only through this default tenant For more information about Interstage BPM s SaaS feature refer the Interstage Business Process Manager Developer s Guide ote The default tenant that is set up is named Default 4 Click Next Interstage BPM Server and Console Installation Guide WebSphere Ap
96. etting Up a Directory Service The user or Group appears in the bottom text area of the dialog Select Users Contacts or Computers user userl juserl example com Figure 34 Selecting a User 6 Click OK Interstage BPM Server and Console Installation Guide WebSphere Application Server 91 10 Setting Up a Directory Service The user appears with the existing users in the Properties dialog General Members Member Of Managed By Members Name Active Directory Folder ibpm_example Add Remove Cancel Apply Figure 35 New Member Added 7 Tothe AdminRole Group add the IDs of all Interstage BPM users who will create wFAdminSession objects through Java This Group should at least include the Interstage BPM Administrator account that you defined during deployment 10 2 Setting Up Sun Java System Directory Server Sun Java System Directory Server formerly known as iPlanet Server uses a form of the Lightweight Directory Access Protocol LDAP Like all LDAP type Directory Services it organizes people into Groups and maintains a user profile with the appropriate permissions for each user To use Interstage BPM with Sun Java System Directory Server you must customize your Sun Java System Directory Server installation as follows e Start the Sun Java System Directory Server e Import the TBPMLDAPAdd 1dif file into your Sun Java System Directory Server The IBPMLDAPAdd 1dif file contains th
97. exportProperties sh MyServerConfiguration properties SomeUserName SomePassword For Tenant Properties exportProperties sh lt File Name gt lt Database User Name gt lt Password gt lt TenantName gt Note that lt TenantName gt is case sensitive Example exportProperties sh MyServerConfiguration properties SomeUserName SomePassword Default For lt File Name gt specify the file name and optionally the path of the configuration file to be generated If you do not specify a path the configuration file is written to the current directory For lt Database User Name gt and lt Password gt specify the database user account that you defined during deployment of the Interstage BPM Server ote Before you make any changes to the Server configuration make a copy of the server configuration file you exported as a back up In case you make errors while editing parameters Interstage BPM Server may not be able to start or errors may occur at runtime In such a case you can import the back up file which contains a working configuration Interstage BPM Server and Console Installation Guide WebSphere Application Server 101 Appendix A Security 2 Make the required changes in the generated configuration file If you want to add parameters use the following syntax lt Parameter Name gt lt Parameter Value gt Parameter names and values are case sensitive Any backslashes or colons used in paramete
98. figure the database Otherwise the deployment process will fail For details refer to section Permissions Required for Installation and Deployment on page 29 If you do not have the required permissions you may need to run the Deployment Tool twice first to configure the database and then to deploy the server ote If you are deploying only Interstage BPM Console this database option will not appear on the application configuration screen 5 Click Next Interstage BPM Server and Console Installation Guide WebSphere Application Server 43 6 7 3 6 7 4 6 7 5 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server interstage BPM Console Settings Prerequisites You have selected to deploy Interstage BPM Console in the Deployment Tool s Application Server and Component Selection page Operation Mode and Application Server Selection on page 40 Console Settings On the Console Configuration page you provide the settings for Interstage BPM Console For details refer section Deploying Interstage BPM Console Using the Deployment Tool on page 65 Database Selection 1 On the Database Selection screen select the database system you wish to use ote Refer to the Release Notes for the exact versions and editions of the supported database systems 2 Click Next The next appearing screen depends on the database system that you selected Microsoft SQL Server Settings Prerequ
99. formation and search for Web Services The examples used below are for CentraSite If you do not know the settings for your particular UDDI registry refer to the instructions for using your UDDI registry software W Interstage Business Process Manager Deployment and Configuration Bel x Other Settings for Default Tenant Select additional configuration options and specify the required settings All Fields are Optional 4Y interstage General Settings Email Address of the Interstage Business Process Manager Administrator T Enable Interstage Business Process Manager Analytics monitoring M WebDAV Repository Settings Publish Metadata to WebDAY Repository Metadata Username Metadata Password M Publish to UDDI Registry r Enable Publishing to UDDI Registry uppiBusinessName UDDI Publish URL UDDI Publish Username fo UDDI Publish Password fo Search UDDI Registry Enable Search in UDDI Registry UDDI Search URL Cancel Figure 19 Other Settings 1 In the General Settings area enter the following information Email Address of the Interstage Business Process Manager Administrator Specify the email address or alias email address of the Interstage BPM Tenant Owner This address will appear in the From field on all email messages sent from the Interstage BPM Server This includes all email notifications work item escalations timer resolution messages etc e Enable Interstage B
100. g Refer to section Installing and Starting WebSphere Application Server on page 21 Interstage BPM Server and Console Installation Guide WebSphere Application Server 29 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server Install Interstage BPM Refer to section Installing Interstage BPM on page 31 Configure the Interstage BPM Server and Console or only the Server and deploy it to the application server Refer to section Deploying Server Instances with Console OR only Server Instances on page 39 If you want to connect to a Directory Service you must configure it before starting the Interstage BPM Server Refer to chapter Setting Up a Directory Service on page 82 If you opted for SaaS mode during Server deployment switch on Java security Refer to section Switching on Java Security on page 57 Start the Interstage BPM Server Refer to section Configuring Interstage BPM for WebSphere Application Server 6 1 and Starting Interstage BPM Server on page 58 If you have also deployed the Console start Interstage BPM Console Refer to section Starting Interstage BPM Console and Tenant Management Console on page 61 If required perform further configurations for Interstage BPM Console Refer section nterstage BPM Console Other Configurations on page 66 Running the Database and Interstage BPM Server on Different Computers 1 Prepare the database and ma
101. g UDDI registry information 4 If you want to search a UDDI registry select Enable search in UDDI Registry and enter the UDDI search location This option allows you to search the UDDI registry using a dialog that is part of the Process Designer tool in the Interstage BPM Console For CentraSite use the following URL http lt hostname gt 53307 UddiRegistry inquiry 5 Click Next 6 7 12 Starting the Deployment The Review Information screen summarizes the selected operations 1 Make sure that all the information displayed on the Review Information screen is correct 2 If you want to generate a script that can be used for silent deployment of the Interstage BPM Server select Generate properties file for silent operation mode Interstage BPM Server and Console Installation Guide WebSphere Application Server 55 6 8 6 9 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server A silent mode deployment is a non interactive type of deployment which may save a significant amount of time You may want to consider using the silent mode deployment if you have to perform multiple deployments of the Interstage BPM Server and the configurations are essentially the same For further information refer to appendix Silent Mode Deployment on page 108 ote Plain text passwords will be written to the properties file As this may pose a security problem make sure that you protect the properties fi
102. g the Configuration Export and Import Scripts on page 100 Configuring SMTP Authentication for Use with Interstage BPM ote Only a System Administrator should perform these instructions If you required SMTP Authentication for logging in to Interstage BPM use the following instructions 1 Set up an email server and enable SMTP Authentication 2 Add the following parameters to the server configuration SMTPServerHost lt Email Server Host Name gt SMTPUserName lt User Name for SMTP Authentication gt SMTPPassword lt Password for SMTP authentication gt For details on the procedure refer to section Using the Configuration Export and Import Scripts on page 100 3 Design a process definition to test the email feature Refer to the Interstage Business Process Manager Studio User s Guide for information on how to design process definitions If the SMTPUserName OF SMTPPassword are set correctly the email will be accepted by the email server If neither the SMTPUserName nor SMTPPassword values are blank Interstage BPM will use the SMTP authentication feature Using the Configuration Export and Import Scripts Prerequisite The database server is running Interstage BPM comes with configuration export and import scripts that allow you to change the server configuration You can use these scripts to add parameters that are not present in the configuration or remove parameters from the configuration If the server fail
103. ge BPM Server and Console Installation Guide WebSphere Application Server 119 Appendix D Clustering Load Balancing and Failover To add the managed nodes for the cell 1 Start the Administrative Console for the WebSphere Deployment Manager http lt hostname gt lt port gt ibm console If you are following the example you start the Administrative Console on DMGRHST using the following URL http dmgrhst 9060 ibm console Expand System administration and click Nodes Add a new node as follows a Click Add Node b Select Managed Node and click Next c In the Host field enter the host name or IP address of one of your node computers Example 1BPMHST1 d Select the Include applications and Include buses check boxes but leave the other settings as default Click OK e On Windows select the Run node agent as Windows service check box Click OK It may take several minutes for the Deployment Manager to add the node Wait while this configuration is in progress Example If you are following the example the computer IBPMHST1 is added as node ibpmhst1Node01 This node appears on the Nodes page Make sure that the node is configured correctly This is indicated by the green color of the status icon If the status icon displays a red color select the node and click Synchronize If the synchronization works a message is displayed to that effect and the status icon displays a green color Repeat steps 3 4 to add
104. guration tab under the Security section uncheck the Enable bus security checkbox d Click OK and in the Messages section at the top of the page click the Save link e Log off from the WebSphere admin console 5 Stop and restart the WebSphere Application Server This step is required so that configuration changes made during Interstage BPM installation and any subsequent changes take effect a To stop the application server run the shutdown script located in lt WebSphere Install dir gt AppServer profiles AppSrv01 bin Operating System Shutdown Script Windows stopServer bat lt Server Name gt Example stopServer bat serverl Note If your WebSphere administrative security is enabled use this script stopServer bat lt ServerName gt user lt Admin UserName gt password lt Admin password gt Example stopServer bat serverl user Abc password Abc123 Interstage BPM Server and Console Installation Guide WebSphere Application Server 59 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server Operating System Shutdown Script Solaris stopServer sh lt Server Name gt Linux Example stops rver sh serverl Note If your WebSphere administrative security is enabled use this script stopServer sh lt ServerName gt user lt Admin UserName gt password lt Admin password gt Example stops rver sh serverl user Abc password Abc123 On Windows you can also stop
105. hange this default name by modifying the AdminRole parameter of the Interstage BPM Server To add members to a Group using the GUI 1 Launch the Active Directory Console if you haven t already done so by selecting Start gt Settings gt Control Panel gt Administrative Tools gt Active Directory Users and Computers Expand the hostname and the domain name to find the groups Organizational Unit 2 Right click the group to which you want to add members 3 From the popup menu that appears select Properties and then select the Members tab to display the Group s properties dialog Interstage BPM Server and Console Installation Guide WebSphere Application Server 89 10 Setting Up a Directory Service The Properties dialog for the Role Group is used in the following example ibpm example is already a member of the Role Group Role Properties 4 Eil x General Members Member Of Managed By Members Active Directory Folder f ibpm_example example com people Figure 33 Adding Members The default Group named Role is installed when you import the IBPMADAdd 1dif file You can maintain all of your users if you like 4 Inthe Role Properties dialog click Add The Select Users Contacts Computers or Groups dialog appears 5 In Windows 2003 Server search a user or Group that you want to add as a member of the Group Interstage BPM Server and Console Installation Guide WebSphere Application Server 90 10 S
106. have installed Interstage BPM e You have set the resolution of your screen and the font size as follows On Solaris 1024x768 Sans 9 pt font or 1280x1024 Sans 10 pt font On Linux 1024x768 Sans 9 pt font or 1280x1024 Sans 10 pt font On Windows 1024x768 system default font e You have the required permissions for deployment For details refer to section Permissions Required for Installation and Deployment on page 29 Interstage BPM Server and Console Installation Guide WebSphere Application Server 37 6 6 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server If you did not select the Launch Deployment Tool check box at the end of the installation process you can start the Deployment Tool manually To start the Deployment Tool for 32bit JVM e Run the startup script located in lt Interstage BPM Installation Directory gt server deployment tool Operating System Startup Script On Windows you can also start the Deployment Tool using Start gt Programs gt Interstage Business Process Manager gt Launch Deployment Tool ote Do not use the 32bit JVM specific Deployment Tool if your Operating System is 64bit Windows and your Java Environment JVM is 64bit Doing so will fail to launch the Deployment Tool Instead use the 64bit JVM specific Deployment Tool as detailed below 64bit Deployment Tool for Windows A new 64bit JVM specific Deployment Tool is provided for Win
107. he popup menu c Select the Members tab and click Add The Select Users Contacts Computers or Groups dialog appears d Enter the name of the new user that is to be added to IflowUsers Click Check Names to verify the user name e Click OK 10 1 5 Adding New Groups with an LDIF File You can add new Groups to Active Directory by manually editing the LDIF file then importing it To add new Groups with an LDIF File 1 Log on as an Administrator to the computer where the Active Directory master schema is located 2 Copy the createADGroup ldif and createADGroup bat files located in lt Interstage BPM Server Installation Directory gt client samples configuration to another directory Interstage BPM Server and Console Installation Guide WebSphere Application Server 87 10 Setting Up a Directory Service If the Active Directory Server is different from the Interstage BPM Server copy the files to the Active Directory Server 3 To create a new Group update the copy of the createADGroup 1dif file Refer to the instructions in this file for details 4 Ensure that the createADGroup 1dif file is located in your current directory 5 Execute the createADGroup bat batch file 10 1 6 Adding New Groups Using the GUI ote To create Groups that are valid for Interstage BPM use only alphanumeric characters hyphens and underscore characters _ Group names must not begin with an at character as this is used to identify
108. here 6 1 Application Server Configuration Enter the following settings For performing the selected operation on a WebSphere 6 1 0 9 server All fields are mandatory and must not be left blank Winterstage m WebSphere Settings Path to Profile Browse Node Server within Node m WebSphere Security r Security Enabled Administrator Username Administrator Password Java Home Directory Java home directory Browse The deployment requires JRE version 1 5 preferably the JRE version that was shipped with the application server Figure 27 WebSphere Settings 8 Click Next 9 Make sure that all the information displayed on the Review Information screen is correct 10 Click Finish to start the removal At the end of the process a message is displayed notifying you that the server console has been removed from the application server 11 Click OK to exit the Deployment Tool Uninstalling Interstage BPM When you uninstall Interstage BPM using its uninstallation program everything except the following is removed The Interstage BPM database e Log files and configuration files located in lt Interstage BPM Server Installation Directory gt or in one of the subdirectories During uninstallation the Deployment Tool is started so that you can remove Interstage BPM Server from the application server if you have not done so yet To uninstall Interstage BPM 1 If you have not yet removed the Inte
109. hese files are located at the following location on the Interstage BPM Server computer lt Interstage BPM Server Installation Directory gt server instance default logs Resolving Specific Error Situations interstage BPM Server Fails to Start Check the IBPMServer log in the lt Interstage BPM Server Installation Directory gt server instance default logs directory Look for DbServic databas setConnection Connection to Is the database server running and reachable through the ORA 01089 in progress no operations are server failed network immediate shutdown permitted LdapBroker getContext Could not create the directory services LDAP code 49 Invalid Credentials error LdapBroker getGroupMembersByDN Could th Could not create the directory services LDAP error code 49 Invalid Credentials not retriev user groups th Could not create the directory services LDAP Credentials LdapBroker Could not retriev user groups error code 49 Invalid What to do Check if the database is running Also check that you can access the database from the machine where the Interstage BPM Server is installed in case the database is running on a different machine You can use telnet lt Database Server Hostname gt lt Port gt from the server host machine to check that the connection to the database host port can be established Ensure that the user name pa
110. hments directory on the file server Example If you mount the shared directory at mp1 you would update the DmsCollections xml file to look like the following lt DmsCollections gt lt Dms gt Interstage BPM Server and Console Installation Guide WebSphere Application Server 131 Appendix D Clustering Load Balancing and Failover lt Path gt mp1 attachments lt Path gt lt ImplementationClass gt com fujitsu iflow dmsadapter impl FileSystemDmsSessionImpl lt ImplementationClass gt lt Name gt Attachments lt Name gt lt Dms gt lt DmsCollections gt The DMS root directory s mount point may be different on the individual server nodes However the directory s symbolic name which is specified in the lt Name gt element must be the same on all server nodes The following figure shows this configuration File Server InterstageBPMShared attachments Server Node 1 Server Node 2 Eo Pi ee N 1 lt Path gt mp1 att achments lt Path gt N lt Path gt mp2 att achments lt Path gt lt Name gt At tachment s lt Name gt lt Name gt At tachment s lt Name gt Kee TEIN Figure 38 Sample DMS Configuration D 1 15 Configuring JVM Parameters To configure JVM parameters of the servers in your cluster 1 In the Administrative Console for the WebSphere Deployment Manager expand Servers and click Application servers Select a server of your cluster for example 1BPMMember1 On the Config
111. icrosoft SQL Server Settings ciini roa ied tae deviation eceneeied 44 Oracle Settings ieie Ag vid aiid heed eddie aa Saved ne ieee aed 47 Super User and Multitenancy Settings c cece eeeeeeeeeeeeeneeeeeeeeeaeeeeeeeeaaeeeey 49 User and Group Managemen nt ccceceeeeeneeeeeeeeteeee eee eeeeeee tenes eetaeeeeretieeeeeread 51 Sun Java System Directory Settings cecccceeeeeeeeeeeceeeeeeeeeeeeeeeeeeaeeeeeeenaeeees 52 Active Directory SetlingS icinced nine A a ele nnana 53 other Sengsara tana wedbatiaaaetandgadaadac S 53 Starting the DeployMenticiscssc cc seceeccehesaedacerdadaccteuesadted coussundecevevsancccenwaadaucenaeaatgeeard 55 Password Protection cccc 2cccesgenceccesstcensceccctecsaesatusecessvacnacecensuntactessccuesterscctaesesss 56 User Accounts and Groups ccccccceceeseeeeeeeeeeeee cess eee eeneeeseeaeeeeseeeeeesneseeseeeeeeees 56 Switching ON Java SCCUIItY ccccceceesee eee eeeeeeeeeeeeeeeeeeeseeeeeeeeseeeeeeeeeeseeeeeeneeeseenens 57 Configuring Interstage BPM for WebSphere Application Server 6 1 and Starting Interstage BPM Serve ccccecseecceceeeeneeeeeeeeeeeeeeeeeeeeeeeeeeceeeeeesneeeeeeesneceeeeeneneeeeeens 58 Starting Interstage BPM Console and Tenant Management Console 61 Deploying only the Interstage BPM Console 0008 64 Permissions Required for Deployment ccccccceeceseeeeseeeeeeeeeeeeeeseeeesneneaned 64 Overview of Installation and Deplo
112. iles AppSrv01 Cell Enter the name of an existing WebSphere cell The cell name corresponds to the name of a subdirectory in your WebSphere installation To determine valid cell names check the following directory lt WebSphere Installation Directory gt AppServer profiles AppSrv01 config cells lt CellName gt Example If you are deploying on a computer named ibpmhost the cell name is typically ibpmhostNode01Cell e Node Enter the name of an existing WebSphere node The node name corresponds to the name of a subdirectory in your WebSphere installation To determine valid node names check the following directory lt WebSphere Installation Directory gt AppServer profiles AppSrv01 config cells lt CellName gt nodes lt NodeName gt Interstage BPM Server and Console Installation Guide WebSphere Application Server 42 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server Example If you are deploying on a computer named ibpmhost the node name is typically ibpmhostNode0l1 e Server within Node Enter the name of an existing application server The application server must be running within the node that you entered in the Node field The server name corresponds to the name of a subdirectory in your WebSphere installation To determine valid server names check the following directory lt WebSphere Installation Directory gt AppServer profiles AppSrv01 config cells lt CellN
113. ing provider page and click Topics b Click the name of the topic and check the Bus name setting These are the correct settings JMS Topic Bus Name Settings iFlowNotificationTopiciFLowSQNotificationTopic Map these topics to the bus that you previously created for example to IBPMDistBus All other topics These topics are mapped to the bus that has been automatically created for the node that you are currently configuring for example to ibpmhst1Node01I1BPMBuss Do not change this mapping 7 Update the activation settings To do so a Return to the JMS providers gt Default messaging provider page and click Activation specifications b Map each of the following topics to the bus that you previously created e NotificationTopic e SQNotificationTopic To do so click the name of the topic and change the Bus name setting If you are following the example map these topics to 1BPMDistBus 8 Repeat steps 2 7 for all nodes of your cluster 9 In the message at the top of the page click Review Select Synchronize changes with Nodes and click Save to save the configuration D 1 9 Configuring the JDBC Driver Every node needs access to the JDBC driver of the database that you are using To configure the JDBC Driver 1 Inthe Administrative Console for the WebSphere Deployment Manager expand Resources gt JDBC and click JDBC Providers 2 From the scope list select a server of your cluster Interstage BPM Server and
114. ion The RequiredUserAttribute property of Interstage BPM stores names of user attributes that are necessary to be defined for a user profile All attributes specified for RequiredUserAttribute are not cached Only attributes for which the cache option is specified are cached Storing attributes in the local database cache allows Interstage BPM to quickly search and retrieve these attribute values for any user from the cache Retrieved attribute values can further be used for different purposes for example directly allocating a task to a particular user s manager or subordinate or viewing what tasks a user s subordinates are allocated to Interstage BPM server refreshes the user attribute values in the cache in the following scenarios e When you modify the value of the RequiredUserAttribute Interstage BPM property e When you call the Model API wrAdminSession refreshAllUserProfileCache method Interstage BPM Server and Console Installation Guide WebSphere Application Server 95 Appendix A Security Appendix A Security A 1 Interstage BPM can be set to two security levels Demo Mode and Security Mode Demo Mode is useful while key members of your work team learn the features of the software Later Security Mode provides a stable and controlled environment for implementing Interstage BPM across your company interstage BPM Operation Model It is assumed that Interstage BPM is used in an organizational Intranet In most situation
115. ion Silent Mode Deployment Options on page 109 for allowed changes For example you might have your database installed on a different drive and in a different directory than on the computer where you recorded the script You must search for that path and change it to the path used by the computer on which you are running the silent mode deployment 4 Open a Command Prompt window and navigate to the directory lt Interstage BPM Server Installation Directory gt server deployment tool 5 Execute the following command Interstage BPM Server and Console Installation Guide WebSphere Application Server 108 C 3 Appendix C Silent Mode Deployment On Windows run _Windows bat silentmode lt Silent Mode Script gt On Solaris run_solaris sh silentmode lt Silent Mode Script gt On Linux cun_linux sh silentmode lt Silent Mode Script gt For lt Silent Mode Script gt specify the absolute path of your script Silent Mode Deployment Options The Silent Mode script is a text file that you record while running the Deployment Tool in interactive mode The contents of the Silent Mode script depends on the type of operation that you record There are different types of operations each type has its own set of parameters e Server Console instance setup without configuring the database e Server Console instance setup including database configuration e Database setup e Server instance removal For each type of op
116. irements 15 T TCP IP 18 Troubleshooting 138 Interstage BPM Server startup 141 U UDDI registry 55 Undeploying Interstage BPM 69 Uninstalling 72 Upgrade 75 Upgrade from a previous version 75 User Add 83 Assign to LDAP Group 83 User accounts 56 User groups 56 WwW WebDAV Repository 55 WebSphere Application Server Starting Interstage BPM Console 61 WebSphere Application Server settings 42 WebSphereJBoss preparing cluster 119 Interstage BPM Server and Console Installation Guide WebSphere Application Server 145
117. isite You have prepared the database server as instructed in section Database Server Preparation on page 18 Interstage BPM Server and Console Installation Guide WebSphere Application Server 44 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server On the Database Configuration screen you provide the settings for the database you will be using with Interstage BPM The items displayed on this screen depend on your selections regarding the database on previous screens W interstage Business Process Manager Deployment and Configuration j fel x Database Configuration These fields are either empty or of unexpected type IBPM User name IBPM password Database Administrator Password Path of the JDBC Driver JAR file saljdbc jar SQL Server Home S nterstage Directory Path to store Data files JRE Home IBPM Database User Interstage BPM Database User O Password Confirm Password ee M Select the version of SQL Server database SQL Server 2005 SQL Server 2008 C r SQL Server Settings Database Administrator User Name Database Administrator Password SQL Server Database Instance can be left blank for default instance Database Host localhost Database Port 1433 DB Driver com microsoft sqlserver jdbc SQLServerDriver DB Connection URL jdbc sqlserver flocalhost 1433 databaseName teamflowdb Path of the JDBC Driver JAR file sqlidbc jar Browse SQ
118. ist of Enterprise Applications appears 4 Click the InterstageBPMConsole link The configuration page for the application appears Integrated Solutions Console welcome Help Logout View All tasks Welcom Enterprise Applications Guided Activities Enterprise Applications gt InterstageBPMConsole Field help For field help information Servers Use this page to configure an enterprise application Click the links to access pages for further configuring of the application or select a field label or list its modules marker when the help E Applications cursor appears Configuration Page help More information about thi Resources ae Security Seneral Properties Modules E Environment Manage Modules E System administration Bu TE Application reference validation E Monitoring and Tuning Web Module Properties Troubleshooting Detail Properties Service integration E UDD Enterprise Java Bean Properties Application profiles Message Driven Bean listener bindings View Deployment Descriptor Last participant support extension References Shared library references Apply OK Reset Cancel Figure 20 Enterprise Application Configuration Page Interstage BPM Server and Console Installation Guide WebSphere Application Server 61 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server 5 Select the Class loa
119. ke sure that the database server is running Refer to section Database Server Preparation on page 18 Prepare the application server and make sure that it is running Refer to section Installing and Starting WebSphere Application Server on page 21 Install Interstage BPM on the database server computer Refer to section nstalling Interstage BPM on page 31 On the database server computer run the Deployment Tool to configure the database Refer to section Configuring the Remote Database on page 38 Install Interstage BPM on the application server computer Refer to section nstalling Interstage BPM on page 31 On the application server computer run the Deployment Tool to deploy the Interstage BPM Server and Console or only the Server Refer to section Deploying Server Instances with Console OR only Server Instances on page 39 If you want to connect to a Directory Service you must configure it before starting the Interstage BPM Server Refer to chapter Setting Up a Directory Service on page 82 If you opted for SaaS mode during Server deployment switch on Java security Refer to section Switching on Java Security on page 57 Start the Interstage BPM Server Interstage BPM Server and Console Installation Guide WebSphere Application Server 30 6 4 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server Refer to section Configuring Interstage BPM for WebSphere Application Server 6 1 a
120. le from being accessed by unauthorized users 3 Click Finish to start deploying the Interstage BPM Server to the application server At the end of the deployment process a message is displayed notifying you that the server has been deployed 4 Click OK to exit the Deployment Tool The Deployment Tool created a configuration file named ibpm properties in lt Interstage BPM Server Installation Directory gt server instance default This file reflects the server configuration parameters that have been written to the database during deployment You can use the ibpm properties file as a reference of your initial configuration settings If you need to change the configuration you can use the Configuration Tool or the configuration scripts provided by Interstage BPM For details refer to the interstage Business Process Manager Server Administration Guide Password Protection Passwords set during deployment are written to several files Exposing these passwords may pose a security problem Fujitsu recommends that you implement suitable security measures over these files to ensure that the passwords are inaccessible to those users who should not have access to them e From lt Interstage BPM Server Installation Directory gt server deployment sql secure the database scripts e From lt Interstage BPM Server Installation Directory gt client samples configuration secure e createADUser bat e IBPMLDAPAdd 1ldif e importAD bat
121. lity proxy at ibpmconsole and the V11 Console at any other context root for example console The default context root for V11 Console is console which is different from the default context root for any previous version So if you have followed the defaults this requirement rule will be automatically satisfied e 10 x had the restriction that two applications cannot have process definitions with the same name This restriction has been removed in V11 0 But to use the Compatibility Proxy the same restriction needs to be followed that is two applications should not have process definitions with the same name 9 5 1 Steps to Overcome the URL incompatibility Problem Pre requisites You have completed the following steps as described in Upgrading from Previous Versions of Interstage BPM on page 75 e You have uninstalled the previous version of Interstage BPM e You have installed the new version of Interstage BPM e You have upgraded the database e You have deployed an instance of Interstage BPM Server and Console in non SaaS mode e Make sure that the WebSphere Application Server is running 1 Create a folder whose name corresponds to your pre v11 0 context root for example ibpmconsole on your machine For example purposes the following directory will be used On UNIX or Linux opt FJISVibpm ibpmconsole On Windows c fujitsu InterstageBPM ibpmconsole 2 Copy webserviceproxy war from the console directory of your Interstage BPM Console I
122. ment Kit JDK installed on a different drive and ina different directory than on the computer where you recorded the installation script Parameter Description The following table lists the parameters that occur in the installation script All parameter values have to be enclosed in double quotes A short description of the parameters is also provided For detailed information about the parameters refer to section nstalling Interstage BPM on page 31 Parameter Name Sample Value On Windows szDir located On Windows Absolute path to the installation below SdAskDestPath2 C Fujitsu InterstageBPM directory of the Interstage BPM On Solaris w On Solaris opt FISVibpm beanl destinationPath On Linux opt FISVibpm On Linux w beanl destinationPath On Windows szDir located On Windows c j2sdak fate oa pe aa i irectory of the below SelectDir On Solaris usr java SAA Kit JDK installation Alternatively the On Linux w bean11 jdkHome path to a Java Runtime Environment JRE installation can be provided On Solaris w bean11 jdkHome On Linux usr java Interstage BPM Server and Console Installation Guide WebSphere Application Server 106 Appendix B Silent Mode Installation On Windows this parameter Specifies whether the installation does not exist for this platform program launches the On Solaris w Deployment Tool in graphical mode at the end of installation bean2223 deploymenttool a
123. ment Tool in graphical mode Installation and deployment is a short smooth process if you know the overall procedure and all of the values for the parameters that you need to supply It is recommended that you take the time to fill out the installation and deployment worksheet before and read the overview of the installation and deployment procedure before starting the installation Refer to System Requirements for Interstage BPM Server and Console on page 15 and to the Release Notes for details on the required components mentioned in the procedures described in this chapter ote If you install Interstage BPM Server on a computer that is periodically disconnected from the network your computer s DHCP lease may expire while you are off line If this happens TCP IP and therefore Interstage BPM Server will cease functioning Therefore you should use a Static IP address for the computer If you want to change the Interstage BPM configuration after deployment you can do so by following the instructions in the nterstage Business Process Manager Server Administration Guide Installation and Deployment Worksheet During the course of the installation and the deployment you will be asked to enter values for a number of parameters To ensure a smooth and easy setup it is recommended that you fill out the following worksheet before beginning the installation Interstage BPM Server and Console Installation Guide WebSphere Application Server
124. n the following example RMI is the directory containing the copied files and record install iss is the name of the installation script to be recorded C RMI gt setupwin32 exe r f1 C RMI record install iss ote The installation script for Windows is created ina iss and not txt file On Solaris setupSolaris bin options record lt Installation Script gt In the following example RMI is the directory containing the copied files and record install txt is the name of the installation script to be recorded RMI gt setupSolaris bin options record record install txt On Linux RMI gt setupLinux bin options record record install txt Interstage BPM Server and Console Installation Guide WebSphere Application Server 104 Appendix B Silent Mode Installation If you receive an error while launching the installation program on Linux download the libXp 1 0 0 8 i1386 rpm package from your Red Hat Enterprise Linux CD or the Red Hat Network website and install the package using the rpm i libXp 1 0 0 8 1386 rpm command Then retry starting the Interstage BPM installation program for Linux This command starts a normal mode installation of Interstage BPM and records the installation choices that you make As the installation program runs use the instructions in chapter nstalling and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server on page 23 At the end of installation the installation
125. ncy with which the problem occurrs Problem Details The application program and its source code that caused the error e The XPDL file of the process definition that caused the error Information about Java Actions Timers and Agents defined in the process definition Screenshot of the process instance history if the process instance goes into error state e Stack trace if any exception is displayed You can obtain the strack trace by clicking Details on the error page displayed in the Interstage BPM Console Screenshot of the exception wherever it is displayed e Screenshot of the process instance graphical view if the process instance goes into error state or into an unexpected state e Calendar files cal if timers are used e The agentsConfig xml file if agents are used Interstage BPM Server and Console Installation Guide WebSphere Application Server 143 Index A About this manual 8 Active Directory settings 53 Cc Cluster 117 Configuration export script 100 Configuration import script 100 D Database configuring 38 preparation 18 Server 18 settings 45 47 Database server 44 Demo Mode 99 Deployment only Console 64 Server 23 Server with Console 23 Silent Mode 108 Deployment Tool 32bit 38 64bit 38 Directory Service Add members to Groups 89 Add new Groups 87 Add new users 83 IBPMADAdd ldif 82 Setup 82 92 Users and Groups 83 E Email Server administrator 54 F Failo
126. nd Starting Interstage BPM Server on page 58 10 If you have also deployed the Console start Interstage BPM Console Refer to section Starting Interstage BPM Console and Tenant Management Console on page 61 11 If required perform further configurations for Interstage BPM Console Refer section nterstage BPM Console Other Configurations on page 66 Installing Interstage BPM Use the instructions in this section to perform a new installation of Interstage BPM ote Ifyou have a previous version of Interstage BPM Server on your computer refer to chapter Upgrading Interstage BPM from Previous Versions on page 75 To install Interstage BPM 1 Read the Release Notes located in the top level directory of the CD ROM 2 Start the installation program located in the engine directory on the CD ROM Operating System Installation Program Solaris setupSolaris bin Linux setupLinux bin Note If you receive an error while launching the installation program on Linux download the libXp 1 0 0 8 i386 rpm package from your Red Hat Enterprise Linux CD or the Red Hat Network website and install the package using the rpm i libXp 1 0 0 8 1386 rpm command Then retry starting the Interstage BPM installation program for Linux 3 Read the Welcome screen and click Next 4 On the Interstage Business Process Manager Installation Directory screen specify a directory where the Interstage BPM software is to be installed Accept the default or click Br
127. nd the main Organizational Unit that you specified during Interstage BPM installation b Right click the flowGroups Group and select Properties from the popup menu c Select the Members tab and click Add The Select Users Contacts Computers or Groups dialog appears d Enter the name of the new Group that is to be added to If lowGroups Click Check Names to verify the Group name e Click OK 10 1 7 Adding Members to a Group Using LDIF The batch file addADGrMember bat imports the addADGrMember 1dif file The file must be available on the Active Directory master schema machine To add Members to a Group Using LDIF 1 Log on as an Administrator to the computer where the Active Directory master schema is located 2 Copy the addADGrMember 1dif and addADGrMember bat files located in lt Interstage BPM Server Installation Directory gt client samples configuration to another directory If the Active Directory Server is different from the Interstage BPM Server copy the files to the Active Directory Server 3 To add a member to a Group update the copy of the addADGrMember 1dif file Refer to the instructions in this file for details 4 Ensure that the addADGrMember 1dif file is located in your current directory 5 Execute the addADGrMember bat batch file 10 1 8 Adding Members to a Group Using the GUI ote After normal installation using Active Directory the default Administrator Role is a Group called AdminRole You can c
128. nd to deploy In this case select IBM WebSphere b Depending on your requirement select the appropriate checkboxes either or both of Interstage BPM Server Interstage BPM Console for the Interstage BPM component you want to deploy Interstage BPM Server and Console Installation Guide WebSphere Application Server 40 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server ote If you choose to deploy Interstage BPM Console Interstage BPM Tenant Management Console is also automatically deployed W interstage Business Process Manager Deployment and Configuration E oj x Application Server Selection Select the application server on which the operation is to be performed S interstage Supported Application Servers Fujitsu Interstage Applicatic ver 9 configured for SQL Ser wal Redhat JBoss 4 0 5 configured for Oracle and SQL Server Datasources BEA WebLogic Server 9 2 IBM Websphere Server 6 1 0 15 configured for Oracle and SQL Server Datasources Select the components I Interstage BPM Server J Interstage BPM Console Finish Cancel Figure 11 Application Server and Component selection sample screen 3 Click Next 6 7 2 WebSphere Application Server Settings Prerequisites The application server is running A WebSphere Application Server profile is available for use by Interstage BPM Interstage BPM Server and Console Installation Guide
129. ng Members to a Group Using the GUI cece eeeeeeeeeeeeenteeeeeeeneeeeeeeaaas 89 Setting Up Sun Java System Directory Server cccccssseeceeeeseeeeeeeneneeneeeenees 92 Starting the Sun Java System Directory Servel ccceceeeceeeeeeeeeeteeeeeeteneeeeerees 93 Importing the IBPMLDAPAdG Idif File cecesceeeeeeeeeeeeeeeeeeeeseeeeeeseeeteaeeeteaeees 93 Using Existing Sun Java System Directory Server Users and Group6 93 Adding New Sun Java System Directory Server Users eseeeeeeeeeeeeeeeeees 94 Addinig New Group Siseosa ara AEO T 94 Group Cachinigossrss a A E E a 95 User Attribute Caching ssssensssesenunnreunnnnnnunnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nnne 95 Security opresar te cette aa aa aE Re eae en edn Aaea aaant araen 96 Interstage BPM Operation Model sss assessnunsennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnne 96 Password Encryption cicceccfetsceliceceedecwacevecedenneeh caus ibcsteccsinceeeccucccpeetdeutaceresedtonceted 97 Using Demo Mode and Security Mode ccescccccesseneeeeeseeneeeeeeeeneeeeeseeeeeeenseees 99 Configuring SMTP Authentication for Use with Interstage BPM 100 Interstage BPM Server and Console Installation Guide WebSphere Application Server 5 A 5 Appendix B B 1 B 2 B 3 Appendix C C 1 C 2 C 3 Appendix D D 1 D 1 1 D 1 2 D 1 3 D 1 4 D 1 5 D 1 6 D 1 7 D 1 8 D 1 9 D 1 10 D 1 11 D 1 12 D
130. ng and Deploying Interstage BPM Server with Console OR only the Interstage BPM Servet ccccccceeeeeeeeeeeeeeeeeeeeeeeeees 23 Installation and Deployment Worksheet cccccsseceeeseeeneeeeeeeeeeeeeeseeeeeeeeeeees 23 Permissions Required for Installation and Deployment eeeeeee 29 Overview of the Installation and Deployment Procedure cccsesseeeeeeeee 29 Installing Interstage BPM cccessssneeesseneeeeeeeeeeeeeeeeeeeeeeeeseceneeenseeeeeeeeeseeeneeenes 31 Starting the Deployment TOOl cceccesesseeeeeeeeceeeeeeeeeneeeeeseeneeeseeeseeeeeeeeseeeeeens 37 Interstage BPM Server and Console Installation Guide WebSphere Application Server 3 6 6 6 7 6 7 1 6 7 2 6 7 3 6 7 4 6 7 5 6 7 6 6 7 7 6 7 8 6 7 9 6 7 10 6 7 11 6 7 12 6 8 6 9 6 10 6 11 6 12 7 1 7 2 7 3 7 4 7 5 7 5 1 7 5 2 8 1 8 2 Table of Contents Configuring the Remote Database ccceeeccsssseeeeeeeeeneeeenseeeneeeeesseeeeeensesseensnes 38 Deploying Server Instances with Console OR only Server Instances 39 Operation Mode and Application Server Selection c c eeeeeceeeeeeeeeeteeeeeeee 40 WebSphere Application Server SettingS cccccceccceeeeeeeeeeeeeeeneeeeeeeeeeeeeeeeee 41 Interstage BPM Console SettingS 0 cccccccceeeeeeeeeneeeeeeenaeeeeeeeeneeeeeeenaeeeeeeeaaes 44 Database Selection 2s cisiste aE dedee tia se ge aad R 44 M
131. nizational unit when you installed Interstage BPM These two special LDAP Groups can be used to allow your LDAP Users and Groups access to Interstage BPM To give your LDAP Users access to Interstage BPM as Interstage BPM users add them as members of the If lowUsers Group You can add each user individually or add a Group that contains the users Users in the Group sub levels are also given access To give your LDAP Groups access to Interstage BPM as Interstage BPM Roles add them as members of the If1lowGroups Group 10 2 4 Adding New Sun Java System Directory Server Users You can add new users by manually editing a copy of the IBPMLDAPAdd 1dif file or by using the Directory Service Control Center through JavaWeb Console ote Do not edit the tBPpMLDAPAdd 1dif file in the lt Interstage BPM Server Installation Directory gt client samples configuration directory because it will be overwritten if you re execute a server instance setup Copy the file to another directory and edit the copy When you create new users note the following 1 To create users that are valid for Interstage BPM use only alphanumeric characters hyphens and underscore characters _ User IDs must not begin with an at character as this is used to identify Agents in Interstage BPM 2 For each user Sun Java System Directory Server requires you to provide a last name and common name s In addition Interstage BPM requires a User ID 3 Although ente
132. nsole Installation Guide WebSphere Application Server 17 5 1 5 1 1 5 Preparing for Installation and Deployment of Interstage BPM Server and Console Preparing for Installation and Deployment of Interstage BPM Server and Console This chapter explains how to set up your environment before installation and deployment of Interstage BPM Use this chapter if you plan to install and deploy Interstage BPM Server together with Console OR only the Server If you have already completed deployment of Interstage BPM Server and plan to deploy only Interstage BPM Console refer section Preparing for Console Deployment Database Server Preparation This section provides instructions in configuring your database software for use by Interstage BPM You must create a new database instance for Interstage BPM When deploying the Interstage BPM Server you will specify this instance These instructions use the default database instance for the purpose of providing an example Configuring Microsoft SQL Server Microsoft SQL Server 2005 or Microsoft SQL Server 2008 can be used as the database with Interstage BPM To configure Microsoft SQL Server 1 Make sure that you install Microsoft SQL Server in Mixed Mode Microsoft SQL Server in Mixed Mode allows Windows Authentication i e a Windows user can log in to the database and Microsoft SQL Server Authentication i e a user needs a user name and a password for the database ote
133. nstallation CD or CD Image to the directory that you just created on your machine 3 Extract the files from webserviceproxy war into the ibpmconsole directory Use the following Java command jar xvf webserviceproxy war 4 After extracting the jar edit the proxy conf file under lt Extraction Directory gt WEB INF config and update the ServerBaseURL to the V11 port number and context root Interstage BPM Server and Console Installation Guide WebSphere Application Server 79 9 Upgrading Interstage BPM from Previous Versions 5 Edit the web xm1 file under lt Extraction Directory gt WEB INF as shown below Change lt url pattern gt lt url pattern gt to lt url pattern gt jsp lt url pattern gt 6 Now run the following command from the location where the extracted contents of webservicesproxy war are available jar cvf ibpmconsole war 7 Start the WebSphere Server Default Server and the Interstage BPM Server to which you want to connect 8 Login to the WebSphere Administration Console if you have not already done so 9 Select Applications gt Install New Application 10 Click Browse and navigate to the location of the WAR file ibpmconsole war 11 Enter the value for Context Root This should be same as the context root at which Pre V11 IBPM was running like ibpmconsole for V10 1 12 Click Next A pop up appears asking you to Please Wait The Interstage BPM Console is being deployed
134. nt to assign application ownership to a group other than the AdminRole you can do so by using Interstage BPM Console For information about changing application owners in Interstage BPM Console refer the Managing Applications section of the Interstage BPM Console Online Help Migrating WebDAV Repository and UDDI Registry from Previous Versions to Interstage BPM v11 0 If you had configured pre v11 0 Interstage BPM to use WebDAV repository and UDDI registry such as Centrasite you need to synchronize the Interstage BPM Server with your WebDAV and UDDI repositories before you can use already published information or publish new process definitions Use the following steps to achieve this 1 After upgrade and configuration of Interstage BPM Server and Console start the Interstage BPM Server and Console Configuring Interstage BPM for WebSphere Application Server 6 1 and Starting Interstage BPM Server on page 58 e Starting Interstage BPM Console and Tenant Management Console on page 61 2 Login to Interstage BPM Console as an administrator After choosing an application in the System Administration tab click Application Settings 4 Inthe Application Settings page click Synchronize with Repository and then click Synchronize in the pop up that appears Once synchronization is successful an appropriate message is displayed oO Now Interstage BPM v11 0 is ready to be used with WebDAV and UDDI repositories Additional Steps for
135. nterstage BPM Deployment Tool ote When you remove a server or console instance the Interstage BPM database will not be removed To undeploy an Interstage BPM Server or Console instance 1 Log out of all Interstage BPM Clients and close all Browser windows 2 Start the Interstage BPM Deployment Tool For details refer to section Starting the Deployment Tool on page 37 3 For Windows Select the appropriate radio button on the Deployment Tool Option Screen and click Next Interstage BPM Server and Console Installation Guide WebSphere Application Server 69 8 Undeploying and Uninstalling Interstage BPM Server and Console ote If you have already removed the Interstage BPM Server and Console from the application server make sure that you select the Do not launch Deployment Tool radio button Interstage Business Process Manager InstallShield Wizard Deployment Tool option screen 4 If you want to launch the Deployment Tool now select the appropriate radio button and click Next Launch Deployment Tool with 32 bit Java VM Launch Deployment Tool with 64 bit Java M Donot launch Deployment Tool installshield Figure 25 Starting Deployment Tool For Windows 4 On the Welcome screen click Server Console Instance Removal 5 On the Application Server Selection screen a Select the type of application server from which you want to undeploy In this case select IBM WebSphere Interstage BP
136. nterstage BPM Server Installation Directory gt client samples configuration On Windows EncryptPassword bat e On Solaris EncryptPassword sh e On Linux EncryptPassword sh Encrypting a Password With the Default Key To encrypt a password with the default key run the script with the following option On Windows EncryptPassword bat e lt TextPassword gt On Solaris EncryptPassword sh e lt TextPassword gt On Linux EncryptPassword sh e lt TextPassword gt ote Make sure to enclose the password and the encryption key in double quotes Otherwise the encryption process might fail As double quotes are delimiters do not use double quotes in the encryption key Encrypting Passwords With a New Key You are recommended to encrypt your passwords with your own key To encrypt a single password with a new key run the script with the following options On Windows EncryptPassword bat e lt TextPassword gt lt Key gt On Solaris EncryptPassword sh e lt TextPassword gt lt Key gt On Linux EncryptPassword sh e lt TextPassword gt lt Key gt If a key other than the default key is used it should contain more than 24 characters Make sure to enclose the password and the encryption key in double quotes Otherwise the encryption process might fail As double quotes are delimiters do not use double quotes in the encryption key During startup of the Interstage BPM S
137. o the console C its intestagSP chiert resar PPlication folder On Linux opt FISVibpm client console war Interstage BPM Console Parameters Parameter Sample Value without Description spaces consoleconfignamingprovider Naming Provider com ibm websphere naming WsnInitialContextFactory consoleconfiguseragentservicename User Agent Service Name iFlow ejb UserAgentServic consoleconfighostname itl hw 132024 Host Name of the machine on which you deploy Console consoleconfignamingproviderurl diop itl hw 132024 Naming provider URL for the application EmailBaseURL http docone Server Email Base URL 49950 console changing this value will make all of your Client related URLs correct with regard to the Console ServerBaseURL http docone Server Base URL changing this 49950 console value will make all of your Client related URLs correct with regard to the Console Web Services Interstage BPM Server and Console Installation Guide WebSphere Application Server 111 Appendix C Silent Mode Deployment Database Parameters Microsoft SQL Server Parameter Sample Value without Description spaces db_ibpmusername ibpmuser User name for a non administrative database user account db_ibpmpassword ibpmuserpassword Password for the non administrative database user account sqlDB_dbVersion false Parameter to choose version of Microsoft SQL Server e Set this to true for Microsoft SQ
138. ocess definition with 10 nodes require about 5 MB During Interstage BPM runtime the processing of work items history entries in the database etc require additional space besides the initial database size This additional space depends on 1 the number Interstage BPM Server and Console Installation Guide WebSphere Application Server 15 3 2 3 3 3 4 3 System Requirements for Interstage BPM Server and Console of process instances 2 the number of active nodes 3 the number of users who are assigned to work items For example if you have 1000 instances of a process with 10 nodes 50 of the nodes require parallel processing e g OR nodes 10 users are accessing the process instances you need the following disk space at runtime 1500 active nodes multiplied with 10 users 15 000 KB or 15 MB Minimum Software Requirements for Server and Console For software requirements for the server refer to the interstage BPM Server Release Notes For software requirements for the Console refer to the nterstage BPM Console Release Notes Hardware Requirements for Browser Machine Fujitsu DESKPOWER ESPRIMO SCENIC SCALEO CELCIUS Lifebook AMILO PRIMERGY or other Windows PC Intel Architecture servers Processor Pentium III 500 MHz or greater Memory Minimum 512 MB Recommended 2 GB or more Minimum Software Requirements for Web Browser Clients For software requirements for the client machines connecting to the Console rem
139. ofiles AppSrv01 Application Server profile On Solaris opt IBM WebSphere AppServer profiles AppSrv01 On Linux opt IBM WebSphere AppServer profiles AppSrv01 websphere cellnam ibpmhostNode01Cell Name of an existing WebSphere cell websphere nodenam ibpmhostNode01 Name of an existing WebSphere node websphere serverinnod serverl Name of the Interstage BPM Server webspherewizard securityenabled_ uname webspherewizard securityenabled_ passwd Interstage BPM Server and Console Installation Guide WebSphere Application Server adminpassword adminusername User name of the administrator for your WebSphere Application Server This parameter only appears if you selected Security Enabled on the WebSphere lt Version gt Application Server Configuration screen Password of the user specified in webspherewizard securityenabled _ uname This parameter only appears if you selected Security Enabled on the WebSphere lt Version gt Application Server Configuration screen 110 Appendix C Silent Mode Deployment Parameter Sample Value without Description spaces as_javahome On Windows Absolute path to the top level C IBM WebSphere AppServer directory of the J2SE Development Kit JDK or Java Runtime Environment JRE installation java On Solaris usr IBM WebSphere AppServer java On Linux usr IBM WebSphere AppServer java ConsoleWARPath On Windows The path t
140. ong e LDAP Key e LDAP Organizational Unit Interstage BPM Server and Console Installation Guide WebSphere Application Server 141 Appendix E Troubleshooting Errors Pertaining to the Database 1 Cause The Database Server is not running Action Start the Database Server and then start the Interstage BPM Server Errors Pertaining to a Hostname Change You changed the hostname of the computer where Interstage BPM Server has been installed As the hostname occurs in the names and values of various configuration parameters of the Interstage BPM Server the server cannot access its configuration settings In the IBPMProperties table of the Interstage BPM database make the following changes e Inthe PROPERTYKEY column update any parameter names that have the hostname in the suffix These parameters have the format lt PARAMETER_NAME gt lt HOSTNAME gt Or lt PARAMETER NAME gt lt HOSTNAME gt lt SERVERNAME gt In the PROPERTYVALUE column update any parameter values containing the hostname To update the IBPpMProperties table use the appropriate database commands or a database client software E 5 Contacting Your Local Fujitsu Support Organization If you are unable to troubleshoot your problem 1 Set the DebugLevel parameter of the Interstage BPM Server to 2 using these steps a Start the Interstage BPM Server Configuration Tool
141. onsole Installation Guide WebSphere Application Server 76 9 Upgrading Interstage BPM from Previous Versions 3 For each application do one of the following a If an application already contains the agentsConfig xml file located in lt DMSRoot gt apps lt application id gt add the following code to that file lt ActionAgent gt lt Name gt FTP lt Name gt lt Description gt FTP Agent lt Description gt lt RetryInterval gt 20 lt RetryInterval gt lt EscalationInterval gt 1 lt EscalationInterval gt lt ClassName gt com fujitsu iflow serveree impl actionagent ServiceAgent lt ClassName gt lt ConfigFile gt ftp xml lt ConfigFile gt lt ActionAgent gt lt ActionAgent gt lt Name gt HTTPAgent lt Name gt lt Description gt HTTP Agent lt Description gt lt RetryInterval gt 20 lt RetryInterval gt lt EscalationInterval gt 1 lt EscalationInterval gt lt ClassName gt can fujitsu iflow serveree imp actionagent httoservice HITPServiceAgent lt ClassName gt lt ConfigFile gt HTTPAgent xml lt ConfigFile gt lt ActionAgent gt b If an application does not contain the agentsConfig xml file located in lt DMSRoot gt apps lt application id gt e Copy the agentsConfig xml file of the previous version to the lt DMSRoot gt apps System folder e Edit the copied agentsConfig xml to remove agents from the text within the lt ConfigFile gt tag 4 Copy the fileListene
142. or exact version information refer to the Release Notes ote The JDK or JRE installation path must not contain blanks Interstage BPM Server and Console Installation Guide WebSphere Application Server 46 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server 5 Click Next 6 7 6 Oracle Settings Prerequisite You have prepared the database server as instructed in section Database Server Preparation on page 18 On the Database Configuration screen you provide the settings for the database you will be using with Interstage BPM The items displayed on this screen depend on your selections regarding the database on previous screens E Interstage Business Process Manager Deployment and Configuration Bel x Database Configuration These fields are either empty or of unexpected type IBPM password SYSTEM User s Password Path of the JDBC Driver JAR file Oracle Home Directory Path to store Data files JRE Home interstage m IBPM Database User Interstage BPM Database User ibpmuser Password Confirm Password M Oracle Settings DB Host flocthost Connect Identifier POR Port tt SYSTEM User s Password DB Driver foracle jdbc driver OracleDriver DB Connection URL idbcroracle thin localhost 1521 0RCL Path of the JDBC Driver JAR file Browse Oracle Home Directory Browse Path to store Data files Browse M Java Runtime Environment JRE Home Directory Browse
143. otely refer to the Release Notes Interstage BPM Server and Console Installation Guide WebSphere Application Server 16 4 4 Overview of Integrated Deployment of Interstage BPM Server and Console Overview of Integrated Deployment of Interstage BPM Server and Console You can deploy Interstage BPM Server and Console together using the integrated Deploment Tool The Deployment Tool offers the following possible combinations of deploying Server and Console Possible Combinations of Deploying Interstage BPM Server and Console 1 Deploying Server and Console together Refer sections Preparing for Installation and Deployment of Interstage BPM Server and Console on page 18 and nstalling and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server on page 23 N Deploying only the Server Refer sections Preparing for Installation and Deployment of Interstage BPM Server and Console on page 18 and nstalling and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server on page 23 oO Deploying only the Console after having deployed the Server Refer section Deploying only the Interstage BPM Console on page 64 ote When you deploy Interstage BPM Console Interstage BPM Tenant Management Console is automatically deployed as well ote Ifyou are upgrading from a previous version of Interstage BPM refer Upgrading Interstage BPM from Previous Versions on page 75 Interstage BPM Server and Co
144. ou must search for that path and change it to the path used by the computer on which you are running the silent mode installation 5 Save the changes made to your installation script 6 Open a Command Prompt window and navigate to the directory that contains the installation script 7 Install Interstage BPM in Silent Mode with the following command On Windows C RMI gt lt Absolute Path gt setupwin32 exe s f1l lt Absolute Installation Script Path gt lt Installation Script Name gt f2 lt Absolute Installation Log File Path gt lt Installation Log File Name gt On Solaris Interstage BPM Server and Console Installation Guide WebSphere Application Server 105 Appendix B Silent Mode Installation RMI gt setupSolaris bin options lt Absolute Path gt record install txt silent On Linux RMI gt setupLinux bin options lt Absolute Path gt record install txt silent This procedure can be repeated for all of your Interstage BPM installations B 3 Silent Mode Installation Options The Silent Mode installation script is a text file that you record while performing the first installation ote Only use the installation script for the type of installation that you recorded Do not add or delete parameters Otherwise your installation script might not work properly You can customize the installation script to make it run properly in a different environment For example you might have your J2SE Develop
145. owse and navigate to a directory of your choice Default on Windows c Fujitsu InterstageBPM Default on Solaris opt FISVibpm Default on Linux opt FISVibpm Interstage BPM Server and Console Installation Guide WebSphere Application Server 31 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server ote The installation directory path must not contain blanks Do not specify an installation directory path that is longer than 255 characters interstage Business Process Manager InstallShield Wizard Choose Destination Location Select folder where setup will install files ea Install Interstage Business Process Manager to C Fujitsu InterstageBPM Cancel Figure 4 Server Installation Directory for Windows Interstage BPM Server and Console Installation Guide WebSphere Application Server 32 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server E Installer ioi x Interstage Business Process Manager Installation Directory Specify the directory where you wish to install Interstage Business Process Manager Enter the path to the installation directory or click Browse and navigate to it Do not use an installation path containing leading trailing or intermediate spaces When the desired directory appears in the installation directory field click Next to continue with the installation Interstage Business Process Manag
146. p level directory of your J2SE Development Kit JDK or Java Runtime Environment JRE installation For exact version information refer to the Release Notes Example on Windows c j2sdk1 5 Example on Solaris usr java j2sdk1 5 Example on Linux usr java j2sdk1 5 ote The JDK or JRE installation path must not contain blanks 4 Click Next 6 7 7 Super User and Multitenancy Settings On the InterstageBPM Super User Page you set your Super User name and password as well as multitenancy settings W interstage Business Process Manager Deployment and Configuration sig xj InterstageBPM Super User Page Please enter the Super User Username Password and Multitenancy Mode All fields are Mandatory except the Mail Host M Super User UserName Password mSS Confirm Password J General Settings Mail Server SMTP Host Select the MultiTenancy Mode For Deployment SAAS Mode m Chose to create Default Tenant for SAAS mode IV Create Default Tenant Option Non SAAS Mode Figure 15 Super User and Mulititenancy Settings Set the username and password for the Super User Also confirm the password Inthe General Settings section optionally update the Mail Server that will be used to send email notifications 3 In the Multitenancy Settings section choose from the following options a Select SAAS Mode if you intend to use Interstage BPM in the SaaS Software as a S
147. perties importProperties bat lt File Name gt lt Database User Name gt lt Password gt lt TenantName gt Note that lt TenantName gt is case sensitive Example importProperties bat MyServerConfiguration properties SomeUserName SomePassword Default Solaris For System Properties Linux importProperties sh lt File Name gt lt Database User Name gt lt Password gt Example importProperties sh MyServerConfiguration properties SomeUserName SomePassword For Tenant Properties importProperties sh lt File Name gt lt Database User Name gt lt Password gt lt TenantName gt Note that lt TenantName gt is case sensitive Example importProperties sh MyServerConfiguration properties SomeUserName SomePassword Default For lt File Name gt specify the file name and if required the path of the updated configuration file You need to specify the path if the configuration file is not located in the current directory For lt Database User Name gt and lt Password gt specify the database user account that you defined during deployment of the Interstage BPM Server 4 Inacluster installation each server node must be configured individually Therefore repeat steps 1 3 for the other server nodes 5 Restart the Interstage BPM Server for the changes to take effect Interstage BPM Server and Console Installation Guide WebSphere Application Server 103 Appendix B Silent Mode Installation Appendix
148. pically located at opt SUNWdsee dsee6 bin directory ldapmodify c h hostname p port number of the Directory Server DN of an user who connect to the Directory Server w password of user specified with D option f location of IBPMLDAPAdd 1ldif For example ldapmodify c h machineName p 389 D cn admin cn Administrators cn config w adminpassword f IBPMLDAPAdd ldif ote The import function 1dapmodify command will not overwrite existing settings If you have imported an IBPMLDAPAdd 1dif file previously duplicate settings will be detected and rejected An appropriate message will appear 10 2 3 Using Existing Sun Java System Directory Server Users and Groups If you are new to Interstage BPM and are already using Sun Java System Directory Server as the Directory Service to maintain your organization s users and Groups you can use your existing directory structure with Interstage BPM You can do this by designating your LDAP Users as Interstage BPM users and your LDAP Groups as Interstage BPM Roles This involves the modification of two special LDAP Groups IflowUsers and IflowGroups When you imported the IBPMLDAPAdd 1dif file you created two LDAP Groups under your main Organizational Unit ou called tflowUsers and IflowGroups Of course this assumes that you Interstage BPM Server and Console Installation Guide WebSphere Application Server 93 10 Setting Up a Directory Service specified your main orga
149. plication Server 50 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server 6 7 8 User and Group Management The Directory Server Selection screen appears only if you have selected the SaaS mode with the option to create a default tenant or the non SaaS mode In this screen you select the system to be used for managing users and groups and you define the Interstage BPM default tenant account W interstage Business Process Manager Deployment and Configuration xi Directory Server Selection for Default Tenant Select the type of Directory Server you wish to use with Interstage Business Process Manager Enter a username and password to define an Interstage Business Process interstage Manager Tenant Owner account M Directory Servers and Local User Management LDAP Directory Service Adapter C Microsoft Active Directory Adapter Use Local User Management r Interstage Business Process Manager Tenant Owner Account Username pm sevei OO O Password eessssssss Confirm Password eeeeceeccee lt Back Finish Cancel Figure 16 Directory Service Selection and Authentication 1 Inthe Directory Servers and Local User Management area select one of the following options e LDAP Directory Service Adapter e Microsoft Active Directory Adapter e Use Local User Management ote If you use Sun Java System Directory Server as your Directory Service select LDAP Directory Service A
150. plication Server 6 1 and Starting Interstage BPM Server on page 58 and Starting Interstage BPM Console and Tenant Management Console on page 61 To configure the SOAP Listener 1 Check to make sure that the services required for SOAP Messaging are available with the following instructions a Enter the following URL in the Location field of your browser http lt host gt lt port gt lt context root gt lt tenant name gt soap soapindex jsp Example http ConsoleHost 9001 console default soap soapindex jsp oO wm If no page is displayed the SOAP Services are not available so you must start them by running the following batch file lt Interstage BPM Console gt web soap soaplisteners start bat on Windows or lt Interstage BPM Console gt web soap soaplisteners start sh on UNIX ote Incase you need to stop the SOAP services run the following batch file lt Interstage BPM Console gt web soap soaplisteners stop bat on Windows or lt Interstage BPM Console gt web soap soaplisteners stop sh on UNIX Interstage BPM Server and Console Installation Guide WebSphere Application Server 67 7 Deploying only the Interstage BPM Console ote You may need to update the following in the startup and stop scripts before running them e JAVA_HOME and INSTALL_DIR properties e MACHINE _NAME and port numbers in all URLs c Click Run The Apache SOAP Admin page appears d Click List If the required services are available
151. ployments in Silent Mode using this script Minor deployment variations can be handled by editing the script Setting Up Silent Mode Operation To set up a Silent Mode operation 1 Start the Deployment Tool 2 Walk through the configuration steps until you reach the Review Information screen On that screen select Generate properties file for silent operation mode 3 Click Finish to start the selected operation Your configuration choices are written to a Silent Mode script named silent lt Date gt The script is located in lt Interstage BPM Server Installation Directory gt server deployment resources ote It is recommended you rename the Silent Mode script because it will be overwritten if you regenerate it You can now use the script to perform the recorded operations on other computers in Silent Mode Running Silent Mode Operations Prerequisite You have created a Silent Mode script as instructed in section Setting Up Silent Mode Operation on page 108 To run the Deployment Tool in Silent Mode 1 Install Interstage BPM on the computer where you want to run the Deployment Tool in Silent Mode 2 Copy the Silent Mode script that you recorded to the computer where you want to run the Deployment Tool in Silent Mode You can copy the script to a directory of your choice 3 Open the Silent Mode script in a text editor and make any changes necessary to make it run properly in the different environment Refer to sect
152. puter hosting the Directory Service ubapppsuffix Jac fujitsu de com Jac fujitsu de com dc com Directory Service Key Service Key oro Send Unit Interstage BPM Tenant Owner Parameter Sample Value without Description spaces LDAPAccessUserID ibpm_serverl User name of Tenant Owner of the default tenant LDAPAccessUserPassword ibpm_serverlpassword Password of Tenant Owner of the default tenant Other Settings Parameter o Sample Value Value Description sone i server MetadataRepositoryURL http localhost URL of the repository to which 53305 CentraSite metadata will be published CentraSite ino dav ino dav projects MetadataRepositoryUserName RepositoryAdministrator Name of the user used for publishing metadata Interstage BPM Server and Console Installation Guide WebSphere Application Server 115 Parameter Appendix C Silent Mode Deployment MetadataRepositoryPassword RepositoryAdminPassword UDDIBusinessName UDDIPublishURL UDDIPublisherUserName UDDIPublisherPassword UDDIInquiryURL MyCompany http localhost 53307 UddiRegistry publish RegistryAdministrator RegistryAdminPassword http localhost 53307 UddiRegistry inquiry Password of the user specified in MetadataRepositoryUserName Name of the organization that is publishing process definition information to the UDDI registry URL of the UDDI registry to which process
153. py the createADUser ldif and createADUser bat files located in lt Interstage BPM Server Installation Directory gt client samples configuration to another directory If the Active Directory Server is different from the Interstage BPM Server copy the files to the Active Directory Server 5 To create a new user update the copies of the createADUser 1dif and createADUser bat files Refer to the instructions in the files for details 6 Ensure that the createADUser 1dif file is located in your current directory 7 Execute the createADUser bat batch file 8 Restore the Password Policies if you changed them in a previous step 10 1 4 Adding New Users Using the GUI ote To create users that are valid for Interstage BPM use only alphanumeric characters hyphens and underscore characters _ User names must not begin with an at character as this is used to identify Agents in Interstage BPM To add new users using the ActiveDirectory GUI 1 Launch the Active Directory Console if you haven t already done so by selecting Start gt Settings gt Control Panel gt Administrative Tools gt Active Directory Users and Computers Expand the host name and the domain name to find the people Organizational Unit 2 Right click people Interstage BPM Server and Console Installation Guide WebSphere Application Server 84 10 Setting Up a Directory Service 3 From the popup menu select New and then select User to open the New
154. r Installation Directory gt client samples configuration to the Active Directory Server 4 Ensure that the IBPMADAdd 1dif file is in your current directory 5 Execute importAD bat 6 Restore the Password Policies to their original settings if you changed them in a previous step Using Existing Active Directory Users and Groups If you are new to Interstage BPM and are already using Active Directory as the Directory Service to maintain your organization s Users and Groups you can use your existing directory structure with Interstage BPM You can do this by designating your LDAP Users as Interstage BPM users and your LDAP Groups as Interstage BPM Roles This involves the modification of two special LDAP Groups IflowUsers and IflowGroups When you imported the IBPMADAdd ldif file refer to section Importing the IBPMADAdd dif File on page 82 you created two LDAP Groups under your main Organizational Unit ou called IflowUsers and IflowGroups Of course this assumes that you specified your main organizational unit when you deployed Interstage BPM These two special LDAP Groups can be used to allow your LDAP Users and Groups access to Interstage BPM To give your LDAP Users access to Interstage BPM as Interstage BPM users add them as members of the I1flowUsers group You can add each user individually or add a group that contains the users Users in the Group sub levels are also given access To give your LDAP Groups access to Interstage BP
155. r and Console Installation Guide WebSphere Application Server 21 5 Preparing for Installation and Deployment of Interstage BPM Server and Console If everything has been installed correctly the WebSphere Application Server starts Interstage BPM Server and Console Installation Guide WebSphere Application Server 22 6 1 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server Use the information in this chapter if e You plan to install and deploy Interstage BPM Server and Console together e You plan to install and deploy only the Interstage BPM Server ote When you deploy Interstage BPM Console Interstage BPM Tenant Management Console is also automatically deployed For other combinations refer Overview of Integrated Deployment of Interstage BPM Server and Console on page 17 Interstage BPM comes with an installation program and a Deployment Tool The installation program installs the product documentation the Deployment Tool and all files required for subsequent deployment of the Interstage BPM Server and Console to an application server of your choice The Deployment Tool walks you through the required configuration steps and performs the actual deployment to an application server This chapter explains how to perform server and console installation using the installation program and the Deploy
156. r values must be escaped by backslashes For example a server address is specified like this ibpmhost 49950 Be careful with any configuration changes If you specify invalid values the Interstage BPM Server may not be able to start or errors may occur at runtime Some configuration parameters have a lt Hostname gt Or lt Hostname gt lt Servername gt suffix appended to their names These suffixes are automatically removed during the export and are automatically appended during the import Do not add these suffixes to the parameter names Passwords in the generated configuration file are encrypted for security reasons If you change a password you are recommended to encrypt it before importing the configuration file Passwords are not automatically encrypted during the import For details on how to encrypt passwords refer to section Password Encryption on page 97 3 Import the updated configuration file into the database by running the import script located in lt Interstage BPM Server Installation Directory gt server deployment bin Interstage BPM Server and Console Installation Guide WebSphere Application Server 102 Appendix A Security Operating System Configuration Import Script Windows For System Properties importProperties bat lt File Name gt lt Database User Name gt lt Password gt Example importProperties bat MyServerConfiguration properties SomeUserName SomePassword For Tenant Pro
157. rConf xml file of the previous version to the lt DMSRoot gt apps System directory 5 Copy the previous versions of each of the following to each application folder in the lt DMSRoot gt apps lt application id gt directory HTTPAgent xml file tp xml file e Business Calendar ca1 files DataSourceDefinition xml file ote Donot migrate Decision Table Management DTM configuration files from previous versions of Interstage BPM Interstage BPM v11 0 does not support DTM configuration files of previous versions Interstage BPM Server and Console Installation Guide WebSphere Application Server 77 9 3 9 4 9 5 9 Upgrading Interstage BPM from Previous Versions ote From version 11 0 of Interstage BPM e Parent process definitions can only call sub process definitions if they exist in the same application To continue using parent process definition from previous versions in Interstage BPM v11 0 enusre their sub process definitions exist in the same application as the parent process definition You cannot migrate process instances from one application to another You cannot copy process definitions from one application to another Migrating Application Owners from Previous Versions to interstage BPM v11 0 When you migrate pre v11 0 applications to Interstage BPM v11 0 the user group having the role of AdminRole is automatically set as the owner of the application After application migration if you wa
158. re versions and editions that are supported by Interstage BPM To prepare the WebSphere Application Server 1 Install WebSphere Application Server according to the WebSphere installation documentation When installing WebSphere Application Server 6 1 Network Deployment ND Edition on the WebSphere Application server environments screen select the Application Server environment 2 Start the WebSphere Application Server using the startup script located in lt webSphere Installation Directory gt AppServer bin Operating System Startup Script Windows startServer bat lt Server Name gt Example startServer bat serverl Solaris startServer sh lt Server Name gt Example startServer sh serverl Linux startServer sh lt Server Name gt Example startServer sh serverl On Windows you can also start the application server using the following menu path WebSphere Application Server Start gt Programs gt IBM WebSphere gt Application Server Base Edition Base V6 1 gt Profiles gt AppSrv01 gt Start the server WebSphere Application Server Start gt Programs gt IBM WebSphere gt Application Server Network Deployment ND Network Deployment V6 1 gt Profiles gt AppSrv01 gt Start the Edition server ote These instructions must be modified if you are using a WebSphere server other than the default server server1 Refer to your WebSphere installation instructions for the details on this Interstage BPM Serve
159. re you make any changes to the Server configuration make a copy of the server configuration file you exported as a back up In case you make errors while editing parameters Interstage BPM Server may not be able to start or errors may occur at runtime In such a case you can import the back up file which contains a working configuration 2 On each cluster node add the following entries to the configuration file ServerName lt Hostname gt ServerSharedRoot lt Path of shared ResourceRoot in file server gt Example Interstage BPM Server and Console Installation Guide WebSphere Application Server 127 Appendix D Clustering Load Balancing and Failover These are the settings on IBPMHST1 ServerName IBPMHST1 ServerSharedRoot MyFileServer InterstageBPMShared These are the settings on IBPMHST2 ServerName IBPMHST2 ServerSharedRoot MyFileServer InterstageBPMShared oO On any one of the cluster nodes add the following entry to the configuration file ibpm properties located in lt Interstage BPM Server Installation Directory gt server instance default ServerInCluster true aN Check the default settings for the multicast group A multicast group is used to distribute information among the Interstage BPM Servers in a cluster These are the default settings used by the Interstage BPM Servers e Multicast port number 5000 e Multicast group address 225 4 5 6 A multicast group address is an IP a
160. ring a password and confirming it are optional for Sun Java System Directory Server Interstage BPM requires a password to log in 4 The other fields such as E Mail Phone and Fax are not used by Interstage BPM 10 2 5 Adding New Groups You can add new Groups by manually editing a copy of the IBPMLDAPAdd 1dif file or by using the Directory Service Control Center through JavaWeb Console ote Do not edit the tBPpMLDAPAdd 1dif file in the lt Interstage BPM Server Installation Directory gt client samples configuration directory because it will be overwritten if you re execute a server instance setup Copy the file to another directory and edit the copy When you create new groups note the following 1 To create Groups that are valid for Interstage BPM use only alphanumeric characters hyphens and underscore characters _ Group names must not begin with an at character as this is used to identify Agents in Interstage BPM 2 Groups are known as Roles in Interstage BPM There is a default Group named Role installed by Interstage BPM when you import the IBPMLDAPAdd ldif file 3 After a normal installation using the Sun Java System Directory Server the default Administrator Group is called AdminRole You can change this default name by modifying the AdminRole parameter of the Interstage BPM Server For a parameter description refer to the Interstage Business Process Manager Server Administration Guide To this Group
161. rise Applications Page with Console Started 8 In a Web browser To access the Interstage BPM Tenant Management Console enter the URL http lt hostname gt lt port gt console TenantManager page e To access the Interstage BPM Console enter the URL http lt hostname gt lt port gt console lt TenantName gt Here e lt hostname gt is the machine name of the computer upon which you have deployed the Interstage BPM Console The default port is 9080 e lt TenantName gt is the name of the tenant if you are in non SaaS mode this is default Itis recommended to use the tenant name in the URL with the same case as it has been created with during deployment Tenant name in the URL is case sensitive for accessing certain features The Login page appears 9 Log on to Interstage BPM Console or Tenant Management Console You can now begin using Interstage BPM Console and Tenant Management Console Refer the Interstage BPM Console Online Help and Interstage BPM Tenant Management Console Online Help for details ote For information about further configuration of Interstage BPM Console refer Interstage BPM Console Other Configurations on page 66 Interstage BPM Server and Console Installation Guide WebSphere Application Server 63 7 1 7 2 7 Deploying only the Interstage BPM Console Deploying only the Interstage BPM Console Use the information in this chapter if having already installed and deployed In
162. rocess definitions to a UDDI registry select Enable Publishing to UDDI Registry and enter the following information e UDDI Business Name Name of the organization that is publishing process definition information to the UDDI registry It is an identifier that helps you to categorize the process definition information added to the UDDI registry and makes it easier to search and retrieve the process definition Web Services For CentraSite use your company name Make sure that the company name specified is registered as an organization in CentraSite e UDDI Publish URL URL to which UDDI registry information will be published when an Interstage BPM process definition is published For CentraSite use the following URL http lt hostname gt 53307 UddiRegistry publish e UDDI Publish Username Name of the user used for publishing UDDI registry information This user must be a CentraSite Administrator Also the user must have rights to publish data to the organization specified in UDDI Business Name For CentraSite specify the name of the user who registered the UDDI Business Name as an organization in CentraSite On Windows Specify a fully qualified user name i e user name including the domain name lt DOMAIN NAME gt lt user name gt Specify the domain name in capital letters If you specify a local user use the hostname as a domain name e g MYLOCALHOST myusername e UDDI Publish Password Password of the user used for publishin
163. rstage BPM Server Console from the application server a Log out of all Interstage BPM Clients and close all Browser windows Interstage BPM Server and Console Installation Guide WebSphere Application Server 72 8 Undeploying and Uninstalling Interstage BPM Server and Console 2 Start the Interstage BPM uninstallation program e OnWindows select Start gt Programs gt Interstage Business Process Manager gt Uninstall Alternatively you can use the Windows Control Panel Start gt Settings gt Control Panel gt Add or Remove Programs gt Interstage Business Process Manager e On Solaris run lt Interstage BPM Server Installation Directory gt uninst uninstall sh e OnLinux run lt Interstage BPM Server Installation Directory gt _uninst uninstall sh 3 For platforms other than Windows the Welcome screen will appear On this screen click Next to launch the Deployment Tool 4 On Windows Select the appropriate radio button on the Deployment Tool Option Screen and click Next ote If you have already removed the Interstage BPM Server and Console from the application server make sure that you select the Do not launch Deployment Tool radio button Interstage Business Process Manager InstallShield Wizard Deployment Tool option screen W If you want to launch the Deployment Tool now select the appropriate radio button and click Next C Launch Deployment Tool with 32 bit Java YM Launch Deploymen
164. rstage BPM Server and Console 3 System Requirements for Interstage BPM Server and Console 3 1 Hardware Requirements for Interstage BPM Server and Console Machine and Processor Operating Processor System Windows Fujitsu PRIMERGY or other Intel Minimum Intel Pentium III processor Architecture servers 1 GHz 1 CPU or greater Recommended Intel Pentium III processor 2 GHz 2 CPU or greater Solaris Fujitsu PRIMEPOWER or other Solaris Minimum Ultra SPARC or SPARC64 V servers kernel arch sun4u sun4us sun4qd 1 GHz 1 CPU or greater Recommended SPARC 1 2GHz 2CPU or greater Linux Fujitsu PRIMERGY or other Intel Minimum Intel Pentium III processor Architecture server 1 GHz 1 CPU or greater Recommended Intel Pentium III processor 2 GHz 2 CPU or greater Memory Minimum 1 GB Recommended for Server 2 GB or more Recommended for Console 4 GB or more Hard Drive Recommended for Server 8 GB of free space during runtime at least 1 GB must be available in the tmp directory Please refer the calculation method below Interstage BPM installation 200 MB Log file space Depends on the number of active users As a rule of thumb with the default log level calculate 5 KB for each user logging in For example if 1000 users log in per day the log file increases by 5 MB per day Database server installation Please refer to the product documentation Database space As a rule of thumb 1000 instances of a pr
165. rver with Console OR only the Interstage BPM Server A pop up asking you to Please Wait appears This could take a few minutes When the Interstage BPM Console has started the Enterprise Applications page appears with a message informing you that the Console has started Integrated Solutions Console welcome Help Logout view All tasks H Welcome E Guided Activities a Close page Enterprise Applications 2S C Field help E Messages For field help informatic Servers select a field label or lis E Application InterstageBPMConsole on server server and node itl hw 132150dNode01 started marker when the help cursor appears E Applications successfully nterprise A Enterprise Appl Page help Enterprise Applications More information about this page Resources Use this page to manage installed applications A single application can be deployed onto multiple servers Command Assistance View administrative scripting command for action Security Preferences E Environment Start stop Install Uninstall Update Rollout Update Remove File Export Export DDL _ Export File E System administration Select Name Application Status E Users and Groups E Monitoring and Tuning E Troubleshooting DefaultApplication gt E Service integration InterstaqeBPMConsole E uoo InterstageBPMServer istano aajaa OAR JE A d query Total 5 Figure 23 Enterp
166. rvletWebApp Web module 9 In the message at the top of the page click Review Select Synchronize changes with Nodes and click Save to save the configuration on BR WwW DY N O The Interstage BPM Configuration Tool is now available on each node at http lt hostname gt lt virtual host port gt fujitsu ibpm config webapp IBPMConfigServlet for example http ibpmhst1 9081 fujitsu ibpm config webapp IBPMConfigServlet Setting Up the Interstage BPM Environment for the Cluster To set up the Interstage BPM environment for the cluster 1 Copy the entire contents of lt Interstage BPM Server Installation Directory gt from the Deployment Manager computer to lt Interstage BPM Server Installation Directory gt on all cluster nodes except the following directory InterstageBPMServer ear ote The path to the installation directory of the Interstage BPM Server must be the same on all cluster nodes If you are following the example copy the contents from the pMGRHsT computer to the nodes IBPMHST1 and IBPMHST2 2 On each cluster node update the environment as follows a Edit the environment variable script located in lt Interstage BPM Server Installation Directory gt server deployment WAS Cluster On Windows set IBPMenv cmd Interstage BPM Server and Console Installation Guide WebSphere Application Server 126 Appendix D Clustering Load Balancing and Failover On Solaris setIBPMenv sh On Linux set IBPMen
167. s end users will work with Interstage BPM applications via a firewall administrators however will be using the server segment End users do not need to run applets or other clients requiring the Interstage BPM model This means that the only port that needs to be opened in the firewall is the standard HTTPS port 443 and the Web Server in the server segment The following diagram depicts a deployment situation where Interstage BPM applications are used via a firewall It also shows possible security threats these are described in more detail in the subsequent table Interstage BPM Operation Model Diagram Business Server Segment zone Provided by Interstage BPM Varennes Anne Operational Management Segment zone Web amp BPM Server Application Server User Applications Confidential Server Segment zone Silt In house Network zone Directory Server Authentication Segment zone Figure 36 Interstage BPM Operation Model The following table lists the possible security threats as well as possible solutions Interstage BPM Server and Console Installation Guide WebSphere Application Server 96 A 2 Appendix A Security ff reat oon SSCSC d os Message interception Use SSL Wrong configuration Make sure that your administrators are properly trained and certified and that the firewall the Web Server the Interstage BPM Server the
168. s to start or denies login due to configuration errors you can use the scripts to import a working configuration into the database You can add or edit both System as well as Tenant properties using the export and import scripts For more information about System and Tenant properties refer the interstage BPM Server Administration Guide Interstage BPM Server and Console Installation Guide WebSphere Application Server 100 Appendix A Security The Interstage BPM Server is not required to be running for the configuration export and import scripts to be used To use the configuration export and import scripts 1 Export the server configuration by running the export script located in lt Interstage BPM Server Installation Directory gt server deployment bin Operating System Configuration Export Script Windows For System Properties exportProperties bat lt File Name gt lt Database User Name gt lt Password gt Example exportProperties bat MyServerConfiguration properties SomeUserName SomePassword For Tenant Properties exportProperties bat lt File Name gt lt Database User Name gt lt Password gt lt TenantName gt Note that lt TenantName gt is case sensitive Example exportProperties bat MyServerConfiguration properties SomeUserName SomePassword Default Solaris For System Properties Linux exportProperties sh lt File Name gt lt Database User Name gt lt Password gt Example
169. ssage informing you that the Console has started Interstage BPM Server and Console Installation Guide WebSphere Application Server 80 9 Upgrading Interstage BPM from Previous Versions 19 Start the Interstage BPM Server and Console Refer the following topics Configuring Interstage BPM for WebSphere Application Server 6 1 and Starting Interstage BPM Server on page 58 e Starting Interstage BPM Console and Tenant Management Console on page 61 Interstage BPM Server and Console Installation Guide WebSphere Application Server 81 10 10 1 10 1 1 10 Setting Up a Directory Service Setting Up a Directory Service This chapter provides instructions for setting up your Directory Service Interstage BPM comes with configuration files that you use to configure the Directory Service These configuration files are located in the lt Interstage BPM Server Installation Directory gt client samples configuration directory During deployment configuration files for the Directory Service that you selected in the Deployment Tool were updated with the settings that you specified The lt Interstage BPM Server Installation Directory gt client samples configuration directory contains configuration files for all of the supported Directory Services However the Deployment Tool only updated the configuration files for the selected Directory Service Configuration files for other Directory Services contain placeholders and cannot be used wi
170. ssword as specified in the LDAPAccessUserID LDAPAccessUserPassword parameters of the Interstage BPM Server are correct and you can login to your Directory Server using the above user name password 136 Appendix E Troubleshooting Look for What to do getContext Could not create the Ensure that the LDAP Server is running on the directory services port as specified in the LDAPServer parameter of the Interstage BPM Server You can use telnet ldapServerHostName port from the server host machine to check that the connection to the host port can be established LdapBroker getGroupMembersByDN Could not retrieve the user groups Could not create the directory services LdapBroker Could not retrieve the user groups Could not create the directory services IflowStartup Failed to execute th This is because you installed WebSphere IBPM startup routine task Unable to Application Server in a Cell deployment manager deliver the message for the requested and a managed node environment causing the ByentCLAaSS BOOTSTRAP ADDRESS port to be incorrect in some javax naming ServiceUnavailableException configuration files A communication failure occurred while 1 Get the correct value of the attempting to obtain an initial context BOOTSTRAP ADDRESS port from the WebSphere with the provider URL Application Server Console from Servers gt iiop lt ServerName gt lt Ports gt Make sure Application
171. sword e LDAPAccessUserPassword e MetadataRepositoryPassword e ServerPassword SMTPPassword e SWAPLinkagePassword e UDDIPublisherPassword Example Use the following command to encrypt all passwords in the configuration file at the same time On Windows EncryptPassword bat f C SomeDirectory MyServerConfiguration properties EWAERJQ23FIQ0J22 On Solaris EncryptPassword sh f SomeDirectory MyServerConfiguration properties EWAERJQ23FIQ0J22 On Linux EncryptPassword sh f SomeDirectory MyServerConfiguration properties EWAERJQ23FIQ0J22 Using Demo Mode and Security Mode Interstage BPM can be set to two security levels Demo Mode and Security Mode Demo Mode is useful while key members of your work team learn the features of the software Later Security Mode provides a stable and controlled environment for implementing Interstage BPM across your company Demo Mode restricts access to Interstage BPM in two ways e Only the person who is assigned a work item may make choices about it thus advancing the process to the next work item or completing it e Only members of the AdminRole can access administration functions in the Interstage BPM Console All Interstage BPM users can experiment with all of Interstage BPM functions including creating and editing process definitions and process instances In Security Mode access to process definitions process instances and work
172. t Tool with 64 bit Java YM Donot launch Deployment Tool Installshield Figure 28 Start Deployment Tool For Windows 5 In the Deployment Tool do one of the following e If you have already removed the Interstage BPM Server and Console from the application server click Cancel to exit the Deployment Tool Interstage BPM Server and Console Installation Guide WebSphere Application Server 73 8 Undeploying and Uninstalling Interstage BPM Server and Console e If you have not yet removed the Interstage BPM Server and Console from the application server click Server Console instance removal to start the removal process For further instructions refer to section Undeploying Interstage BPM Server and Console from the Application Server on page 69 In either case after exiting the Deployment Tool you will return to the uninstallation program On Windows when asked if you want to completely remove the selected application and all of its features click Yes Next During uninstallation the uninstallation program may ask you to confirm the deletion of some files Decide whether you want to keep or remove the files When the uninstallation is complete click Finish Make sure that the lt NodeName gt lt ServerName gt lt NodeName gt IBPMBuss directory and all of its subdirectories under lt webSphere Installation Directory gt AppServer profiles AppSrv01 databases com ibm ws sib directory have been deleted by the
173. tabase On Solaris opt oracle product 10 2 0 db_1 database On Linux opt oracle product 10 2 0 db_1 database db_javahome On Windows c j2sdk Absolute path to the top level directory of your JDK or JRE On Solaris usr java installation On Linux usr java Interstage BPM System Administrator Super User Parameter Sample Value without Description spaces systemadminuser ibpm admin User name of the Interstage BPM System Administrator Super User systemadminpassword ibpm_adminpassword Password of the Interstage BPM System Administrator Super User Interstage BPM SaaS Mode Selection Parameter Sample Value without Description spaces MultiTenancyMode_ SAAS true Boolean string value true or false to select or de select the SaaS mode Ensure this value is always opposite that of the MultiTenancyMode_ Non SAAS parameter CreateDefaultTenant_SAAS Boolean string value true or false to select or de select creation of the default tenant Interstage BPM Server and Console Installation Guide WebSphere Application Server 114 Appendix C Silent Mode Deployment Parameter Sample Value without Description spaces MultiTenancyMode Non SAAS Boolean string value true or false to select or de select the non SaaS mode Ensure this value is always opposite that of the MultiTenancyMode_ SAAS parameter Directory Service Parameters LDAPServer myhost Host name or IP address of the com
174. tabase Setting Microsoft SQL Server User name of a non administrative database user account Example ibpmuser Password of the non administrative database user account Database instance name Database server host name or IP address of the server that hosts the database instance Database port number Default 1433 Database administrator password Package name of the JDBC driver class typically com microsoft sqlserver jdboc SQLServerDriver Location of the database JDBC driver sqljdbc jar Example c MicrosoftSQLServer 2005JDBCDriver sqljdbc_1 2 enu Database top level directory typically C Program Files Microsoft SQL Server Database directory typically C Program Files Microsoft SQI Server MSSQL 1 MSSQL Data Location of a JDK or JRE installation on the database server computer Database connection URL typically jdbc sqlserver lt Hostname gt lt Database Port gt databaseName teamf lowdb Interstage BPM Server and Console Installation Guide WebSphere Application Server 25 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server Database Settings Oracle User name of a non administrative database user account Example ibpmuser Password of the non administrative database user account Host name or IP address of the computer that hosts the database instance Connection identifier of the database typically the database name Package name of
175. terstage BPM Server separately you plan to deploy only Interstage BPM Console It is recommended that you read the overview of the deployment procedure before starting the deployment Refer to System Requirements for Interstage BPM Server and Console on page 15 and to the Release Notes for details on the required components ote When you deploy Interstage BPM Console you also automatically deploy Interstage BPM Tenant Management Console Permissions Required for Deployment You must have read write and execute permissions on the installation directory of Interstage BPM Console Overview of Installation and Deployment of Interstage BPM Console This section summarizes the steps required for installing and deploying only Interstage BPM Console Installing and Deploying only Console on WebSphere 1 Make sure Interstage BPM Server is already installed and deployed Refer chapter Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server on page 23 2 Make sure the application server is running Refer section nstalling and Starting WebSphere Application Server on page 21 3 Deploy Interstage BPM Console to the application server using the Deployment Tool Refer section Deploying Interstage BPM Console Using the Deployment Tool on page 65 4 Make sure Interstage BPM Server is running Refer section Configuring Interstage BPM for WebSphere Application Server 6 1 and Starting Interstage BPM Server on
176. the application server using the following menu path WebSphere Application Start gt Programs gt IBM WebSphere gt Application Server Server Base Edition Base V6 1 gt Profiles gt AppSrv01 gt Stop the server WebSphere Application Start gt Programs gt IBM WebSphere gt Application Server Server Network Deployment Network Deployment V6 1 gt Profiles gt AppSrv01 gt Stop ND Edition the server b To start the application server run the startup script located in lt WebSphere Install dir gt AppServer profiles AppSrv01 bin Operating System Startup Script Windows startServer bat lt Server Name gt Note If your WebSphere administrative security is enabled use this script startServer bat lt ServerName gt user lt Admin UserName gt password lt Admin password gt Solaris startServer sh lt Server Name gt Linux Note If your WebSphere administrative security is enabled use this script startServer sh lt ServerName gt user lt Admin UserName gt password lt Admin password gt On Windows you can also start the application server using the following menu path WebSphere Application Start gt Programs gt IBM WebSphere gt Application Server Server Base Edition Base V6 1 gt Profiles gt AppSrv01 gt Start the server WebSphere Application Start gt Programs gt IBM WebSphere gt Application Server Server Network Deployment Network Deployment V6 1 gt Profiles gt AppSr
177. the database and if you plan to use a remote user store the Directory Service on the same computer carpe J2EE Engine Application Server Configure amp deploy interstage BPM Server Configure Database Figure 1 All systems on the same computer MEELA CSE o F 3 o o3 30 Sa e sa oe so re Ww Computer LS Interstage BPM Component Sa External Software Component For details about the architecture of Interstage BPM refer to the Interstage Business Process Manager Server Administration Guide Interstage BPM Server and Console Installation Guide WebSphere Application Server 12 1 System Configurations for Interstage BPM Server 1 2 Database on Remote Computer The following figure shows a configuration where the Interstage BPM Server and the database are installed on separate computers J2EE Engine Application Server Configure amp deploy interstage BPM Server SsJUGUOdWOD JAS Joo juawAoldag Wd e6e ss9 uU 7 TE 35E os os 5 3s oe gt TE 53 95 a5 w External Software Component eae eae EZ computer Dir pannoo SAET E Interstage BPM Component Figure 2 Database on Remote Computer To set up this configuration you install the Interstage BPM Server software on the computer hosting the database and use the Deployment Tool to configure the database Next you install the Interstage BPM Server software on the computer hosting the application ser
178. this parameter is 3600 seconds that is the LDAP Cache will be checked every hour If this parameter is set to 1 new user and Group information is retrieved from the Directory Service every time it is needed Refer to the nterstage Business Process Manger Server Administration Guide for more information about the configuration parameters of the Interstage BPM Server Each entry in the cache has a timestamp that is set to the last time that group was read from the Directory Service Whenever someone calls the Directory Adapter to fetch a Group the Directory Adapter checks if that Group is in the cache If the Group requested is not in the cache it is read in and timestamped with the current time If the Group requested is already in the cache the timestamp is checked If the Group was timestamped before the previous cache check it is at a time before LDAPGroupCacheAgeSec seconds ago then just that Group is deleted from the LDAP Cache and read back in from the Directory Service All other Groups in the cache are unaffected User Attribute Caching The generic structure of an Interstage BPM user s profile is stored using multiple user attributes These attribute values include the user s ID email manager or subordinate s ID and so on Inclusion of manager or subordinate information in the Interstage BPM user profile allows mapping of your company s organization and people structure so that Interstage BPM can further use this informat
179. thout modifications If you selected Interstage BPM s local user store during deployment no configuration files were updated Do not edit the configuration files in the lt Interstage BPM Server Installation Directory gt client samples configuration directory because these files will be overwritten if you re execute a server instance setup Before making any changes copy the configuration files to another directory and edit the copy Setting Up Microsoft Active Directory This section provides instructions for setting up Microsoft Active Directory Active Directory uses a form of the Lightweight Directory Access Protocol LDAP Like all LDAP type Directory Services Active Directory organizes people into Groups and maintains a user profile with the appropriate permissions for each user The Active Directory setup procedure must be performed on the domain controller for your network by an Administrator To customize your Active Directory Server installation 1 Import the IBPMADAdd 1dif file into your Directory Server The IBPMADAdd 1dif file contains the default Interstage BPM users and Groups 2 Add users and Groups to the Directory Service Importing the IBPMADAdd ldif File To effectively import the IBPMADAdd 1dif file you must have permission to import the file on the machine containing the Active Directory domain controller The batch file importAD bat imports the IBPMADAdd 1dif file but it must be moved to the
180. tificationTopic JImsSQNotificationTopic iFlow jms TopicDistConnectionFactory iFlow jms sq SQNotificationTopic JmsNamingProviderURL corbaname IBPMHST1 2809 IBPMHST2 2809 cel1 clusters IBPMCluster Interstage BPM Server and Console Installation Guide WebSphere Application Server 128 Appendix D Clustering Load Balancing and Failover n On IBPMHST2 set the parameters to JmsNotificationTopic iFlow jms TopicDistConnectionFactory iFlow jms NotificationTopic JImsSQNotificationTopic iFlow jms TopicDistConnectionFactory iFlow jms sq SQNotificationTopic JmsNamingProviderURL corbaname IBPMHST1 2809 IBPMHST2 2809 cel1 clusters IBPMCluster ServerHost IBPMHST2 6 On each cluster node also ensure the values of the following node specific properties are correct e KPIListenerConfigFile e ServerBaseURL e ServerEmailBaseURL e ServerName e ServerRoot 7 Before importing the configuration file to the database delete the older system properties from the database from the 1BpMProperties table using the following SQL command 8 On each cluster node run the configuration import script located in lt Interstage BPM Server Installation Directory gt server deployment WAS Cluster Operating System Configuration Import Script Windows importProperties bat lt File Name gt lt DB UserName gt lt Password gt Solaris importProperties sh lt File Name gt lt DB UserName gt
181. tion Server 11 1 System Configurations for Interstage BPM Server 1 System Configurations for Interstage BPM Server Interstage Business Process Manager Interstage BPM is a server based workflow engine with APIs Application Programming Interfaces for workflow application development The Interstage BPM Server runs on an application server providing load balancing and failover capabilities and it operates with a database which persistently stores and maintains all process information A user and group store is required to manage Interstage BPM user accounts and to expand a group into a list of users Depending on your choices when deploying the server users are managed either in Interstage BPM s local user store or in a Directory Service Groups can be managed in Interstage BPM s local group store in a Directory Service or in both systems The Interstage BPM Server is shipped with a Deployment Tool which is used to e Configure the database the application server and the Interstage BPM Server e Deploy the Interstage BPM Server to the application server Deploy the Interstage BPM Console to the application server The system configurations described in the next sections are typically used The decision of the configuration to be used depends on the desired performance of the employed systems 1 1 Minimum Configuration All Systems on the same Computer You can install the Interstage BPM Deployment Tool the Interstage BPM Server
182. tion about supported versions refer to the Release Notes ote Ensure that the value of the environment variable ORACLE_HOME is set to the path of the Oracle installation directory for UNIX environment 2 Create a new database instance for Interstage BPM When deploying the Interstage BPM Server you will specify this instance The default database instance for Oracle is orcl ote Make sure that the database instance is created with the following character sets e AL32UTF8 as the database character set e AL16UTF16 as the national character set These settings are required to support Unicode UTF 16 characters Refer to the Oracle documentation for instructions on how to install Oracle and a database instance 3 For performance reasons the following settings are required The database instance must be configured with at least 1 GB System Global Area SGA size The database statistics must be up to date Depending on the number of changes it might be appropriate to collect the statistics explicitly although the database server is doing this automatically every 24 hours per default Interstage BPM Server and Console Installation Guide WebSphere Application Server 19 5 Preparing for Installation and Deployment of Interstage BPM Server and Console 4 Make sure that a TCP IP version of Oracle s SQL Net is installed The Oracle JDBC driver requires a TCP IP version of Oracle s SQL Net This is the default for a standard inst
183. ts E 2 3 Timeout During JavaScript EXeCution 0 c cece eeeeeeeeeeeeecneeeeeeeneeeeeeenaeeeeeeeaas 137 E 2 4 Failure in Writing to an Oracle Database ccceececeeeeeeeeeeeeeeeeetteeeeeeeteeeeeees 138 E 3 Errors During Installation Deployment and Configuration ccceeee 138 E 4 Errors during Starting the Interstage BPM Server cccccssseeseeseereeeeeees 141 E 5 Contacting Your Local Fujitsu Support Organization 00 cccccseeeeeeseeeeee 142 TiC gt Gimme ae cre ene re ae OE a ener Ee ae oe eee nee Perr eee 144 Interstage BPM Server and Console Installation Guide WebSphere Application Server 7 About this Manual About this Manual This manual describes how to configure the system environment and install the Interstage Business Process Manager Interstage BPM Server and Console Note that the Interstage BPM Tenant Management Console is automatically deployed when you deploy Interstage BPM Console Intended Audience This manual is intended for Interstage BPM Super Users who are administrators managing Interstage BPM Server It assumes that the reader has a working knowledge of e Operating system administration e Application server administration e Database administration e Directory Service administration This Manual Contains Here is a list of what is in this manual Chapter 1 Title System Configurations for Interstage BPM Server System Configurations for Interstage BPM
184. uninstallation program If they have not been deleted delete them If these directories remain the WebSphere Application Server will fail to start after re installation of the Interstage BPM software Interstage BPM Server and Console Installation Guide WebSphere Application Server 74 9 Upgrading Interstage BPM from Previous Versions 9 Upgrading Interstage BPM from Previous Versions 9 1 Upgrading from Previous Versions of Interstage BPM To upgrade from previous versions of Interstage BPM 1 Before uninstalling the previous version of Interstage BPM back up the following e The Interstage BPM database This is the only way to ensure the retention of your current Interstage BPM data The upgrade process automatically migrates and therefore overwrites process definitions to the current release s formats Use the default functionalities of your database software for backing up your database e The ibpm properties file if upgrading from Interstage BPM v10 x This preserves your previous server configurations If upgrading from Interstage BPM v7 x or v8 x the uninstallation program automatically saves your configuration files with the suffix previous appended to their file names For example the ibpm properties file is saved as ibpmprevious properties After installing the new version of Interstage BPM you can use the saved properties file to manually configure your new server installation For information on how to change the s
185. unning LDAP Key Enter the directory sub tree where groups and users to be used with Interstage BPM are stored LDAP Organizational Unit OU Enter the organizational unit where groups to be used with Interstage BPM are stored Example ou Groups LDAP Port Enter the port number of your LDAP server The port number is typically 389 After deployment you need to configure your Directory Service for Interstage BPM Refer to section Setting Up Sun Java System Directory Server on page 92 for more information 2 Click Next Interstage BPM Server and Console Installation Guide WebSphere Application Server 52 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server 6 7 10 Active Directory Settings On the Active Directory Configuration screen you provide the settings for Microsoft Active Directory W interstage Business Process Manager Deployment and Configuration lo x Active Directory Configuration e The Following field s are either empty or not of expected type Active Directory Host Active Directory Key SV interstage Active Directory Host Active Directory Key mma Active Directory Organizational Unit OU ou Groups Active Directory Port 389 Figure 18 Active Directory Settings 1 Enter the following information Active Directory Host Enter the name of the computer on which your Active Directory server is running Active Directory Key Ent
186. uration tab expand Java and Process Management and click Process Definition Click Java Virtual Machine In the Generic JVM arguments field enter the following value E Pe CN Dibpm nodename lt Server Name gt For lt Server Name gt specify the value of the SERVERNAME parameter that you specified in the environment variable script For more information refer to section Setting Up the Interstage BPM Environment for the Cluster on page 126 Example If you are following the example specify Dibpm nodename ibpmhst1Node01 6 Repeat steps 2 5 for the other servers of your cluster Example If you are following the example repeat the steps for 1BPMMember2 specifying Dibpm nodename ibpmhst2Node01 as a JVM argument Interstage BPM Server and Console Installation Guide WebSphere Application Server 132 D 1 16 D 1 17 Appendix D Clustering Load Balancing and Failover Starting the Cluster To start the Interstage BPM Cluster 1 Start the node agent on all nodes of your cluster cd lt WebSphere Installation Directory gt AppServer profiles AppSrv lt Number gt bin startNode 2 Start the cluster itself To do so a In the Administrative Console for the WebSphere Deployment Manager expand Servers and click Cluster b Select your cluster and click Start It may take several minutes for the cluster to start The status icon in the Status column displays the current startup status Implementing
187. usiness Process Manager Analytics monitoring Select this option if you want to use Interstage BPM Analytics for analyzing and evaluating process data Additional configuration steps must be performed to set up the Interstage BPM Analytics Sensor Refer to the nterstage BPM Analytics documentation for more information Interstage BPM Server and Console Installation Guide WebSphere Application Server 54 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server 2 If you want to publish metadata for process definitions to a metadata repository in the WebDAV Repository Settings area select Publish Metadata to WebDAV Repository and enter the following information e Metadata URL WebDAV Enter the URL to which metadata will be published when an Interstage BPM process definition is published For CentraSite use the following URL http lt hostname gt 53305 CentraSite CentraSite ino dav ino dav projects e Metadata Username Enter the name of the user used for publishing metadata This user must be a CentraSite Administrator On Windows Specify a fully qualified user name i e user name including the domain name lt DOMAIN NAME gt lt user name gt Specify the domain name in capital letters If you specify a local user use the hostname as a domain name e g MYLOCALHOST myusername e Metadata Password Enter the password of the user used for publishing metadata 3 If you want to publish p
188. using the following URL http lt Hostname gt lt Port gt fujitsu ibpm config webapp IBPMConfigServlet b Log in as an Interstage BPM Super User c Set the DebugLevel parameter to 2 d Click Save and Reload properties 2 Replicate the actions that caused the error 3 Contact your local Fujitsu Support organization and provide the following information General Information e Operating System e Directory Service type and version e Database server type and version e JDK or JRE version e Application server type and version e Interstage BPM edition version and build number e Major problem area e Priority of the issue Environment in which the problem occurs Interstage BPM Server and Console Installation Guide WebSphere Application Server 142 Appendix E Troubleshooting Configuration Information e The configuration file that you exported from the Interstage BPM Server Log Files e All log files from lt Interstage BPM Server Installation Directory gt server instance default logs e When using WebSphere All log files from lt webSphere Installation Directory gt profiles lt Your Application Server Profile gt logs lt Your Server gt OS System Logs e The Windows event log that you obtain using the Windows Event Viewer e UNIX system logs stored in var adm messages e Linux system logs stored in var log messages Problem Description Description of the steps you performed before the problem occurred e Freque
189. v sh o wm Set the NODE NAME SERVER_NAME and SERVERNAME parameters to the correct values of that cluster node The SERVERNAME parameter is used to identify the cluster node s configuration within Interstage BPM Make sure that the specified name is unique in the cluster To achieve this you could use the same value as for the node name Example If you are following the example on IBPMHST1 set the parameters to E NAME ibpmhst1Node01 ER NAME IBPMMemberl ERNAME ibpmhst1Node01 E l1bpmhst2Node01 ER NAME IBPMMember2 ERNAME ibpmhst2Node01 D 1 12 Updating the Interstage BPM Server Configuration Prerequisites e Oneach cluster node you have updated the environment variables as explained in section Setting Up the Interstage BPM Environment for the Cluster on page 126 e The database server is running You must change some server configuration settings to complete the cluster s server configuration To update the Interstage BPM Server configuration 1 On each of the cluster nodes from the database export system level server configuration parameters into a configuration file lt filename gt properties Configuration Import Script exportProperties bat lt filePath gt lt Database User Name gt lt Password gt exportProperties sh lt filePath gt lt Database User Name gt lt Password gt Befo
190. v01 gt Start ND Edition the server Interstage BPM Server and Console Installation Guide WebSphere Application Server 60 6 Installing and Deploying Interstage BPM Server with Console OR only the Interstage BPM Server If everything has been installed correctly your WebSphere Application Server starts The Interstage BPM Server also starts Interstage BPM for WebSphere is now ready to use If you want to change the hostname of the computer where WebSphere Application Server and Interstage BPM have been installed you can do so However make sure that you replace the old hostname in directory names under the WebSphere installation directory For example if you change the hostname from ibpmhost to testhost you must rename directories like lt webSphere Installation Directory gt AppServer profiles AppSrv01 config cells ibpmhostNode01Cell1 to lt WebSphere Installation Directory gt AppServer profiles AppSrv01 config cells testhostNode01Cell 6 12 Starting Interstage BPM Console and Tenant Management Console Prerequisites The application server where you have deployed Console is running To start Interstage BPM Console or Tenant Management Console 1 Ensure Interstage BPM Server is started Refer section Configuring Interstage BPM for WebSphere Application Server 6 1 and Starting Interstage BPM Server on page 58 2 Login to the WebSphere Administration Console 3 Select Applications gt Enterprise Applications A l
191. ver The Interstage BPM Deployment Tool can then be run from that computer to configure the application server and deploying the Interstage BPM Server to the application server In the configuration shown above the Directory Service is also installed on a remote computer However this has no impact on the Interstage BPM installation procedure Interstage BPM Server and Console Installation Guide WebSphere Application Server 13 2 System Configurations for Interstage BPM Console 2 System Configurations for Interstage BPM Console The Interstage BPM Console is the Client that connects to the Interstage BPM Server The Interstage BPM Console must run on the same type of application server as the Interstage BPM Server to which it connects The system configurations described in the next sections are typically used The decision of the configuration to be used depends on the desired performance of the employed systems 2 1 Minimum Configuration All Systems on the same Computer You can install the Interstage BPM Server and Console on the same computer Application Server JSP Container Customer Application Figure 3 All systems on the same computer For details about the architecture of the Interstage BPM Server refer to the Interstage Business Process Manager Server Administration Guide Interstage BPM Server and Console Installation Guide WebSphere Application Server 14 3 System Requirements for Inte
192. ver 117 133 Index G Group Add 87 Add member 89 Group Caching 95 Groups 56 H Hardware requirements 15 ibpm properties 56 Installation procedure overview 29 only Console 64 Interstage Analytics 54 Interstage BPM deploying 39 documentation list 10 installation on a laptop 23 installing 31 removing 69 uninstalling 72 upgrading from a previous version 75 Interstage BPM Console other configurations 66 Overview 14 starting 61 Interstage BPM Server Deployment Tool 12 overview 12 L LDAP Add members to Groups 89 Add new Groups 87 Add new users 83 IBPMADAdd ldif 82 Setup 82 Users and Groups 83 LDAP settings 52 Load balancing 117 Interstage BPM Server and Console Installation Guide WebSphere Application Server 144 Microsoft SQL Server settings 45 Microsoft Active Directory 82 Minimum configuration Server 12 O Oracle preparing 19 settings 47 P Passwords encryption 97 protection 56 R Remote database 13 Removing Interstage BPM 69 Roles 56 S Security features 96 Security Mode 99 Server System configuration Minimum configuration 12 Remote database 13 Server System configurations 12 Silent Mode deployment 108 Silent Mode installation 104 Index Starting Interstage BPM Console 61 Sun Java System Directory Server 92 Add new users 94 Import IBPMLDAPAdd ldif 93 Start 93 Sun Java System Directory settings 52 System requ
193. xample IBPMDistBus Then click Finish and Save Add the servers of your cluster as members of the new bus To do so a On the Buses page click the name of the new bus b On the Configuration tab click Bus members c Click Add From the Server dropdown list select a server of your cluster Then click Next If you are following the example select ibpmhst1Node01 IBPMMember1 Qa e Make sure that File Store is selected as the message store Then click Next f Use the default message store properties and click Next g Click Finish h In the message at the top of the page click Review Select Synchronize changes with Nodes and click Save to save the configuration i Repeat substeps c h for the remaining servers of your cluster If you are following the example add ibpmhst2Node01 IBPMMember2 as another bus member Create the required topic destinations for the new bus To do so a Return to the Buses gt lt Your newly created bus gt page for example Buses gt IBPMDistBus b On the Configuration tab click Destinations c Create the following destinations of type Topic space for this bus e JmsNotification Topic Space e SQNotification Topic Space d In the message at the top of the page click Review Select Synchronize changes with Nodes and click Save to save the configuration D 1 8 Configuring JMS To configure the JMS settings for your cluster 1 In the Administrative Console for the WebSphere
194. yment of Interstage BPM Console 64 Deploying Interstage BPM Console Using the Deployment Tool 65 Starting Interstage BPM Console ccccesceeseeeeeeeeeee eee eeeeeeeeeaeeeeeeseeeeeeseeeeeeeeed 66 Interstage BPM Console Other Configurations cccsscccesssereesesseeeeeeeseeee 66 Configuring Interstage BPM Console to work with Interstage Analytics 66 Configuring the SOAP Listener 0 ccc cceceeeeeeeee teeter eee teeeeeeeseeeeeeeeteeaeeeeteeaaeey 67 Undeploying and Uninstalling Interstage BPM Server and COMS O16 ios ATT TA E TT 69 Undeploying Interstage BPM Server and Console from the Application OPV OM e AEA dovcvcy eee isversiechnsugecait feeryseueduoustewueds T 69 Uninstalling Interstage BPM ccccccceesssnceeeeeeeeeeeeeseceeeeeeeseeeeeeenseceeeeenenenneeeenees 72 Interstage BPM Server and Console Installation Guide WebSphere Application Server 4 9 9 1 9 2 9 3 9 4 9 5 9 5 1 10 10 1 10 1 1 10 1 2 10 1 3 10 1 4 10 1 5 10 1 6 10 1 7 10 1 8 10 2 10 2 1 10 2 2 10 2 3 10 2 4 10 2 5 10 3 10 4 Appendix A A 1 A 2 A 3 A 4 Table of Contents Upgrading Interstage BPM from Previous Version6 75 Upgrading from Previous Versions of Interstage BPM sseeeeeeeeeees 75 Migrating Application Resources from Previous Versions to Interstage BPM VIO E E teh seetewaas ew auceicea se ciesutedes yea oe

Interstage BPM Server and Console Installation Guide

Contents

Download Pdf Manuals

Related Search

Related Contents