Installation procedures for Load Balancer service releases
 Technote (troubleshooting)
 
Problem(Abstract)
Load Balancer is part of WebSphere® Application Server Edge Components. This technote provides instructions for installing Load Balancer service releases on multiple platforms.
 
Cause
You require installation instructions for service releases and interim fixes.
 
Resolving the problem
The following installation procedures are for Load Balancer (formally known as Network Dispatcher) service releases on these platforms:
AIX® systems
Solaris systems
Microsoft® Windows® 2000 systems
Linux® systems
HP-UX systems

Files that might need to be saved during an upgrade include:
  • License filesets (ndxxFull.LIC or ndxxTry.LIC)

  • Server startup scripts that have been customized, such as dsserver and default.cfg, if modified.


For AIX® systems
Before installing a new Load Balancer service release on AIX systems, stop and uninstall any presently-installed release. Perform the following steps as required.
  • Uninstalling Load Balancer on AIX systems
    1. Go to a command prompt with root authority.

    2. Copy to a backup directory any files that you created and placed in the Load Balancer installation directory chain. Also consider saving any Load Balancer configuration scripts.

    3. Use the following command to stop the Executor:

      dscontrol executor stop

      Note: The Executor can still be running even if dsserver is stopped. If you receive a message that dsserver is not running, start dsserver, then issue the command again.

    4. Stop dsserver with the following command:

      dsserver stop

    5. Uninstall the product:
      1. Copy the .LIC file from the /conf directory to a temporary place.

      2. Enter the following command:

        installp -u ibmlb

      3. Copy the license file back to the /conf directory, because it is deleted if the license fileset is installed.

  • Installing Load Balancer on AIX systems
    1. If any version of Load Balancer is installed, use the preceding instructions to uninstall it.

    2. Go to a command prompt with root authority.

    3. Obtain the new Load Balancer Service Release and place it in a temporary directory. Perform all FTP transfers in binary mode.

    4. Uncompress and untar the build package. This results in a number of separate filesets.

    5. Install the software.

    6. Use the following command to generate a .toc file if it is not already there:

      inutoc

    7. Enter the following command:

      installp -acXd . ibmlb

    8. (Optional) Restore any configuration files and start scripts that you saved or modified during a previous uninstallation. Verify that any start scripts you created reflect the correct Load Balancer installation directory chain.


For Solaris systems
Before installing a new Load Balancer service release on Solaris, stop and uninstall any presently installed Load Balancer. Perform the following steps as required.
  • Uninstalling Load Balancer on Solaris systems
    1. Go to a command prompt with root authority.

    2. (Optional) Copy to a backup directory any files that you created and placed in the Load Balancer installation directory chain. Also consider saving any Load Balancer configuration scripts.

    3. Stop the Executor:

      dscontrol executor stop

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

      dsserver stop

    5. Uninstall the product:
      1. Copy the .LIC file from the /conf directory to a temporary place.

      2. Run pkgrm on all of the Load Balancer related packages.

  • Installing Load Balancer on Solaris systems
    1. If any version of Load Balancer is installed on the box, use the preceding instructions to uninstall it.

    2. Go to a command prompt with root authority.

    3. Obtain the new Load Balancer service release and place it in a temporary directory. Perform all FTP transfers in binary mode.

    4. Uncompress the .Z file:

      uncompress filename

      where:
      filename is the name of the new Service Release.

      For example:
      To uncompress Load Balancer 5.0.1.0:

      uncompress eLBSUN-5.0.1.0.tar.Z

      A file without the .Z extension is created.

    5. Untar the service release file:

      tar -xf filename

      where:
      filename is the name of the new service release (without the .Z)

      For example:
      To untar Load Balancer 5.0.1.0:

      tar -xf eLBSUN-5.0.1.0.tar

      Several files are created in the temporary directory.

    6. From the same temporary directory, install the product:

      pkgadd -d pathname

    7. (Optional) Restore any configuration files and start scripts that you saved or modified during a previous uninstall. Verify any start scripts that you created reflect the correct Load Balancer installation directory chain.


