This topic describes how to customize the response file for installing the WebSphere Application Server - Express product from a command line without using the graphical user interface of the Installation wizard.
Before you begin
Before using the install -options myoptionsfile -silent command on a Linux or UNIX platform, or the install.exe -options myoptionsfile -silent command on a Windows platform to invoke a silent installation, you must customize the response file to add your selections.
Use the response file to supply values to the Installation wizard as the wizard runs in silent mode. The wizard does not display interactive panels when it runs in silent mode, but reads values from the response file instead.
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 with the -options or -silent parameters. 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.express.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.express.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 detectedexistingcopypanelInstallWizardBean.choice="addFeatures"Platform specific: -P wasProductBean.installLocation="/usr/IBM/WebSphere/AppServer"
Platform specific: -P wasProductBean.installLocation="/opt/IBM/WebSphere/AppServer"
Platform specific: -P wasProductBean.installLocation="C:\Program Files\IBM\WebSphere\AppServer" # -W detectedexistingcopypanelInstallWizardBean.choice ="upgrade" # -W detectedexistingcopypanelInstallWizardBean.upgradeMatchInstallLocations = "EXPRESS TRIAL INSTALL LOCATION" -W setuptypepanelInstallWizardBean.selectedSetupTypeId="Custom" -P samplesProductFeatureBean.active="true" -P javadocsProductFeatureBean.active="true" -W defaultprofileportspanelInstallWizardBean.WC_defaulthost="9080" -W defaultprofileportspanelInstallWizardBean.WC_adminhost="9060" -W defaultprofileportspanelInstallWizardBean.WC_defaulthost_secure="9443" -W defaultprofileportspanelInstallWizardBean.WC_adminhost_secure="9043" -W defaultprofileportspanelInstallWizardBean.BOOTSTRAP_ADDRESS="2809" -W defaultprofileportspanelInstallWizardBean.SOAP_CONNECTOR_ADDRESS="8880" -W defaultprofileportspanelInstallWizardBean.SAS_SSL_SERVERAUTH_LISTENER_ADDRESS="9401" -W defaultprofileportspanelInstallWizardBean.CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS="9403" -W defaultprofileportspanelInstallWizardBean.CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS="9402" -W defaultprofileportspanelInstallWizardBean.ORB_LISTENER_ADDRESS="9100" -W defaultprofileportspanelInstallWizardBean.DCS_UNICAST_ADDRESS="9353" -W defaultprofileportspanelInstallWizardBean.SIB_ENDPOINT_ADDRESS="7276" -W defaultprofileportspanelInstallWizardBean.SIB_ENDPOINT_SECURE_ADDRESS="7286" -W defaultprofileportspanelInstallWizardBean.SIB_MQ_ENDPOINT_ADDRESS="5558" -W defaultprofileportspanelInstallWizardBean.SIB_MQ_ENDPOINT_SECURE_ADDRESS="5578" -W nodehostandcellnamepanelInstallWizardBean.nodeName="nodeName" -W nodehostandcellnamepanelInstallWizardBean.hostName="hostName"
Platform specific: -W winservicepanelInstallWizardBean.winServiceQuery="true"
Platform specific: -W winservicepanelInstallWizardBean.accountType="localsystem"
Platform specific: -W winservicepanelInstallWizardBean.startupType="manual"
Platform specific: -W winservicepanelInstallWizardBean.userName="YOUR_USER_NAME"
Platform specific: -W winservicepanelInstallWizardBean.password="YOUR_PASSWORD"
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\WAS\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. |
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:
The feature selection options are described after the installation type option. |
Default value | Description | Your value |
---|---|---|
Commented out | Leave this directive commented if you do not have a
trial installation that you intend to upgrade. Uncomment the line to upgrade the configuration and applications of a product trial installation to the actual WebSphere Application Server - Express product that you are installing. You must also use the next directive to specify the location of the existing trial. |
Default value | Description | Your value |
---|---|---|
Commented out | Leave this directive commented if you are not upgrading
an existing trial to the actual Express product that you are installing. Uncomment the line to upgrade the product trial installation to the WebSphere Application Server - Express product. Replace the value "EXPRESS TRIAL INSTALL LOCATION" with the installation root directory of the existing trial. During an upgrade, all other installation options are ignored. Only the upgrade occurs. |
Default value | Description | Your value |
---|---|---|
Typical | Do not change the value of this directive. A custom installation of the Express product is required when using an options response file. A custom installation accepts values for all of the options that you have specified in the response file. |
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. |
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. |
Default value | Description | Your value |
---|---|---|
WC_defaulthost="9080" | Default port assignment for the virtual host named defaulthost. This virtual host serves Samples and the default application, including the snoop servlet. | |
WC_adminhost="9060" | Default port assignment for the virtual host named adminhost. This virtual host serves the administrative console application. | |
WC_defaulthost_secure="9443" | Secure port assignment for the defaulthost. | |
WC_adminhost_secure="9043" | Secure port assignment for the adminhost. | |
BOOTSTRAP_ADDRESS="2809" | These port assignments do not normally
change unless they are already in use on your system. All port assignments must be unique on a machine to avoid conflicts with other products and applications on your machine. Other installations of WebSphere Application Server can use conflicting port assignments. Multiple profiles (V6 Application Servers) on the machine must each have unique port assignments. |
|
SOAP_CONNECTOR_ADDRESS="8880" | ||
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS="9401" | ||
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS="9403" | ||
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS="9402" | ||
ORB_LISTENER_ADDRESS="9100" | ||
DCS_UNICAST_ADDRESS="9353" | ||
SIB_ENDPOINT_ADDRESS="7276" | ||
SIB_ENDPOINT_SECURE_ADDRESS="7286" | ||
SIB_MQ_ENDPOINT_ADDRESS="5558" | ||
SIB_MQ_ENDPOINT_SECURE_ADDRESS="5578" |
Default value | Description | Your value |
---|---|---|
hostName | The hostName value is not a variable. The Installation
wizard replaces the value with the short local host name when you use the
graphical interface without a response file. Every Application Server environment in WebSphere Application Server products must be addressable through a host name on a network file system. See Installing the Express product with custom options for more information about the field. |
Default value | Description | Your value |
---|---|---|
true | A true value creates a Windows service that starts or
stops the application server that is named server1. A value of false skips
the creation of the Windows service. When you create a Windows service, WebSphere Application Server - Express attempts to start the Windows service whenever you start or stop the server that the service controls. This attempt to start or stop the service occurs even though you might select a startup type of manual. |
Default value | Description | Your value |
---|---|---|
localsystem | You can install the service on the local system account or on the specified user account that you identify. |
Default value | Description | Your value |
---|---|---|
manual | You can start the service automatically or manually
or disable the service. When you create a Windows service, WebSphere Application Server attempts to start the Windows service whenever you start or stop the server that the service controls. This attempt to start or stop the service occurs even though you might select a startup type of manual. No attempt is made to start or stop a disabled Windows service. |
Default value | Description | Your value |
---|---|---|
YOUR_ USER_NAME | You must specify your user account. The user account must belong to the administrator user group and have the advanced user rights Act as part of the operating system and Log on as a service. |
Default value | Description | Your value |
---|---|---|
YOUR_ PASSWORD | You must specify your password if you have password
protection enabled on the Windows operating system. The password is not recorded in a file other than this one. After installing the product, edit the response file and remove the password. |
Perform the following procedure to edit the response file.
Steps for this task
Read the directions within the response file to choose appropriate values.
umaskTo set the umask setting to 022, issue the following command:
umask 022
For example, on some Windows systems, click Administrative Tools > Local Security Policy > User Rights Assignments to see the advanced options. See your Windows documentation for more information.
The installation wizard grants your Windows user ID the
advanced user rights, if the user ID belongs to the administrator group. The
silent installation does not grant these rights. If you create a new user
ID on a Windows platform to perform a silent installation, you must restart
the system to activate the proper authorizations for the user ID before you
can perform a successful silent installation.
When
installing the WebSphere Application Server as a Windows service, do not use
a user ID that contains spaces. A user ID with spaces cannot be validated.
Such a user ID is not allowed to continue the installation. To work around
this problem, install with a user ID that does not contain spaces, or do not
choose to install Windows services.
You can find the sample options response file in the WAS directory on the product CD.
Result
This procedure results in creating a customized response file and using the file to start a silent installation.Example
Edit the version of the file that ships with the WebSphere Application Server - Express product. The example in responsefile.express.txt is not guaranteed to be an accurate representation of what ships with the product.
What to do next
Go to Installing silently to continue.
Related tasks
Installing silently