responsefile.express.txt

Installing WebSphere Application Server - Express using silent installation refers to using a file to supply installation options without user interaction. To configure the installation, change the options in the response file before you issue the installation command. Silent installation mode does not accept interactive installation options. To specify non-default options during a silent installation, you must use the response file. To install silently, you must accept the license agreement in the agreement option.

Verify that the required disk space is available.

See Preparing the operating system for product installation for more information.

Do not use the default response file that is shipped on the product disk to install the product because the value of the silentInstallLicenseAcceptance option is false. Copy the file to change the value to true.

Location of the response file

The sample options response file is named responsefile.express.txt. The file is in the WAS directory on the product disk or the downloaded installation image.

You can also use an options response file named responsefile.express.txt in the WAS directory of a customized installation package (CIP) produced by the Installation Factory.

Creating an operational environment

Installing the product with the response file creates an operational environment by default. The installer program:

  1. Installs the new product code.
  2. Creates the default profile.

    You can create additional profiles using any of these available methods:

Installing with a response file

  1. Copy the responsefile.express.txt file from the WAS directory on the product disk to a place that you can easily identify on your system.
  2. Edit the file to customize the values for your installation.
  3. Save the file as myresponsefile.txt, for example.
  4. Start the installation. For example:
    [AIX] [HP-UX] [Linux] [Solaris]
    install -options /tmp/WAS/myresponsefile.txt -silent
    
    [Windows]
    install -options C:\temp\WAS\myresponsefile.txt -silent
    
  5. After the installation, examine the logs for success.

Logging

The installation wizard and profile management record installation events in the following log files.

Log files for WebSphere® Application Server - Express®: The following table shows the installation logs, content, and indicators of success and failure for WebSphere Application Server - Express:

Table 1. Installation and profile creation logs for WebSphere Application Server products
Log Content Indicators
app_server_root/logs/log.txt Logs all installation events
INSTCONFFAIL
Total installation failure.
INSTCONFSUCCESS
Successful installation.
INSTCONFPARTIALSUCCESS
Installation errors occurred but the installation is still usable. Additional information identifies the errors.
app_server_root/wasprofileprofile_name.log
  • Traces all events that occur during the creation of the named profile
  • Created when using the Profile Creation wizard or the wasprofile command
INSTCONFFAIL
Total profile creation failure.
INSTCONFSUCCESS
Successful profile creation.
INSTCONFPARTIALSUCCESS
Profile creation errors occurred but the profile is still functional. Additional information identifies the errors.
app_server_root/logs/wasprofile/wasprofile_delete_ profile_name.log
  • Traces all events that occur during the deletion of the named profile
  • Created when using the Profile Creation wizard or the wasprofile command
INSTCONFFAIL
Total profile deletion failure.
INSTCONFSUCCESS
Successful profile deletion.
INSTCONFPARTIALSUCCESS
Profile deletion errors occurred but the profile is still deleted. Additional information identifies the errors.
profile_root/logs/pctLog.txt Logs all profile creation events that occur when using the Profile Creation wizard
INSTCONFFAIL
Total profile creation failure.
INSTCONFSUCCESS
Successful profile creation.
INSTCONFPARTIALSUCCESS
Profile creation errors occurred but the profile is still functional. Additional information identifies the errors.
app_server_root\logs\instconfig.log (Not available on systems such as AIX or Linux) Logs the activities of ANT configuration scripts that run at the end of the installation procedure.
Configuration action failed:
Unsuccessful ANT script configuration.
Configuration action succeeded:
Successful ANT script configuration.

Information that ISMP can log when it cannot start the Installation wizard

Verify or troubleshoot the installation if the app_server_root/logs/install/log.txt file or the profile_root/logs/pctLog.txt file does not contain a record of a problem, but problems exist. If the profile_root directory exists, the pctLog.txt file is in the logs directory. If the error happens early in the installation, look for the logs in the system temporary area. The installation program copies the logs from the system temporary area to the logs directory at the end of the installation.

If the profile_root directory does not exist, the pctLog.txt file is in the USER_HOME directory and is named .$~pctLog.txt. Issue the env command to display the USER_HOME directory on operating systems such as AIX or Linux. See the environment variable settings on Windows system to display the value of the variable.

