Installing Load Balancer

This chapter instructs you on Load Balancer installation using system packaging tools and requirements for all supported operating systems.

For Installation instructions using the product setup program, refer to the Concepts, Planning, and Installation for Edge Components document.

The Java 2 SDK automatically installs with Load Balancer on all platforms.

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.

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

AIX system requirements and installation

Requirements for AIX systems

For information on hardware and software requirements, including supported browsers, refer to the following Web page: http://www.ibm.com/support/docview.wss?rs=180&uid=swg27006921

Installing for AIX systems

Table 1 lists the installp images for Load Balancer and the recommended order of installation using the system's package installation tool.

Table 1. AIX installp images
Base ibmlb.base.rte
Administration (with messages)
  • ibmlb.admin.rte
  • ibmlb.msg.language.admin
Device Driver ibmlb.lb.driver
License ibmlb.lb.license
Load Balancer components (with messages)
  • ibmlb.component.rte
  • ibmlb.msg.language.lb
Documentation (with messages)
  • ibmlb.doc.rte
  • ibmlb.msg.en_US.doc
Metric Server ibmlb.ms.rte

Where component can be: disp (Dispatcher), cbr (CBR), ss (Site Selector), cco (Cisco CSS Controller), or nal (Nortel Alteon Controller). Optionally select which component(s) you want to install.

Where language can be:

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

Before you install

If you have an earlier version installed, uninstall that copy before installing the current version. First, ensure that all the executors and all the servers are stopped. Then, to uninstall the entire product, enter installp -u ibmlb (or previous name, for example, intnd). To uninstall specific filesets, list them specifically instead of specifying the package name.

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

Installation steps

Follow these steps to install Load Balancer for AIX® systems:

  1. Log in as root.
  2. Insert the product media, or if you are installing from the Web, copy the installation images to a directory.
  3. Install the installation image. Use SMIT to install Load Balancer for AIX because SMIT will ensure that all messages are installed automatically.

    Using SMIT:

    Select
    Software Installation and Maintenance
    Select
    Install and Update Software
    Select
    Install and update from latest Available Software
    Enter
    The device or directory containing the installp images
    Enter
    On the *SOFTWARE to Install line, the appropriate information to specify options (or select List)
    Press
    OK

    When the command completes, press Done, and then select Exit Smit from the Exit menu or press F12. If using SMITTY, press F10 to exit the program.

    Using the Command Line:

    If installing from a CD, you must enter the following commands to mount the CD:

    mkdir /cdrom
    mount -v cdrfs -p -r /dev/cd0 /cdrom

    Refer to the following table to determine which command(s) to enter to install the desired Load Balancer packages for AIX systems:

    Table 2. AIX install 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:

    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 you want to install are successfully applied.

    Note:
    To generate a list of filesets in any installp image, including all available message catalogs, enter
    installp -ld device

    where device is:

    • /cdrom if you are installing from a CD.
    • /dir (the directory containing the installp images) if you are installing from a file system.

    To unmount the CD, type:

    unmount /cdrom
  4. Verify that the product is installed. Enter 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 install paths include the following:

For remote administration of Load Balancer, using Remote Method Invocation (RMI), you will need to install the administration, base, component, and license packages on the client. For information on RMI, see Remote Method Invocation (RMI).

HP-UX system requirements and installation

Requirements for HP-UX systems

For information on hardware and software requirements, including supported browsers, refer to the following Web page: http://www.ibm.com/support/docview.wss?rs=180&uid=swg27006921

Installing for HP-UX systems

This section explains how to install Load Balancer on HP-UX systems 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 steps

Table 3 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 3. 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, en_US, 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 Load Balancer documentation set are at the following Web site: www.ibm.com/software/webservers/appserv/ecinfocenter.html.
Note:
HP-UX systems do not support the Portuguese Brazilian (pt_BR) locale. The supported locales on HP-UX systems 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:

    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.

    The following command installs just 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 the swlist command to list all the packages that you installed. For example,

    swlist -l fileset ibmlb
    

