responsefile.nd.txt

Installing the product 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.nd.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.nd.txt in the WAS directory of a customized installation package (CIP) produced by the Installation Factory.

Creating an operational environment

Installing a new installation of WebSphere Application Server Network Deployment 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:

    • Use the Profile Creation wizard.

      See Creating profiles using the graphical user interface.

    • Use the wasprofile command.

      See the description of the wasprofile command.

    • Install with the response file with the createProfile="true" option and select a cell profile, a deployment manager profile, a custom profile, or a standalone application server profile with the -OPT profileType="profile_type" option.

    The only other way to create a profile is when installing with the installation wizard GUI. The wizard installs the product files and creates the selected profile.

Installing with a response file

  1. Copy the responsefile.nd.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 Network Deployment: The following table shows the installation logs, content, and indicators of success and failure for WebSphere Application Server Network Deployment:

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

Edit the version of the file that ships with the WebSphere Application Server Network Deployment product. The following example is not guaranteed to be an accurate representation of the file that ships with the product.
################################################################################
#
# 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.nd.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 NDdetectedexistingcopypanelInstallWizardBean.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 NDdetectedexistingcopypanelInstallWizardBean.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 Network Deployment, 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.
#
#
# 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"

################################################################################
#
# "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"


################################################################################
#
# 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 ndsummarypanelInstallWizardBean.launchPCT="true"


################################################################################
# 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.NDdmgrProfile.txt           For DMGR profile creation
#             /tmp/WAS/responsefile.pct.NDmanagedProfile.txt        For Manage profile creation
#             /tmp/WAS/responsefile.pct.NDstandAloneProfile.txt     For Stand alone profile creation
# 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.NDdmgrProfile.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
Options for creating profiles vary according to the profile that you are creating:
  • Cell
  • Deployment manager
  • Stand-alone application server
  • Custom
  • None

Options for a new installation

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

Options for creating a cell

-OPT allowNonRootSilentInstall="false"
-OPT feature="samplesSelected" 
-OPT installLocation="/opt/IBM/WebSphere/AppServer"
-OPT createProfile="true" 
-OPT profileType="cell" 
-OPT silentInstallLicenseAcceptance="true" 
-OPT traceFormat=ALL 
-OPT traceLevel=INFO
-OPT PROF_appServerNodeName=
-OPT PROF_appServerProfileName= 
-OPT PROF_cellName=
-OPT PROF_defaultPorts= 
-OPT PROF_dmgrProfileName=
-OPT PROF_enableAdminSecurity="false" 
-OPT PROF_hostName= 
-OPT PROF_isDefault=
-OPT PROF_nodeName= 
-OPT PROF_nodeOmitAction=
-OPT PROF_omitAction= 
-OPT PROF_portsFile= 
-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=

Options for creating a deployment manager

-OPT allowNonRootSilentInstall="false"
-OPT feature="samplesSelected"
-OPT installLocation="/opt/IBM/WebSphere/AppServer"
-OPT createProfile="true"
-OPT profileType="deploymentManager"
-OPT silentInstallLicenseAcceptance="false"
-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_winserviceAccountType=
-OPT PROF_winserviceCheck= 
-OPT PROF_winservicePassword= 
-OPT PROF_winserviceStartupType=
-OPT PROF_winserviceUserName=

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=

Options for creating a custom profile

-OPT allowNonRootSilentInstall="false"
-OPT feature="samplesSelected"
-OPT installLocation="/opt/IBM/WebSphere/AppServer"
-OPT createProfile="true"
-OPT profileType="custom"
-OPT silentInstallLicenseAcceptance="true"
-OPT traceFormat=ALL
-OPT traceLevel=INFO
-OPT PROF_cellName=
-OPT PROF_dmgrAdminPassword=
-OPT PROF_dmgrAdminUserName=
-OPT PROF_dmgrHost=
-OPT PROF_dmgrPort=
-OPT PROF_enableAdminSecurity="false"
-OPT PROF_hostName=
-OPT PROF_isDefault=
-OPT PROF_nodeName=
-OPT PROF_omitAction=
-OPT PROF_profileName=
-OPT PROF_profilePath=
-OPT PROF_serverName=

Option descriptions




Reference topic    

Terms of Use | Feedback

Last updated: Sep 20, 2010 11:08:29 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=vela&product=was-nd-mp&topic=rins_responsefile_nd61_cip
File name: rins_responsefile_nd61_cip.html