Sample response file: Modify IBM WebSphere Application Server Liberty Core

We can edit and use this example of a response file for modifying IBM WebSphere Application Server Liberty Core.

<?xml version="1.0" encoding="UTF-8"?>

<!-- ##### Copyright ######################################################
# Licensed Materials - Property of IBM (c) Copyright IBM Corp. 2013. 
# All Rights Reserved. US Government Users Restricted Rights-Use, duplication 
# or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
####################################################################### -->

<!-- ##### Frequently Asked Questions #####################################
# The latest information about using Installation Manager is 
# located in the online Information Center. There we can find 
# information about the commands and attributes used in 
# silent installation response files.
# 
#     Installation Manager Information Center can be found at:
#     http://publib.boulder.ibm.com/infocenter/install/v1r6/index.jsp
# 
# Question 1. How do I record a response file using Installation Manager?
# Answer 1. Start Installation Manager from the command line under the 
# eclipse subdirectory with the record parameter and it will generate a  
# response file containing actions it performed, repositories it used, and   
# its preferences settings. Optionally use the -skipInstall parameter if 
# we do not want the product to be installed to the machine. Specify a  
# new agentDataLocation location value when doing a new installation. Do  
# not use an existing agentDataLocation for an installation because it might  
# damage the installation data and prevent you from modifying, updating,  
# rolling back, or uninstalling the installed packages.
#
# Windows: IBMIM -record <responseFile> -skipInstall <agentDataLocation>
# Linux or UNIX: ./IBMIM -record <responseFile> -skipInstall <agentDataLocation>
# 
# For example:
#   Windows = IBMIM.exe -record c:\temp\responsefiles\WASv85.install.Win32.xml
#     -skipInstall c:\temp\skipInstall\WebSphere_Temp_Registry
#   Linux or UNIX = ./IBMIM -record /home/user/responsefiles/WASv85.install.RHEL64.xml
#     -skipInstall c:\temp\skipInstall\WebSphere_Temp_Registry
# 
# Question 2. How do I run Installation Manager silently using response file?
# Answer 2. Create a silent installation response file, and run the following command 
# from the eclipse\tools subdirectory in the directory where you installed 
# Installation Manager:
#
#   Windows = imcl.exe -acceptLicense -showProgress 
#     input <response_file_path_and_name> -log <log_file_path_and_name> 
#   Linux, UNIX, IBM i and z/OS = ./imcl -acceptLicense -showProgress  
#     input <response_file_path_and_name> -log <log_file_path_and_name> 
# 
# For example: 
#   Windows = imcl.exe -acceptLicense -showProgress
#     input c:\temp\responsefile\WASv85.install.Win32.xml 
#   Linux, UNIX, IBM i and z/OS = ./imcl -acceptLicense -showProgress
#     input /home/user/responsefile/WASv85.install.RHEL64.xml
# 
# The -acceptLicense command must be included to indicate acceptance of all
#     license agreements of all offerings being installed, updated or modified.
# The -showProgress command shows progress when running in silent mode.
# Additional commands can be displayed by requesting help:  IBMIM -help
#
# Question 3. How do I store and pass credentials to repositories that 
# require authentication?
# Answer 3.  There are two methods for storing authentication credentials 
# for Installation Manager depending on the version being used, 
# either key ring files or storage files.
#
# Versions of Installation Manger before 1.6.2 use a key ring file to store 
# encrypted credentials for authenticating with repositories. Follow this 
# two-step process for creating and using a key ring file with Installation Manager.
# 
# First, create a key ring file with the credentials by starting 
# Installation Manager from the command line under eclipse subdirectory 
# with the keyring parameter.
# Use the optional password parameter to password protect the file.
# 
#   Windows = IBMIM.exe -keyring <path and file name> -password <password>
#   Linux, UNIX, IBM i and z/OS = ./IBMIM -keyring <path and file name> 
#                                 -password <password>
# 
# Installation Manager will start in graphical mode. Verify that the 
# repositories to which we need to authenticate are included in the 
# preferences, File / Preferences / Repositories. If they are not 
# listed, then click Add Repositories to add the URL or UNC path.
# Installation Manager will prompt for the credentials. If the repository 
# is already in the list, then any attempt to access the repository location, 
# such as clicking the Test Connections button, will also prompt for our # credentials. Enter the correct credential and check the Save password 
# checkbox. The credentials are saved to the key ring file you specified. 
# 
# Second, when you start a silent installation, run imcl under eclipse/tools
# subdirectory, and provide Installation Manager with the location of the key 
# ring file and the password if the file is protected. For example:
#
#   Windows = imcl.exe -acceptLicense -showProgress
#     input <path and file name of response file>
#     -keyring <path and name of key ring file> -password <password>
#   Linux, UNIX, IBM i and z/OS = ./imcl -acceptLicense -showProgress
#     input <path and file name of response file> 
#     -keyring <path and name of key ring file> -password <password>
#
# Versions of Installation Manager at 1.6.2 or higher use storage files 
# to store encrypted credentials. Complete the following steps to create 
# master password and storage files to use with Installation Manager.
#
# First, if we do not have a master password file already, create a text file 
# containing a master passphrase. An example of a passphrase is:
#   "This text is the passphrase for a master password file."
#
# Next, run imutilsc under the eclipse/tools subdirectory with the following 
# options to create and store user credentials in a storage file.
#   -secureStorageFile <path and file name of storage file>
#   -masterPasswordFile <path and file name of master password file>
#   -url <repository address> or -passportAdvantage <PPA repository address>
#   -userName <user name> 
#   -userPassword <password for user>
#
#  Example of a command to create a storage file by operating system #  Windows = imutilsc saveCredential -url http://myServer -userName myUserName 
#     -userPassword myPassword -secureStorageFile C:\IBM\credential.store 
#     -masterPasswordFile C:\IBM\master_password_file.txt
#  Linux, UNIX, IBM z/OS, and the OS X operating system = 
#    ./imutilsc saveCredential -url http://myServer -userName myUserName 
#    -userPassword myPassword -secureStorageFile /home/IBM/credential.store 
#    -masterPasswordFile /home/user/IBM/master_password_file.txt
#
# Usage hints:
#    * Do not use both the -url and -passportAdvantage options in the same command.
#    * Enclose file paths that include spaces with double quotation marks.
#    * If we use the IBM service repositories, we can specify the value:
#        http://www.ibm.com/software/repositorymanager/entitled/repository.xml   
#      for the -url option which is a generic service repository for IBM packages.
#    * Repeat steps to store credentials for multiple users in one file.
#    * Repeat steps to store credentials for multiple repositories in one file.
#
# Afterwards, when you start a silent installation, run imcl under the eclipse/tools
# subdirectory, and provide Installation Manager with the location of the storage 
# file. For example:
#
#   Windows = imcl.exe -acceptLicense -showProgress
#     input <path and file name of response file>
#     -secureStorageFile <path and name of storage file> 
#     -masterPasswordFile <path and name of master password file>
#   Linux, UNIX, IBM i and z/OS = ./imcl -acceptLicense -showProgress
#     input <path and file name of response file> 
#     -secureStorageFile <path and name of storage file> 
#     -masterPasswordFile <path and name of master password file>
#
####################################################################### -->