Instructions for uninstalling the packages

Use the swremove command to uninstall the packages. Remove the packages in the reverse order that they were installed. For example, issue the following commands:

Linux system requirements and installation

Requirements for Linux systems

For hardware and software requirements, including supported browsers, refer to the following Web page: http://www.ibm.com/support/docview.wss?rs=180&uid=swg27006921

Installing for Linux systems

This section explains how to install Load Balancer on Linux 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 all the executors and all the servers are stopped. Then to uninstall the entire product, enter rpm -e pkgname. When uninstalling, reverse the order used for package installation ensuring the administration packages are last to be uninstalled.

Installation steps

To install Load Balancer:

  1. Prepare to install.
  2. Verify that the product is installed. Enter the following command:

    rpm -qa | grep ibmlb

    Installing the full product produces a listing like the following example:

For remote administration of Load Balancer, using Remote Method Invocation (RMI), you need to install the administration, base, component, and license packages on the client. For information on RMI, see Remote Method Invocation (RMI).

Solaris system requirements and installation

Requirements for Solaris

For information on hardware and software requirements, including supported browsers, refer to the following Web page: http://www.ibm.com/support/docview.wss?rs=180&uid=swg27006921

Installing for Solaris

This section explains how to install Load Balancer on Solaris systems 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, uninstall that copy before installing the current version. First, ensure that you have stopped all the executors and the servers. Then, to uninstall Load Balancer enter pkgrm pkgname.

Installation steps

To install Load Balancer:

  1. Prepare to install. At the command prompt, enter pkgadd -d pathname, where pathname is the device name of the CD-ROM drive or the directory on the hard drive where the package is located; for example: pkgadd -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 Load Balancer 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(s) corresponding to the packages to be installed separated by a space or comma and press return. You may be prompted to change permissions on existing directories or files. Simply press return, or answer "yes." You need to install prerequisite packages (because it installs in alphabetical order not prerequisite order). If you say "all" then just answer "yes" to all prompting and the install will complete 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.

    For remote administration of Load Balancer, using Remote Method Invocation (RMI), you will need to install the administration, base, component, and license packages on the client. For information on RMI, see Remote Method Invocation (RMI).

    The Load Balancer install paths are the following:

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

Windows system requirements and installation

Requirements for Windows systems

For information on hardware and software requirements, including supported browsers, refer to the following Web page: http://www.ibm.com/support/docview.wss?rs=180&uid=swg27006921

Installing for Windows systems

This section explains how to install Load Balancer on Windows systems using the product CD.

Installation Packages

You are given a choice of packages to install:

For remote administration of Load Balancer, using Remote Method Invocation (RMI), you will need to install the administration, license, and component packages on the client. For information on RMI, see Remote Method Invocation (RMI).

Before you install

Restrictions: The Windows version of Load Balancer cannot be installed on the same machine with IBM® Firewall.

Before beginning the installation procedure, ensure you have logged in as the Administrator or as a user with administrative privileges.

If you have an earlier version installed, you should uninstall that copy before installing the current version. To uninstall using the Add/Remove Program, do the following:

  1. Click Start > Settings (for Windows 2000) > Control Panel
  2. Double-click Add/Remove Programs
  3. Select IBM WebSphere Edge Components (or previous name, for example, IBM Edge Server)
  4. Click Change/Remove button

Installation steps

To install Load Balancer:

  1. Insert the Load Balancer CD-ROM into your CD-ROM drive, and the install window should come up automatically.
  2. The following step is only required if autorun of the CD did not work on your computer. Using your mouse, click mouse button 1 to perform these tasks:
  3. Select Language in which to read the install process.
  4. Click OK.
  5. Follow the instructions of the setup program.
  6. If you want to change the drive or directory destination, click Browse.
  7. You have the choice of selecting "All of the Load Balancer product" or "your choice of components."
  8. After installation is complete, a message will tell you to reboot your system before using Load Balancer. This is necessary to make sure that all files are installed and the IBMLBPATH environment variable is added to the registry.

Load Balancer install paths include the following: