WebSphere

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

Perform a silent, or background, installation of the feature pack on an existing installation of a supported WebSphere® Business Process Management, version 6.2.0.1 or later, product by using a file called a response file. Instead of displaying a graphical user interface, the silent installation uses your responses from this file. The response file passes command-line options to the installation program. An example response file, responsefile.wpswesbfep.txt, is supplied with default values that you must customize.

Before you begin

Before starting this installation, complete the following tasks:

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. Copy the responsefile.wpswesbfep.txt file, which is located in the WPSWESBFEP directory of the extracted installation image, to another location on the target operating system.
  3. If you have not already done so, read the IBM® International Program License Agreement. It is located in the following directory:
    • For AIX operating systemFor HP-UX operating systemFor Linux operating systemFor Solaris operating system /WPSWESBFEP/lafiles
    • For Windows operating system \WPSWESBFEP\lafiles
    If you agree to the terms of the agreement, continue with the installation process.
  4. Open the copy of the response file that you created in step 2 on the target operating system, and customize it with the parameters for your system using a flat file editor of your choice.

    For AIX operating system To prepare the file for a silent installation on the AIX® platform, use UNIX line-end characters (0x0D0A) to end each line of the response file. The safest method of preparing the file is to edit the file on the target operating system.

    Read the directions in the response file to choose appropriate values for all of the options you must set for your specific silent installation. You can modify all of the parameters in the response file but, in particular, note the following options and values:
    • Change the silentInstallLicenseAcceptance option value in the file to a value of true. Leaving it with a value of false causes the installation to fail. For example:
      -OPT silentInstallLicenseAcceptance="true"
    • If you are installing as a nonroot or nonadministrator user ID, the installation will not be registered with the operating system. You must accept this limitation in order to install. Do so by uncommenting the allowNonRootSilentInstall option and leaving the value of true. For example:
      -OPT allowNonRootSilentInstall="true"
      Restriction: If you are installing on Windows Vista or 2008, review the information related to these platforms under Before you begin.
    • Specify whether to perform a new installation or add a feature to an existing feature pack installation by changing the installType option to one of the following values:
      • installNew: Select this value to install a new copy of the feature pack.
      • addFeature: Select this value to add features to an existing feature pack installation. This option can be used only on installations where WebSphere Process Server V6.2.0.1 is installed.
      For example,
      -OPT installType="installNew"
      or
      -OPT installType="addFeature"
    • Specify the installation to which you want to apply the feature pack by setting the installLocation option. In the following example, install_root is the directory path to your WebSphere Business Process Management product installation:
      -OPT installLocation="install_root"
      The installation must be listed in the New Install Framework (NIF) registry. If you are installing as a nonroot or nonadministrator user, be sure that you have write permission to the install_root directory.
      Restriction: You cannot install the feature pack on a WebSphere Process Server Client installation. If you set the installLocation option to a WebSphere Process Server Client installation location, the feature pack installation fails.
    • Set values for the administrationSelected and humanTaskManagementSelected options. Valid values depend on the WebSphere Business Process Management products that are included in the installation to which you apply the feature pack.
      Refer to Table 1 for guidelines about choosing values for the administrationSelected and humanTaskManagementSelected options.
      Important: If you select options that are not valid for an installation (for example, if you select to install the Human Task Management feature on a WebSphere ESB installation), the feature pack installation fails.
      Table 1. Installable features (based on underlying products)
      Products in the installation Which features can be installed How to set options in the response file
      • 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
      • Set the administrationSelected option to true:
        -OPT administrationSelected="true"
      • Leave the humanTaskManagementSelected option set to false:
        -OPT humanTaskManagementSelected="false"
      • Feature Pack Business Space widgets feature is installed automatically.
      • 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
      • Leave the administrationSelected option set to false:
        -OPT administrationSelected="false"
      • Leave the humanTaskManagementSelected option set to false:
        -OPT humanTaskManagementSelected="false"
      • Feature Pack Business Space widgets feature is installed automatically.
      • WebSphere Process Server only
      • WebSphere Process Server in a stacked-product installation with WebSphere Business Modeler Publishing Server, WebSphere Business Monitor, or both
      • Administration, Human Task Management, or both
      • Feature Pack Business Space widgets
      • Set the administrationSelected option to true:
        -OPT administrationSelected="true"
      • Set the humanTaskManagementSelected option to true:
        -OPT humanTaskManagementSelected="true"
      • Feature Pack Business Space widgets feature is installed automatically.
      Alternatively, you can select to install just the Administration feature or just the Human Task Management feature. In this case, set only the value of the option you want to install to true.
      Important: You must install either the Administration feature or the Human Task Management feature, or the installation will fail.
      Tip: If you elect to install only one feature, you can rerun the installer at a later time to install the other feature. 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. Start the feature pack installation program by running the install command in the WPSWESBFEP directory of the feature pack installation image.
    In the following example commands, path/my_responsefile.wpswesbfep.txt represents the fully qualified path of the response file that you edited:
    • For AIX operating systemFor HP-UX operating systemFor Solaris operating system /WPSWESBFEP/install.sh -options path/my_responsefile.wpswesbfep.txt -silent
    • For Linux operating system /WPSWESBFEP/install -options path/my_responsefile.wpswesbfep.txt -silent
    • For Windows operating system \WPSWESBFEP\install.exe -options path\my_responsefile.wpswesbfep.txt -silent
