> Installation and Upgrade Guide > Quickstart Overview

Installation and Upgrade Guide

     Previous  Next    Open TOC in new window  Open Index in new window  View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Quickstart Overview

This chapter provides brief, high level instructions for the installation and upgrade of BEA AquaLogic BPM Workspace Extensions, and is intended to quickly guide experienced administrators through the installation or upgrade procedure. More detailed instructions are provided in the following chapters.

This chapter is divided into two major sections:

 

Installation

Install AquaLogic BPM Enterprise

Acquire and run the installer for one of the following:

For AquaLogic BPM Enterprise for WebLogic, ensure that the WebLogic license is updated with the AquaLogic BPM license information.

For details on installing these products, see the Installation and Upgrade Guide for AquaLogic BPM.

Caution: Do not configure an AquaLogic BPM directory or JDBC datasources at this time.

Install AquaLogic BPM Workspace Extensions

Acquire and run the installer for ALBPM Workspace Extensions 5.7.

For details on running the ALBPM Workspace Extensions installer, see Completing the Installer Wizard Pages.

For ALBPM Enterprise for WebLogic, ensure the WebLogic license is updated with the AquaLogic BPM Workspace Extensions license information.

Configure the Process Database

Create the database and user for the process database, as entered into the AquaLogic BPM Workspace Extensions installer wizard.

Script the database for process and the BEA ALI Identity Service. Run the following scripts against the process database in the order described.

Configuring the Process Database on Microsoft SQL Server

Run all scripts as the database user specified during installation.

From <INSTALL_DIR>/ptprocess/1.7/sql/mssql/

  1. create_tables.sql
  2. seeddata.sql

From <INSTALL_DIR>/ptids/1.2/sql/mssql/

  1. create_schema.sql

Configuring the Process Database on Oracle

Run the first two scripts as sysdba user. Run all subsequent scripts as the database user specified during installation.

From <INSTALL_DIR>/ptprocess/1.7/sql/<DB_TYPE>/

  1. create_table_space.sql
  2. create_user.sql
  3. create_tables.sql
  4. load_seed_info.sql

From <INSTALL_DIR>/ptids/1.2/sql/<DB_TYPE>/

  1. create_schema.sql

For details on creating the process database, see Configuring the Process Database.

Configure WebLogic and WebSphere with ALBPM Workspace Extensions Shared Libraries

Configuring Shared Libraries in WebLogic

  1. Stop the WebLogic server on the AquaLogic BPM WebLogic domain.
  2. Copy the following libraries to the shared libraries directory of the AquaLogic BPM WebLogic domain.
    • <INSTALL_DIR>/albpm5.7/j2eewl/j2ee/common/lib/fuegoj2ee-lib-all.jar
    • <INSTALL_DIR>/albpm5.7/j2eewl/ext/fuegoconn-plumtree.jar
    • <INSTALL_DIR>/albpm5.7/j2eewl/ext/fuegofdi-plumtree.jar
    • <INSTALL_DIR>/albpm5.7/j2eewl/libraries/plumtree/aopalliance-1.0.jar
    • <INSTALL_DIR>/albpm5.7/j2eewl/libraries/plumtree/burlap-2.1.12.jar
    • <INSTALL_DIR>/albpm5.7/j2eewl/libraries/plumtree/hessian-2.1.12.jar
    • <INSTALL_DIR>/albpm5.7/j2eewl/libraries/plumtree/hydrogen-commons-core-1.2.0.jar
    • <INSTALL_DIR>/albpm5.7/j2eewl/libraries/plumtree/hydrogen-directory-api-1.2.0.jar
    • <INSTALL_DIR>/albpm5.7/j2eewl/libraries/plumtree/plbase.jar
    • <INSTALL_DIR>/albpm5.7/j2eewl/libraries/plumtree/ploracle.jar
    • <INSTALL_DIR>/albpm5.7/j2eewl/libraries/plumtree/plsqlserver.jar
    • <INSTALL_DIR>/albpm5.7/j2eewl/libraries/plumtree/plutil.jar
    • <INSTALL_DIR>/albpm5.7/j2eewl/libraries/plumtree/spring-1.2.2.jar
    • <INSTALL_DIR>/albpm5.7/j2eewl/webapps/portal/WEB-INF/lib/commons-httpclient-3.0.1.jar
    • <INSTALL_DIR>/albpm5.7/j2eewl/webapps/portal/WEB-INF/lib/commons-codec-1.3.jar
  3. Start the WebLogic server on the AquaLogic BPM WebLogic domain.

Configuring Shared Libraries in WebSphere

