Performance Endpoint for Linux
File README
Version 5.1
Copyright (C) 1995-2006 NetIQ Corporation.
All rights reserved.
NetIQ Corporation
4825 Creekstone Drive
Suite 400
Durham, North Carolina 27703 U.S.A.
Web: www.netiq.com/support
phone: North and South America: (toll) 1-713-418-5555
Europe, Middle East, Africa: (toll) 353 (0) 91-782 677
Other countries: (toll) 1-713-418-5540
Technical support:
email: support@netiq.com
Thanks!
We appreciate your interest in our software. We keep seeking
ways to improve it; we welcome your feedback and suggestions.
We continue to enhance and expand our Web site -- come and
visit us.
The latest versions of the endpoints are always available for
free at www.netiq.com/download/endpoints
Linux Kernel 2.0
__________________________________________________________________
We've tested with packages that implement Linux kernel 2.0. We have not tested this version of Performance Endpoint with earlier versions of the Linux kernel. Red Hat 5.0, kernel 2.0.32 is required for IP Multicast support.
TCP and UDP Support
__________________________________________________________________
The Performance Endpoint for Linux uses the Sockets interface to the TCP/IP support shipped with Linux. APPC, IPX, SPX, or other network protocols are not supported in this version.
IP Address Needed for Traceroute Scripts
__________________________________________________________________
If you're using the Networks-RT Traceroute or Action Traceroute
Knowledge Scripts, the endpoint needs to know the IP address of
the proxy computer. If you discovered the computer as a proxy
using hostname, you must configure the \etc\hosts file so that the
proxy computer resolves to an IP address other than localhost.
Configuration is necessary because the IP header for the
traceroute tests is built based on the resolved IP address.
Configuration is not necessary for any other Networks-RT Knowledge
Scripts because the header is built by the IP stack.
If you discovered the computer as a proxy using the IP address
(instead of hostname), then no other configuration is needed.
Installation Requirements
__________________________________________________________________
Here's what you need to run the endpoint program with Linux:
- A computer capable of running Linux well.
For Cobalt servers: the RaQ3 system, which uses an Intel x86
processor, gives good performance.
For x64 computers: AMD Opeteron 64-bit systems or Intel Xeon
64-bit systems
For x86 computers: a CPU such as an Intel 80386, 80486, a member
of the Pentium family, or equivalent. A Pentium or better is
recommended.
- 16 MBytes of random access memory (RAM).
The total RAM requirement depends on RAM usage of the
underlying protocol stack and the number of concurrent
endpoint pairs. For tests involving more than 100
connections through a single endpoint, additional memory may
be required.
- A hard disk with at least 8 MBytes of space available
- Linux kernel 2.0 with "pthreads support" (which is at least
version 2.0.6 of glibc). TCP/IP networking and corresponding
networking hardware must be installed and configured, plus
ELF support. We have tested with Red Hat (kernel 2.0.32).
TAR-Based Endpoint Installation for Linux
__________________________________________________________________
Use the TAR-based installation if you are installing the endpoint on any Linux platform other than Red Hat or Cobalt.
First, make sure that you are logged in as a "root" user. Also
remember all commands and parameters discussed here are case-sensitive. Use the combination of uppercase and lowercase
letters as shown below.
The following instructions describe how to install the endpoint
on a computer with a CD-ROM drive. Put the CD-ROM in your
CD-ROM drive.
Enter the following commands, assuming your CD-ROM drive device
name is /dev/cdrom and you are able to create a temporary
directory named cdrom:
mkdir /cdrom
mount /dev/cdrom /cdrom
The CD-ROM contains an archive of the endpoint package. Use the
rm command to ensure a clean temporary install directory. Then
use the tar command to extract the archive contents from the
CD-ROM:
cd /tmp
rm -fr temp
tar -xvf /cdrom/endpoint/linux/endlnxr.tar
You will see the license agreement, presented with the more command. Press the spacebar until the end of the agreement is displayed. You are asked whether you accept the terms and conditions of the agreement. If you do, enter accept_license.
After the installation is complete, use the UMOUNT command to unmount the file system from the CD-ROM:
umount /cdrom
During installation, you will see several status messages. Pay
close attention to the output. When the installation is
successful, you see the message "Installation of endpoint was
successful."
The installation script and temporary directory are not removed
automatically if the installation is successful. If you need the disk space after installing the endpoint, delete the temporary directory and installation script.
Unattended Installation for TAR-Based Linux
___________________________________________________________________
You can install the endpoint silently, that is, without providing any additional user input. Complete the steps, as described above, through the TAR command. Next, run the endpoint installation, adding the "accept_license" parameter:
./endpoint.install accept_license
Removing the TAR-Based Endpoint Package
___________________________________________________________________
You must be logged in as the root user to remove the endpoint
package. If you need to remove the endpoint package from your hard disk, first stop the endpoint program (if running). Enter the following command:
/usr/local/NetIQ/endpoint -k
Use the following command to remove the endpoint:
/usr/local/NetIQ/endpoint.remove
If the removal is successful, you will see the following: "Removal of endpoint was successful." This removes the files from /usr/local/NetIQ, except for any files added to this directory that were not present at install, such as the endpoint.ini file, but does not delete the directory. The remove program does not automatically delete files added to the directory that you may need if you reinstall the product.
RPM-Based Endpoint Installation for Linux
___________________________________________________________________
Use the RPM-based installation if you are installing the endpoint on Red Hat Linux.
For installation, first make sure that you are logged in as a "root" user. Also remember all commands and parameters discussed here are case-sensitive. Use the combination of uppercase and lowercase letters as shown below.
The following instructions describe how to install the endpoint on a computer with a CD-ROM drive. Put the CD-ROM in your CD-ROM drive.
Enter the following commands, assuming your CD-ROM drive device name is /dev/cdrom and you are able to create a temporary directory named cdrom:
mkdir /cdrom
mount /dev/cdrom /cdrom
Copy the endlnxr.rpm file from the CD-ROM drive to a local directory (for example, tmp).
cp /cdrom/endpoint/linux/endlnxr.rpm /tmp
For RPM, use the RPM command to install the endpoint:
rpm -Uvh /tmp/endlnxr.rpm
After the installation is complete, use the UMOUNT command to unmount the file system from the CD-ROM:
umount /cdrom
During installation, you will see several status messages. Pay close attention to the output. When the installation is successful, you see the message "Installation of endpoint was successful."
Removing the RPM-Based Endpoint Package
__________________________________________________________________
You must be logged in as the root user to remove the endpoint
package. If you need to remove the endpoint package from your hard disk, first stop the endpoint program (if running). Enter the following command:
/usr/local/NetIQ/endpoint -k
Use the following command to remove the endpoint (you must be logged in as root to run this program):
rpm -e endpoint
If the removal is successful, you will see the following: "Removal of endpoint was successful." This removes the files from /usr/local/NetIQ, except for any files that were added to this directory that were not present at install, such as the endpoint.ini file, and does not delete the directory. The remove program does not automatically delete files added to the directory that you may need if you reinstall the product.
Cobalt-Based Endpoint Installation for Linux
___________________________________________________________________
Use the Cobalt installation if you are installing the endpoint on a Cobalt Web Server. The endpoint is installed from a computer on the same network as the Cobalt Web Server.
Typically, when you install an endpoint, you can automatically upgrade from the previous version of the endpoint. However, when you抮e upgrading the endpoint on a Cobalt RaQ 3 (x86) computer, you must first remove the previous version of the endpoint, following the directions in 揜emoving the Cobalt Endpoint Package?below. Then install the new version of the endpoint.
These instructions are for installing on the Cobalt Web Server from a Web browser running on a Linux computer. Note that you can install the endpoint from computers running other platforms. In these cases, follow the instructions below, omitting the step to mount the CD-ROM if this is not required by your OS.
Put the CD-ROM in your CD-ROM drive.
Enter the following commands, assuming your CD-ROM drive device name is /dev/cdrom and you are able to create a temporary directory named cdrom:
mkdir /cdrom
mount /dev/cdrom /cdrom
Access the Welcome to Cobalt page on the Cobalt Web Server. By
default, this page is available by browsing at the Cobalt Web Server's home page. If it is not, contact your Cobalt Web Server administrator. Click on the link to the RAQ Server Management section. The User Name and Password Required dialog is displayed.
Enter the username and password for Administrator. The Server
Management Page is shown.
Click the Maintenance button and then click the Install Software button. In the Software to install field, enter the location of the package. If you are using the Browse function, make sure that the filename and extension are in lowercase.
/cdrom/endpoint/linux/endcbl3.pkg
If prompted, enter the password for Administrator. Click the Install a '.pkg' package button. During installation, you should see status messages.
After the endpoint is installed, a message stating that the endpoint has been installed is shown. If you do not get this message, go to the server management panel and browse the box entitled "Software on the Cobalt Server." This contains a list of products installed on the Cobalt computer. You should see a line "Performance Endpoint X.X" where X.X is the release number of the Performance Endpoint.
After the installation is complete, use the UMOUNT command to unmount the file system from the CD-ROM:
umount /cdrom
The installation script and temporary directory are not removed
automatically if the installation is successful. If you need the disk space after installing the endpoint, you can delete the temporary directory and installation script.
Removing the Cobalt-Based Endpoint Package
___________________________________________________________________
You must be logged in as the root user to remove the endpoint package. Do not use the RPM command to remove the Cobalt Endpoint.
Enter the following command at a command prompt:
/bin/sh /var/lib/cobalt/uninstallers/endpoint-x.y.uninst
(where x.y is the endpoint version numner)
Note that the endpoint version number is included as part of the
command. This is all that is required for RaQ3 products.
What Happens During Installation
__________________________________________________________________
Here is what happens during the installation steps. The endpoint is installed into the directory /usr/local/NetIQ. A directory is created with the following contents:
- the executable programs.
- the README file.
- various install and uninstall programs.
- the directory cmpfiles. This directory contains files with
the .cmp file extension. These are files containing data of
different types, such as typical text or binary data. These
files are used by the endpoint as data on SEND commands. The
different data types can be used to vary the data compression
performance of your network hardware and software.
- the file endpoint.ini.
Our software ends any copy of the endpoint program currently
running and starts a copy of the newly-installed endpoint. You can run tests immediately, without a reboot.
Our software displays information on how to update your system to have the endpoint start automatically upon reboot.
No changes are made to the PATH environment variable of the root user.