For Microsoft® Windows® 2000 systems
  • Uninstalling Load Balancer on Windows 2000 systems

    Note: Installation of a new Load Balancer service release on Windows automatically uninstalls a previous version.

    Copy the .LIC file from the /conf directory to a temporary place.

  • Installing Load Balancer on Windows 2000 systems
    1. (Optional) Copy to a backup directory any files that you created and placed in the Load Balancer installation directory chain. Also consider saving any Load Balancer configuration scripts.

    2. Sign on with administrator authority.

    3. Edit any start scripts you might have created that automatically start Load Balancer upon reboot. Temporarily suppress the commands that start Load Balancer.

    4. Prevent the presently installed Load Balancer from starting as a service on the next reboot. Click Start > Settings > Control Panel > Services.

    5. Select IBM Dispatcher, then click Startup.

    6. Select Manual > OK. Close the windows.

    7. Reboot.

    8. Obtain the new Load Balancer service release and place it in a temporary directory. Perform all FTP transfers in binary mode.

    9. Start Windows Explorer, double-click the service release executable file to begin the installation. Follow the instructions.

    10. (Optional) Restore any configuration files and start scripts that you saved or modified before the installation. Verify that any start scripts that you created reflect the correct Load Balancer installation directory chain.


For Linux® systems
Before installing a new Load Balancer service release on Linux, any presently-installed Load Balancer must be stopped and uninstalled. Perform the following steps as required.
  • Uninstalling Load Balancer on Linux systems
    1. Go to a command prompt with root authority.

    2. (Optional) Copy to a backup directory any files that you created and placed in the Load Balancer installation directory chain. Also consider saving any Load Balancer configuration scripts.

    3. Stop the Executor:

      dscontrol executor stop

      Note: 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, then issue the command again.

    4. Stop dsserver:

      dsserver stop

    5. Uninstall the product:
      1. Copy the .LIC file from the conf directory to a temporary place.

      2. Run rpm -e on all of the Load Balancer related packages.

  • Installing Load Balancer on Linux systems
    1. If any version of Load Balancer is installed on the box, use the preceding instructions to uninstall it.

    2. Go to a command prompt with root authority.

    3. Obtain the new Load Balancer service release and place it in a temp directory. Perform all FTP transfers in binary mode.

    4. Uncompress the .Z file:

      uncompress filename

      where:
      filename is the name of the new service release.

      For example:
      To uncompress Load Balancer 5.0.2.0:

      uncompress eLBLX-5.0.2.0.tar.Z

      A file without the .Z extension is created.

    5. Untar the service release file:

      tar -xf filename

      where:
      filename is the name of the new service release (without the .Z)

      For example:
      To untar Load Balancer 5.0.2.0:

      tar -xf eLBLX-5.0.2.0.tar

      Several files are created in the temp directory.

    6. From the same temp directory, install the product:

      rpm -i --nodeps ibmlb*.rpm

      The product is installed in its directory chain.

    7. (Optional) Restore any configuration files and start scripts that you saved or modified during a previous uninstall. Verify that any start scripts that you created reflect the correct Load Balancer installation directory chain.


    For HP-UX systems
    Before installing a new Load Balancer service release on HP-UX, stop and uninstall any presently-installed release. Perform the following steps as required.
  • Uninstalling Load Balancer on HP-UX systems
    1. Go to a command prompt with root authority.

    2. Copy to a backup directory any files which you created and placed in the Load Balancer installation directory chain. Also consider saving any Load Balancer configuration scripts.

    3. Stop the Executor with the following command:

      dscontrol executor stop

      Note: The Executor can still be running even if dsserver is stopped. If you receive a message that dsserver is not running, start dsserver, then issue the command again.

    4. Stop dsserver with the following command:

      dsserver stop

    5. Uninstall the product:
      1. Copy the .LIC file from the /conf directory to a temporary place.

      2. Enter the following command:

        swremove ibmlb

      3. Copy the license file back to the /conf directory, because it is deleted if the license fileset is installed.

  • Installing Load Balancer on HP-UX systems
    1. If any version of Load Balancer is installed on the box, use the preceding instructions to uninstall it.

    2. Go to a command prompt with root authority.

    3. Obtain the new Load Balancer Service Release and place it in a temporary directory. Make sure you perform all FTP transfers in binary mode.

    4. Uncompress and untar the build package. This results in a number of separate filesets.

    5. Install the software using the following command,

      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, the following command installs the base package for Load Balancer (ibmlb.base) when the packages reside in the lb directory:

      swinstall -s /lb ibmlb.base

    6. (Optional) Restore any configuration files and start scripts that you saved or modified during a previous uninstallation. Verify that any start scripts you created reflect the correct Load Balancer installation directory chain.
 
 
 


Document Information


Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server > Edge Component
Operating system(s): Windows
Software version: 6.1
Software edition:
Reference #: 1174350
IBM Group: Software Group
Modified date: Aug 26, 2005