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:
- Ensure that you want to install on a Linux®, UNIX®,
or Windows® system silently
by using a response file. 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:
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 those 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.

If you are installing on Windows Vista or 2008 platforms,
perform the silent installation of the feature pack with administrator
privileges. If you start the silent installation using standard user
privileges, you are presented with an elevation prompt for administrator
privileges before you are allowed to continue. You can avoid this
prompt by running the silent installation from a Command Prompt window: - Right-click a Command Prompt shortcut.
- Click Run As Administrator.
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
- Log on to the system.
- 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.
- If you have not already done so, read the IBM® International Program License Agreement. It is located in the following directory:



/WPSWESBFEP/lafiles
\WPSWESBFEP\lafiles
If you agree to the terms of the agreement, continue with the
installation process.
- 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.
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
|
|
- 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 |
|
- 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
|
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.
|
- Start the feature pack installation program by running
the install command in the WPSWESBFEP directory
of the feature pack installation image.
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:



install_root/logs/wpswesbfep/install/log.txt
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
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.
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.
|