IBM Remote API Client for AIX v6.3.1.0 INSTALLATION AND RELEASE NOTES 5724-I33, 5724-I34, 5765-E51 * © Copyright International Business Machines Corp. 2005, 2007 * 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 ----------------- 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 Operating system version 2.2.2 Java 2.2.3 HTTPS 2.3 Installation process 3. Uninstallation information 4. Known limitations and problems 5. Documentation updates 6. Notices and trademarks 1. About this release ---------------------- IBM Remote API Client for AIX provides a remote SNA API for pSeries AIX v5 systems, allowing it to connect to a domain of IBM Communications Server for Linux v6.2 (or later) servers or a domain of CS/AIX v6.3 (or later) servers via TCP/IP. The APIs supported by the IBM Remote API Client for AIX are those documented in the Communications Server for Linux and CS/AIX v6.3 manuals. The old CS/AIX v4.2 APIs are not supported. 1.1 New in this release ------------------------ This release includes enhancements for: - IPv6 support - NOF Indications for Remote API Clients - Filtering Logging (see Diagnostics Guide, Chapter 3) 1.2 Product fix history ------------------------ Please check the web sites: http://www.ibm.com/software/network/commserver/aix http://www.ibm.com/software/network/commserver/linux http://www.ibm.com/software/network/commserver/support for the latest information about this product. You can use the public newsgroups: news://news.software.ibm.com/ibm.software.commserver.aix news://news.software.ibm.com/ibm.software.commserver.linux for informal Question & Answer support. 1.3 Product compatibility -------------------------- The IBM Remote API Client for AIX requires one of: AIX v5.2-ML7 or later AIX v5.3-ML3 or later AIX v6.1 or later 1.4 Viewing the Documentation ------------------------------ The documentation is available on the first 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-02 czx00102.pdf Quick Beginnings on System z GC31-6769-02 czx00202.pdf Administration Command Reference SC31-6770-02 czx00302.pdf Administration Guide SC31-6771-02 czx00402.pdf APPC Application Suite User's Guide SC31-6772-01 czx00501.pdf APPC Programmer's Guide SC31-6773-01 czx00601.pdf CPI-C Programmer's Guide SC31-6774-01 czx00701.pdf CSV Programmer's Guide SC31-6775-01 czx00801.pdf LUA Programmer's Guide SC31-6776-01 czx00901.pdf MS Programmer's Guide SC31-6777-01 czx01101.pdf NOF Programmer's Guide SC31-6778-02 czx01202.pdf Diagnostics Guide GC31-6779-02 czx01302.pdf Glossary GC31-6780-01 czx01401.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 unzip it - from within Adobe Acrobat: Select Edit --> Search --> Select Indexes Within the index selection, add the books.pdx file. To perform a search: - Select Edit -->Search -->Query. - Select the index you want to search OR -- insert the term for which you want to search the library. Search results will be across all the books in the library. The product documentation is also available on the Internet at: http://www.ibm.com/software/network/commserver/library 2. Installation information ---------------------------- The IBM Remote API Client for AIX is packaged as installp images on the Remote API Clients CD containing this README file, the client code, the licensing tool, and the gskit packages. This file has details for the IBM Remote API Client for AIX when installed on a 32-bit or 64-bit RS/6000 or pSeries system. If you are installing the client on a different platform see the README file in the proper ibm-commserver-clients subdirectory on the install media. If you are installing one of the server components see the appropriate README file in the root directory on the server CD of the install media. 2.1 Hardware requirements -------------------------- IBM Remote API Client for AIX requires a pSeries system supported by one of the AIX operating systems listed in section 2.2.1 Operating system version. 2.2 Software requirements -------------------------- 2.2.1 Operating system version ------------------------------------- This version of IBM Remote API Client for AIX has been tested with the following operating system versions. AIX v5.2-ML7 AIX v5.3-ML3 AIX v6.1 2.2.2 Java ---------- A Java may be needed if you use the JavaCPI-C API. Using the latest Java 5 SDK from the web site below satisfies all the requirements. http://www.ibm.com/developerworks/java/jdk Install the Java SDK package with the installp command. 2.2.3 HTTPS ----------- To run the client-server connection in HTTPS mode on a 64-bit AIX system you will need to install the gskta.rte, gsksa.rte, and sna.gsk_jre filesets as described in section 2.3. To run the client-server connection in HTTPS mode on a 32-bit AIX system you will need to install the gskta.rte and sna.gsk_jre filesets as described in section 2.3. You can also install the gsksa.rte fileset on a 32-bit system in case you later switch kernels. This is recommended. The IBM Remote API Client for AIX will detect which AIX kernel is running and use the appropriate gskit libraries as needed. The key manager function of gskit requires a customized Java JRE, which is shipped in the sna.gsk_jre fileset. To invoke the key manager, type the following: snakeyman 2.3 Installation process ------------------------- 2.3.1 Installing the IBM Remote API Client for AIX -------------------------------------------------- You cannot have both the IBM Remote API Client for AIX and the CS/AIX server code installed on the same system at the same time. If a previous level of the Remote API Client for AIX is installed check to be sure none of the sna.* filesets are locked by an EFIX. Use the following command: lslpp -L 'sna.*' and check the State column. If any fileset has an E in the State column then the fileset is locked and cannot be updated until the lock is cleared. Any attempt to update the locked fileset will fail with a message about it being locked by the EFIX manager. To get a listing of all locked filesets and the locking EFIX label execute the following command: /usr/sbin/emgr -P To obtain more information about the EFIX before removing it execute the following command: /usr/sbin/emgr -l -L -v3 To remove the given EFIX, execute the following command: /usr/sbin/emgr -r -L For more information on EFIX management please see the 'emgr' man page and documentation. To clear the lock, use the 'emgr -r' command as shown above. - To install the 6.3.1.0 level of the IBM Remote API Client for AIX: 1. Load the Remote API Clients CD in the AIX system. 2. Run the 'smit install_selectable_all' panel selecting /dev/cd0 (or whatever your CD-ROM or DVD drive is called) as the 'INPUT device'. Select the sna.client fileset in the 'SOFTWARE to install' list. 3. If you use the HTTPS support to connect to a server you also need to install the gskta.rte, gsksa.rte, and sna.gsk_jre filesets. or mount the Remote API Clients CD and install the package directly: 1. Mount the Remote API Clients CD on the aix system: # mount -o ro /dev/cd0 /mnt 2. Run the installp command to install the fileset: # installp -aYd /mnt/ibm-commserver-clients/aix sna.client Note: Using the 'Y' flag accepts the license agreement or # smit install_selectable_all and start the installer program. 3. If you use the HTTPS support to connect to a server you also need to install the gskta.rte, gsksa.rte, and sna.gsk_jre filesets from the ibm-commserver-clients/aix directory. 4. Unmount the Remote API Clients CD from the aix system: # umount /mnt or copy the install images and install them manually: 1. Copy the sna.client.6.3.1.0.I file to your computer. This file is on the Remote API Clients CD. in the ibm-commserver-clients/aix directory. The copy must be done in binary mode. For example, use "ftp" with the binary mode command. 2. Remove any existing .toc file from the install directory so the subsequent installp command will re-create it. 3. Run the installp command to install the package: # installp -aYd sna.client.6.3.1.0.I all Note: Using the 'Y' flag accepts the license agreement or # smit install_selectable_all and start the installer program. 4. If you use the HTTPS support to connect to a server you also need to install the gskta, gsksa, and sna.gsk_jre packages from the ibm-commserver-clients/aix directory. 5. When the install has completed, you can delete the sna.client.6.3.1.0.I and gsk* files from the working directory. - Start IBM Remote API Client. 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 3. Uninstallation information ------------------------------ Close the IBM Remote API Client for AIX program if it is running: # sna stop Use the AIX installp command to un-install the IBM Remote API Client for AIX: # installp -u sna.client or # smit remove If no other packages are using the gskit support you can remove it with the command: # installp -u 'gsksa.*' 'gskta.*' or # smit remove Any old configuration information will be left in place for use by a future re-installation. 4. Known limitations and problems ---------------------------------- none 5. Documentation updates ------------------------- See the "WhatsNew6230.txt" file in the root of the CD for more details. 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: Advanced Peer-to-Peer Networking AIX Application System/400 AS/400 CICS IBM MQSeries MVS MVS/ESA MVS/XA NetView OpenPower OS/2 Power5 pSeries S/390 SP System p System x System z System/370 System/390 SAA Systems Application Architecture VTAM WebSphere z/OS z9 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 and Pentium are trademarks of Intel Corporation. AMD64 is a trademark of Advanced Micro Devices, Inc. Linux is a trademark of Linus Torvalds. Microsoft, Windows, Windows NT, Windows XP, 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.