Certain events can prevent the installer from starting the installation wizard. Such an event is not enough disk space to launch the installation wizard, for example. If your installation fails and there is no information in the installation logs, use the -log parameter to record entries for events that cause the installer program to fail to start the installation wizard. The syntax of the install command for logging such events is:
install  -options fully_qualified_options_response_file_name               
         -silent
         -log # !fully_qualified_log_file_name  @ALL 
  • [AIX]
    install -options "/usr/IBM/WebSphere/silentFiles/myresponsefile.txt" 
            -silent -log # !/usr/IBM/WebSphere/myOptionFiles/log.txt  @ALL
    
  • [Linux] [HP-UX] [Solaris]
    install -options "/opt/IBM/WebSphere/silentFiles/myresponsefile.txt" 
            -silent -log # !/opt/IBM/WebSphere/myOptionFiles/log.txt  @ALL
    
  • [Windows]
    install.exe -options "C:\IBM\WebSphere\silentFiles\myresponsefile.txt" 
                -silent -log # !C:\IBM\WebSphere\silentFiles\log.txt  @ALL

See Troubleshooting installation for more information.

Example of the default file

################################################################################
#
# InstallShield Options File
#
# Wizard name: Install
# Wizard source: setup.jar
#
# This file can be used to configure Install with the options specified below
# when the wizard is run with the "-options" command line option. Read each
# setting's documentation for information on how to change its value.
# 
# A common use of an options file is to run the wizard in silent mode. This lets
# the options file author specify wizard settings without having to run the
# wizard in graphical or console mode. To use this options file for silent mode
# execution, use the following command line arguments when running the wizard:
# 
#    -options "D:\installImage\WAS\responsefile.express.txt" -silent
#
################################################################################

###################################################################################
#
# License Acceptance
#
# Valid Options	: true   Accepts the license. Will install the product.
#		  false  Declines the license. Install will not occur.  
#
# If no install occurs, this will be logged to a temporary log file in the user's temporary directory.
#
# 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.
#
# 

-W silentInstallLicenseAcceptance.value="false"

################################################################################
#
# Install a new copy of IBM WebSphere Application Server product 
#
# If you are installing a new of copy of the product,  leave  the following line uncommented.
# Otherwise, comment the line.
#
-W detectedexistingcopypanelInstallWizardBean.choice="installNew"


################################################################################
#
# Apply maintenance and add features
#
# If you are planning to apply maintenance, add features, or both on 
# top of an existing installation, uncomment the following line. 
#
# -W detectedexistingcopypanelInstallWizardBean.choice="addFeaturesAndFixes"
#
# Please make sure installLocation is set to your existing install location.
#
#
# For additional features you wish to install, set the feature active
# properties to true.  
#
# NOTE: If the product edition of the custom installation package is 
#       different from the existing installation package, then the features
#       will not be added.
#
# For example, you have installed core product feature, now you want to install
# samples feature, the active properties should be:
#
# -P samplesProductFeatureBean.active="true"
# -P javadocsProductFeatureBean.active="false"
#


################################################################################
#
# IBM WebSphere Application Server - Express, V6.0 Install Location
#
# The install location of the product. Specify a valid directory into which the
# product should be installed. If the directory contains spaces, enclose it in
# double-quotes as shown in the Windows example below. Note that spaces in the
# install location is only supported on Windows operating systems.
# 
# Below is the list of default install locations for each supported operating
# system.  By default, in this response file, the Windows install location is 
# used.  If you want to use the default install location for another operating
# system, uncomment the appropriate default install location entry (by removing '#') and 
# then comment out (by adding '#') the Windows operating system entry below.
#
# Comment this install location entry when doing an upgrade or upgrade will fail.
#
# AIX Default Install Location:
#
#    -P wasProductBean.installLocation=/usr/IBM/WebSphere/AppServer	
#
#
# HP-UX, Solaris or Linux Default Install Location:
#
#    -P wasProductBean.installLocation=/opt/IBM/WebSphere/AppServer	
#
#
# Windows Default Install Location:
#

-P wasProductBean.installLocation="C:\Program Files\IBM\WebSphere\AppServer"

################################################################################
#
# Warning: the custom install package may update your existing profiles.
#
# This custom install package may update the runtime environment profiles
# in your runtime environment.  Tt is strongly recommended that you backup 
# all profiles before you continue.   If you uninstall this maintenance package
# at a later time, these profile updates will not be uninstalled because 
# additional custom modifications may have subsequently been made.  
# 
# For more information on profile management, see the wasprofile command
# documentation in the Information Center.
#
# The default value is "true", it will block the install unless you change
# the active property to "false".
#
# If you have already backed up your profiles or you wish to ingore the warnings,
# you can change it to "false".
#
# For example:
#
# -W profileUpdateWarningPanelWizardBean.active="false"
#

-W profileUpdateWarningPanelWizardBean.active="true"


################################################################################
#
# IBM WebSphere Application Server - Express, V6.0 UPGRADE from Express Trial
#
# NOTE - : DO NOT Set this Option if you do not have any Express Trial installed
#          You can not do an upgrade if you do not have at least one Express Trial installed
#
#
# To setup an upgrade install, UNcomment the following entry ( do not change the "upgrade" value )
#
#-W detectedexistingcopypanelInstallWizardBean.choice="upgrade"
#
#
# Additionally, specificy the installation location where the Express Trial (which you want to upgrade)
# is installed, by UNcommenting the following entry and by replacing "EXPRESS TRIAL INSTALL LOCATION" with the a
# actual installation directory
#
#-P wsglobalinstallconstantsProductBean.detectedExistingPanelUpgradeMatchInstallLocation="EXPRESS TRIAL INSTALL LOCATION"
#
#
#
# NOTE - : In an Upgrade the following entries will be skipped and only an upgrade of the specified Express Trial
#          to Express will occur
#


################################################################################
#
# Setup Type
#
# This value is required for the installation. Do not change this!
# 

-W setuptypepanelInstallWizardBean.selectedSetupTypeId="Custom"


################################################################################
#
# "Core Product Files" feature
#
# This feature is required by Application Server and will be installed by default. 
# Selection is not required.
#


################################################################################
#
# "Application Server samples" feature
#
# The selection state of the "Application Server samples" feature. Legal values
# are:
# 
#    true  - Indicates that the feature is selected for installation
#    false - Indicates that the feature is not selected for installation
# 
# For example, to select "Application Server samples" for installation, use
# 
#    -P samplesProductFeatureBean.active="true"
#
# 


-P samplesProductFeatureBean.active="true"


################################################################################
#
# "Javadocs" feature
#
# The selection state of the "Javadocs" feature. Legal values are:
# 
#    true  - Indicates that the feature is selected for installation
#    false - Indicates that the feature is not selected for installation
# 
# For example, to select "Javadocs" for installation, use
# 
#    -P javadocsProductFeatureBean.active="true"
#


-P javadocsProductFeatureBean.active="true"



################################################################################
# 
# Port value assignment
# 
# The following entries are used to reset port numbers used in the configuration
#
# They are currently set to the defaults. 
# Please check to make sure there are no Port Conflicts
#
-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"



################################################################################
# 
# Node name
#
# Please select the node name for the Application Server. Node name under one cell 
# has to be unique. 
#
# Replace YOUR_NODE_NAME with the actual node name.
#
-W nodehostandcellnamepanelInstallWizardBean.nodeName="YOUR_NODE_NAME"


################################################################################
#
# Host name
#
# Specify the host name for the Application Server. The host name is the domain 
# name system (DNS) name (short or long) or the IP address of this computer. 
# 
# Replace YOUR_HOST_NAME with the actual host name. Comment the line to use 
# the default value.
#
-W nodehostandcellnamepanelInstallWizardBean.hostName="YOUR_HOST_NAME"


################################################################################
#
# Cell name
#
# You should not Modify this, unless absolutely necessary.
# 
# The Wizard would set this to short local host name + "Node##Cell" by default.
#
# If you would like to override the resolved cell name value, uncomment the line and
# replace YOUR_CELL_NAME with <YOUR_OWN_VALUE>.
#
# -W setcellnameinglobalconstantsInstallWizardBean.value="YOUR_CELL_NAME"


################################################################################
#
# Run WebSphere Application Server as a Windows service
# (Windows ONLY)
# 
# The selection state of the service installation. Legal values are:
#
#    true  - Indicates that you choose to install the service
#    false - Indicates that you not choose to install the service
#


-W winservicepanelInstallWizardBean.winServiceQuery="true"

