WebSphere Application Server - Express, Version 6.0.x     Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

Customizing the options response file for Express

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"
[AIX]Platform specific: -P wasProductBean.installLocation="/usr/IBM/WebSphere/AppServer"
[Linux][HP-UX][Solaris]Platform specific: -P wasProductBean.installLocation="/opt/IBM/WebSphere/AppServer"
[Windows]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"
[Windows]Platform specific: -W winservicepanelInstallWizardBean.winServiceQuery="true"
[Windows]Platform specific: -W winservicepanelInstallWizardBean.accountType="localsystem"
[Windows]Platform specific: -W winservicepanelInstallWizardBean.startupType="manual"
[Windows]Platform specific: -W winservicepanelInstallWizardBean.userName="YOUR_USER_NAME"
[Windows]Platform specific: -W winservicepanelInstallWizardBean.password="YOUR_PASSWORD"
 
-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\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.

 
-W detectedexistingcopypanelInstallWizardBean.choice= "addFeatures"
The only valid value for this directive is addFeatures. 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 wasProductBean.installLocation=
  • [AIX]-P wasProductBean.installLocation= "/usr/IBM/WebSphere/AppServer"
  • [Linux][HP-UX][Solaris]-P wasProductBean.installLocation= "/opt/IBM/WebSphere/AppServer"
  • [Windows]-P wasProductBean.installLocation= "C:\Program Files\IBM\WebSphere\AppServer"
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][UNIX]
Important: Do not use symbolic links as the destination directory. Symbolic links are not supported.

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

[Windows]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.

[Windows]To create a profile successfully on Windows systems during product installation, the installation directory path must be no longer than 60 characters. The C:\Program Files\IBM\WebSphere\AppServer path is 40 characters, for example. If you use a name longer than 60 characters, shorten the values of the node name and the cell name directives.

 
-W detectedexistingcopypanelInstallWizardBean.choice ="upgrade"
The only valid value is upgrade.
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.

 
-W detectedexistingcopypanelInstallWizardBean.upgradeMatchInstallLocations = "EXPRESS TRIAL INSTALL LOCATION"
The only valid value is the absolute file path to the installation root directory of the trial Express product.
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.

 
-W setuptypepanelInstallWizardBean.selectedSetupTypeId="Custom"
The only valid value is Custom.
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.

 
-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 defaultprofileportspanelInstallWizardBean.WC_*=*
The following port assignment directives use default values. It is your responsibility to specify values that are not in conflict with other ports in use on your operating system. Use the netstat -a command to display ports in use on your system. The resulting display shows ports in use at the current time. If applications or products are not running, the ports that they use do not appear in the list.
Default port assignments are shown in the following list:
  • -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"
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"  
-W nodehostandcellnamepanelInstallWizardBean.nodeName="nodeName"
Replace nodeName with a valid and meaningful name for your system. WebSphere Application Server - Express configuration files use the value as a folder name in the configuration and also within certain XML configuration files.
Reserved names: Avoid using reserved folder names as field values. The use of reserved folder names can cause unpredictable results. The following words are reserved:
  • cells
  • nodes
  • servers
  • clusters
  • applications
  • deployments
Default value Description Your value
nodeName The nodeName value is not a variable. The Installation wizard replaces the value with the short DNS form of the machine name when you use the graphical interface without a response file.

You can change the value to any unique value other than the reserved words. The node name is used in the administration of the WebSphere Application Server - Express product.

[Windows]The installation directory path must be no longer than 60 characters.

 
-W nodehostandcellnamepanelInstallWizardBean.hostName="hostName"
Replace hostName with the actual host name of your machine in long or short DNS format. You can also specify the IP address.
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.

 
[Windows]-W winservicepanelInstallWizardBean.winServiceQuery="true"
Valid values are true or false.
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.

 
[Windows]-W winservicepanelInstallWizardBean.accountType="localsystem"
Valid values are localsystem or specifieduser. 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
localsystem You can install the service on the local system account or on the specified user account that you identify.  
[Windows]-W winservicepanelInstallWizardBean.startupType="manual"
Valid values are
automatic
Indicates that you choose to let Windows start the server1 process whenever there is an abnormal stop or whenever Windows is rebooted.
manual
Indicates that you choose to start the service manually and do not intend to let Windows restart the service for you.
disabled
Indicates that the service is disabled and cannot start.
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.

 
[Windows]-W winservicepanelInstallWizardBean.userName="YOUR_USER_NAME"
Valid values are your user account that belongs to the administrator user group.
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.

 
[Windows]-W winservicepanelInstallWizardBean.password="YOUR_PASSWORD"
Valid values are the password for your user account.
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

  1. Locate the sample options response file. The file is named responsefile.express.txt in the WAS directory on the product CD-ROM.
  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 terminate 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. Log on as root on a Linux or UNIX operating system, or as a member of the administrator group on a Windows system.
    [Linux][UNIX]In addition, verify that the umask setting is 022. To verify the umask setting, issue the following command:
    umask
    To set the umask setting to 022, issue the following command:
    umask 022
    [Windows]Some steps of the installation on a Windows platform require the administrator group user to have the following advanced user rights:
    • Act as part of the operating system
    • Log on as a service

    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.

    [Windows]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.

    [Windows]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.

  7. [Linux][UNIX]Issue the proper command to use your custom response file. For example, issue one of the following commands:
    • [Linux][UNIX]mnt_cdrom/WAS/install -options /tmp/WAS/myoptionsfile.txt -silent
    • [Windows]"CD_drive_D:\WAS\install" -options "C:\temp\WAS\myoptionsfile.txt" -silent

    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.




Sub-topics
responsefile.express.txt

Related tasks
Installing silently

Task topic    

Terms of Use | Feedback

Last updated: Jun 8, 2005 12:45:23 PM EDT
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.express.doc/info/exp/ae/tins_silente.html

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