Installation Instructions for WebSphere Lombardi Edition V7.2.0 Fix Pack 5 (V7.2.0.5)

Product documentation


Abstract

This document provides the installation instructions for IBM WebSphere Lombardi Edition (WLE), Version 7.2.0 Fix Pack 5 (V7.2.0.5).

Content

It includes information that is specific to the AIX, HP-UX, Red Hat Enterprise Linux (RHEL), Solaris, SUSE Linux, and Microsoft Windows operating systems.



The following tabs provide access to information that you need to install, uninstall, or reinstall WebSphere Lombardi Edition, Version 7.2.0 Fix Pack 5 (V7.2.0.5) .

  • This fix pack requires a minimum of 5 GB disk space for complete installation.

  • Extract the contents of the compressed package for the fix pack to a temporary directory. In this document, this directory is referred to as WLE_fixpack_installer_dir.

    For Windows operating systems, the directory is C:\Temp\WLE-7.2.0.5-FixPack\.

    For UNIX-based operating systems, the directory is /tmp/WLE-7.2.0.5-FixPack/.
    Note:
    The UNIX operating system zip library is needed when you extract the fix pack.
  • You can apply this fix pack to WebSphere Lombardi Edition Version 7.2.0 and later.
    CAUTION
    : You cannot use this fix pack to install any other version of the WebSphere Lombardi Edition.

  • This fix pack requires WebSphere Application Server Version 7.0.0 Fix Pack 7 or later.
    Note:
    It is recommended that you download and upgrade your WebSphere Application Server to the latest fix pack.

  • Ensure that JAVA_HOME is set to the location of the Java™ Development Kit that is used within the WebSphere product.

    For Windows operating systems, you need to set JAVA_HOME=WLE_install_dir\AppServer\java, where WLE_install_dir is the directory in which WebSphere Lombardi Edition is installed. Use set PATH=%JAVA_HOME%\bin;%JAVA_HOME%\lib;%PATH%

    For UNIX-based operating systems, you need to export JAVA_HOME=WLE_install_dir/AppServer/java
    Use export PATH=$JAVA_HOME/bin:$JAVA_HOME/lib:$PATH

  • Ensure that database users have the required authorization or privilege to drop, create, and run stored procedures while accessing the Process Center and Process Server databases. These users are listed in the ProcDB.properties file, which is located in the WLE_install_dir\twinit\resources directory for Windows operating systems and the WLE_install_dir/twinit/resources directory for UNIX-based operating systems.


Note: Before you apply WebSphere Lombardi Edition Version 7.2.0 Fix Pack 5, create backup copies of your existing WebSphere Lombardi Edition databases on your system.

Backups enable you to revert to the pre-upgrade state of the databases at any time, if necessary.
Note: You need to create backups of the Process Center databases and the databases in each runtime environment.

Most databases provide a backup wizard or other user assistance for creating database backups. Contact your database administrator for more information.

Process Center​


