WebSphere

This information applies to feature pack. To use what is described, you must have installed the optional feature pack Installing the feature pack on Linux, UNIX, and Windows

Install the feature pack on an existing installation of a supported WebSphere® Business Process Management, version 6.2.0.1 or later, product using the graphical user interface.

Before you begin
Before starting this installation, perform the following tasks:
  • Ensure that you want to install on a Linux®, UNIX®, or Windows® system by using an interactive interface. For alternative installation procedures, click the following links:
  • Ensure that you install the feature pack on a supported WebSphere Business Process Management, version 6.2.0.1 or later, product. You can apply the feature pack to installations of the following products:
    • WebSphere Process Server, version 6.2.0.1 or later
      Restriction: You cannot apply the feature pack to an installation of the WebSphere Process Server Client.
    • WebSphere Enterprise Service Bus (WebSphere ESB), version 6.2.0.1 or later
    • WebSphere Business Modeler Publishing Server, version 6.2.0.1 or later
    • WebSphere Business Monitor, version 6.2.0.1 or later

    You can apply the feature pack to single- or stacked-product installations.

    Important: The installed product or products must be at version 6.2.0.1 or later.
    The operating system requirements for the feature pack are the same as the requirements for the 6.2.0.1 product. For information about the hardware and software that are required by products, see the following Web pages:
  • Download and extract the feature pack. For instructions on downloading and extracting the feature pack, see the following Web site.

    For example, create two directories, fep_download and fep_installation_image. Then, download the feature pack to the fep_download directory and extract the downloaded file to the fep_installation_image directory. Do not move any files out of the fep_installation_image directory. After extraction, the fep_installation_image directory contains the directory WPSWESBFEP, which contains the install executable file.

About this task
The content of the feature pack is sets of widgets that you can use with Business Space powered by WebSphere, depending on the WebSphere product that you have installed. Widgets are grouped into the following features:
  • Administration feature: The Administration widgets provide a way for administrators to manage and monitor the individual components -- including modules and services -- of your business process management solution.
  • Human Task Management feature: This feature includes two sets of widgets. The Human Task Management widgets provide a way for your business users and managers to easily view, assess, and drill down into human tasks and business processes in your business process management solution. The My Work Organizer widgets enable business users and managers to quickly plan and organize their tasks.
A third feature, which is called the Feature Pack Business Space widgets feature, is installed silently with every feature pack installation. It contains the enterprise archive (EAR) files and the deployment and removal scripts for the other features.
Procedure
  1. Log on to the system.
    • For AIX operating systemFor HP-UX operating systemFor Linux operating systemFor Solaris operating system Log on as root or as the nonroot user ID that installed the product to which you want to apply the feature pack.

      Run the ls -al command at the root of the installation to find the user ID that was used to install the product.

    • For Windows operating system Log on as a user who belongs to the administrator group or as the nonadministrator user ID that installed the product to which you want to apply the feature pack.
  2. Start the feature pack installation program by running the install command in the WPSWESBFEP directory of the feature pack installation image:
    • For AIX operating systemFor HP-UX operating systemFor Solaris operating system /WPSWESBFEP/install.sh
    • For Linux operating system /WPSWESBFEP/install
    • For Windows operating system \WPSWESBFEP\install.exe
    The language of the installation wizard is determined by the default language on the system. If the default language on the system is not one of the supported languages, English is used. You can override the system default language by starting the installation wizard from the command line and using the java user.language setting to replace the default language. Use the following command, which can be run from the WPSWESBFEP directory on the electronic installation image. In this example, the variable lang represents the language.
    • For AIX operating systemFor HP-UX operating systemFor Linux operating systemFor Solaris operating system /WPSWESBFEP/java/bin/java -Duser.language=lang -cp setup.jar run
    • For Windows operating system \WPSWESBFEP\java\bin\java -Duser.language=lang -cp setup.jar run
    For example, to start the installation wizard in the German language on a Windows system, type the following command:
    \WPSWESBFEP\java\bin\java 
    -Duser.language=de -cp setup.jar run
    Restriction: Do not run two instances of the installation wizard concurrently. If you do so, you receive a warning about an installation already being in progress.

    The installer program does not support console-mode installation.

  3. Complete the steps in the feature pack installation wizard.
    1. On the Feature Pack Installation Wizard Welcome page, click Next.
    2. On the Software License Agreement page, select I accept both the IBM and the non-IBM terms and click Next.
    3. On the Product Detection page, select the installation to which you want to apply the feature pack and click Next.

      The installation must be listed in the New Install Framework (NIF) registry. The installer finds installations that are specific to the user ID running the installer. Because the feature pack cannot be installed over installations of WebSphere Process Server Client, these installations are not detected. If the installer does not find a suitable installation, a page that lists minimum requirements is displayed, which allows you to cancel the installation.

      The WebSphere Business Process Management products that are included in the installation to which you apply the feature pack determine which of the features can be installed and the next page that is displayed in the GUI.
      Table 1. Installable features and next step (based on underlying products)
      Products in the installation Installable features Next step
      • WebSphere ESB only
      • WebSphere ESB in a stacked-product installation with WebSphere Business Modeler Publishing Server, WebSphere Business Monitor, or both
      • Administration
      • Feature Pack Business Space widgets
      The Administration and Feature Pack Business Space widgets features will be installed automatically.

      The Installation Summary page is displayed. Go to step 3.e.

      • WebSphere Business Modeler Publishing Server, WebSphere Business Monitor, or both in an installation used to run the Business Space server in a heterogeneous cell that also contains WebSphere Process Server nodes, WebSphere ESB nodes, or both
      Feature Pack Business Space widgets The Feature Pack Business Space widgets feature will be installed automatically.

      The Installation Summary page is displayed. Go to step 3.e.

      • WebSphere Process Server only
      • WebSphere Process Server in a stacked-product installation with WebSphere Business Modeler Publishing Server, WebSphere Business Monitor, or both
      • Feature Pack Business Space widgets
      • Administration, Human Task Management, or both
      You will have a choice of installing the Administration feature, Human Task Management feature, or both features. The Feature Pack Business Space widgets feature will be installed automatically.

      The Features Selection page is displayed. Go to step 3.d.

    4. Select the features you want to install and click Next. Both the Administration and Human Task Management features are selected by default. You must leave at least one feature selected to continue. The Feature Pack Business Space widgets feature is always installed.
      Tip: If you elect to install only one feature, you can rerun the installer at a later time to install the other feature. When you rerun the installer, the installed feature is selected and disabled. If you applied maintenance to the installed feature, to ensure that the fixes are applied to the new feature, choose one of these methods:
      • Remove the existing maintenance from the feature pack before installing the new feature, install the new feature, and reapply the maintenance.
      • If a later maintenance package is available than the one that is installed, install the new feature and install the higher-level maintenance package on the feature pack.
    5. On the Installation Summary page, click Next.

      This page identifies which features will be installed and into which directory. It also lists the estimated disk space that is required by the features.

    6. On the Installation Results page, click Finish.