Results
The installer installs the feature pack and records installation events in the log.txt file. You can verify the success of the installation by examining this file in the following location:

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 this log file contains the string INSTCONFSUCCESS on the last line, then the installation was successful. Other strings, such as INSTCONFPARTIALSUCCESS or INSTCONFFAILED, can occur on other lines in the file, or even on the last line, but if INSTCONFSUCCESS is included in the last line, the installation was successful.

If the string INSTCONFPARTIALSUCCESS or INSTCONFFAILED appears in the last line of the file without INSTCONFSUCCESS, problems were detected during installation. INSTCONFPARTIALSUCCESS indicates that the installation completed but errors were generated; INSTCONFFAILED means that the installation failed completely. In either case, the log file provides information to troubleshoot the problems.

Log file location after invalid installations: If you set the installLocation option to an invalid location (one that is not in the NIF registry), the directory location in which the log file ends up depends on whether the location actually exists:
  • If the installation location does exist, the log file is copied to that directory.
  • If the installation location does not exist, the log file remains in the following directory:
    • For AIX operating systemFor HP-UX operating systemFor Linux operating systemFor Solaris operating system user_home/wpswesbfeplogs
    • For Windows operating system user_home\wpswesbfeplogs
What to do next

Run the deployment scripts that are associated with the features that you installed. These scripts enable functions that are provided by the feature pack. See Deploying and configuring widgets for the feature pack for more information.

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 create a new response file and rerun the feature pack installer 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 How to set options in the response file
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
  • Set the silentInstallLicenseAcceptance option to true:
    -OPT silentInstallLicenseAcceptance="true"
  • If you are installing as a nonroot or nonadministrator user ID, uncomment the allowNonRootSilentInstall option and leave it with a value of true:
    -OPT allowNonRootSilentInstall="true"
  • Set the installType option to addFeature:
    -OPT installType="addFeature"
  • Set the installLocation option to the installation to which you want to apply the feature pack:
    -OPT installLocation="install_root"
  • Set the administrationSelected option to true:
    -OPT administrationSelected="true"
  • Leave the humanTaskManagementSelected option set to false:
    -OPT humanTaskManagementSelected="false"
  • Feature Pack Business Space widgets feature is already installed.
WebSphere Process Server, version 6.2.0.1 or later Administration, Human Task Management, or both
  • Set the silentInstallLicenseAcceptance option to true:
    -OPT silentInstallLicenseAcceptance="true"
  • If you are installing as a nonroot or nonadministrator user ID, uncomment the allowNonRootSilentInstall option and leave it with a value of true:
    -OPT allowNonRootSilentInstall="true"
  • Set the installType option to addFeature:
    -OPT installType="addFeature"
  • Set the installLocation option to the installation to which you want to apply the feature pack:
    -OPT installLocation="install_root"
  • Set the administrationSelected option to true:
    -OPT administrationSelected="true"
  • Set the humanTaskManagementSelected option to true:
    -OPT humanTaskManagementSelected="true"
  • Feature Pack Business Space widgets are already installed.
Alternatively, you can select to install just the Administration feature or just the Human Task Management feature. In this case, set only the value of the option you want to install to true.
Important: You must install either the Administration feature or the Human Task Management feature or the installation will fail.
  • 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
  • Set the silentInstallLicenseAcceptance option to true:
    -OPT silentInstallLicenseAcceptance="true"
  • If you are installing as a nonroot or nonadministrator user ID, uncomment the allowNonRootSilentInstall option and leave it with a value of true:
    -OPT allowNonRootSilentInstall="true"
  • Set the installType option to addFeature:
    -OPT installType="addFeature"
  • Set the installLocation option to the installation to which you want to apply the feature pack:
    -OPT installLocation="install_root"
  • Set the administrationSelected option to false (this feature is already installed):
    -OPT administrationSelected="false"
  • Set the humanTaskManagementSelected option to true :
    -OPT humanTaskManagementSelected="true"
  • Feature Pack Business Space widgets feature is already installed.

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_silent.html
Copyright IBM Corporation 2005, 2009. All Rights Reserved.
This information center is powered by Eclipse technology (http://www.eclipse.org).