IBM Communications Server for Data Center Deployment v7.1.0.0 AIX server platform INSTALLATION AND RELEASE NOTES 5725-H32 * © Copyright International Business Machines Corp. 2003, 2020 * 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 1.4 Viewing the Documentation 2. Installation information 2.1 Hardware requirements 2.2 Software requirements 2.2.1 AIX operating system version 2.2.2 Java 2.2.3 bos.dlc 2.2.4 SSL 2.3 Installation process 2.3.1 Installing the v7.1 base 2.3.2 Post-install cleanup 3. Uninstallation information 4. Known limitations and problems 4.1 Dynamic LPAR 4.2 AIX Workload Partitions (WPAR) 4.3 GSKit8 and SSL support 5. Documentation updates 6. Notices and trademarks 6.1 Notices 6.2 Trademarks 1. About this release --------------------- Communications Server for Data Center Deployment v7.1.0.0, AIX server platform (CS/AIX) provides SNA connectivity for 64-bit AIX v7.1 and v7.2 systems, allowing it to connect to IBM z/OS Communications Server and other SNA implementations that support Enterprise Extender and Ethernet 802.2 connections. The CS/AIX is backwards compatible with Remote API clients v6.4 and v7.0. The Remote API Clients which work best with the Communications Server for Data Center Deployment V7.1 servers are the v7.1 clients. 1.1 New in this release ------------------------ The Communications Server for Data Center Deployment v7.1.0.0 release provides the following updates to the server and Remote API clients: - Additional support for the Linux distributions from Ubuntu, SuSE, SLES 12 SP4 and SLES 15 SP2, and Red Hat RHEL 8.2, RHEL 7.8. - Updated encrypted Telnet session including TLS 1.3 enhancements. - Power ppc64le Linux platform support - Documentation updates available for the Admin Guide, Admin Command Reference, Diagnostic Guide and Node Operations Facility (NOF). There are no updates to the manuals for application APIs. See the "WhatsNew7100.txt" file in the root of the download image for more details. 1.2 Product fix history ------------------------ This release is a follow-on release to the Communications Server for Data Center Deployment v7.0 product. The specific release level that this release follows is: Communications Server for Data Center Deployment v7.0.0.6. Please check the web sites: https://www.ibm.com/support/home/product/D383627W52509B26/other_software/communications_server_for_data_center_deployment https://www.ibm.com/it-infrastructure/z/communications-server for the latest information about this product. You can use the Developerworks forums to ask questions and find answers regarding distributed Communications Server products: http://www-01.ibm.com/support/docview.wss?uid=swg21418224 1.3 Product compatibility -------------------------- If the CS/AIX is used in a domain of servers, all the servers must be AIX servers. The CS/AIX will not support a domain of servers that include Communications Server for Linux. For systems that are migrating from previous Communications Server for AIX 6.4 systems, there are some legacy APIs that are no longer supported. Some application will need to modifications. Refer to the TechNote: "Planning an upgrade from Communications Server for AIX, V6 to Communications Server for Data Center Deployment, V7": https://www.ibm.com/support/pages/planning-upgrade-communications-server-aix-v6-communications-server-data-center-deployment-v7 1.4 Viewing the Documentation ------------------------------ The CS/AIX documentation is available on the CS/AIX 7.1 downloadable image, and the Quick Start image, 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-8583-06 czxdys11.pdf Administration Command Reference SC31-8587-06 czxdyw11.pdf Administration Guide SC31-8586-06 czxdyv11.pdf APPC Application Suite User's Guide SC23-8595-01 czx40510.pdf APPC Programmer's Guide SC23-8592-01 czx40610.pdf CPI-C Programmer's Guide SC23-8591-01 czx40710.pdf CSV Programmer's Guide SC23-8589-01 czx40810.pdf LUA Programmer's Guide SC23-8590-01 czx40910.pdf MS Programmer's Guide SC23-8596-01 czx41110.pdf NOF Programmer's Guide SC31-8595-06 czxdze11.pdf Diagnostics Guide SC31-8588-06 czxdyx11.pdf The documentation is also available on the Internet at: https://www.ibm.com/support/pages/node/318387 2. Installation information ---------------------------- The CS/AIX v7.1 product is shipped as a downloadable TAR file, including this README file, the PDF documentation, and several installp images. This file has details for the server component of CS/AIX. If you are installing one of the IBM Remote API Clients see the appropriate README file in the ibm-commserver-clients subdirectories on the Remote API Clients downloadable image. 2.1 Hardware requirements -------------------------- CS/AIX v7.1 requires a 64-bit Power 8, 9 systems supported by one of the AIX level listed in section 2.2.1 AIX operating system version. 2.2 Software requirements -------------------------- 2.2.1 AIX operating system version ----------------------------------- This version of CS/AIX has been tested with the following AIX operating system versions. AIX v7.1 AIX v7.2 2.2.2 Java ---------- A Java may be needed if you use the JavaCPI-C API. Using the latest Java SDK from the web site below satisfies all the requirements. http://www.ibm.com/developerworks/java/jdk 2.2.3 bos.dlc ------------- CS/AIX uses the bos.dlc.* filesets from the AIX install media. You can install the bos.dlc.* filesets before or after installing CS/AIX. You should use the latest bos.dlc.* levels available for your release of AIX. 2.2.4 SSL --------- The Communications Server for Data Center Deployment v7.1.0.0 media package includes GSKit version 8.0.55.18 used for Telnet encryption (SSL) support. The GSKit package provides TLS 1.3 support and the latest cipher encryption support. CS/AIX uses the sna.gsk_jre fileset to provide a customized JRE which is used by the 'snakeyman' command to manage the SSL key database. The sna.gsk_jre fileset can be installed at the same time or after installing CS/AIX. The sna.gsk_jre fileset is on the CS/AIX install media in the same directory as the other AIX installp images. 2.3 Installation process ------------------------ 2.3.1 Installing the v7.1 base --------------------------------- You cannot have both the IBM Remote API Client for AIX and the CS/AIX server installed on the same system at the same time. If a previous level of CS/AIX is installed check to be sure none of the sna.* filesets are locked by an EFIX. Use the 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. - Download, as binary, the install image of the Communications Server for Data Center Deployment v7.1 compressed TAR image for AIX server. - Use one of the following smit fast paths: smit install_bundle smit install_latest smit install_selectable_all to select filesets from the CS/AIX v7.1 install directory. - For Java CPI-C applications you should set the environment variable: export CLASSPATH=$CLASSPATH:/usr/lib/sna/cpic.jar - Start CS/AIX. After installation this will happen automatically when the system is rebooted. cd / sna start - Run the CS/AIX MOTIF administration tool. We strongly recommend you use the Motif administration program until you are familiar with CS/AIX operation. Simply follow the instructions you are given. If your AIX system does not have a graphics display, you will need to use a remote XWindows server. On the XWindows server, run: xhost +XX where XX is the TCP/IP name or address of the AIX system. Now tell the xsnaadmin client where the X 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 Post-install cleanup -------------------------- None 3. Uninstallation information ----------------------------- The CS/AIX packages can be removed with the following commands: sna stop installp -u 'sna.*' /sbin/shutdown -r now If no other AIX applications are using GSKit, then that can also be uninstalled by running: installp -u GSKit8.gskcrypt32.ppc.rte GSKit8.gskssl32.ppc.rte Uninstalling CS/AIX will leave any customized configuration information behind for use by a later installation. You can also use the smit fast-path: smit remove to uninstall CS/AIX from your system. 4. Known limitations and problems ---------------------------------- 4.1 Dynamic LPAR ---------------- In a Dynamic LPAR (DLPAR) environment, CS/AIX will perform normally when resources are added (memory, cpu, adapters) to the LPAR, but may not use those resources without manual intervention. For added cpu or memory, you will need to restart CS/AIX before the new resources will be used by CS/AIX. When adapters are added to the LPAR you can use the 'snaadmin' commands to have CS/AIX use the new adapter without restarting. In a Dynamic LPAR (DLPAR) environment, CS/AIX may not perform normally when resources are removed (memory, cpu, adapters) from the LPAR. You should stop CS/AIX before removing cpu or memory. When adapters are removed from the LPAR you should use the 'snaadmin' commands to remove them from CS/AIX before removing them from the LPAR. 4.2 AIX Workload Partitions (WPAR) ------------------------------------------------ The CS/AIX server component is not supported in either an AIX 7.1, or 7.2 System WPAR or an AIX 7.1 or 7.2 Application WPAR. You can run the CS/AIX server in an AIX 7.1 or 7.2 global (base) system. The Remote API AIX Client is supported in either an AIX 7.1 or 7.2 System WPAR or an AIX 7.1 or 7.2 Application WPAR. In both cases care must be taken to assure the WPAR has a unique hostname and can DNS resolve that hostname. You can also run the AIX Remote API Client in an AIX 7.1 or 7.2 global (base) system. You cannot have the CS/AIX server on a global (base) system and the Remote API Client in a WPAR at the same time. See technote "Support for AIX v6 Workload Partitions (WPARs)", url is: http://www.ibm.com/support/docview.wss?uid=swg21285685 4.3 GSKit8 and SSL support ------------------------------ The Communications Server for Data Center Deployment v7.1.0.0 media pack contains the full release level of the product that supports GSKit 8 and TLS. It is recommended that GSKit 8, 8.0.55.18 or higher be installed to support the latest vulnerability fixes. 5. Documentation updates ------------------------- If you update a CS/AIX v6.4 or v7.0 system to CS/AIX v7.1 and you had any local customizations to the /etc/rc.sna shell script, that shell script will be saved as /etc/rc.sna.old and a new /etc/rc.sna will have additions specific to CS/AIX v7.1. You will have to manually re-customize the /etc/rc.sna shell script. 6. Notices and trademarks -------------------------- 6.1 Notices ----------- IBM may not offer all of 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: Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan Ltd. 1623-14 Shimotsuruma,, Yamato-Shi Kanagawa 242-8502 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. Any references in this information to non-IBM websites are provided for convenience only and do not in any manner serve as an endorsement of those websites. The materials at those websites are not part of the materials for this IBM product and use of those websites is at your own risk. 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: Site Counsel IBM Corporation P.O. Box 12195 3039 Cornwallis Road Research Triangle Park, North Carolina 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. Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development- level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurement may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment. Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products. All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. 6.2 Trademarks -------------- IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the web at Copyright and trademark information at www.ibm.com/legal/copytrade.shtml. Intel is a registered trademark of Intel Corporation or its subsidiaries in the United States and other countries. Java and all Java-based trademarks are trademarks or registered trademarks of Oracle and/or its affiliates. Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both. Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both. Adobe and PostScript are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, and/or other countries. Ubuntu is a registered trademark of Canonical Limited in the United Kingdom and other countries. UNIX is a registered trademark of The Open Group in the United States and other countries. Other product and service names might be trademarks of IBM or other companies.