WebSphere WebSphere Enterprise Service Bus, Version 6.0.1 Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

Customizing the options response file

When you install WebSphere ESB silently, the installation wizard does not display interactive panels, but reads values from the response file instead. You must customize the response file to supply values to the installation wizard as it runs in silent mode.

Before you begin

Before using the install -silent -options myoptionsfile command on a Linux® or UNIX® platform, or the install.exe -silent -options myoptionsfile command on a Windows® platform to invoke a silent installation, you must customize the response file to add your selections.

Be precise when supplying values in the file: Customize the options response file precisely to let the installation program read the option values that the file contains. Incorrect specifications affect the silent interface of the Installation wizard. For example, always enclose values in double quotation marks.

If you customize the response file incorrectly, the installation wizard cannot install the product unless you remove the -options parameter. If the error is an invalid option value, ISMP displays a warning message that you must confirm and stops the installation.

Compare your options response file to the responsefile.esb.txt file that is shipped with the product to make the necessary corrections. After correcting the file, reinstall.

Why and when to perform this task

Guidance: The options response file has comments that describe each directive in the file. Read the explanations in the file to further understand the purpose of each directive.

See responsefile.esb.txt for an example of the comments and directives in the response file.

Use the following description of options as a worksheet to plan your values. Refer to the individual descriptions of directives in the following list to help plan your responses:
-W silentInstallLicenseAcceptance.value="false"
# -W esbDetectionPanel_InstallWizardBean.optionSelected="1"
Platform specific: -P esbProductBean.installLocation="/usr/IBM/WebSphere/ESB"
Platform specific: -P esbProductBean.installLocation="/opt/IBM/WebSphere/ESB"
Platform specific: -P esbProductBean.installLocation="C:\Program Files\IBM\WebSphere\ESB"
-P samplesProductFeatureBean.active="true"
-P javadocsProductFeatureBean.active="true"
-W summarypanel_InstallWizardBean.launchPCAW="true"
-W pawresponsefilelocationqueryaction_InstallWizardBean.fileLocation=""
-W silentInstallLicenseAcceptance.value="false"
Valid values are true or false. You must accept the license agreement before you are allowed to install the product.
Default value Description Your value
false By changing the silentInstallLicenseAcceptance.value in this response file to "true", you agree that you have reviewed and agree to the terms of the IBM® International Program License Agreement accompanying this program, which is located at CD_ROOT\ESB\lafiles. If you do not agree to these terms, do not change the value or otherwise download, install, copy, access, or use the program and promptly return the program and proof of entitlement to the party from whom you acquired it to obtain a refund of the amount you paid.

Change the value to true to accept the license agreement and install the product. You cannot install the product with the default value.

 
-W esbDetectionPanel_InstallWizardBean.optionSelected= "1"
The only valid value for this directive is 1. Leave the line commented if you are not adding features to a previous installation.
Default value Description Your value
Commented out Uncomment the line to add features to an existing installation in an incremental migration.

Change the value of the following -P wasProductBean.installLocation= directive to the directory of the existing installation.

To avoid problems, set the feature active properties for currently installed features to false. To install a new feature, set the feature active property to true.

For example, suppose that you have an existing installation of the product with the Javadocs feature installed, but not the Samples feature. To install the Samples feature, set the following directives accordingly:
  • -P samplesProductFeatureBean.active=true
  • -P javadocsProductFeatureBean.active=false

The feature selection options are described after the installation type option.

 
-P esbProductBean.installLocation=
  • For AIX platforms -P esbProductBean.installLocation="/usr/IBM/WebSphere/ESB"
  • LINUX platforms Solaris platforms -P esbProductBean.installLocation="/opt/IBM/WebSphere/ESB"
  • For Windows platforms -P esbProductBean.installLocation="C:\Program Files\IBM\WebSphere\ESB"
Default value Description Your value
Varies per product disc The installation root directory for the product. Specify a valid directory.

The default installation location is for a Windows system. Comment the Windows line to install on a Linux or UNIX operating system.

Uncomment the line that describes your platform and optionally change the location. The installation path must be 80 characters or less.

LINUX platforms UNIX platforms
Important: Do not use symbolic links as the destination directory. Symbolic links are not supported.

LINUX platforms UNIX platforms Spaces are also not supported in the name of the installation directory.

