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]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
./IBMIM -skipInstall /var/temp/imRegistry -record /var/temp/install_response_file.xml
![[Windows]](../images/windows.gif)
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 documentation.
- 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]](../images/aixlogo.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../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]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
./IBMIM -skipInstall /var/temp/imRegistry -keyring /var/IM/im.keyring
-password password
-record /var/temp/keyring_response_file.xml
![[Windows]](../images/windows.gif)
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 documentation.
- 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]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
./IBMIM --launcher.ini silent-install.ini -input /var/temp/install_response_file.xml
-log /var/temp/install_log.xml
![[Windows]](../images/windows.gif)
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 documentation 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]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.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
![[Windows]](../images/windows.gif)
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
![[Windows]](../images/windows.gif)
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 documentation 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