Performance Endpoint for Linux/ia64
File README
Version 4.4

Copyright (C) 1995-2002 NetIQ Corporation.
All rights reserved.

NetIQ Corporation
1100 Perimeter Park Drive
Suite 104
Morrisville, North Carolina  27560   U.S.A.
     Web:  www.netiq.com
   phone:  919-469-0997 or 888-426-9633
     fax:  919-469-5553

General information:
  email:  networkinfo@netiq.com

Technical support:
  email:  network-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.4

  We've tested with TurboLinux Frontier IA-64 Beta 3 (2001-03-07)
  which implements Linux kernel 2.4, on an Intel Itanium step A-3.


TCP, RTP, and UDP support only

  The Performance Endpoint for Linux/ia64 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.


TAR-based installation only

  RPM-based installation is not available at present.

-------------------------------------------------------------------
Hardware Requirements
-------------------------------------------------------------------

Here's what you need to run the endpoint program with Linux/ia64:

  - A computer capable of running Linux/ia64 well.  This implies a
    64-bit CPU such as an Intel Itanium processor.

  - At least 16 MBytes of random access memory (RAM).  We have
    tested on an Intel Itanium processor with 1 GByte of random
    access memory (RAM).  16 MBytes was sufficient for 32-bit Linux
    platforms.  The final memory requirements for 64-bit Linux
    are still being investigated.

    The total RAM requirement depends on RAM usage of the
    underlying protocol stack and the number of concurrent
    endpoint pairs.  For tests involving over one hundred
    connections through a single endpoint, additional memory may
    be required.

  - A hard disk with at least 24 MBytes of space available.

  - Linux kernel 2.4 with "pthreads support."  TCP/IP networking
    and corresponding networking hardware must be installed and
    configured, plus ELF support.  We have tested with TurboLinux
    (kernel 2.4.0test7-42).


-------------------------------------------------------------------
TAR-Based Endpoint Installation for Linux/ia64
-------------------------------------------------------------------

  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.  First
  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/linux64/endl64r.tar

  Next, run the endpoint's installation script to install the
  endpoint:

    ./endpoint.install

  The license agreement is shown, presented with the "more"
  command.  Press the space bar 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, you may delete
  the temporary directory and installation script.


Unattended Installation for TAR-Based Linux/ia64
-------------------------------------------------------------------

  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's installation, adding the "accept_license" parameter:

    ./endpoint.install accept_license


Removing the TAR-Based Endpoint Package (Uninstall)
-------------------------------------------------------------------

  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.


-------------------------------------------------------------------
What We Do 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 test 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 restarting.

  Our software displays information on how to update your system
  to have the endpoint start automatically upon restarting the
  computer.

  No changes are made to the PATH environment variable of the
  root user.


Additional Notes
-----------------------------------------------

Try Qcheck!

  This endpoint works well with Qcheck, our free network testing
  utility.  Qcheck is available on the Web:

     www.Qcheck.net


* NetIQ, Chariot, Ganymede, Ganymede Software, and Qcheck are
  registered trademarks, and End2End and Pegasus are trademarks
  of NetIQ Corporation.  United States Patent Numbers
  5,838,919, 5,881,237, 5,937,165, and 6,061,725.  Other patents
  pending.