Note:
The following steps will update the IBM Process Center installation and also the embedded Authoring Environments.
  1. Stop the Process Center and Performance Data Warehouse:
    1. From a command prompt, navigate to the WLE_install_dir\bin directory.

    2. For Windows operating systems, run stopLombardi.cmd.

      For UNIX-based operating systems, run ./stopLombardi.sh.

      Note: If you have configured WebSphere Lombardi Edition to run as a Windows or Linux service, you need to stop the relevant service.

  2. If you are upgrading from V7.2.0 and are affected by an issue where the password is not encrypted for proxy settings in the 99Local.xml file, then complete the following steps:
    1. Locate the 99WLEFixPack7205.xml file in the content directory.

      For Windows operating systems, the file is WLE_fixpack_installer_dir\content\99WLEFixPack7205.xml.

      For UNIX-based operating systems, the ffile is WLE_fixpack_installer_dir/content/99WLEFixPack7205.xml.

    2. Uncomment the section corresponding to this issue and edit the relevant properties based on your environment.

  3. Optional: Complete the following steps if you have changed the default password for the users tw_admin and tw_user using the process described in Changing the default user passwords on IBM WebSphere Lombardi Edition.
    1. Locate the user.properties file inside the content directory.

      For Windows operating systems, the file is WLE_fixpack_installer_dir\content\user.properties

      For UNIX-based operating systems,the file is WLE_fixpack_installer_dir/content/user.properties
    2. Update the file with the modified password. The password should be in non-encrypted text.

  4. From the WLE_fixpack_installer_dir directory:

    Run the following command for Windows operating systems:
    install_fixpack.cmd WLE_install_dir

    For example: install_fixpack.cmd C:\IBM\Lombardi7.

    Note:
    After the installation is complete, you can find the backup files under WLE_install_dir\wlebackup\before7.2.0.5.

    Run the following commands for UNIX-based operating systems:
    1. chmod +x install_fixpack.sh

    2. ./install_fixpack.sh WLE_install_dir 

      For example: ./install_fixpack.sh /Lombardi7

      Note:
      After the installation is complete, you can find the backup files under the WLE_install_dir/wlebackup/before7.2.0.5 directory.
      Note: Review the Known Issues section for the list of issues that are fixed in the previous V7.2.0 fix packs. Wherever applicable for your installation, apply the required steps.

  5. Start both the Process Center and Performance Data Warehouse:
    1. From a command prompt, navigate to the WLE_install_dir\bin directory.

    2. For Windows operating systems, run startLombardi.cmd.

      For UNIX-based operating systems, run ./startLombardi.sh.

      Note: If you have configured WebSphere Lombardi Edition to run as a Windows or Linux service, you need to start the relevant service.

Note:
After you complete the installation, ensure that you complete the following steps for updating your process application.

Although the install_fixpack command updates the System Data Toolkit to Version 7.2.0 Fix Pack 5, it does not automatically update the existing dependencies. Update the existing dependencies using the following steps for each process application and toolkit:
  1. Start the Authoring Environment.
  2. Open the existing application in the authoring environment.
  3. Under Toolkits, right-click System Data toolkit.
  4. Select Change Version of dependency.
  5. Select the 7.2.0.5 snapshot from the Change Dependency snapshot list.


Authoring Environments
  • For the embedded Authoring Environment in Process Center installation, the fix pack is applied when you install it on the Process Center.
  • For all the stand-alone Authoring Environments, delete the existing ones, download from the Process Center, and extract the updated Authoring Environment.

Note:
Ensure that you initiate the download after installing the fix pack on the Process Center and the Process Center server is started.


Process Server​
  1. Stop the Process Server and Performance Data Warehouse:
    1. From a command prompt, navigate to the WLE_install_dir\bin directory.
    2. For Windows operating systems, run stopLombardi.cmd.

      For UNIX-based operating systems, run ./stopLombardi.sh.

      Note: If you have configured WebSphere Lombardi Edition to run as a Windows or Linux service, you need to stop the relevant service.

  2. If you are upgrading from V7.2.0 and are affected by an issue where the password is not encrypted for Proxy settings in the 99Local.xml file, then complete the following steps:
    1. Locate the 99WLEFixPack7205.xml file in the content directory.

      For Windows operating systems, the file is WLE_fixpack_installer_dir\content\99WLEFixPack7205.xml

      For UNIX-based operating systems, the file is WLE_fixpack_installer_dir/content/99WLEFixPack7205.xml.

    2. Uncomment the section that corresponds to this issue and edit the relevant properties that are based on your environment.

  3. Optional: Complete the following steps if you have changed the default password for the users tw_admin and tw_user using the process described in Changing the default user passwords on IBM WebSphere Lombardi Edition.
    1. Locate the user.properties file inside the content directory.

      For Windows operating systems, the file is WLE_fixpack_installer_dir\content\user.properties

      For UNIX-based operating systems, the file is WLE_fixpack_installer_dir/content/user.properties

    2. Update the file with the modified password. The password should be in non-encrypted text.

  4. From the WLE_fixpack_installer_dir directory:

    Run the following command for Windows operating systems:
    install_fixpack.cmd WLE_install_dir

    For example: install_fixpack.cmd C:\IBM\Lombardi7.

    Note:
    After the installation is complete, you can find the backup files under WLE_install_dir\wlebackup\before7.2.0.5.

    Run the following commands for UNIX-based operating systems:
    1. chmod +x install_fixpack.sh

    2. ./install_fixpack.sh WLE_install_dir 

      For example: ./install_fixpack.sh /Lombardi7

      Note: After the installation is complete, you can find the backup files under the WLE_install_dir/wlebackup/before7.2.0.5 directory.
      Note: Review the Known Issues section for the list of issues that are fixed in the previous V7.2.0 fix packs. Wherever applicable for your installation, apply the required steps.

  5. Start both the Process Server and Performance Data Warehouse:
    1. From a command prompt, navigate to the WLE_install_dir\bin directory.

      For Windows operating systems, run startLombardi.cmd.

      For UNIX-based operating systems, run ./startLombardi.sh.

      Note: If you have configured WebSphere Lombardi Edition to run as a Windows or Linux service, you need to start the relevant service.

  6. Deactivate 7.2.0, 7.2.0 Fix Pack 1, 7.2.0 Fix Pack 2, 7.2.0 Fix Pack 3, and 7.2.0 Fix Pack 4 Process Portal Application, only. Process Portal(TWP) - 7.2.0 Fix Pack 5 needs to be active.
    1. Login to Process Admin and locate the application Process Portal(TWP) - 7.2.0, Process Portal (TWP) - 7.2.0.1, Process Portal (TWP) - 7.2.0.2, Process Portal (TWP) - 7.2.0.3, and Process Portal (TWP) - 7.2.0.4 under installed applications.

    2. Select the application and, in the following screen, select Deactivate Application.