On a Windows system, the directory can contain spaces. Enclose a directory name with spaces within double quotation marks as shown in the Windows example.

 
-P samplesProductFeatureBean.active="true"
Valid values are true or false.
Default value Description Your value
true This option installs the Samples feature.

Change the value to false to skip the installation of the Samples feature.

Change the value to false during an incremental installation if the Samples feature is already installed.

Do not use a value of true if the Samples feature is already installed.

 
-P javadocsProductFeatureBean.active="true"
Valid values are true or false.
Default value Description Your value
true This option installs the Javadocs feature.

Change the value to false to skip the installation of the Javadocs feature.

Change the value to false during an incremental installation if the Javadocs feature is already installed.

Do not use a value of true if the Javadocs feature is already installed.

 
-W summarypanel_InstallWizardBean.launchPCAW="true"
Valid values are true or false.
Default value Description Your value
true A value of true launches the Profile creation wizard silently.

This option controls launching the Profile creation wizard silently at the end of the installation of the core product files and features. The Profile creation wizard can create one of the three available profile types for the Network Deployment product.

 
-W pcawresponsefilelocationqueryaction_InstallWizardBean.fileLocation=""
Valid values are the absolute path and file name of the customized options file for a profile. The original files are located in the ESB directory on the product disc or the downloaded installation image.
You must copy the appropriate file to a location on your machine where you can edit and save the file. The names of the original profile response files are:
  • Deployment manager profile: The response file responsefile.pcat.esb.dmgrProfile.txt can be used to silently create a deployment manager profile.
  • Stand-alone server profile: The response file responsefile.pcat.esb.standAloneProfile.txt can be used to silently create a WebSphere ESB stand-alone server profile.
  • Custom profile: The response file responsefile.pcat.esb.managedProfile.txt can be used to silently create a custom profile. A custom profile must be federated into a deployment manager cell to become operational. Because of this strong dependency on being a managed node, the profile is often referred to as a managed profile.

Each file contains a planning area for marking your values.

Default value Description Your value
none This option must specify the absolute path to the customized options file for the appropriate profile.

For example:

LINUX platforms UNIX platforms
-W pcawresponse...fileLocation=
"/tmp/ESB/responsefile.pcat.esb.dmgrProfile.txt"
For Windows platforms
-W pctresponse...fileLocation=
"C:\temp\ESB\responsefile.pcat.esb.dmgrProfile.txt"

 

Perform the following procedure to use the options response file

Steps for this task

  1. Locate the sample options response file. The file is named responsefile.esb.txt in the ESB directory on the product CD-ROM or in a downloaded installation image.
  2. Copy the file to preserve it in its original form. For example, copy it as myoptionsfile on your disk drive.
  3. Edit the copy in your flat file editor of choice, on the target operating system. Read the directions within the response file to choose appropriate values.
    Important: To prepare the file for a silent installation on AIX®, use UNIX line-end characters (0x0D0A) to end each line of the options response file. The safest method of preparing the file is to edit the file on the target operating system.
  4. Include custom option responses that reflect parameters for your system.

    Read the directions within the response file to choose appropriate values.

  5. Save the file.
  6. Optional: Edit the response file for the profile that you selected while editing the response file for the product installation. The directives for each file are described in the following topics:
  7. Save the response file for creating the profile.
  8. Log on with the proper authorizations for installing the product.

    Log on as root on a Linux platform or a UNIX platform, or as a user that belongs to the administrator group on a Windows platform. Installing as a non-root user is not supported on Linux or UNIX operating systems.

    Some steps of the silent installation procedure on a Windows platform require that the administrator group user have the advanced user rights Act as part of the operating system and Log on as a service.

  9. Issue the command to start the installation.

    Use the following command to install WebSphere ESB with a file that you customize with your own responses. The following command assumes that you copy the responsefile.esb.txt file as myoptionsfile.txt before customizing the file.

    • LINUX platforms UNIX platforms install -silent -options /tmp/ESB/myoptionsfile.txt
    • For Windows platforms install.exe -silent -options "C:\temp\ESB\myoptionsfile.txt"

Result

This procedure results in creating a customized response file and using the file to start a silent installation.

What to do next

Go to Installing WebSphere ESB silently to continue.


Task topic

Terms of Use | Rate this page

Timestamp iconLast updated: 13 Dec 2005
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/index.jsp?topic=/com.ibm.websphere.wesb.doc\tasks\twesb_responsefile.html

(C) Copyright IBM Corporation 2005. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)