WebSphere WebSphere Enterprise Service Bus, Version 6.0.1 Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

Creating a deployment manager profile silently

The responsefile.pcaw.esb.dmgrProfile.txt file is a sample response file for creating a deployment manager profile during the silent installation of WebSphere ESB.

Create a deployment manager profile with an options response file after logging on as root on a Linux® or UNIX® platform, or as a user that belongs to the administrator group on a Windows® platform. Some steps of the installation procedure on a Windows platform require the user to belong to the administrator group and to have the advanced user rights Act as part of the operating system and Log on as a service.

The installation program reads this file to determine the characteristics of a deployment manager profile when you install silently. You can also create additional deployment manager profiles by using this response file after initial installation. The response file is shipped with default values.

Avoiding the use of the -silent option within the options response file

A problem occurs when the -silent option exists in the file. The file works with the option during a direct call to the profile creation wizard, but fails when called from a silent product installation. See Customizing the options response file for information about creating a profile silently during a silent product installation.

The option is unnecessary. Avoid using the option to avoid problems.

Response file locations

The example options response files are in two locations.

Example files:
  • responsefile.pcaw.esb.dmgrProfile.txt
  • responsefile.pcaw.esb.managedProfile.txt
  • responsefile.pcaw.esb.standAloneProfile.txt

Location:

Table 1. Option response file locations
Product disc location Installed location
/ESB directory install_root/bin/ProfileCreator directory

Use the file on the product disc to install WebSphere ESB silently and create a profile.

After installing WebSphere ESB, you can use the installed response file with the -options parameter on the Profile creation wizard command.

Required disk space

Profile Required disk space Required temp space
Deployment manager profile 30 MB 40 MB
Custom profile 10 MB 40 MB
Application server profile 200 MB 40 MB

Creating an operational environment during product installation

Installation of WebSphere ESB is a two-step process:
  1. Installing the core product files and feature files.
  2. Creating a deployment manager profile, a custom profile, or an application server profile.

The sample options response file, responsefile.esb.txt, controls the first part of the installation and can also start the second part of the installation. To create a profile as part of installing the core product files, use the option in the responsefile.esb.txt file that identifies the response file for creating a profile. The profile response file lets you use the Profile creation wizard silently.

To edit and use the appropriate response file for creating a profile, perform the following procedure:
  1. Copy the appropriate file from the ESB directory on the product disc to a place that you can easily identify on your machine. The example files are:
    To create a: Copy the following response file:
    Deployment manager profile responsefile.pcaw.esb.dmgrProfile.txt
    Custom profile responsefile.pcaw.esb.managedProfile.txt
    Application server profile responsefile.pcaw.esb.standAloneProfile.txt
  2. Edit the file to customize the values for your installation.
  3. Verify that no -silent option exists in the response file for the Profile creation wizard. If the option exists, the profile is not created.
  4. Save the file.
  5. Edit the responsefile.esb.txt file to identify the location and name of the profile response file. Change the value of the -W pcawresponsefilelocationqueryactionInstallWizardBean.fileLocation option to identify the file. For example:
    -W pcawresponsefilelocationqueryactionInstallWizardBean.fileLocation=
    "/opt/IBM/WebSphere/MyOptionFiles/customProfile.txt"
  6. Start the installation. For example:
    install -options "myresponsefile.txt" -silent
  7. After the installation, examine the logs for success.

Creating a profile after installation

Installation of WebSphere ESB product is a two-step process:
  1. Installing the core product files and feature files
  2. Creating a deployment manager profile, a custom profile, or an stand-alone server profile

When the core product files exist, create a profile at any time using the Profile creation wizard. Start the wizard from the First steps console or directly using the Profile creation wizard command.

You can also use one of the following sample options response files for profiles to create a profile silently using the Profile creation wizard in silent mode. To edit and use the appropriate response file for creating a profile, perform the following procedure:
  1. Copy the appropriate file from the install_root/bin/ProfileCreator directory to a place that you can easily identify on your machine. The example files are:
    To create a profile for a: Copy the following response file:
    Deployment manager responsefile.pcaw.esb.dmgrProfile.txt
    Managed node responsefile.pcaw.esb.managedProfile.txt
    Stand-alone application server responsefile.pcaw.esb.standAloneProfile.txt

    For example, copy the file as my_options_file.txt

  2. Edit the file to customize the values for your installation.
  3. Save the file.
  4. Start the installation.
    For example:
    • For AIX platforms ./pcatAIX.bin -options my_options_file.txt -silent
    • ./pcatHPUX.bin -options my_options_file.txt -silent
    • LINUX platforms ./pcatLinux.bin -options my_options_file.txt -silent
    • LINUX platforms Power platforms: ./pcatLinuxPPC.bin -options my_options_file.txt -silent
    • Solaris platforms ./pcatSolaris.bin -options my_options_file.txt -silent
    • For Windows platforms pcatWindows.exe -options my_options_file.txt -silent
  5. After using the Profile creation wizard, examine the logs for success.

Logging

The following log files record information about profile creation:
  • The install_root/logs/log.txt file records installation status.
  • The install_rootprofiles/profile_name/logs/pctLog.txt file records installation events that occur when creating profiles with the Profile creation wizard.
  • The install_root/logs/wasprofile/wasprofile_create_profile_name.log file records installation events that occur when creating profiles.
  • The install_root/logs/wasprofile/wasprofile_delete_profile_name.log file records installation events that occur when deleting profiles.

Naming considerations

Refer to Naming considerations for profiles, nodes, hosts, and cells for information about naming considerations.

Example responsefile.pcaw.esb.dmgrProfile.txt file


################################################################################
#
# Response file for Websphere ESB dmgr profile creation
#
# This options file is located in the CD_ROOT\ESB\ directory and in the 
# install_root\bin\ProfileCreator_wbi directory. 
#
# To use the options file under CD_ROOT\ESB\ directory, follow the instructions 
# in CD_ROOT\ESB\responsefile.esb.txt. The WebSphere ESB
# installer locates this file during silent installation
# and automatically runs the silent profile creation at the end of installation.
# 
# To use the options file under install_root\bin\ProfileCreator_wbi for silent profile
# creation, you must change various values in the file and use the following  
# command line arguments:
# 
#    -options "responsefile.pcaw.esb.dmgrProfile.txt" -silent
#
################################################################################


################################################################################
# 
# Profile name
#
# Set the profile name for installing a deployment manager profile. The profile 
# name must be unique for this WebSphere ESB installation.  
#
-W profilenamepanelInstallWizardBean.profileName="profileDmgr"

################################################################################
# If you want to set this profile to be your default profile, set to "true".
# Otherwise set to "false". If this is the first profile being created, the profile  
# automatically is the default. 
#
-W profilenamepanelInstallWizardBean.isDefault="false"


################################################################################
# 
# Profile location
#
# Specify a directory to contain the files that define the run-time environment, 
# such as commands,configuration files, and log files. If the specified directory
# already exists it must be empty. 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.
#
# Default Install Location:
#
#    -P installLocation="<ESB_HOME>\profiles\<PROFILE_NAME>"
#
-P installLocation="C:\Program Files\IBM\WebSphere\ESB\profiles\profileDmgr"


################################################################################
# 
# 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
#
# Specify the cell name for the Application Server. 
#
# Replace YOUR_CELL_NAME with the actual cell name. 
#
-W nodehostandcellnamepanelInstallWizardBean.cellName="YOUR_CELL_NAME"


################################################################################
# 
# 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.
# Port nubmers for each profile can be found in: 
# <profile>/config/cells/<cell name>/nodes/<node name>/serverindex.xml
#
-W pctdmgrprofileportspanelInstallWizardBean.WC_adminhost="9060"
-W pctdmgrprofileportspanelInstallWizardBean.WC_adminhost_secure="9043"
-W pctdmgrprofileportspanelInstallWizardBean.BOOTSTRAP_ADDRESS="9809"
-W pctdmgrprofileportspanelInstallWizardBean.SOAP_CONNECTOR_ADDRESS="8879"
-W pctdmgrprofileportspanelInstallWizardBean.SAS_SSL_SERVERAUTH_LISTENER_ADDRESS="9404"
-W pctdmgrprofileportspanelInstallWizardBean.CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS="9406"
-W pctdmgrprofileportspanelInstallWizardBean.CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS="9405"
-W pctdmgrprofileportspanelInstallWizardBean.ORB_LISTENER_ADDRESS="9101"
-W pctdmgrprofileportspanelInstallWizardBean.CELL_DISCOVERY_ADDRESS="7277"
-W pctdmgrprofileportspanelInstallWizardBean.DCS_UNICAST_ADDRESS="9352"


################################################################################
# 
# Windows service
#
# The following directives are to install services for WebSphere Application Server 
# on Windows.  
# Using Services, you can start and stop services, 
# and configure startup and recovery actions. 
# Set winServiceQuery="false" will turn off the function on windows system.
# You can ignore these or comment them out for other Operating Systems.
#
-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"

################################################################################
# If you chose to install a service above with the accountType="localsystem",
# the userName and password below can be ignored. If the accountType was set to:
# accountType="specifieduser", then you must specify the User Name and Password 
# which are required to install the Services. The current user must be admin or must 
# have admin authority to install a Service. Also the username
# which is given here must have "Log On as a Service " authority 
# for the service to run properly.
#
# Replace YOUR_USER_NAME with your username.
#
-W winservicepanelInstallWizardBean.userName="YOUR_USER_NAME"

################################################################################
# Replace YOUR_PASSWORD with your valid password.
#
-W winservicepanelInstallWizardBean.password="YOUR_PASSWORD"

################################################################################
# Set the startup type of the WebSphere ESB on Windows.
# Valid values are "automatic", "manual", and "disabled".
#
-W winservicepanelInstallWizardBean.startupType="manual"


################################################################################
#
# Service Component Architecture Configuration
#
# The following entries are used to create a Service Component Architecture
# configuration.  Set doConfigureSCACheckList="true" if you want
# to configure a Service Component Architecture.  If you do not want a 
# Service Component Architecture leave the value as "".  
# If you set the value to "true" then the rest of the parameters must also be filled 
# out.
#
-W wbiSCAConfigInputPanelBeanId.doConfigureSCACheckList=""


################################################################################
# If you chose to create a Service Component Architecture configuration above
# then specify the userid for that configuration.  If not then comment out
# this line.
#
-W wbiSCAConfigInputPanelBeanId.userId="YOUR_USER_ID_SCA"


################################################################################
# If you chose to create a Service Component Architecture configuration above
# then specify the password for that configuration and confirm that password. 
# If not then comment out these lines.
#
-W wbiSCAConfigInputPanelBeanId.password="YOUR_PASSWORD_SCA"
-W wbiSCAConfigInputPanelBeanId.passwordConfirmation="YOUR_PASSWORD_SCA"

################################################################################
# Profile type
#
# Must be set to  "dmgr" for installing a deployment manager Profile.
# Do not change this!
#
-W profiletypepanelInstallWizardBean.selection="dmgr"

Related tasks
Customizing the options response file

Reference topic

Terms of Use | Rate this page

Timestamp iconLast updated: 13 Dec 2005
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/index.jsp?topic=/com.ibm.websphere.wesb.doc\tasks\twesb_silent_dmgr.html

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