<!-- ##### Agent Input ##############################################
#
# The clean and temporary attributes specify the repositories and other
# preferences Installation Manager uses and whether those settings
# should persist after the installation finishes.
# 
# Valid values for clean:
#      true = only use the repositories and other preferences that are 
#           specified in the response file.
#      false = use the repositories and other preferences that are 
#           specified in the response file and Installation Manager.
# 
# Valid values for temporary:
#      true = repositories and other preferences specified in the 
#           response file do not persist in Installation Manager.
#      false = repositories and other preferences specified in the 
#           response file persist in Installation Manager.
# 
####################################################################### -->

<agent-input clean="true" temporary="true">

<!-- ##### Repositories ###################################################
# Repositories are locations that Installation Manager queries for 
# installable packages. Repositories can be local (on the machine
# with Installation Manager) or remote (on a corporate intranet or 
# hosted elsewhere on the internet). 
# 
# If the machine using this response file has access to the internet, 
# then include the IBM WebSphere Live Update Repositories in the list 
# of repository locations. 
# 
# If the machine using this response file cannot access the internet, 
# then comment out the IBM WebSphere Live Update Repositories and 
# specify the URL or UNC path to custom intranet repositories and 
# directory paths to local repositories to use.
# 
####################################################################### -->

<server>
    <!-- ##### IBM WebSphere Live Update Repositories ####################
     # These repositories contain WebSphere Application Server Liberty offerings, 
     # and updates for those offerings
     # 
     # To use the secure repository (https), have an IBM ID, 
     # which can be obtained by registering at: http://www.ibm.com/account
     # or the Passport Advantage account.  
     # 
     # And, use a key ring file with the response file.
     ################################################################## -->