Process Server Cluster Environment​

Note:
  • Repeat step 4 for each server in the cluster environment.

  • Review the Known Issues section for the list of issues that are fixed in the previous V7.2.0 fix packs. Wherever applicable for your installation, apply the required steps.
  1. Stop all the nodes, the Process Server, and the Performance Data Warehouse in your entire cluster environment.

  2. If you are upgrading from V7.2.0 and are affected by an issue where the password is not encrypted for Proxy settings in the 99Local.xml file, then follow the steps provided below:

    1. Locate the 99WLEFixPack7205.xml file in the content directory.

      For Windows operating systems, the file is WLE_fixpack_installer_dir\content\99WLEFixPack7205.xml

      For UNIX-based operating systems, the file is WLE_fixpack_installer_dir/content/99WLEFixPack7205.xml.

    2. Uncomment the section that corresponds to this issue and edit the relevant properties that are based on your environment.

  3. Optional: Complete the following steps if you have changed the default password for the users tw_admin and tw_user using the process described in Changing the default user passwords on IBM WebSphere Lombardi Edition.
    1. Locate the user.properties file inside the content directory.

      For Windows operating systems, the file is WLE_fixpack_installer_dir\content\user.properties

      For UNIX-based operating systems, the file is WLE_fixpack_installer_dir/content/user.properties
    2. Update the file with the modified password. The password should be in non-encrypted text.

  4. From the WLE_fixpack_installer_dir directory:

    Run the following command for Windows operating systems:
    install_fixpack.cmd WLE_install_dir

    For example: install_fixpack.cmd C:\IBM\Lombardi7.

    Note: After the installation is complete, you can find the backup files under the WLE_install_dir\wlebackup\before7.2.0.5 directory.

    Run the following commands for UNIX-based operating systems:
    1. chmod +x install_fixpack.sh

    2. ./install_fixpack.sh WLE_install_dir 

      For example: ./install_fixpack.sh /Lombardi7

      Note: After the installation is complete, you can find the backup files under the WLE_install_dir/wlebackup/before7.2.0.5 directory.

  5. Start the Deployment Manager by running the startManager command.

    For Windows operating systems, the command is C:\IBM\Lombardi7\AppServer\profiles\Dmgr01\bin>startManager.bat.

    For UNIX-based operating systems, the command is /Lombardi7/AppServer/profiles/Dmgr01/bin>./startManager.sh.

    For more information about starting Deployment Manager, see the startManager command.

    Note: If you have configured the WebSphere Lombardi Edition deployment manager to run as a Windows or Linux service, you need to start the relevant service.

  6. After the Deployment Manager starts, synchronize each node, one at a time, by using the syncNode command.

    For example:

    For Windows operating systems, the command is C:\IBM\Lombardi7\AppServer\profiles\Lombardi\bin>syncNode.bat ProdNode1.example.com -user tw_user -password tw_user.

    For UNIX-based operating systems, the command is /Lombardi7/AppServer/profiles/Lombardi01/bin>./syncNode.sh ProdNode1.example.com -user tw_user -password tw_user

    Note:
    If you have modified the default Deployment Manager SOAP port, you must specify the port in the previous commands immediately after the host name for the primary node. For more information about synchronizing nodes, see syncNode command.

  7. Start all the nodes, Process Server, and Performance Data Warehouse in your entire cluster environment.

  8. Deactivate 7.2.0, 7.2.0 Fix Pack 1, 7.2.0 Fix Pack 2, 7.2.0 Fix Pack 3, and 7.2.0 Fix Pack 4 Process Portal Application, only Process Portal(TWP) - 7.2.0 Fix Pack 5 needs to be active.
    1. Login to Process Admin and Locate the application Process Portal(TWP) - 7.2.0, Process Portal (TWP) - 7.2.0.1, Process Portal (TWP) - 7.2.0.2, Process Portal (TWP) - 7.2.0.3, and Process Portal (TWP) - 7.2.0.4 under installed applications.

    2. Select the application and, in the following screen, select Deactivate Application.