Create a shared library instance for the ALBPM Workspace Extensions libraries. The libraries must be in this order:

  1. <INSTALL_DIR>/albpm5.7/j2eews/j2ee/common/lib/fuegoj2ee-lib-all.jar
  2. <INSTALL_DIR>/albpm5.7/j2eews/j2ee/websphere/was6stubs/fuegoj2ee-was6-stubs.jar
  3. <INSTALL_DIR>/albpm5.7/j2eews/ext/fuegoconn-plumtree.jar
  4. <INSTALL_DIR>/albpm5.7/j2eews/ext/fuegofdi-plumtree.jar
  5. <INSTALL_DIR>/albpm5.7/j2eews/libraries/plumtree/aopalliance-1.0.jar
  6. <INSTALL_DIR>/albpm5.7/j2eews/libraries/plumtree/burlap-2.1.12.jar
  7. <INSTALL_DIR>/albpm5.7/j2eews/libraries/plumtree/hessian-2.1.12.jar
  8. <INSTALL_DIR>/albpm5.7/j2eews/libraries/plumtree/hydrogen-commons-core-1.2.0.jar
  9. <INSTALL_DIR>/albpm5.7/j2eews/libraries/plumtree/hydrogen-directory-api-1.2.0.jar
  10. <INSTALL_DIR>/albpm5.7/j2eews/libraries/plumtree/plbase.jar
  11. <INSTALL_DIR>/albpm5.7/j2eews/libraries/plumtree/ploracle.jar
  12. <INSTALL_DIR>/albpm5.7/j2eews/libraries/plumtree/plsqlserver.jar
  13. <INSTALL_DIR>/albpm5.7/j2eews/libraries/plumtree/plutil.jar
  14. <INSTALL_DIR>/albpm5.7/j2eews/libraries/plumtree/spring-1.2.2.jar
  15. <INSTALL_DIR>/albpm5.7/j2eews/webapps/portal/WEB-INF/lib/commons-httpclient-3.0.1.jar
  16. <INSTALL_DIR>/albpm5.7/j2eews/webapps/portal/WEB-INF/lib/commons-codec-1.3.jar

Deploy the Process PTE

Use the migration tool to import the Process PTE file. The file is located:

<INSTALL_DIR>/ptprocess/1.7/serverpackages/.

Import process-6x.pte for 6.x versions of the portal (Plumtree Foundation or ALI). Import process-5x.pte for 5.x versions of the portal (Plumtree Corporate Portal 5.x).

Note: If installing with ALBPM Enteprise WebLogic or WebSphere, the Remote Server objects in the Portal must be edited to point to the WebLogic or WebSphere server.
Note: The Remote Server objects that must be edited are in the Remote Server section of the Process folder in portal administration.

For details on importing a PTE file, see the Administrator guide for the appropriate version of the portal.

Start the BEA ALI Identity Service

Start the ALI Identity Service using the OS appropriate script in:

<INSTALL_DIR>/ptids/1.2/bin/

From the command line, in Windows run

service console

in Linux or Unix run

./service.sh console

The service should start without error.

For details on starting the ALI Identity Service, see Starting the BEA AquaLogic Interaction Identity Service.

Configure an ALBPM Workspace Extensions Directory Service

Prior to configuring the directory service, ensure that the ALI Identity Service and the ALI API service are running.

To configure a data service for ALBPM Workspace Extensions:

  1. From AquaLogic BPM Administration Console | Configuration click Add....
  2. Select Create New Directory and click OK.
  3. For Provider choose either Oracle (ALI) or SQLServer (ALI).
  4. Complete the fields for the directory service and click Start.

For details on creating the data service for ALBPM Workspace Extensions, see Configuring an ALBPM Workspace Extensions Directory Service

Configure an ALBPM Workspace Extensions Engine

To create an ALBPM Workspace Extensions engine:

  1. In AquaLogic BPM Administrator Console, ensure that the AquaLogic BPM Workspace starts when the BPM Web Application starts. Start the BPM Web Application.
  2. Log into the ALI portal as a Process Administrator.
  3. In Administration, select the Process Administrator utility.
  4. Add an engine with a Type matching your install of AquaLogic BPM (enterprise, weblogic, or websphere). For Engine Database Type choose either Oracle (ALI) or SQLServer (ALI). Click Next.
  5. Enter connection properties for the database to be used. User and database/schema fields refer to the user and database or schema to be created. Click Next.
  6. Ensure all configurations are correct. Configure mail properties under the Networking tab.
  7. Save the engine.

For details, see Configuring an ALBPM Workspace Extensions Engine

Create the Engine Database

From the Engine Advanced Properties, click Manage Database. Enter a database user name and password with permission to create a database/schema, and check boxes next to Create the database and Create the data structure.

Click OK to generate the database, or click Show SQL Statements to have a DBA review the SQL and generate the database offline.

For details on the engine database creation process, see Creating the Engine Database.

Configure WebLogic or WebSphere for AquaLogic BPM

For deployments of AquaLogic BPM Enterprise for WebLogic or AquaLogic BPM Enterprise for WebSphere, the respective application servers must be configured prior to deploying the engine. For details, see the Administrator Guide for AquaLogic BPM, Create a Process Execution Engine on WebLogic or Create a Process Execution Engine on WebSphere.

 

Upgrade

To upgrade to ALBPM WE 5.7 MP2, see Upgrading AquaLogic BPM Workspace Extensions.


  Back to Top       Previous  Next