<repository location="http://www.ibm.com/software/repositorymanager/com.ibm.websphere.liberty.v85"/>
    <!-- <repository location="https://www.ibm.com/software/rational/repositorymanager/repositories/websphere" /> -->

    <!-- ##### Custom Repositories #######################################
     # Uncomment and update the repository location key below 
     # to specify URLs or UNC paths to any intranet repositories 
     # and directory paths to local repositories to use.
     ################################################################## -->
    <!-- <repository location='https:\\w3.mycompany.com\repositories\'/> -->
    <!-- <repository location='/home/user/repositories/websphere/'/> -->

    <!-- ##### Local Repositories ########################################
     # Uncomment and update the following line when using a local      # repository located on our own machine to install a 
     # WebSphere Application Server Liberty offering.
     ############################################################# -->
    <!-- <repository location='insert the full directory path inside single quotes'/> -->
</server>

<!-- ##### Modify Packages ###############################################
#
# Install and Uninstall Commands
#
# Use the install and uninstall commands to inform Installation Manager 
# of the installation packages to install or uninstall. 
# 
# The modify attribute is optional and can be paired with an install 
# command to add features or paired with an uninstall command to 
# remove commands. If omitted, the default value is set to false.
#    false = indicates not to modify an existing install by adding 
#            or removing features.
#    true = indicates to modify an existing install by adding or 
#           removing features.
# 
# The offering ID attribute is required because it specifies the 
# offering to be installed. The offering listed must be present in 
# at least one of the repositories listed earlier. The example 
# command below contains the offering ID for the Core 
# edition of WAS Liberty. 
# 
# The version attribute is optional. If a version number is provided, 
# then the offering will be installed or uninstalled at the version level 
# specified as long as it is available in the repositories. If the version 
# attribute is not provided, then the default behavior is to install or # uninstall the latest version available in the repositories. The version 
# number can be found in the repository.xml file in the repositories.
# For example, <offering ... version='8.5.5000.20130328_1111'>.
# 
# The profile attribute is required and typically is unique to the 
# offering. If modifying or updating an existing installation, the 
# profile attribute must match the profile ID of the targeted installation 
# of WAS Liberty.
# 
# The features attribute is optional. Offerings always have at least
# one feature; a required core feature which is installed regardless 
# of whether it is explicitly specified. If other feature names 
# are provided, then only those features will be installed. 
# Features must be comma delimited without spaces.
# 
# The feature values for WebSphere Application Server Liberty include:
# liberty,embeddablecontainer
#
# The features embeddablecontainer is a subfeature of liberty.
# 
# We can use these functions to add or remove feature embeddablecontainer 
# later.
#
# In the example that follows, the feature embeddablecontainer is 
# being added and no feature are being removed from the specified offering.
# 
# The installFixes attribute indicates whether fixes available in 
# repositories are installed with the product. By default, all 
# available fixes will be installed with the offering.
# 
# Valid values for installFixes:
#      none = do not instavailable fixes with the offering.
#      recommended = installs available recommended fixes with the offering.
#      all = installs available fixes with the offering.
# 
# Installation Manager supports modifying multiple offerings at once.
# Additional offerings can be included in the install and uninstall commands, 
# with each offering requiring its own offering ID, version, profile value, 
# and feature values.
# 
# Profile Command
# 
# A separate profile command must be included for each offering listed 
# in the install command. The profile command informs Installation # Manager about offering specific properties or configuration values.
# 
# The installLocation specifies where the offering will be installed.
# If the response file is used to modify or update an existing 
# installation, then ensure the installLocation points to the 
# location where the offering was installed previously. 
# 
# The eclipseLocation data key should use the same directory path to 
# WebSphere Application Server Liberty as the installationLocation attribute.
# 
# Include data keys for product specific profile properties. 
# For instance, Installing WebSphere Application Server Liberty Offerings on 
# a 64-bit system will require to include one of the options for an IBM Software 
# Development Kit, this can be specified by data key cic.selector.arch, its value 
# can be either x86 (for 32-bit), or x86_64 (for 64-bit).
# 
# More details for cic.selector.arch can be found in the link below:
#
# https://infocenters.hursley.ibm.com/was/vNext/draft/help/index.jsp?topic=%2Fcom.ibm.websphere.wlp.core.doc%2Fae%2Ftwlp_ins_installation_dist_silent.html
# 
####################################################################### -->