Note:
  • You must apply the fix pack to the Process Center and perform the necessary tests to confirm if the applications are working appropriately. Then apply the fix pack to the Process Server. The Process Center and Process Server must be at the same level before any process application deployments.
  • If you have multiple environments with their own set of Process Center and Process Server, apply the fix pack one by one to all the environments. Then within each environment, follow the sequence of applying the fix pack to the Process Center followed by the Process Server.


Note: After uninstalling Version 7.2.0 Fix Pack 5, the databases are not reverted to the pre-upgrade state. You need to restore your database to revert to the pre-upgrade state after uninstallation, if necessary.

Note: Both the Process Center databases and the databases in each runtime environment need to be restored.

Most databases provide a restore wizard or other user assistance for restoring database backups. Contact your database administrator for more information.

Process Center
  1. Stop the Process Center and Performance Data Warehouse:
    1. From a command prompt, navigate to the WLE_install_dir\bin directory.

    2. For Windows operating systems, run stopLombardi.cmd.

      For UNIX-based operating systems, run ./stopLombardi.sh

      Note: If you have configured WebSphere Lombardi Edition to run as a Windows or Linux service, you need to stop the relevant service.

  2. From the WLE_fixpack_installer_dir directory:

    For Windows operating systems, run the following command:
    install_fixpack.cmd WLE_install_dir uninstall

    For example: install_fixpack.cmd C:\IBM\Lombardi7 uninstall

    For UNIX-based operating systems, run the following command:
    ./install_fixpack.sh WLE_install_dir  uninstall

    For example: ./install_fixpack.sh /Lombardi7 uninstall

Process Server
  1. Stop the Process Server and Performance Data Warehouse:
    1. From a command prompt, navigate to the WLE_install_dir\bin directory.

    2. For Windows operating systems, run stopLombardi.cmd.

      For UNIX-based operating systems, run ./stopLombardi.sh

      Note: If you have configured WebSphere Lombardi Edition to run as a Windows or Linux service, you need to stop the relevant service.

  2. From the WLE_fixpack_installer_dir directory:

    For Windows operating systems, run the following command:
    install_fixpack.cmd WLE_install_dir uninstall

    For example: install_fixpack.cmd C:\IBM\Lombardi7 uninstall

    For UNIX-based operating systems, run the following command:
    ./install_fixpack.sh WLE_install_dir uninstall

    For example: ./install_fixpack.sh /Lombardi7 uninstall

Process Server Cluster Environment

Note: Repeat the step 2 below for each server in the cluster environment.
  1. Stop all the nodes, Process Server, and Performance Data Warehouse in your entire cluster environment.

  2. From the WLE_fixpack_installer_dir directory:

    For Windows operating systems, run the following command:
    install_fixpack.cmd WLE_install_dir uninstall.

    For example: install_fixpack.cmd C:\IBM\Lombardi7 uninstall

    For UNIX-based operating systems, run the following command:
    ./install_fixpack.sh WLE_install_dir uninstall

    For example: ./install_fixpack.sh /Lombardi7 uninstall

  3. Start the Deployment Manager by running the startManager command.

    For Windows operating systems, the command is C:\IBM\Lombardi7\AppServer\profiles\Dmgr01\bin>startManager.bat.

    For UNIX-based operating systems, the command is /Lombardi7/AppServer/profiles/Dmgr01/bin>./startManager.sh

    For more information about starting the Deployment Manager, see the startManager command.

    Note: If you have configured WebSphere Lombardi Edition deployment manager to run as a Windows or Linux service, you need to start the relevant service.

  4. After the Deployment Manager starts, synchronize each node, one at a time, by using the syncNode command.

    For Windows operating systems, the command is C:\IBM\Lombardi7\AppServer\profiles\Lombardi\bin>syncNode.bat ProdNode1.example.com -user tw_user -password tw_user.

    For UNIX-based operating systems, the command is /Lombardi7/AppServer/profiles/Lombardi01/bin>./syncNode.sh ProdNode1.example.com -user tw_user -password tw_user
    Note: If you have modified the default Deployment Manager SOAP port, you must specify the port in the previous commands immediately after the host name for the primary node. For more information about synchronizing nodes, see syncNode command.


Note: You can complete the steps in this section only if you have uninstalled Version 7.2.0 Fix Pack 5 and have not restored your database to the pre-upgrade state.

Process Center
  1. Stop the Process Center and Performance Data Warehouse:
    1. From a command prompt, navigate to the WLE_install_dir\bin directory.

    2. For Windows operating systems, run stopLombardi.cmd.

      For UNIX-based operating systems, run ./stopLombardi.sh.

      Note: If you have configured WebSphere Lombardi Edition to run as a Windows or Linux service, you need to stop the relevant service.

  2. From the WLE_fixpack_installer_dir directory:

    For Windows operating systems, run the following command:
    install_fixpack.cmd WLE_install_dir reinstall

    For example: install_fixpack.cmd C:\IBM\Lombardi7 reinstall

    Note:
    After installation is complete, you can find the backup files under WLE_install_dir\wlebackup\before7.2.0.5.

    For UNIX-based operating systems, run the following command:
    ./install_fixpack.sh WLE_install_dir reinstall

    For example: ./install_fixpack.sh /Lombardi7 reinstall

    Note:
    After installation is complete, you can find the backup files under WLE_install_dir/wlebackup/before7.2.0.5.

Process Server
  1. Stop the Process Server and Performance Data Warehouse:
    1. From a command prompt, navigate to the WLE_install_dir\bin directory.

    2. For Windows operating systems, run stopLombardi.cmd.

      For UNIX-based operating systems, run ./stopLombardi.sh.

      Note: If you have configured WebSphere Lombardi Edition to run as a Windows or Linux service, you need to stop the relevant service.

  2. From the WLE_fixpack_installer_dir directory:

    For Windows operating systems, run the following command:
    install_fixpack.cmd WLE_install_dir reinstall

    For example: install_fixpack.cmd C:\IBM\Lombardi7 reinstall

    Note:
    After installation is complete, you can find the backup files under the WLE_install_dir\wlebackup\before7.2.0.5 directory.

    For UNIX-based operating systems, run the following command:
    ./install_fixpack.sh WLE_install_dir reinstall

    For example: ./install_fixpack.sh /Lombardi7 reinstall

    Note:
    After installation is complete, you can find the backup files under the WLE_install_dir/wlebackup/before7.2.0.5 directory.

Process Server Cluster Environment

Note: Repeat the step 2 below for each server in the cluster environment.
  1. Stop all the Nodes, Process Server, and Performance Data Warehouse in your entire cluster environment.

  2. From the WLE_fixpack_installer_dir directory,

    For Windows operating systems, run the following command:
    install_fixpack.cmd WLE_install_dir reinstall

    For example: install_fixpack.cmd C:\IBM\Lombardi7 reinstall

    Note:
    After installation is complete, you can find the backup files under the WLE_install_dir\wlebackup\before7.2.0.5 directory.

    For UNIX-based operating systems, run the following command:
    ./install_fixpack.sh WLE_install_dir reinstall

    For example: ./install_fixpack.sh /Lombardi7 reinstall

    Note:
    After installation is complete, you can find the backup files under the WLE_install_dir/wlebackup/before7.2.0.5 directory.

  3. Start the Deployment Manager by running the startManager command.

    For Windows operating systems, the command is C:\IBM\Lombardi7\AppServer\profiles\Dmgr01\bin>startManager.bat.

    For UNIX-based operating systems, the command is /Lombardi7/AppServer/profiles/Dmgr01/bin>./startManager.sh

    For more information about starting Deployment Manager, see the startManager command.

    Note: If you have configured the WebSphere Lombardi Edition deployment manager to run as a Windows or Linux service, you need to start the relevant service.

  4. After the Deployment Manager starts, synchronize each node, one at a time, by using the syncNode command.

    For Windows operating systems, the command is C:/IBM/Lombardi7/AppServer/profiles/Lombardi/bin>syncNode.bat ProdNode1.example.com -user tw_user -password tw_user.

    For UNIX-based operating systems, the command is /Lombardi7/AppServer/profiles/Lombardi01/bin>./syncNode.sh ProdNode1.example.com -user tw_user -password tw_user.
    Note: If you have modified the default Deployment Manager SOAP port, you must specify the port in the previous commands immediately after the host name for the primary node.
    For more information about synchronizing nodes, see syncNode command.


This section lists the suggested fixes for issues that are identified in the previous V7.2.0 fix packs.

For the complete list of fixes provided in the previous V7.2.0 fix packs, see Fix list for IBM WebSphere Lombardi Edition Versions 7.2 and 7.1.

For some of the known issues and solutions up to V7.2.0 Fix Pack 4, refer to the Known Issues section in the Installation Instructions document for V7.2.0.4.

For some of the frequently asked questions (FAQ) about IBM WebSphere Lombardi Edition, refer to the Frequently asked questions document.

If you are upgrading from V7.2.0 Fix Pack 2 and affected by malformed integer/decimal business search data, then run the tool as per the instructions below:

Issue:
Business Process Definitions (BPD) are created in 7.2.0 Fix Pack 1 with Integer variables marked as searchable store the "searchable field" as a Decimal rather than an Integer.After updating to 7.2.0 Fix Pack 2, this approach causes the Integer values to not show up in Portal.

Solution:
Run the BPD Fix Searchable tool from the WLE_fixpack_installer_dir in Process Center and Process Server environments.

For Windows operating systems, the command is:
install_fixpack.cmd <WLE_Install_Dir> bpdFixSearchable

For UNIX-based operating systems, the command is:
./install_fixpack.sh <WLE_Install_Dir> bpdFixSearchable

Issue:
Windows long path issue
When you extract the fix pack during installation, the following errors are displayed when there is a long path name:

! C:\WLE-L3\7205\WLE-7.2.0.5-FixPack.zip: Cannot create content\LombardiAuthoringEnvironment\teamworks\eclipse\plugins\teamworks.ae.organization.diagram_7.2.0.jar\com\lombardisoftware\organization\diagram\edit\parts\OrganizationUnitNodeEditPart$OrganizationUnitNodeFigure.class
Total path and file name length must not exceed 260 characters

Solution:
The length of the path name, including the file name, should not exceed 260 characters. Use a shorter path name for extracting the fix pack files to a temporary folder.

You can use the following example for extracting your files:
For Windows: C:\temp\WLE7205\

Original publication date

2013/2/15

Rate this page:

(0 users)Average rating

Document information


More support for:

WebSphere Lombardi Edition
Installation / Configuration

Software version:

7.2.0.5

Operating system(s):

AIX, Linux, Linux zSeries, Solaris, Windows

Reference #:

7037785

Modified date:

2013-03-08

Translate my page

Machine Translation

Content navigation