



IBM Communications Server v6.2.0.1 for Linux
INSTALLATION AND RELEASE NOTES
5724-I33




* (c) Copyright International Business Machines Corp. 2002, 2004
* All Rights Reserved
* Licensed Material - Property of IBM
*
* US Government Users Restricted Rights - Use, duplication or
* disclosure restricted by GSA ADP Schedule Contract with IBM Corp.




Table of Contents
-----------------
0. Third-party license terms and conditions, notices, and information
1.  About this release
1.1  New in this release
1.2  Product fix history
1.3  Product compatibility
2.  Installation information
2.1  Hardware requirements
2.2  Software requirements
2.2.1  Linux operating system version
2.2.2  Linux Streams (LiS) 2.16.18
2.2.3  OpenMOTIF
2.2.4  Java
2.2.5  SSL
2.3  Installation process
2.3.1  Installing the 6.2.0.0 base
2.3.2  Updating to the 6.2.0.1 PTF
3.  Uninstallation information
4.  Known limitations and problems
5.  Documentation updates
6.  Notices and trademarks




0. Third-party license terms and conditions, notices, and information
---------------------------------------------------------------------

The relevant terms and conditions, notices and other information
are provided in the "LICENSE.TXT" file in the 'drivers' subdirectory
on the installation
media for this product.  Please note that any non-English version
of the information in this file is unofficial and is provided
to you for your convenience only.  The English version of the
file is the official version.




1. About this release
---------------------

CS Linux provides SNA connectivity for 32-bit Intel
based Linux systems, allowing it to connect to IBM
z/OS Communications Server and other SNA implementations
that support Enterprise Extender and 802.2 connections.


1.1  New in this release
------------------------

This release includes enhancements for client applications
on Linux or Windows to use a TCP/IP network to access the
server functions.

For PTF 6.2.0.1, the TN3270E Server nows supports reporting the 
IP address information of client connections to the Host system
when the session initializes. See Technote(FAQ) "IP client resource
visibility for TN3270E Server LUs" at:

    http://www.ibm.com/support/docview.wss?uid=swg21192649 


1.2  Product fix history
------------------------

This release contains all the fixes for the CS/Linux v6.0.1.0 PRPQ.

Please check the web sites:
   http://www.ibm.com/software/network/commserver/linux
   http://www.ibm.com/software/network/commserver/support
for the latest information about this product.


1.3  Product compatibility
--------------------------

If you are using a RedHat Linux 2.1 distribution with
EE (HPR/IP) connections to z/OS, you should have the fix for
z/OS APAR PQ79197 applied to the z/OS system.

If you are using a RedHat Linux 2.1 distribution with
EE (HPR/IP) connections to z/OS v1r2, you should have the fix for
z/OS APAR PQ87818 applied to the z/OS system.

If you are using EE (HPR/IP) connections to z/OS v1r5,
you should have the fix for
z/OS APAR OA06668 applied to the z/OS system.


1.4  Viewing the Documentation
------------------------------

The CS Linux documentation is available on the
CD in the 'docs' subdirectory in PDF format.
The publication names and numbers map to the PDF
file names as shown below:

   Publication name                     Book number   PDF filename
   -----------------------------------  ------------  ------------
   Quick Beginnings                     GC31-6768-00  czx00100.pdf
   Quick Beginnings on zSeries          GC31-6769-00  czx00200.pdf
   Administration Command Reference     SC31-6770-00  czx00300.pdf
   Administration Guide                 SC31-6771-00  czx00400.pdf
   APPC Application Suite User's Guide  SC31-6772-00  czx00500.pdf
   APPC Programmer's Guide              SC31-6773-00  czx00600.pdf
   CPI-C Programmer's Guide             SC31-6774-00  czx00700.pdf
   CSV Programmer's Guide               SC31-6775-00  czx00800.pdf
   LUA Programmer's Guide               SC31-6776-00  czx00900.pdf
   MS Programmer's Guide                SC31-6777-00  czx01100.pdf
   NOF Programmer's Guide               SC31-6778-00  czx01200.pdf
   Diagnostics Guide                    GC31-6779-00  czx01300.pdf
   Glossary                             GC31-6780-00  czx01400.pdf

For Adobe Acrobat users on Windows, there is a zip file in the
docs subdirectory which contains the indices needed to enable
cross-manual searching.
To install this index:
   - copy the zip file to a Windows PC and un-zip it
   - from within Adobe Acrobat:
       Select Edit --> Search --> Select Indexes
       Within the index selection, add the CS Linux books.pdx file.
To perform a search:
   - Select Edit -->Search -->Query.
   - Select the index you want to search, in this case, CS Linux books.
   OR -- insert the term for which you want to search the library.