<install modify="true">
<offering id="com.ibm.websphere.liberty.v85" profile="WebSphere Liberty V8.5" features="embeddablecontainer" /> 
</install>
<profile id="WebSphere Liberty V8.5" installLocation="C:\Program Files\IBM\WebSphere\Liberty">
<data key="eclipseLocation" value="C:\Program Files\IBM\WebSphere\Liberty" /> 
<data key="cic.selector.arch" value="x86_64" /> 
</profile>

<!-- ##### Shared Data Location ###########################################
# Uncomment the preference for eclipseCache to set the shared data 
# location the first time we use Installation Manager to do an 
# installation.
# 
# Eclipse cache location can be obtained from the installed.xml file found in 
# Linux/Unix: /var/ibm/InstallationManager
# Windows: C:\Documents and Settings\All Users\Application Data\IBM\Installation Manager # from the following property:  
# <property name='cacheLocation' value='C:\Program Files\IBM\IMShared'/>
#
# Open the installed.xml file in a text editor because the style sheet 
# might hide this value if opened in a web browser.
# For further information on how to edit preferences, refer to the public library at:
# http://publib.boulder.ibm.com/infocenter/install/v1r5/index.jsp?topic=/com.ibm.silentinstall12.doc/topics/r_silent_prefs.html
#
# After the shared data location is set, it cannot be changed
# using a response file or the graphical wizard.
# 
# Ensure that the shared data location is a location that can be written 
# to by all user accounts that are expected to use Installation Manager.
#
# By default, Installation Manager saves downloaded artifacts to 
# the shared data location. This serves two purposes. 
# 
# First, if the same product is installed a more than once to the machine, 
# then the files in the shared data location will be used rather than 
# downloading them again. 
#
# Second, during the rollback process, the saved artifacts are used. 
# Otherwise, if the artifacts are not saved or are removed, then 
# Installation Manager must have to access the repositories used to 
# install the previous versions.
# 
# Valid values for preserveDownloadedArtifacts:
#     true = store downloaded artifacts in the shared data location
#     false = remove downloaded artifacts from the shared data location
# 
####################################################################### -->

<!-- 
<preference name='com.ibm.cic.common.core.preferences.eclipseCache' value='C:\Program Files\IBM\IMShared'/> 
<preference name='com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts' value='true'/>
-->

<!-- ##### Preferences Settings ###########################################
# Additional preferences for Installation Manager can be specified. 
# These preference correspond to those that are located in the graphical
# interface under File / Preferences. 
# 
# If a preference command is omitted from or commented out of the response 
# file, then Installation Manager uses the preference value that was 
# previously set or the default value for the preference. 
# 
# Preference settings might be added or deprecated in new versions of # Installation Manager. Consult the online Installation Manager # Information Center for the latest set of preferences and 
# descriptions about how to use them.
#
# http://publib.boulder.ibm.com/infocenter/install/v1r6/index.jsp
# 
####################################################################### -->

<!--
<preference name='com.ibm.cic.common.core.preferences.connectTimeout' value='30'/>
<preference name='com.ibm.cic.common.core.preferences.readTimeout' value='45'/>
<preference name='com.ibm.cic.common.core.preferences.downloadAutoRetryCount' value='0'/>
<preference name='offering.service.repositories.areUsed' value='true'/>
<preference name='com.ibm.cic.common.core.preferences.ssl.nonsecureMode' value='false'/>
<preference name='com.ibm.cic.common.core.preferences.http.disablePreemptiveAuthentication' value='false'/>
<preference name='http.ntlm.auth.kind' value='NTLM'/>
<preference name='http.ntlm.auth.enableIntegrated.win32' value='true'/>
<preference name='com.ibm.cic.common.core.preferences.keepFetchedFiles' value='false'/>
<preference name='PassportAdvantageIsEnabled' value='false'/>
<preference name='com.ibm.cic.common.core.preferences.searchForUpdates' value='false'/>
<preference name='com.ibm.cic.agent.ui.displayInternalVersion' value='false'/>
 --> 

</agent-input>

Parent topic: Use the sample response files

---

Terms and conditions for information centers