# Specify account type of the service. Legal values are:
#   
#    localsystem   - Indicates that you choose to use Local System account.
#    specifieduser - Indicates that you choose to use specified user account.
#



-W winservicepanelInstallWizardBean.accountType="localsystem"


# Specify startup type of the service. Legal values are:
#
#    automatic - Indicates that you choose to use automatic startup type
#    manual    - Indicates that you choose to use manual startup type
#    disabled  - Indicates that you choose to use disabled startup type
#


-W winservicepanelInstallWizardBean.startupType="manual"
 

# Specify your user name and password. Your user name
# must belong to the administrator group to be authorized
# to install a Windows service. Your user name must have
# the "Log On as a Service" user right for the service to run properly.
#
# Replace YOUR_USER_NAME with your username.
# Replace YOUR_PASSWORD with your valid password.
 

-W winservicepanelInstallWizardBean.userName="YOUR_USER_NAME"
-W winservicepanelInstallWizardBean.password="YOUR_PASSWORD"
 

################################################################################
#
# WebSphere Application Server Profile Creation Tool (PCT)
#
# To launch the Profile Creation Tool SILENTLY at the end
# of the installation, please change the value to "true".
# Otherwise, change the value to "".
#
# Please Note: This will launch the latest PCT.  If the Custom Install Package
# contains profile customizations, this will launch the PCT installed in
# <WAS_HOME>/cip/<uid>/ProfileCreator.  Otherwise, it will launch the GM version
# PCT which can be found at <WAS_HOME>/bin/ProfileCreator.
# 

-W BEsummarypanelInstallWizardBean.launchPCT="false"


################################################################################
# If you choose to run Profile Creation Tool silently at the end of the
# installation, you must
# 1. get a copy of the PCT response file of Profile creator (from CD) and put to a temp dir
#    such as: /tmp/WAS/responsefile.pct.ExpressProfile.txt
# 2. modify the response file by filling in the required options/values. 
# Note: If the values are not completed properly, the configuration may be unsuccessful. 
# 3. specify below the absolute path to your modified response file. 
# 
# For example, -W pctresponsefilelocationqueryactionInstallWizardBean.fileLocation="/tmp/WAS/responsefile.pct.ExpressProfile.txt"


-W pctresponsefilelocationqueryactionInstallWizardBean.fileLocation=""




################################################################################


Installation type options and options for profiles

Options that you can use to install silently vary according to the installation task that you are performing:
  • installNew
  • addFeature
  • upgrade

Options for a new installation

-OPT silentInstallLicenseAcceptance="true"
-OPT installType="installNew"
-OPT feature="samplesSelected"
-OPT installLocation="/opt/IBM/WebSphere/AppServer"

Options for creating a stand-alone application server cell

-OPT feature="samplesSelected"
-OPT installLocation="/opt/IBM/WebSphere/AppServer"
-OPT createProfile="true"
-OPT profileType="standAlone"
-OPT silentInstallLicenseAcceptance="true"
-OPT traceFormat=ALL
-OPT traceLevel=INFO
-OPT PROF_cellName= 
-OPT PROF_defaultPorts=
-OPT PROF_enableAdminSecurity="false"
-OPT PROF_hostName=
-OPT PROF_isDefault=
-OPT PROF_nodeName=
-OPT PROF_omitAction=
-OPT PROF_portsFile=
-OPT PROF_profileName=
-OPT PROF_profilePath=
-OPT PROF_serverName=
-OPT PROF_startingPort=
-OPT PROF_validatePorts=
-OPT PROF_webServerCheck=
-OPT PROF_webServerHostname=
-OPT PROF_webServerInstallPath= 
-OPT PROF_webServerName= 
-OPT PROF_webServerOS=
-OPT PROF_webServerPluginPath=
-OPT PROF_webServerPort= 
-OPT PROF_webServerType=
-OPT PROF_winserviceAccountType=
-OPT PROF_winserviceCheck=
-OPT PROF_winservicePassword=
-OPT PROF_winserviceStartupType=
-OPT PROF_winserviceUserName=
Reference topic    

Terms of Use | Feedback

Last updated: Aug 29, 2010 6:22:59 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=vela&product=was-express-dist&topic=rins_responsefile_express61_cip
File name: rins_responsefile_express61_cip.html