Installing the product silently

Use IBM® Installation Manager from the command line to install Websphere Load Balancer for IPv4 and IPv6 silently.

Before you begin

For information on hardware and software requirements, including supported browsers, refer to the following Web page: WebSphere Application Server detailed system requirements.

If you have not installed or configured IBM Installation Manager, refer to Setting up IBM Installation Manager.

Two versions of Load Balancer cannot be installed on the same machine. If you have an earlier version installed, uninstall that copy before installing the current version. Refer to Uninstalling the product for more information.

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

  1. 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.

    1. From a command line, navigate to the directory in which you installed Installation Manager, and then change directories to the eclipse subdirectory.
    2. Start Installation Manager from the command line with the -record option.

      For example, run the following command as an administrator:

      [AIX][HP-UX][Linux][Solaris]
      ./IBMIM -skipInstall /var/temp/imRegistry -record /var/temp/install_response_file.xml
      [Windows]
      IBMIM.exe -skipInstall "C:\temp\imRegistry" -record C:\temp\install_response_file.xml
      Best practice 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.
    3. Add the appropriate repositories to your preferences.
      1. In the menu, click File > Preferences.
      2. Select Repositories.
      3. Click Add Repository.
      4. 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.
        For example, you can add one or both of the following types:
        Remote repositories
        https://www.ibm.com/software/rational/repositorymanager/repositories/websphere
        http://public.dhe.ibm.com/software/websphere/repositories
        The remote repository for Websphere Load Balancer for IPv4 and IPv6 is:
        http://www.ibm.com/software/repositorymanager/com.ibm.websphere.EDGELBIPV4IPV6.v85
        Local repositories
        [AIX][HP-UX][Linux][Solaris]
        /var/repositories/edge85/local-repositories
        [Windows]
        C:\repositories\edge85\local-repositories
      5. Click OK.
    4. Click Apply.
    5. Click OK.
    6. 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.

    7. Select IBM Websphere Edge Components: Load Balancer for IPv4 and IPv6 and the most recent version number.
      Avoid trouble 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
    8. Click Next.
      Avoid trouble 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
    9. Accept the terms in the license agreements, and click Next.
    10. Review the installation location. The Installation Location panel will appear. This panel also displays the shared resources directory and disk-space information.
      • [AIX][HP-UX][Linux][Solaris]You are not allowed to change the default installation location. The folder for the installation location on the system should be empty before you proceed.
      • [Windows]Specify the installation root directory for the product binaries, which are also referred to as the core product files or system files.
        Avoid trouble Avoid trouble: Be aware of the following restrictions:
        • You cannot continue if you delete the default target location and leave any installation-directory fields empty.
        • Do not use symbolic links as the destination directory.
        • Symbolic links are not supported.
        • Do not use a semicolon in the directory name.
        • The maximum path length on the Windows 2000, Windows Server 2008, Windows Vista, and Windows 7 operating systems is 60 characters.
        gotcha
    11. Click Next.
    12. Select the languages for which translated content should be installed, and click Next.

      English is always selected.

    13. 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.
    14. [AIX][Linux][Solaris][Windows]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.
    15. 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.
    16. Click Finish.
    17. Close Installation Manager.

      Click File > Exit.

    18. Optional: If you are using an authenticated remote repository, create a keyring file for silent installation.
      1. From a command line, navigate to the eclipse subdirectory in the directory in which you installed Installation Manager.
      2. Start Installation Manager from the command line with the -record option. For example, run the following command as an administrator:
        [AIX][HP-UX][Linux][Solaris]
        ./IBMIM -skipInstall /var/temp/imRegistry -keyring /var/IM/im.keyring 
               -password password 
               -record /var/temp/keyring_response_file.xml
        [Windows]
        IBMIM.exe -skipInstall "C:\temp\imRegistry" -keyring C:\IM\im.keyring 
               -password password 
               -record C:\temp\keyring_response_file.xml
      3. When you are prompted for your credentials for the authenticated remote repository, enter the correct credentials, and save them.
      4. Close Installation Manager. Click File > Exit. For more information on keyring files, read the topic on silently installing from authenticated repositories with Installation Manager in the Installation Manager documentation.
  2. Use the response files to install the product silently.
    1. 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][HP-UX][Linux][Solaris]
      ./IBMIM --launcher.ini silent-install.ini -input /var/temp/install_response_file.xml 
         -log /var/temp/install_log.xml
      [Windows]
      IBMIMc.exe --launcher.ini silent-install.ini -input C:\temp\install_response_file.xml 
         -log C:\temp\install_log.xml
      Avoid trouble 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
    2. 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][HP-UX][Linux][Solaris]
      ./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]
      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]

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

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: March 23, 2018 0:18
File name: tins_lbinstallingsilent.html