Use IBM® Installation
Manager from the command line to install Websphere Load Balancer for IPv4 and IPv6 silently.
About this task
With IBM Installation
Manager, you can work with response files to install the product silently
in a variety of ways. You can:
- Generate a new response file by hand or by taking an example and
modifying it.
- Record a response file using the GUI as described in the following
procedure.
Procedure
- Optional: Record a response file to install
the product.
On one of your systems, perform the following
actions to record a response file that will install the product.
- From a command line, navigate to the directory in which
you installed Installation Manager, and then change directories to
the eclipse subdirectory.
- Start Installation Manager from the command line with
the -record option.
For example, run the following
command as an administrator:
![[AIX]](../lb/images/aixlogo.gif)
![[HP-UX]](../lb/images/hpux.gif)
![[Linux]](../lb/images/linux.gif)
./IBMIM -skipInstall /var/temp/imRegistry -record /var/temp/install_response_file.xml
IBMIM.exe -skipInstall "C:\temp\imRegistry" -record C:\temp\install_response_file.xml
Best practice: When you record a new response file, specify the
-skipInstall parameter. This parameter streamlines the installation
process.
- No files are actually installed, which speeds up the recording.
- If you use a temporary data location with the -skipInstall parameter,
Installation Manager writes the installation registry to the specified
data location while recording. When you start Installation Manager
again without the -skipInstall parameter, you then can use your response
file to install the files to the real installation registry.
The -skipInstall operation should not be used on the actual agent
data location that Installation Manager will use. Use a clean, writable
location, and reuse that location for future recording sessions.
bprac
For more information on recording a response file, read the
topic on recording a response file with Installation Manager in the
Installation Manager information center.
- Add the appropriate repositories to your preferences.
- In the menu, click .
- Select Repositories.
- Click Add Repository.
- Enter the path to the repository.config file
in the remote web-based repository or the local directory into which
you unpacked the repository files.
- Click OK.
- Click Apply.
- Click OK.
- Click Install. If
you are prompted to authenticate, use the IBM ID and password that you registered with
on the program's web site.
Installation
Manager will search the defined repositories for available packages.
- Select IBM Websphere Edge Components: Load Balancer for IPv4 and IPv6 and
the most recent version number.
Avoid trouble: If
you already installed the product using Installation Manager, Installation
Manager displays a message that you are not allowed to install more
than one instance in a system. You cannot collocate two versions of
Load Balancer.
gotcha
- Click Next.
Avoid trouble: If you installed a previous version of the product
using installers other than Installation Manager, Installation Manager
will detect it and prompt you to uninstall that version product and
then proceed with the installation. Uninstall the older version of
the product, and proceed with the installation using Installation
Manager. Refer to
Uninstalling Load Balancer if it was installed without Installation Manager.
gotcha
- Accept the terms in the license agreements, and click Next.
- Review the installation location. The Installation
Location panel will appear. This panel also displays the shared resources
directory and disk-space information.
- Click Next.
- Select the languages for which translated content should
be installed, and click Next.
English
is always selected.
- Select any features that you want to install, and click Next.
Choose from the following optional features:
- Dispatcher
- The Dispatcher component performs load balancing for servers within
a local area network (LAN) or wide area network (WAN) for all Internet
services, such as HTTP, FTP, HTTPS, and Telnet. For HTTP services,
Dispatcher can perform load balancing of servers based on the URL
content of the client request.
- Metric Server
- The Metric Server component runs as a daemon on a load-balanced
server. Metric Server:
- Provides information about system loads to the Load Balancer components
- Reports on the health of the servers
Content Based Routing
- Content Based Routing proxies requests to specific servers depending
on the content of the request for HTTP and SSL traffic.
Site Selector
- Site Selector works with a name server to load balance among a
group of servers.
Tip: You can run the Installation Manager
later to modify this installation and add or remove features.
![[AIX]](../lb/images/aixlogo.gif)
![[Linux]](../lb/images/linux.gif)
![[Solaris]](../lb/images/solaris.gif)
If you are using
a 64-bit operating system that has a corresponding 32-bit image for
the product, choose to install the 32-bit version of the application
server or the 64-bit version, and click Next. This panel displays only if you are using a 64-bit operating
system.
- Review the summary information, and click Install. Review the results:
- If the installation is successful, the program will display a
message indicating that the installation is successful. The program
might also display important post-installation instructions.
- If the installation is not successful, click View Log
File to troubleshoot the problem.
- Click Finish.
- Close Installation Manager.
Click .
- Optional: If you are using an authenticated
remote repository, create a keyring file for silent installation.
- From a command line, navigate to the eclipse subdirectory in the
directory in which you installed Installation Manager.
- Start Installation Manager from the command line with the -record
option. For example, run the following command as an administrator:
![[AIX]](../lb/images/aixlogo.gif)
![[HP-UX]](../lb/images/hpux.gif)
![[Linux]](../lb/images/linux.gif)
./IBMIM -skipInstall /var/temp/imRegistry -keyring /var/IM/im.keyring
-password password
-record /var/temp/keyring_response_file.xml
IBMIM.exe -skipInstall "C:\temp\imRegistry" -keyring C:\IM\im.keyring
-password password
-record C:\temp\keyring_response_file.xml
- When you are prompted for your credentials for the authenticated
remote repository, enter the correct credentials, and save them.
- Close Installation Manager. Click . For more information on
keyring files, read the topic on silently installing from authenticated
repositories with Installation Manager in the Installation Manager
information center.
- Use the response files to install the product silently.
- Use the response file to install the product silently.
From the command line, on each of the systems on which you
want to install the product, change to the eclipse subdirectory in
the directory in which you installed Installation Manager, and install
the product silently.
For example, enter the following
command as an administrator:![[AIX]](../lb/images/aixlogo.gif)
![[HP-UX]](../lb/images/hpux.gif)
![[Linux]](../lb/images/linux.gif)
./IBMIM --launcher.ini silent-install.ini -input /var/temp/install_response_file.xml
-log /var/temp/install_log.xml
IBMIMc.exe --launcher.ini silent-install.ini -input C:\temp\install_response_file.xml
-log C:\temp\install_log.xml
Avoid trouble: The program might write important post-installation
instructions to standard output. Read the topic on silently installing
packages using Installation Manager in the Installation Manager information
center for more information.
gotcha
- Optional: Use the response file to install
the keyring silently.
From the command line, for each
of the systems on which you want to install the product, change to
the eclipse subdirectory in the directory in which you installed Installation
Manager, and install the keyring silently.
For
example, enter the following command as an administrator:![[AIX]](../lb/images/aixlogo.gif)
![[HP-UX]](../lb/images/hpux.gif)
![[Linux]](../lb/images/linux.gif)
./IBMIM --launcher.ini silent-install.ini -input /var/temp/install_response_file.xml
-log /var/temp/install_log.xml
-keyring /var/IM/im.keyring -password password
IBMIMc.exe --launcher.ini silent-install.ini -input C:\temp\install_response_file.xml
-log C:\temp\install_log.xml
-keyring C:\IM\im.keyring -password password
Example
The following is an example of a response
file for silently installing the product. This installation includes
all the features into the
C:\Program Files\IBM\edge\ulb directory
and uses a local repository that is located in the
C:\repositories\edge85\local-repositories directory.
<?xml version="1.0" encoding="UTF-8"?>
<agent-input acceptLicense='true'>
<server>
<repository location='C:\repositories\edge85\local-repositories'/>
</server>
<profile id='Load Balancer for IPV6 v8.5'
installLocation='C:\Program Files\IBM\WebSphere\edge\ulb'>
<data key='eclipseLocation' value='C:\Program Files\IBM\WebSphere\edge\ulb'/>
<data key='user.import.profile' value='false'/>
<data key='cic.selector.nl' value='cs,ja,es,zh_HK,en,zh_TW,pt_BR,it'/>
</profile>
<install modify='false'>
<offering id='com.ibm.websphere.EDGELBIPV4IPV6.v85' version='8.5.0.0'
profile='IBM WebSphere Edge Components: Load Balancer for IPV4 and IPV6 V8.5'
features='Dispatcher,Load Balancer,Metric Server,Content Based Routing,Site Selector'/>
</install>
<preference name='com.ibm.cic.common.core.preferences.eclipseCache'
value='C:\Program Files\IBM\IMShared'/>
<preference value='30' name='com.ibm.cic.common.core.preferences.connectTimeout'/>
<preference value='30' name='com.ibm.cic.common.core.preferences.readTimeout'/>
<preference value='0'
name='com.ibm.cic.common.core.preferences.downloadAutoRetryCount'/>
<preference value='false' name='offering.service.repositories.areUsed'/>
<preference value='false' name='com.ibm.cic.common.core.preferences.ssl.nonsecureMode'/>
<preference value='false'
name='com.ibm.cic.common.core.preferences.http.disablePreemptiveAuthentication'/>
<preference value='true'
name='com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts'/>
<preference value='false' name='PassportAdvantageIsEnabled'/>
<preference value='false'
name='com.ibm.cic.common.core.preferences.searchForUpdates'/>
</agent-input>
Tip: To disable remote searches
for updates in the response file, set the following preferences to
false:
- offering.service.repositories.areUsed
- Used for searching remote repositories for updates to installed
offerings
- com.ibm.cic.common.core.preferences.searchForUpdates
- Used for searching for updates to Installation Manager
For example, change the response file to read:
<preference value='false' name='offering.service.repositories.areUsed'/>
<preference value='false' name='com.ibm.cic.common.core.preferences.searchForUpdates'/>
You
can find more details on silent preference keys in the information
center for IBM Installation
Manager. Here are some examples of changes that you could make to
manipulate this response file to perform alternative actions:
- Alter the location of the local repository by updating the repository
location with the desired path. For example, replace the following
line:
<repository location='C:\repositories\edge85\local-repositories'/>
with
this:<repository location='/usr/edge85/local-repositories'/>
- Install from the live remote repository instead of a local repository
by replacing the repository location. For example, replace the following
line:
<repository location='C:\repositories\edge85\local-repositories'/>
with
this:<repository location='http://www.ibm.com/software/repositorymanager/com.ibm.websphere.EDGELBIPV4IPV6.v85'/>
- Remove optional features by removing the entry for each desired
feature in the offering from the comma-separated list. For example,
to install without an optional feature, replace the following line:
<offering id='com.ibm.websphere.EDGELBIPV4IPV6.v85'
version='8.5.0.0'
profile='IBM WebSphere Edge Components: Load Balancer for IPV4 and IPV6 V8.5'
features='Dispatcher,Load Balancer,Metric Server,Content Based Routing,Site Selector'/>
with
this:<offering id='com.ibm.websphere.EDGELBIPV4IPV6.v85'
version='8.5.0.0'
profile='IBM WebSphere Edge Components: Load Balancer for IPV4 and IPV6 V8.5'
features='Dispatcher,Load Balancer,Content Based Routing,Site Selector'/>
The new line indicates that the Metric Server will not
be installed.
What to do next
The installation process does not add the command directories
for Load Balancer into the PATH environment variable. To run Load
Balancer commands from the system root, add the command directories
to the PATH environment variable.
Avoid trouble: If you installed previous
installation of the Dispatcher component, be aware that
Websphere Load Balancer for IPv4 versions of
the Dispatcher component used commands in the
/usr/bin directory,
which might be in the PATH variable.
Websphere Load Balancer for IPv4 and IPv6 has commands
in the
install_root/bin directory,
so ensure that the directory entries point to the appropriate directories
for the
dsserver and
dscontrol commands.
gotcha