Installing Load Balancer using system packaging tools

This topic documents the installation of Load Balancer on AIX®, HP-UX, Linux, and Solaris systems:

Depending on the type of installation, not all the Load Balancer component packages that are listed in this section are provided.

If you are migrating from a previous version of Load Balancer, or re-installing an operating system, prior to installation, you can save any of your previous configuration files or script files for Load Balancer.

If you log off a machine after Load Balancer has been installed, you must restart all Load Balancer services when you log back on.

Installing for AIX

Table 5 lists the AIX filesets for Load Balancer and the recommended order of installation using the system's package installation tool.

Table 5. AIX filesets
Load Balancer components AIX filesets
Base ibmlb.base.rte
Administration (with messages)
  • ibmlb.admin.rte
  • ibmlb.msg.lang.admin
Device Driver ibmlb.lb.driver
License ibmlb.lb.license
Load Balancer components (with messages)
  • ibmlb.component.rte
  • ibmlb.msg.lang.lb
Documentation (with messages)
  • ibmlb.doc.rte
  • ibmlb.msg.en_US.doc
Metric Server ibmlb.ms.rte
Notes:
  1. The following can be substituted for the variable component: disp (dispatcher), cbr (CBR), ss (Site Selector), cco (Cisco CSS Controller), or nal (Nortel Alteon Controller).
  2. The following can be substituted for the variable lang: en_US, de_CH, de_DE, es_ES, fr_CA, fr_CH, fr_FR, it_CH, it_IT, ja_JP, Ja_JP, ko_KR, pt_BR, zh_CN, ZH_CN, zh_TW, Zh_TW

The documentation package contains English only. Translations of the Edge Component documentation set are at the following Web site: www.ibm.com/software/webservers/appserv/ecinfocenter.html.

Before you install

Before you install Load Balancer for AIX, ensure the following:

When you install the product, you are given the option of installing any or all of the following:

Installation procedure

It is recommended that you use SMIT to install Load Balancer for AIX because SMIT ensures that all messages are installed automatically.

Using SMIT to install Load Balancer for AIX

  1. Select Software Installation and Maintenance.
  2. Select Install and Update Software.
  3. Select Install and update from latest Available Software.
  4. Enter the device or directory containing the filesets.
  5. In the *SOFTWARE to Install field, enter the appropriate information to specify options (or select List).
  6. Press OK.
  7. When the command completes, press Done.
  8. Close SMIT by selecting Exit Smit from the Exit menu or pressing F12. If you are using SMITTY, press F10 to close the program.

Installing Load Balancer from the command line

  1. If installing from a CD, enter the following commands to mount the CD:
    mkdir /cdrom
    mount -v cdrfs -p -r /dev/cd0 /cdrom
  2. Refer to the following table to determine which command or commands to enter to install the desired Load Balancer packages for AIX:
    Table 6. AIX installation commands
    Packages Commands
    Base installp -acXgd device ibmlb.base.rte
    Administration (with messages) installp -acXgd device ibmlb.admin.rte ibmlb.msg.language.admin
    Device Driver installp -acXgd device ibmlb.lb.driver
    License installp -acXgd device ibmlb.lb.license
    Load Balancer components (with msgs). Includes: Dispatcher, CBR, Site Selector, Cisco CSS Controller, and Nortel Alteon Controller

    installp -acXgd device ibmlb.component.rte

    ibmlb.msg.language.lb

    Documents (with messages) installp -acXgd device ibmlb.doc.rte ibmlb.msg.en_US.lb
    Metric Server installp -acXgd device ibmlb.ms.rte
    where device is:
  3. Ensure that the result column in the summary contains SUCCESS for each part of Load Balancer that you are installing (APPLYing). Do not continue until all of the parts that you wish to install are successfully applied.
    Note:
    To generate a list of filesets on a specified device, including all available message catalogs, enter
    installp -ld device

If installing from a CD, to unmount the CD, enter the following command:

unmount /cdrom

Verify that the product is intalled by entering the following command

lslpp -h | grep ibmlb

If you installed the full product, this command returns the following:

ibmlb.base.rte
ibmlb.admin.rte
ibmlb.lb.driver
ibmlb.lb.license
ibmlb.component.rte
ibmlb.doc.rte
ibmlb.ms.rte
ibmlb.msg.language.admin
ibmlb.msg.en_US.doc
ibmlb.msg.language.lb

Load Balancer installation paths include the following:

Installing for HP-UX

This section explains how to install Load Balancer on HP-UX using the product CD.

Before you install

Before beginning the installation procedure, ensure that you have root authority to install the software.

If you have an earlier version installed, you should uninstall that copy before installing the current version. First, ensure that you have stopped both the executor and the server. Then, to uninstall Load Balancer see Instructions for uninstalling the packages.

Installation procedure

Table 7 lists the names of the installation packages for Load Balancer and the recommended order to install the packages using the system's package installation tool.

Table 7. HP-UX package installation details for Load Balancer
Package description HP-UX package name
Base ibmlb.base
Administration and messages ibmlb.admin ibmlb.nlv-lang
Load Balancer License ibmlb.lic
Load Balancer components ibmlb.component
Documentation ibmlb.doc
Metric Server ibmlb.ms
Notes:
  1. The variable lang refers to the substitution of one of the following language specific codes: de_DE, es_ES, fr_FR, it_IT, ja_JP, ko_KR, zh_CN, zh_TW.
  2. The variable component refers to the substitution of one of the following: disp (dispatcher), cbr (CBR), ss (Site Selector), cco (Cisco CSS Controller), or nal (Nortel Alteon Controller).
  3. The documentation package (ibmlb.doc) contains English only. Translations of the Edge Component documentation set are at the following Web site: www.ibm.com/software/webservers/appserv/ecinfocenter.html.

HP-UX does not support the Portuguese Brazilian (pt_BR) locale. The supported locales on HP-UX are:

Instructions for installing the packages

The following procedure details the steps necessary to complete this task.

  1. Become the local superuser root.
    su - root
    Password: password
  2. Issue the install command to install the packages

    Issue the install command

    swinstall -s /source package_name

    where source is the absolute directory path for the location of the package, and package_name is the name of the package.

    For example, the following installs the base package for Load Balancer (ibmlb.base), if you are installing from the root of the CD

    swinstall -s /source ibmlb.base

    To install all the packages for Load Balancer issue the following command, if you are installing from the root of the CD:

    swinstall -s /source ibmlb
  3. Verify the installation of the Load Balancer packages

    Issue swlist command to list all the packages that you have installed. For example,

    swlist -l fileset ibmlb
    

Instructions for uninstalling the packages

Use the swremove command to uninstall the packages. The packages should be removed in the reverse order they were installed. For example, issue the following:

Load Balancer installation paths include the following:

Installing for Linux

This section explains how to install Load Balancer on Linux using the Edge components CD.

Before you install

Before installing Load Balancer, ensure the following:

Installation steps

  1. Insert the Edge Components media or download the product from the Web site and install the installation image using RPM (Red Hat Packaging Manager).

    The installation image is a file in the format lblinux-version.tar.

  2. Untar the tar file in a temporary directory by entering the following command:
    tar -xf lblinux-version.tar
    The result is the following set of files with the .rpm extension:

    Where --

    The documentation package contains English only. Translations of the Edge Component documentation set are at the following Web site: www.ibm.com/software/webservers/appserv/ecinfocenter.html.

  3. From the directory where the RPM files are located, issue the command to install each package. For example:
    rpm -i package.rpm

    Red Hat Linux systems: Due to a known Red Hat Linux problem, you will also need to delete the _db* RPM files, or an error will occur.

    It is important to install the packages in the order shown in the following list of packages needed for each component.

    Note:
    At least one of the RPM files requires that Java™ is installed and registered in the RPM database. If Java is installed but not registered in the RPM database, use the installation command with a no dependencies option as follows:
    rpm -i --nodeps package.rpm 
  4. Verify that the product is installed. Enter the following command:
    rpm -qa | grep ibmlb

    Installing the full product produces the following output:

Load Balancer installation paths include the following:

If you need to uninstall the packages, reverse the order used for package installation, ensuring that the administration packages are uninstalled last.

Installing for Solaris

This section explains how to install Load Balancer on Solaris using the Edge components CD.

Before you install

Before beginning the installation procedure, ensure that you are logged in as root and that any previous version of the product is uninstalled.

To uninstall, ensure that all the executors and the servers are stopped. Then, enter the following command:

pkgrm pkgname

Installation steps

  1. Insert the CD-ROM that contains the Load Balancer software into the appropriate drive.
  2. At the command prompt, enter the following command:
    pkgadd -d pathname
    where -d pathname is the device name of the CD-ROM drive or the directory on the hard drive where the package is located; for example: -d /cdrom/cdrom0/.

    The following is a list of packages displayed and the recommended order in which they should be installed.

    The documentation package (ibmlbdoc) contains English only. Translations of the Edge Component documentation set are at the following Web site: www.ibm.com/software/webservers/appserv/ecinfocenter.html.

    If you want to install all of the packages, simply type all and press Return. If you want to install some of the components, enter the name or names corresponding to the packages to be installed, separated by a space or comma, and press Return. You might be prompted to change permissions on existing directories or files. Simply press Return or respond yes. You need to install the prerequisite packages (because the installation follows alphabetical, not prerequisite order). If you type all, then respond yes to all prompting, and the installation completes successfully.

    If you want to install just the Dispatcher component with the documentation and Metric Server, you must install the following packages: ibmlbbase, ibmlbadm, ibmlblic, ibmdisp, ibmlbdoc, and ibmlbms.

  3. Verify that the product is installed. Issue the following command:
    pkginfo | grep ibm

The Load Balancer installation paths include the following: