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.
- For Edge Component installations that can provide both Load Balancer and
Caching Proxy, all the Load Balancer install component packages are available.
- For Edge Component installations that can provide Load Balancer but not
Caching Proxy, the CBR component package is not included with Load Balancer.
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.
- After installation, place your configuration files in the ...ibm/edge/lb/servers/configurations/component directory (where component is either dispatcher, cbr, ss, cco, or nal).
- After installation, place your script files (such as goIdle and goStandby)
in the .../ibm/edge/lb/servers/bin directory in order to run them.
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:
- 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).
- 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:
- You are logged in as root.
- The Edge components media is inserted, or if you are installing from the Web,
the installation images are copied to a directory. Any earlier version of the
product is uninstalled. To uninstall, ensure that all the executors and all
the servers are stopped. Then, to uninstall the entire product, enter the
following command:
installp -u ibmlb
or, for previous versions, enter
the following command:
installp -u ibmnd
To uninstall specific filesets,
list them specifically instead of specifying the package name ibmlb.
When you install the product, you are given the option of installing any
or all of the following:
- Base Administration
- Administration (with messages)
- Device Driver (required)
- License (required)
- Dispatcher component (with messages)
- CBR component (with messages)
- Site Selector component (with messages)
- Cisco CSS Controller component (with messages)
- Nortel Alteon Controller component (with messages)
- Documentation (with messages)
- Metric Server
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
- 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 filesets.
- In the *SOFTWARE to Install field, enter the appropriate
information to specify options (or select List).
- Press OK.
- When the command completes, press Done.
- 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
- If installing from a CD, 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 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:
- /cdrom if you are installing from a CD.
- /dir (the directory containing the filesets) if you are installing
from a file system.
- 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:
- Administration -- /opt/ibm/edge/lb/admin
- Load Balancer components -- /opt/ibm/edge/lb/servers
- Metric Server -- /opt/ibm/edge/lb/ms
- Documentation (Administration Guide) -- /opt/ibm/edge/lb/documentation
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:
- 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.
- 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).
- 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:
- de_DE.iso88591
- en_US.iso88591
- es_ES.iso88591
- fr_FR.iso88591
- de_DE.iso88591
- it_IT.iso88591
- ja_JP.SJIS
- ko_KR.eucKR
- zh_CN.hp15CN
- zh_TW.big5
Instructions for installing the packages
The following procedure details the steps necessary to complete this task.
- Become the local superuser root.
su - root
Password: password
- 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
- 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:
- To uninstall all the Load Balancer packages
swremove ibmlb
To uninstall an individual package (for example the Cisco CSS Controller)
swremove ibmlb.cco
Load Balancer installation paths include the following:
- Administration -- /opt/ibm/edge/lb/admin
- Load Balancer components -- /opt/ibm/edge/lb/servers
- Metric Server -- /opt/ibm/edge/lb/ms
- Documentation (Administration Guide) -- /opt/ibm/edge/lb/documentation
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:
- You are logged in as root.
- Any earlier version of the product is uninstalled. To uninstall, ensure
that all the executors and all the servers are stopped. Then to uninstall
the entire product, enter the following command:
rpm -e pkgname
When
uninstalling, reverse the order used for package installation, ensuring that
the administration packages are uninstalled last.
Installation steps
- 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.
- 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:
- ibmlb-base-release-version.hardw.rpm
(Base)
- ibmlb-admin-release-version.hardw.rpm
(Administration)
- ibmlb-lic-release-version.hardw.rpm (License)
- ibmlb-component-release-version.hardw.rpm (LB component)
- ibmlb-doc-release-version.hardw.rpm (Documentation)
- ibmlb-ms-release-version.hardw.rpm (Metric
Server)
Where --
- release-version is the current release, for example:
6.1.0-0
- hardw is one of the following values:
i386, ppc64, ppc, s390, s390x, x86_64
- component is one of the following values: disp
(Dispatcher component), cbr (CBR component), ss (Site Selector component),
cco (Cisco CSS Controller), nal (Nortel Alteon Controller)
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.
- 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.
- Base (base)
- Administration (admin)
- License (lic)
- Load Balancer components (ds, cbr, ss, cco, nal)
- Metric Server (ms)
- Documentation (doc)
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
- Verify that the product is installed. Enter the following command:
rpm -qa | grep ibmlb
Installing the full product produces the following
output:
- ibmlb-base-release-version
- ibmlb-admin-release-version
- ibmlb-lic-release-version
- ibmlb-disp-release-version
- ibmlb-cbr-release-version
- ibmlb-ss-release-version
- ibmlb-cco-release-version
- ibmlb-nal-release-version
- ibmlb-doc-release-version
- ibmlb-ms-release-version
Load Balancer installation paths include the following:
- Administration -- /opt/ibm/edge/lb/admin
- Load Balancer components -- /opt/ibm/edge/lb/servers
- Metric Server -- /opt/ibm/edge/lb/ms
- Documentation -- /opt/ibm/edge/lb/documentation
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
- Insert the CD-ROM that contains the Load Balancer software into the appropriate
drive.
- 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.
- ibmlbbase (Base)
- ibmlbadm (Administration)
- ibmlblic (License)
- ibmlbdisp (Dispatcher component)
- ibmlbcbr (CBR component)
- ibmlbss (Site Selector component)
- ibmlbcco (Cisco CSS Controller component)
- ibmlbnal (Nortel Alteon Controller component)
- ibmlbdoc (Documentation)
- ibmlbms (Metric Server)
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.
- Verify that the product is installed. Issue the following command:
pkginfo | grep ibm
The Load Balancer installation paths include the following:
- Administration -- /opt/ibm/edge/lb/admin
- Load Balancer components -- /opt/ibm/edge/lb/servers
- Metric Server -- /opt/ibm/edge/lb/ms
- Documentation -- /opt/ibm/edge/lb/documentation