Updating Load Balancer

Obtaining an update You can obtain the Edge Components fix pack for the AIX, HP-UX, Linux, Solaris Operating System, or Microsoft Windows operating systems in the following mediums:

For information about supported operating systems, refer to the IBM support site for WebSphere Application Server detailed system requirements.

You can find the link to the refresh packs or fix packs for Edge Components in the IBM support site's Recommended downloads for WebSphere Application Server.

  1. Find the corrective service release to which you are upgrading and follow the link to the download site.
  2. Follow the instructions on the site to download the Edge Components refresh pack.
Note:
You also can download the latest Edge components fix packs from the Edge Components FTP server.

Updating Load Balancer for AIX, HP-UX, Linux, and Solaris operating systems

Uninstall previous versions of Load Balancer

Before installing the refresh or fix pack, stop and uninstall any existing versions of Load Balancer that are earlier than the version to which you are upgrading.

  1. Go to a command prompt with root authority.
  2. Backup any files to another directory that you created and placed in the Load Balancer install directory. Also, consider saving any Load Balancer configuration scripts.
  3. Stop the Load Balancer Executor by using the following command:
    dscontrol executor stop
    The Load Balancer Executor can still be running even if dsserver is stopped. If you receive a message that dsserver is not running, start dsserver and then issue the command again.
  4. Stop dsserver by using the following command:
    dsserver stop
  5. Uninstall all of the Load Balancer packages using the system-specific commands in the table that follows.
Table 4. System-specific commands to uninstall Load Balancer
System-specific commands to uninstall Load Balancer
Platform Commands
AIX Uninstall all of the Load Balancer product packages with the following command:
installp -u ibmlb
HP-UX Uninstall all of the Load Balancer product packages with the following command:
swremove ibmlb
Linux
  1. To check for Load Balancer or related packages that were previously installed, use the following command:
    rpm -qa | grep ibmlb
  2. Uninstall each Load Balancer package. Use the following command:
    rpm -e package_name
    where package_name is the individual Load Balancer package name.
Note:
To uninstall individual packages, remove the packages in the reverse order in which they were installed.
Solaris
  1. To check for Load Balancer or related packages that were previously installed, use the following command:
    pkginfo | grep ibmlb
  2. Uninstall each Load Balancer package. Use the following command:
    pkgrm package_name
    where package_name is the individual Load Balancer package name.

Installing the Load Balancer refresh pack or fix pack

If you do not have Load Balancer installed, you are only required to install the license file for Load Balancer, which is lb70Full.LIC, prior to installing a refresh or fix pack. You can obtain the license by installing the license package for Load Balancer.

To install a fix or refresh pack:

  1. Go to a command prompt with root authority.
  2. Obtain the Load Balancer refresh or fix pack and place it in a temporary directory.
  3. Uncompress and untar the build package. This results in a number of separate file sets.
  4. Install the software using the system-specific commands in the table that follows. Refer to the list of packages for the order in which to install the file sets.
    Table 5. System-specific commands to install an refresh or fix pack
    System-specific commands to install an refresh or fix pack
    System Commands
    AIX
    1. Generate a .toc file, if not already there, by issuing the command:
      inutoc
    2. Install the packages for Load Balancer. For example, to install the base package from the current directory, issue the following command:
      installp -acXd . ibmlb.base.rte
    HP-UX
    swinstall -s /source package_name
    where source is the directory for the location of the package and package_name is the name of the package.

    For example, to install the base package from the current directory, issue the following command:

    swinstall -s /lb ibmlb.base
    Linux
    rpm -iv package_name
    where package_name is the name of the package.

    For example, the following command installs all of the packages for Load Balancer when the packages reside in the current directory:

    rpm -iv ibmlb*.rpm
    Note:
    You can use the -nodeps option to successfully install all of the packages in any order.
    Solaris
    pkgadd -d pathname package_name
    where pathname is the directory for the location of the package and package_name is the name of the package.

    For example, to install the administration package from the current directory, issue the following command:

    pkgadd -d . ibmlbadm
  5. Restore any configuration files and the start scripts that you saved or modified during a previous uninstall.

This table lists all of the packages that are delivered with Edge Components and their required order of installation. Install the packages that are included in the refresh or fix pack according to the order that is specified in the following table.

Note:
Not all of the packages listed here are delivered with the refresh or fix pack. Update only the packages that are delivered with the refresh or fix pack and that were previously installed on your system.
Table 6. List of packages
List of packages
Components installed Update the packages (listed generically) in this order
  • Dispatcher
  • Content Based Routing
  • Site Selector
  • Cisco CSS Controller
  • Nortel Alteon Controller
  • Metric Server
  • Load Balancer Documentation
  1. Base
  2. Administation
  3. License
  4. Device Driver (AIX only)
  5. LB component(s)
  6. Metric Server
  7. Load Balancer Documentation (lang)
Edge Components Documentation doc-lang

Updating Load Balancer for Windows operating systems

Use the setup program for Edge Components to upgrade as follows

  1. To prevent the currently installed Load Balancer from starting, edit any start scripts that you have created to temporarily suppress any commands that will start Load Balancer upon reboot.
  2. Ensure that the Load Balancer service is set as Manual.
  3. Restart your Windows machine.
  4. Download the Edge Components refresh or fix pack.
  5. Use the Add/Remove programs option in the Windows control panel to uninstall the current Load Balancer component, if present.
  6. Run the installation program by doing one of the following actions:
    1. From a command prompt:
      1. Change to the /lb directory and enter setup.
      2. For a refresh pack, change to the /lb directory and enter setup. For a Load balancer fix pack, unzip the downloaded package to a folder and enter setup from that folder.
    2. From the Start menu:
      1. Click Run.
      2. Click Browse.
        • To install Caching Proxy and Load Balancer, or only Caching Proxy, select the directory that contains the installation files for your operating system and select setup.
        • To install only Load Balancer:
          1. For a refresh pack, change to the /lb directory and select setup. For a fix pack, the Load balancer fix pack only contains Load balancer installation files and does not include the /lb folder. Select the installation files for your operating system and select setup.
      3. Click Open.
      4. Click OK.
  7. Enter information as requested by the installation program.

Rejecting an update

For most components, when the refresh or fix pack is removed, the configuration files are saved in the oldfiles/component directory. You can use these configuration files with the reinstalled version of the product to maintain the patched configuration in the prepatched version. For the Load Balancer component, you must manually save configuration files to maintain the patched configuration.