Results

The installation wizard installs the feature pack. The Installation Results page indicates whether the completed installation was successful.

The installer records installation events in the following log file:
  • For AIX operating systemFor HP-UX operating systemFor Linux operating systemFor Solaris operating system install_root/logs/wpswesbfep/install/log.txt
  • For Windows operating system install_root\logs\wpswesbfep\install\log.txt
If you rerun the installer to install another feature, a new log.txt file is created and the existing one is appended with a number for example, log.txt.1.

If errors are detected during installation, other messages might be displayed instead of Success.

The message Partial success indicates that the installation completed but errors were generated. The message Failed indicates that the installation failed completely. In either case, the log file provides information to troubleshoot the problems.

The installer also opens the topic Deploying and configuring widgets for the feature pack, which describes the scripts you must run to deploy the features that you installed. The scripts enable functions that are provided by the feature pack.

What to do next

Run the deployment scripts that are associated with the features that you installed.

Installing additional features as you add WebSphere Business Process Management products to an installation: When you add a WebSphere Business Process Management product to an installation that includes the feature pack, and you want to add features from the feature pack that are available with the new product, you must rerun the feature pack installer on the installation using the procedure in this topic. The version of the WebSphere Business Process Management product you add must be 6.2.0.1 or later. Table 2 lists the features that are available for each product.

You must also deploy the new features, as described in Deploying and configuring widgets for the feature pack.

If you applied maintenance to the installed feature pack, to ensure that the fixes are applied to the new features, choose one of these methods:
  • Remove the existing maintenance from the feature pack before installing the new features, install the new features, and reapply the maintenance.
  • If a later maintenance package is available than the one that is installed, install the new features and install the higher-level maintenance package on the feature pack.
Table 2. Installable features (based on adding new products to a stack)
Products in the installation with feature pack applied Feature pack features already installed Product added to stack Additional features available by rerunning the feature pack installer on the installation
WebSphere Business Modeler Publishing Server, WebSphere Business Monitor, or both Feature Pack Business Space widgets WebSphere ESB, version 6.2.0.1 or later Administration
WebSphere Process Server, version 6.2.0.1 or later Administration, Human Task Management, or both
  • WebSphere ESB only
  • WebSphere Business Modeler Publishing Server, WebSphere Business Monitor, or both, with WebSphere ESB
  • Administration
  • Feature Pack Business Space widgets
WebSphere Process Server, version 6.2.0.1 or later Human Task Management

task Task topic

Terms of use | Feedback


Timestamp icon Last updated: 23 June 2009


http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r2mx/topic/com.ibm.websphere.wbpm.fep.psesb.620.doc/doc/tins_wpswesb_fep_install_gui.html
Copyright IBM Corporation 2005, 2009. All Rights Reserved.
This information center is powered by Eclipse technology (http://www.eclipse.org).