Search results will be across all the books in the library.


The CS Linux documentation is also available on the Internet at:

    http://www.ibm.com/software/network/commserver/library




2.  Installation information
----------------------------

The base 6.2.0.0 CS Linux product is packaged as a CD-ROM containing
a README file, the PDF documentation, several RPMs,
the install shell scripts, and licensing tool.

The 6.2.0.1 CS Linux PTF is shipped as a compressed tar file (tgz).
The tgz contains the update RPM and this README file.

This file has details for the server component of CS Linux.
If you are installing one of the client components of CS Linux
see the appropriate README file in the ibm-commserver-clients
subdirectories on the install media.


2.1  Hardware requirements
--------------------------

CS Linux requires Pentium II or later 32-bit Intel system
supported by one of the Linux distributions listed in section
2.2.1 Linux operating system version.

Use the 'uname -m' command to verify the CPU class.
It must report 'i686' to indicate a Pentium II or later system.


2.2  Software requirements
--------------------------

2.2.1  Linux operating system version
-------------------------------------

This version of CS Linux has been tested
with the following operating system versions.

  RedHat Enterprise Linux 2.1
  RedHat Enterprise Linux 3
  SuSE Linux Enterprise Server 8 (SLES8)


For each operating system version you also need to have loaded
a set of optional RPMs.  Some of these RPMs come from the Linux
install media and some need to be downloaded (the URLs or FTP sites
for the download sites are described later).  Each of the RPMs
which you need to download are noted with "(download)".  Use the
"rpm -q -a" command to see what packages are currently installed.


  RedHat Advanced Server 2.1
  --------------------------
    Required:
      kernel-headers-2.4.9-e.3
      kernel-source-2.4.9-e.3
      gcc-2.96-108.1
      make-3.79.1-8
      XFree86-libs-4.1.0-25
    Optional, needed for xsnaadmin:
      XFree86-4.1.0-25
      openmotif-2.2.2                (download)
    Optional, needed for SSL:
      libstdc++3-3.0.4-1
      libgcc-3.0.4-1
    Optional, needed for JavaCPI-C:
      IBMJava2-SDK                   (download)


  RedHat Advanced Server 2.1, Jun 2003 update (QU2)
  http://rhn.redhat.com/errata/RHSA-2003-195.html
  -------------------------------------------------
    Same as 'RedHat Advanced Server 2.1', plus:
      kernel-source-2.4.9-e.25       (download)
      kernel-headers-2.4.9-e.25      (download)
    and one or more of:
      kernel-summit-2.4.9-e.25       (download)
      kernel-enterprise-2.4.9-e.25   (download)
      kernel-smp-2.4.9-e.25          (download)
      kernel-2.4.9-e.25              (download)


  RedHat Enterprise Linux AS/ES/WS 2.1
  ------------------------------------
    Required:
      kernel-headers-2.4.9-e.12
      kernel-source-2.4.9-e.12
      gcc-2.96-116.7.2
      make-3.79.1-8
      XFree86-libs-4.1.0-44
    Optional, needed for xsnaadmin:
      XFree86-4.1.0-44
      openmotif-2.2.2                (download)
    Optional, needed for SSL:
      libstdc++3-3.0.4-1             (download)
      libgcc-3.0.4-1                 (download)
    Optional, needed for JavaCPI-C:
      IBMJava2-SDK-1.3.1-5


  RedHat Enterprise Linux AS/ES/WS 2.1, Jan 2004 update
  http://rhn.redhat.com/errata/RHSA-2003-419.html
  -----------------------------------------------------
    Same as 'RedHat Enterprise Linux AS/ES/WS 2.1', plus:
      kernel-source-2.4.9-e.35       (download)
      kernel-headers-2.4.9-e.35      (download)
    and one or more of:
      kernel-enterprise-2.4.9-e.35   (download)
      kernel-smp-2.4.9-e.35          (download)
      kernel-2.4.9-e.35              (download)


  RedHat Enterprise Linux AS/ES/WS 2.1, Apr 2004 update
  http://rhn.redhat.com/errata/RHSA-2004-105.html
  -----------------------------------------------------
    Same as 'RedHat Enterprise Linux AS/ES/WS 2.1', plus:
      kernel-source-2.4.9-e.40       (download)
      kernel-headers-2.4.9-e.40      (download)
    and one or more of:
      kernel-enterprise-2.4.9-e.40   (download)
      kernel-smp-2.4.9-e.40          (download)
      kernel-2.4.9-e.40              (download)


  RedHat Enterprise Linux AS/ES/WS 2.1, Aug 2004 update (QU5)
  http://rhn.redhat.com/errata/RHSA-2004-437.html
  -----------------------------------------------------
    Same as 'RedHat Enterprise Linux AS/ES/WS 2.1', plus:
      kernel-source-2.4.9-e.49       (download)
      kernel-headers-2.4.9-e.49      (download)
    and one or more of:
      kernel-enterprise-2.4.9-e.49   (download)
      kernel-smp-2.4.9-e.49          (download)
      kernel-2.4.9-e.49              (download)


  RedHat Enterprise Linux 3
  -------------------------
    Required:
      glibc-kernheaders-2.4-8.34
      kernel-source-2.4.21-4.EL
      gcc-3.2.3-20
      make-3.79.1-17
      XFree86-libs-4.3.0-35.EL
      rpm-4.2.1-4.4      (from http://rhn.redhat.com/errata/RHEA-2004-010.html)
    Optional, needed for xsnaadmin:
      XFree86-4.3.0-35.EL
      openmotif-2.2.2-16
    Optional, needed for SSL:
      libstdc++3-3.0.4-1             (download)
    Optional, needed for JavaCPI-C:
      IBMJava2-SDK-1.4.1-9


  RedHat Enterprise Linux 3, QU1
  http://rhn.redhat.com/errata/RHSA-2004-017.html
  -----------------------------------------------------
    Same as 'RedHat Enterprise Linux 3', plus:
      kernel-source-2.4.21-9.EL      (download)
    and one or more of:
      kernel-smp-2.4.21-9.EL         (download)
      kernel-2.4.21-9.EL             (download)


  RedHat Enterprise Linux 3, QU3
  http://rhn.redhat.com/errata/RHBA-2004-443.html
  -----------------------------------------------------
    Same as 'RedHat Enterprise Linux 3', plus:
      kernel-source-2.4.21-20.EL     (download)
    and one or more of:
      kernel-smp-2.4.21-20.EL        (download)
      kernel-2.4.21-20.EL            (download)


  SuSE Linux Enterprise Server 8 (SLES 8)
  ---------------------------------------
    Required:
      kernel-source-2.4.19.SuSE-82
      gcc-3.2-45
      make-3.79.1-407
      binutils-2.12.90.0.15-50
      glibc-devel-2.2.5-163
      xshared-4.2.0-188
    Optional, needed for xsnaadmin:
      xf86-4.2.0-188
      openmotif-2.2.2-124
    Optional, needed for SSL:
      libgcc-3.2-45
      libstdc++3-3.0.4-1             (download)
    Optional, needed for JavaCPI-C:
      IBMJava2-SDK-1.3.1-24


  SLES 8, Service Pack 1
  ----------------------
    Same as 'SLES 8', plus:
      kernel-source-2.4.19.SuSE-152.i586
    and one of:
      k_deflt-2.4.19-246
      k_smp-2.4.19-233
      k_psmp-2.4.19-239


  SLES 8, Service Pack 2
  -------------------------------------
    Same as 'SLES 8', plus:
      kernel-source-2.4.19.SuSE-290.i586
    and one of:
      k_deflt-2.4.19-290
      k_smp-2.4.19-290
      k_psmp-2.4.19-290


  SLES 8, Service Pack 2 HotFix (SP2a)
  ---------------------------------------------
    Same as 'SLES 8', plus:
      kernel-source-2.4.19.SuSE-304.i586
    and one of:
      k_deflt-2.4.19-304
      k_smp-2.4.19-304
      k_psmp-2.4.19-304


  SLES 8, Service Pack 3
  ---------------------------------------------
    Same as 'SLES 8', plus:
      kernel-source-2.4.21-138.i586
    and one of:
      k_deflt-2.4.21-138
      k_smp-2.4.21-138
      k_psmp-2.4.21-138


  SLES 8, Jan 2004 update
  http://www.suse.com/de/security/2004_01_linux_kernel.html
  ---------------------------------------------------------
    Same as 'SLES 8', plus:
      kernel-source-2.4.21.SuSE-169  (download)
    and one of:
      k_deflt-2.4.21-169             (download)
      k_smp-2.4.21-169               (download)
      k_psmp-2.4.21-169              (download)


  SLES 8, Apr 2004 update
  http://www.suse.com/de/security/2004_09_kernel.html
  ---------------------------------------------------------
    Same as 'SLES 8', plus:
      kernel-source-2.4.21.SuSE-203  (download)
    and one of:
      k_deflt-2.4.21-203             (download)
      k_smp-2.4.21-203               (download)
      k_psmp-2.4.21-203              (download)


  SLES 8, Service Pack 4
  ---------------------------------------------
    Same as 'SLES 8', plus:
      kernel-source-2.4.21-261.i586
    and one of:
      k_deflt-2.4.21-261
      k_smp-2.4.21-261
      k_psmp-2.4.21-261



2.2.2 Linux Streams (LiS) 2.16.18 plus patch
--------------------------------------------

CS Linux uses the LiS streams implementation
provided by the "LiS" open source project.
The 2.16.18 level is required plus a CS Linux v6.2 specific patch.
The 2.16.18 level should be used even if there are later
levels available, unless IBM support indicates otherwise.


If you already have a previous level of LiS installed
or you are about to apply the patch shipped with CS Linux 6.2.0.0
or are about to change the kernel you are running,
LiS should be completely uninstalled by doing:

    unset LD_PRELOAD
    PATH=$PATH:/sbin
    cd /usr/src/LiS
    make uninstall
    make very-clean
    cd
    rm -rf /usr/src/LiS /usr/src/LiS-2.16
    /sbin/shutdown -r now


If you are running SLES 8 with the k_smp or k_psmp kernel
you should run the following
commands to make sure the kernel source is consistent
with running kernel:

  cp -p /boot/vmlinuz.config /usr/src/linux-2.4.19.SuSE/.config
  cp -p /boot/vmlinuz.autoconf.h \
    /usr/src/linux-2.4.19.SuSE/include/linux/autoconf.h
  cp -p /boot/vmlinuz.version.h \
    /usr/src/linux-2.4.19.SuSE/include/linux/version.h
  mv /usr/src/linux-2.4.19.SuSE/.kversion \
    /usr/src/linux-2.4.19.SuSE/.kversion.save


If you are running SLES 8 SP1,SP2,SP2a with the k_smp or k_psmp kernel
you should run the following
commands to make sure the kernel source is consistent
with running kernel:

  cp -p /boot/vmlinuz.config /usr/src/linux-2.4.19.SuSE/.config
  cp -p /boot/vmlinuz.autoconf.h \
    /usr/src/linux-2.4.19.SuSE/include/linux/autoconf.h
  cp -p /boot/vmlinuz.version.h \
    /usr/src/linux-2.4.19.SuSE/include/linux/version.h
  mv /usr/src/linux-2.4.19.SuSE/.kversion \
    /usr/src/linux-2.4.19.SuSE/.kversion.save


If you are running SLES 8 Service Pack 3
you should run the following
commands to make sure the kernel source is consistent
with the running kernel:

  cd /usr/src/linux-2.4.21-138
  make clean
  make mrproper
  make cloneconfig
  make dep


If you are running SLES8 with the Jan 2004 update
you should run the following
commands to make sure the kernel source is consistent
with the running kernel:

  cd /
  cat kernel-source-2.4.21-169.tar.bz2 | /usr/bin/bunzip2 | tar -xf -
  cd /usr/src/linux-2.4.21-169
  make clean
  make mrproper
  make cloneconfig
  make dep


If you are running SLES8 with the Apr 2004 update
you should run the following
commands to make sure the kernel source is consistent
with the running kernel:

  cd /usr/src/linux-2.4.21-203
  make clean
  make mrproper
  make cloneconfig
  make dep


The LiS package can be obtained from the following URL:

    ftp://ftp.gcom.com/pub/linux/src/LiS/LiS-2.16.18.tgz

The LiS-2.16.18-CS62.patch file is on the CS Linux CD.
Now copy the LiS-2.16.18.tgz and LiS-2.16.18-CS62.patch files
to the /usr/src directory on your Linux system.
Make sure to use binary mode if you FTP the tgz file.


Execute the following commands to unpack LiS:

    cd /usr/src
    tar -xzf LiS-2.16.18.tgz


Apply the patch by running the commands:

    cd /usr/src/LiS-2.16
    patch -g0 -p1 < ../LiS-2.16.18-CS62.patch


Execute the following commands to build LiS:

    PATH=$PATH:/sbin
    cd /usr/src/LiS-2.16
    make
      Select the default answer to all the questions
    make install
    insmod streams


See http://www.gcom.com/LiS/index.html for more information on LiS.



2.2.3 OpenMOTIF
---------------

The CS Linux administration GUI ('xsnaadmin') uses the
MOTIF implementation from the Open group at the 2.2 level.
This is not required for the command-line administration tool ('snaadmin').

For SLES 8 and RedHat Enterprise Linux 3
this is the 'openmotif-2.2.2' RPM on the Linux CDs.

For RedHat AS2.1 or RedHat EL2.1 this is available from
    http://www.motifzone.org/download
or other open source sites.  In testing we used this RPM:
    http://ftp.motifzone.net/om2.2/linux-rpm/x86/openmotif-2.2.2-3_ICS.i386.rpm

Once you have copied the RPM file to your Linux
system issue a command like the following to install it:
    rpm -i --force openmotif-2.2.2-3_ICS.i386.rpm
or
    rpm -U openmotif-2.2.2-3_ICS.i386.rpm

The '--force' flag would be used if you already had the
'lesstif' package from RedHat 7.2 installed or an 'openmotif21'
package which was used by previous levels of CS Linux.
The '-U' flag would be used if you already had an 'openmotif-2.1'
RPM installed, which was used by previous levels of CS Linux.

If you are using the QU3 or later release of RedHat Enterprise Linux 3,
you may see the following message during installation:
  Open Motif 2.2.2 is not installed (see README for details)
  CS Linux will install, but you will not be able to run xsnaadmin
This message can be ignored and xsnaadmin will still run.




2.2.4 Java
----------

A Java may be needed for CS Linux if you use the JavaCPI-C API.
Using the latest Java 1.4.1 SDK from the web site below satisfies
all the requirements.

    http://www.ibm.com/developerworks/java/jdk

For RedHat Enterprise Linux 3, use the IBMJava2-SDK-1.4.1-9.s390.rpm
from the Linux install media.

Install the Java SDK package with a command like:

    rpm -i IBMJava2-SDK-1.4.1-1.0.i386.rpm


For RedHat Enterprise Linux 3 use the IBMJava2-SDK-1.4.1-9 RPM
from the RedHat Enterprise Linux 3 install CDs.

For RedHat Enterprise Linux 3
which uses the 2.4.20 or later kernels,
you might also have to run:
    export LD_ASSUME_KERNEL=2.4.1
in order to use the current Java RPMs with those Linux distributions.



2.2.5 SSL
---------

If you plan on using SSL with the CS Linux TN3270 server,
you will first need to install the optional RPMs:

  RedHat Enterprise Linux AS/ES/WS 2.1
  ------------------------------------
    libstdc++3-3.0.4-1
    libgcc-3.0.4-1

    These packages are available at:
      ftp://rpmfind.net/linux/redhat/updates/7.2/en/os/
        i386/libstdc++3-3.0.4-1.i386.rpm
      ftp://rpmfind.net/linux/redhat/updates/7.2/en/os/
        i386/libgcc-3.0.4-1.i386.rpm

  RedHat Enterprise Linux 3
  ------------------------------------
    libstdc++3-3.0.4-1

    This package is available at:
      ftp://rpmfind.net/linux/redhat/updates/7.2/en/os/
        i386/libstdc++3-3.0.4-1.i386.rpm

  SLES 8 (all versions)
  ------------------------------
    libgcc-3.2-45
    libstdc++3-3.0.4-1

    The libstdc++ package is available at:
      ftp://rpmfind.net/linux/redhat/updates/7.2/en/os/
        i386/libstdc++3-3.0.4-1.i386.rpm


If the prerequistite RPMs are already installed when CS Linux is
installed, then the gskit RPM (gsk6bas-6.0-5.39.i386.rpm) will be
automatically installed at that time.  In addition, various necessary
updates to the Java config and file locations are made.

If the prerequistite RPMs are not installed when CS Linux is installed
and at a later time you wish to install the gskit toolkit and co-requisite
updates, follow these instructions.

-  Log into the machine as root.

-  Mount the CD and issue the following command to install gskit

     For RedHat:

         mount /dev/cdrom
         cd /mnt/cdrom
         ./installgskit

     For SuSE:

         mount /dev/cdrom
         cd /media/cdrom
         ./installgskit

The key manager function of gskit requires a customized
Java 1.4.1 JRE, which is shipped as part of the CS Linux on zSeries RPM.
To invoke the key manager, just type:

    snakeyman



2.3 Installation process
------------------------

2.3.1 Installing the 6.2.0.0 base 
---------------------------------

If you already have CS Linux v6.2.0.0 installed, proceed to section 2.3.2.

The 6.2.0.0 level must be installed before the 6.2.0.1 PTF.

If you have a previous level of CS Linux already installed, follow
the steps in section 3 to remove it before installing the 6.2.0.0 level.

To install CS Linux follow these instructions.

-  Log into the machine as root.

-  Mount the CD and make it the current directory

     For RedHat:

         mount /dev/cdrom
         cd /mnt/cdrom

     For SuSE:

         mount /dev/cdrom
         cd /media/cdrom

-  Run the installibmcs shell script

       ./installibmcs

   The installibmcs shell script will test for certain
   pre-requisites and issue warning messages if they are
   not met.  You will be prompted to read and accept the
   license agreement.  You will then prompted for the name
   of the server that will be the master server in the CS Linux
   domain.  If you want to run CS Linux as a standalone node,
   do not specify this parameter.  Once the prompts have
   been answered the installibmcs tool will install the RPMs.

   You can convert the node from standalone to being in a domain
   and visa-versa at a later time using the snanetutil command.

-  Add the CS Linux binary directories to your PATH.
   You may wish to change your profile to do this automatically.

       export PATH="$PATH:/opt/ibm/sna/bin:/opt/ibm/sna/bin/X11"
       export LD_LIBRARY_PATH=/usr/lib:/opt/ibm/sna/lib
       export LD_RUN_PATH=/usr/lib:/opt/ibm/sna/lib

   For Java CPI-C applications you should
   also set the environment variable:

       export CLASSPATH=$CLASSPATH:/opt/ibm/sna/java/cpic.jar

   For some applications you may also need to set the LD_PRELOAD
   environment variable, but you should not make this a global change:

       export LD_PRELOAD=/usr/lib/libpLiS.so


-  Start CS Linux.  After installation this will
   happen automatically when the machine is rebooted.
   Make sure you are not still in the
   CD's directories when this is done.

       cd /
       sna start

   For machines with limited memory a reboot may be required.
   For larger systems this may not be needed.  If the CS Linux node
   fails to start, check the /var/log/messages file for an entry like:
      kernel: SNA Trace Driver can only get X blocks of memory - please reboot
   If these messages persist even after rebooting you need more memory
   or you need to reduce the number of kernel modules.

-  Run the CS Linux MOTIF administration tool. We strongly
   recommend you use the Motif administration program until
   you are familiar with CS Linux operation.  Simply follow
   the instructions you are given.

   You may use a remote XWindows server instead of graphics mode
   on the Linux system.  On the XWindows server, run:

       xhost +XX

   where XX is the TCP/IP name or address of the Linux system.

   Now tell the xsnaadmin client where the server is and start it up:

       export DISPLAY=YY:Z
       xsnaadmin &

   where YY is the TCP/IP name or address of the XWindows server
   and Z is the virtual display number (typically '0').


2.3.2 Updating to the 6.2.0.1 PTF
---------------------------------

The 6.2.0.0 level must be installed before the 6.2.0.1 PTF.
See section 2.3.1 for instruction on installing the 6.2.0.0 base release.

-  Download the 6.2.0.1 PTF tgz package from:

       ftp://ps.software.ibm.com/ps/products/cslinux/fixes/v6201

   then uncompress and un-tar it:

       mkdir /tmp/ibmcs
       cd /tmp/ibmcs
       tar -xzf ibm-commserver-6.2.0.1.i386.tgz

-  Install the 6.2.0.1 RPM with the command:

       rpm -Uhv ibm-commserver-6.2.0.1-1.i386.rpm

-  Restart CS Linux with the commands:

       cd /
       sna start


2.3.3 Post-install cleanup
--------------------------

   When you are done with the installs, the tgz file and
   temporary directory created in section 2.3.2 may be erased.



3. Uninstallation information
-----------------------------

The CS Linux packages can be removed with the following commands:

    /opt/ibm/sna/bin/sna stop
    rpm -e ibm-commserver-ptf
    rpm -e ibm-commserver-docs
    rpm -e ibm-commserver-ecl
    rpm -e ibm-commserver-cli
    rpm -e ibm-commserver
    /sbin/shutdown -r now

Not all of these packages will be installed on every system.




4.  Known limitations and problems
----------------------------------

4.1 Connectivity Options
------------------------

CS Linux can be used over Ethernet or Token Ring adapters.

CS Linux has been tested with several different ethernet adapters
using several different Linux device drivers.

CS Linux has been tested with the IBM 16/4 PCI token ring adapter
(olympic driver) and the IBM LANStreamer adapter (lanstreamer driver).
Other adapters (such as Madge) using these or other drivers are also
expected to work.

See the web site
    http://www.ibm.com/software/network/commserver/linux/sysreq
for a complete list of adapters and drivers which have been tested.


If you want to use an adapter for CS Linux but not for TCP/IP,
you have to manually tell Linux to load the device driver and
enable the adapter.  For RedHat this is done by having an
entry in the /etc/modules.conf file for that adapter and modifying
the appropriate /etc/sysconfig/network-scripts/ifcfg-* file to
look something like this:

    DEVICE=eth1
    ONBOOT=yes
    BOOTPROTO=none

For SuSE this is done by having an entry in the
/etc/modules.conf file for that adapter and modifying
the appropriate /etc/sysconfig/network/ifcfg-* file to
look something like this:

    DEVICE=eth1
    BOOTPROTO="none"
    STARTMODE="onboot"



4.2 TN3270 Server
-----------------

The CS Linux TNServer is limited to a certain number
of open files/sockets.  The actual limit
depends on how much memory the Linux system has available.
Use the 'cat /proc/sys/fs/file-max' command to see
what the current limit is.  For any value of file-max
you must have:

  ( (#_of_ReDir_clients * 2) + #_of_TN3270_clients ) < file-max

This limit can be increased by following the instructions in:
    /usr/src/linux*/Documentation/filesystems/proc.txt
in the section titled "file-nr and file-max".

If the customer hits this limit they will see this in /var/opt/ibm/sna/sna.err:
  hh:mm:ss TZ dd mmm yyyy 4102-6(0-1) E (hostname) PID pid# (snatnsrvr_mt)
  O/S accept call failed with error code 23.
  hh:mm:ss TZ dd mmm yyyy 4102-8(1-1) E (hostname) PID pid# (snatnsrvr_mt)
  Failed to initialize TN3270 or TN Redirector Client due to serious error.


4.3 Number of concurrent LUA+APPC+CPI-C+NOF applications
--------------------------------------------------------

There is an O/S limit that prevents more than 255 open Streams
(i.e. applications) on CS Linux at once.  CS Linux itself uses
some of these streams internally.  That means the total number
of concurrent LUA+APPC+CPI-C+NOF applications must be less than
about 230.  A single application can have multiple SNA sessions
open and that only counts as 1 open stream.

If the customer hits this limit they will see this in /var/opt/ibm/sna/sna.err:
  hh:mm:ss TZ dd mmm yyyy 16388-10(1-0) E (hostname) PID pid# (application)
  Error opening Stream to SNA kernel subsystem.
  Errno = 28 (No space left on device)
  hh:mm:ss TZ dd mmm yyyy 16385-6(1-10) E (hostname)
  SNA Kernel open error 28.


4.5 Using applications and TPs built on older levels
----------------------------------------------------

There are two issues when trying to use applications and TPs that
were compiled on older levels of Linux, CS Linux and LiS.

a) The level of LiS which is required for this release
   may also require that you set the environment variable:
     export LD_PRELOAD=/usr/lib/libpLiS.so
   for old applications and TPs to work properly.

b) Some new distributions are based on a Linux kernel
   level (2.4.20 or later) which includes a new threading model.
   You may have to recompile your applications on these
   distributions for them to work properly or you may be
   able to set the environment variable:
      export LD_ASSUME_KERNEL=2.4.1
   to force the old threading model.




5.  Documentation updates
--------------------

CS Linux comes with the common set of applications from
the APPC Application Suite:
  aping
  acopy, aftp, aftpd
  atell, atelld
  aname, anamed
  arexec, arexecd

The invokable TP definitions for these applications
are in /etc/opt/ibm/sna/asuite.tps.  These can be activated
with the command:

  /opt/ibm/sna/bin/snatpinstall -a /etc/opt/ibm/sna/asuite.tps


CS Linux also comes with a few sample source code
programs in /opt/ibm/sna/samples which you can compile.
Examples of the configuration, compile and run steps are below.
More details are in the appropriate "Programmer's Guide"
for each API.



- "asample"
   snaadmin define_mode, mode_name=LOCMODE
   snaadmin define_local_lu, lu_alias=TPLU1, lu_name=TPLU1
   snaadmin define_local_lu, lu_alias=TPLU2, lu_name=TPLU2
   cd /opt/ibm/sna/samples
   gcc -o asample2 -I /opt/ibm/sna/include \
      -L /opt/ibm/sna/lib -lappc -lsna -lcsv -lpLiS asample2.c
   gcc -o asample1 -I /opt/ibm/sna/include \
      -L /opt/ibm/sna/lib -lappc -lsna -lcsv -lpLiS asample1.c
   ./asample2 &
   ./asample1 /etc/hosts



- "csample"
   snaadmin define_mode, mode_name=LOCMODE
   snaadmin define_local_lu, lu_alias=TPLU1, lu_name=TPLU1
   snaadmin define_local_lu, lu_alias=TPLU2, lu_name=TPLU2
   snaadmin define_cpic_side_info, sym_dest_name=CPICTEST, \
     lu_alias=TPLU1, partner_lu_name=TPLU2, tp_name=TPNAME2, \
     mode_name=LOCMODE
   snaadmin define_tp, tp_name=TPNAME2
   snaadmin define_tp_load_info, tp_name=TPNAME2, userid=root, \
     path=/opt/ibm/sna/samples/csample2, type=QUEUED, \
     env=APPCTPN=TPNAME2, env=APPCLLU=TPLU2, \
     env=LD_LIBRARY_PATH=/usr/lib:/opt/ibm/sna/lib|LD_RUN_PATH=/usr/lib:/opt/ibm/sna/lib
   cd /opt/ibm/sna/samples
   gcc -o csample2 -I /opt/ibm/sna/include \
      -L /opt/ibm/sna/lib -lcpic -lappc -lsna -lcsv -lnof -lpLiS csample2.c
   gcc -o csample1 -I /opt/ibm/sna/include \
      -L /opt/ibm/sna/lib -lcpic -lappc -lsna -lcsv -lnof -lpLiS csample1.c
   chmod ugo+s csample2
   export APPCLLU=TPLU1
   export APPCTPN=TPNAME1
   ./csample1 /etc/hosts
   unset APPCLLU
   unset APPCTPN



- "lsample"
   snaadmin define_*_dlc, ...
   snaadmin define_*_port, ...
   snaadmin define_*_ls, ...
   snaadmin define_internal_pu, ...
   snaadmin define_lu_0_to_3, ...
   cd /opt/ibm/sna/samples
   gcc -o lsample -I /opt/ibm/sna/include \
      -L /opt/ibm/sna/lib -llua -lsna -lcsv -lpLiS lsample.c
   export SNATBLG=/opt/ibm/sna/samples/luatblg.dat
   ./lsample LUNAME



- "JPing"
   rpm -q -a | grep Java
      make sure the Java SDK is installed
   snaadmin define_node, ...
   snaadmin define_cpic_side_info, sym_dest_name=SIDE, ...
   PATH=/opt/IBMJava2-141/jre/bin:/opt/IBMJava2-141/bin:$PATH
   export LD_LIBRARY_PATH=/usr/lib:/opt/ibm/sna/lib
   export CLASSPATH=$CLASSPATH:/opt/ibm/sna/java/cpic.jar
   export LD_PRELOAD=/usr/lib/libpLiS.so
   cd /opt/ibm/sna/samples
   javac JPing.java
   java JPing SIDE
   unset LD_PRELOAD




6.  Notices and trademarks
--------------------------

6.1 Notices
-----------

This information was developed for products
and services offered in the U.S.A.

IBM may not offer the products, services, or features discussed
in this document in other countries. Consult your local IBM
representative for information on the products and services
currently available in your area.

Any reference to an IBM product, program, or service is not
intended to state or imply that only that IBM product,
program, or service may be used.  Any functionally equivalent
product, program, or service that does not infringe any
IBM intellectual property right may be used instead.
However, it is the user's responsibility to evaluate and
verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering
subject matter described in this document.  The furnishing
of this document does not give you any license to these patents.
You can send license inquiries, in writing, to:

IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

For license inquiries regarding double-byte (DBCS) information,
contact the IBM Intellectual Property Department in your country
or send inquiries, in writing, to:

IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan

The following paragraph does not apply to the United Kingdom or any
other country where such provisions are inconsistent with local law:
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES
THIS PUBLICATION AS IS WITHOUT WARRANTY OF ANY KIND,
EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
THE IMPLIED WARRANTIES OF NON-INFRINGEMENT,
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Some states do not allow disclaimer of express or implied warranties in
certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or
typographical errors.  Changes are periodically made to
the information herein; these changes will be incorporated
in new editions of the publication. IBM may make improvements
and/or changes in the product(s) and/or the program(s) described
in this publication at any time without notice.

IBM may use or distribute any of the information you supply in any
way it believes appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the
purpose of enabling: (i) the exchange of information between independently
created programs and other programs (including this one) and (ii) the
mutual use of the information which has been exchanged, should contact:

IBM Corporation
P.O. Box 12195
3039 Cornwallis Road
Research Triangle Park, NC 27709-2195
U.S.A.

Such information may be available, subject to appropriate terms
and conditions, including in some cases, payment of a fee.

The licensed program described in this information and all licensed
material available for it are provided by IBM under terms of the
IBM Customer Agreement, IBM International Program License Agreement,
or any equivalent agreement between us.


Trademarks
----------

The following terms are trademarks of the IBM Corporation
in the United States or other countries or both:

 ACF/VTAM
 Advanced Peer-to-Peer Networking
 Application System/400
 APPN
 AS/400
 eServer
 IBM
 S/390
 VTAM
 zSeries


The following terms are trademarks or registered trademarks of other
companies:

Java and all Java-based trademarks are trademarks of Sun Microsystems,
Inc., in the United States, other countries, or both.

UNIX is a registered trademark in the United States and other countries
licensed exclusively through The Open Group.

Intel is a trademark of Intel Corporation.

Linux is a trademark of Linus Torvalds.

RedHat and RPM are trademarks of Red Hat, Inc.

SuSE Linux is a trademark of SuSE Linux AG.

UnitedLinux is a trademark of UnitedLinux LLC.

Microsoft, Windows, Windows NT, Windows 2003, and the Windows logo are
trademarks of Microsoft Corporation in the United States, other countries,
or both.

Other company, product, and service names may be trademarks or service
marks of others.

