This chapter describes how to install BEA AquaLogic BPM. To upgrade from an earlier version of AquaLogic BPM, follow the instructions in Upgrade.
To install AquaLogic BPM:
Ensure that you have met the prerequisites for installation. It is important that the appropriate version of the Java SDK is installed prior to running the AquaLogic BPM installer. For details, see Installation Prerequisites.
Copy the appropriate installer to your host and launch it.
Note:
On Linux and UNIX hosts without a graphical interface, start the installer using the -i console flag:
Note:
% <installer> -i console
Completing the Installer Wizard Pages
The following table describes the AquaLogic BPM installer wizard pages for all products on all platforms. Depending on your configuration, not all installer wizard pages may be present.
Table 3-1 AquaLogic BPM Installer Wizard Pages
Wizard Page
Description
License Agreement
Read and accept the license agreement.
Installation Folder
The default install directory is recommended.
Caution:
The installation folder must be a subdirectory used only by the AquaLogic BPM product being installed.
Choose J2SE SDK
Select an appropriate J2SE SDK. To do this, either:
Populate the list of J2SE SDKs on your system by clicking Search For Others.
Browse your system for a J2SE SDK by clicking Choose Another...
When the correct J2SE SDK is listed on the installer wizard page, highlight that SDK and click Next.
Pre-Installation Summary
Review the summary and click Install.
No further steps are required for AquaLogic BPM Designer or AquaLogic BPM Studio. To complete the installation of a AquaLogic BPM Enterprise product, create the directory as described in the next section.
Licensing AquaLogic BPM
The AquaLogic BPM products are automatically installed with a 60 day evaluation license.
In order to install a purchased license:
Rename the file license.bea to license.bea.old. The license file is located one directory up from your installation directory:
<INSTALL_DIRECTORY>\..
Launch the AquaLogic BPM product. A notice will appear stating that the existing license is invalid or has expired.
Click Import License.
Browse to the license file you were supplied and click OK.
Click OK to close the program.
When the AquaLogic BPM product is restarted, the new license will be installed.
Creating the AquaLogic BPM Directory
The AquaLogic BPM Enterprise servers require an established directory prior to starting the application. To complete the installation you must either provide connection information for an existing AquaLogic BPM directory or create a new AquaLogic BPM directory.
This section covers the most common method for creating the AquaLogic BPM directory. For more details on the directory service configuration utility, see the Administrator Guide for AquaLogic BPM.
Registering the JDBC Drivers
Before AquaLogic BPM Enterprise can connect to your database system, the appropriate JDBC drivers must be installed on your system and then registered with AquaLogic BPM.
Note:
When connecting to a directory service, such as Microsoft Active Directory or Sun ONE, a JDBC driver is not required.
Note:
Connecting to IBM DB2 Type 2 requires the DB2 Client to be installed on the same host as AquaLogic BPM Enterprise. No JDBC driver needs to be registered with AquaLogic BPM.
To register the installed JDBC drivers with AquaLogic BPM Enterprise:
Open the AquaLogic BPM Enterprise Admin Center.
If you are installing AquaLogic BPM Enterprise Standalone, from the Start menu select BEA | ALBPM | Enterprise 5.7 | Admin Center.
If you are installing AquaLogic BPM Enterprise for a specific application server, from the Start menu select BEA | ALBPM | J2EE 5.7 | Admin Center.
Open the Configuration Utility. From the AquaLogic BPM Admin Center, click Configuration.
Click Install Drivers....
Browse to the jar files for your installed JDBC driver. Select and open the JDBC driver's jar files.
The following table lists the default names of the jar files for each JDBC driver that must be registered with AquaLogic BPM Enterprise.
JDBC Driver
Required JARs
Oracle
ojdbc14.jar
SQL Server with i-NET JDBC driver
Merlia.jar
SQL Server 2005 with Microsoft JDBC
sqljdbc.jar
DB2
db2java.jar
db2jcc.jar
Creating a New Directory
If an AquaLogic BPM directory has been created by another installation of AquaLogic BPM Enterprise and you want this installation to connect to the same directory, follow the instructions in Connecting to an Existing Directory.
To create a new AquaLogic BPM directory:
Open the Configuration Utility. From the AquaLogic BPM Enterprise Admin Center click Configuration.
Click Add....
Select the Create New Directory radio button. Click OK.
Name the directory by typing a name into the Directory ID field.
Choose the JDBC provider appropriate for the database from the drop-down.
Complete the server and credential information for the backend system selected. For more details on specific settings, refer to the table appropriate for the JDBC provider being used:
Oracle JDBC Driver
Setting
Description
Database Host
The host name or IP address of the Oracle database server.
Database Port
The port on the database host that Oracle is listening to.
Organization Logical Name
The organization within AquaLogic BPM this directory will belong to. This can be any string.
Administrator User
A user with administrator access to Oracle. This user must have permissions necessary to create a new schema.
Administrator Password
The password of the administrator user.
Schema Name
The desired name for the schema to be created for this AquaLogic BPM directory.
Schema Password / Confirm Password
The desired password for the schema to be created.
SID
The SID for the Oracle database.
i-net MERLIA JDBC Driver, SQL Server Microsoft JDBC Driver for SQL Server 2005
Setting
Description
Database Host
The host name or IP address of the SQL Server database server.
Database Port
The port on the database host that SQL Server is listening to.
Organization Logical Name
The organization within AquaLogic BPM this directory will belong to. This can be any string.
Administrator User
A user with administrator access to SQL Server. This user must have permissions necessary to create a new database.
Administrator Password
The password of the administrator user.
Database
A name for the database to be created for this AquaLogic BPM directory.
Login Name
A name for the database user to be created for this AquaLogic BPM directory.
Login Password / Confirm Password
A password for the database user to be created.
IBM DB2 JDBC (Type 2)
Setting
Description
Organization Logical Name
The organization within AquaLogic BPM this directory will belong to. This can be any string.
Administrator User
A user with administrator access to DB2. This user must have permissions necessary to create a new database.
Administrator Password
The password of the administrator user.
Schema Name
A name for the schema to be created for this AquaLogic BPM directory.
Database
The name of the database where the schema will be created.
IBM DB2 JDBC (Type 4)
Setting
Description
Database Host
The host name or IP address of the DB2 database server.
Database Port
The port on the database host that DB2 is listening to.
Organization Logical Name
The organization within AquaLogic BPM this directory will belong to. This can be any string.
Administrator User
A user with administrator access to DB2. This user must have permissions necessary to create a new database.
Administrator Password
The password of the administrator user.
Schema Name
A name for the schema to be created for this AquaLogic BPM directory.
Database
The name of the database where the schema will be created.
Microsoft Active Directory
Setting
Description
LDAP Host
The host name or IP address of the Microsoft Active Directory server.
Domain
The fully qualified domain name of the Active Directory. For example, sample.bea.com.
Organization Logical Name
The organization within AquaLogic BPM this directory will belong to. This can be any string.
Root DN
The name of an Active Directory administrative user in the domain specified. For example, Administrator.
Note:
Do not qualify the user name. For example, it would be incorrect to enter sample/Administrator.
Root Password
The password of the adminsitrative user.
Directory Base DN
[Optional] Specify the base DN under which the AquaLogic BPM directory will be created. This is important if more than one AquaLogic BPM directory will be created on the Active Directory server. AquaLogic BPM directories cannot share the same root DN.
iPlanet/Sun ONE Java System Directory Server
Setting
Description
LDAP Host
The host name or IP address of the directory service server.
LDAP Port
The port on the host that the directory service is listening to.
LDAP Base DN
The topmost entry of the directory service. For example, o=bea.com.
Organization Logical Name
The organization within AquaLogic BPM this directory will belong to. This can be any string.
Root DN
The DN of the root user. For example, cn=root.
Root Password
The password of the root user.
Connecting to an Existing Directory
To use an existing AquaLogic BPM directory:
Open the Configuration Utility. From the AquaLogic BPM Enterprise Admin Center click Configuration.
Click Add....
Select the Use Existing Directory radio button. Click OK.
Choose the JDBC provider from the drop-down.
Enter the same properties that were used to create the directory during the original AquaLogic BPM installation. For more details, see the Administrator Guide for AquaLogic BPM.
