IBM Communications Server for Data Center Deployment v7.1.0.0 Linux System p (ppc64) Remote API client 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 Linux 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 6.1 Notices 6.2 Trademarks 1. About this release --------------------- IBM Remote API Client for Linux provides a remote SNA API for Power systems based Linux systems (ppc64le), allowing it to connect to a domain of IBM Communications Server for Data Center Deployment v7.0 (or later) servers. 1.1 New in this release ------------------------ This release includes enhancements for: - 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. - Power ppc64le 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 -------------------------- There are no known product compatibility issues with this release. 1.4 Viewing the Documentation ------------------------------ The documentation is available on the download image in the 'DOCS' subdirectory in PDF format. See the README file for the associated server for details. The documentation is also available on the Internet at: https://www.ibm.com/support/pages/node/317755 2. Installation information ---------------------------- The IBM Remote API Client for Linux on Power system is packaged as a subdirectory on the Remote API Clients download image containing the README files, several RPMs, the install shell scripts, and licensing tool. This file has details for the IBM Remote API Client when installed on a Linux on Power server. If you are installing the client on a different latform 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 requires a Power system (ppc64le) server 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 'ppc64le' to indicate a System p server. 2.2 Software requirements -------------------------- 2.2.1 Linux operating system version ------------------------------------- This version of IBM Remote API Client has been tested with the following Linux operating system versions. It may also run satisfactorily on other Linux distributions. RedHat Enterprise Linux 7 (RHEL7) RedHat Enterprise Linux 7.x RedHat Enterprise Linux 8 (RHEL 8) RedHat Enterprise Linux 8.x SUSE Linux Enterprise Server 12 (SLES12) SPx SUSE Linux Enterprise Server 15 (SLES15) SPx Ubuntu LTS 18.04 Ubuntu LTS 20.04 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)". For the 64-bit distributions, some 32-bit ('ppcle') packages are needed in addition to the 64-bit ('ppc64le') packages. Use the "rpm -q -a" command to see what packages are currently installed. The lists below specify the minimum recommended levels of these RPMs. Later levels should also work.. RedHat Enterprise Linux 7 (RHEL7) --------------------------------- Required: glibc-2.17-*.ppc64le glibc-2.17-*.ppcle (note 'ppcle') libXp-1.0.2-*.ppcle (note 'ppcle') libXt-1.1.4-*.ppcle (note 'ppcle') libgcc-4.8.2-*.ppc64le libgcc-4.8.2-*.ppcle (note 'ppcle') Optional, needed for JavaCPI-C: ibm-java-ppc-sdk-8.0-16.35.ppc64le.rpm (download) Optional, needed for HTTPS: libXtst-1.2.2-*.ppc64le libstdc++-4.8.2-*.el7.ppcle (note 'ppcle') RedHat Enterprise Linux 8 (RHEL8) --------------------------------- Required: gcc-8.2.1-3.5.el8.ppc64le elfutils-libelf-devel-0.174-6.el8.ppc64le glibc-2.28-42.el8.ppc64le glibc-devel-2.28-42.el8.ppc64le libgcc-8.2.1-3.5.el8.ppc64le libnsl-2.28-42.el8.ppc64le nss-softokn-3.41.0-5.el8.ppc64le perl-libs-5.26.3-416.el8.ppc64le Optional, needed for JavaCPI-C: ibm-java-ppc64le-sdk-8.0.5.ppc64le.rpm (download) SUSE Linux Enterprise Server 12 (SLES12) ---------------------------------------- Required: gcc-4.8-5.3 binutils-2.19-8.3 glibc-devel-2.19-11 perl-5.18 Optional, needed for JavaCPI-C: ibm-java-ppc64le-sdk-8.0-3.22.ppc64le.rpm (download) SUSE Linux Enterprise Server 15 (SLES15) ---------------------------------------- Required: gcc-7-1.516 binutils-2.29.1-3.38 glibc-2.26-4.54 glibc-devel-2.26-4.54 perl-5.26.1 Optional, needed for JavaCPI-C: ibm-java-ppc64le-sdk-8.0-3.22.ppc64le.rpm (download) UBUNTU Linux 18.04 LTS (bionic): ----------------------------------------------- gcc/* 4:7.4.* gcc-7/* 7.5.0 gcc-7-base/* 7.5.0 libgcc-7-dev/* 7.5.0 libgcc1/* 1:8.4.0 perl/* 5.26.1 perl-base/* 5.26.1 libstdc++6/ * 8.4.0 Optional, needed for JavaCPI-C: ibm-java-ppc64le-sdk-8.0* (download) UBUNTU Linux 20.04 LTS (focal): ----------------------------------------------- gcc-9-base/* 9.3.0 gcc-9/* 9.3.0 gcc/* 9.3.0 libgcc-9-dev/* 9.3.0 libgcc-s1/* 10 perl/* 5.30.0 perl-base/* 5.30.0 libstdc++6/ * 10 Optional, needed for JavaCPI-C: ibm-java-ppc64le-sdk-8.0* (download) 2.2.2 Java ---------- A Java may be needed if you use the JavaCPI-C API. Using the latest Java 8 SDK from the web site below satisfies all the requirements. http://www.ibm.com/developerworks/java/jdk Install the Java SDK package with a command like: rpm -i ibm-java2-ppc-sdk-8.0-6.0.ppcle.rpm and/or rpm -i ibm-java2-ppc64-sdk-8.0-6.0.ppc64le.rpm 2.2.3 HTTPS ----------- The HTTPS support for Remote API Client is not recommended any longer due to more secure and efficient means for securing TCP/IP client/server flows. When considering secure socket connections between client/server, technologies like VPN, Socket-Tunneling are more efficient and can secure all the TCP/IP sockets between a client and a data center or server. 2.3 Installation process ------------------------- If you have a previous level of IBM Remote API Client already installed, follow the steps in section 3 to remove it before installing this new level. Any old configuration information will be left in place for use by the new installation. To install the IBM Remote API Client for Linux on Power systems follow these instructions. - Log into the machine as root. - Mount the Remote API Clients CD and make it the current directory mount /dev/cdrom cd /media/cdrom The "/media/cdrom" directory name may be different if you have a DVD drive. Use the "df" command to see where Linux mounted the CD. - Go into the IBM Remote API Client for Linux on Power systems subdirectory and run the installibmcscli shell script cd ibm-commserver-clients/linux-ppc64le ./installibmcscli The installibmcscli shell script will test for certain prerequisites and issue warning messages if they are not met. You will be prompted to read and accept the license agreement, then the installibmcscli tool will install the RPMs. - Add the IBM Remote API Client binary directories to your PATH. You may wish to change your profile to do this automatically. export PATH="$PATH:/opt/ibm/sna/bin" export LD_LIBRARY_PATH=/usr/lib:/opt/ibm/sna/lib export LD_RUN_PATH=/usr/lib:/opt/ibm/sna/lib If you are running 64-bit applications, you would use: export LD_LIBRARY_PATH=/usr/lib64:/opt/ibm/sna/lib64 export LD_RUN_PATH=/usr/lib64:/opt/ibm/sna/lib64 For Java CPI-C applications you should also set the environment variable: export CLASSPATH=$CLASSPATH:/opt/ibm/sna/java/cpic.jar - Configure the client/server connection parameters using an ASCII configuration file created in /etc/opt/ibm/sna/sna_clnt.net. Refer to the Quick Beginnings book for configuring Remote API Client on Linux for details on this file format. - 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 ----------------------------- The IBM Remote API Client packages can be removed with the following commands: /opt/ibm/sna/bin/sna stop rpm -e ibm-commserver-cli rpm -e ibm-commserver /sbin/shutdown -r now Not all of these packages will be installed on every system. Uninstalling IBM Remote API Client will leave any customized configuration information behind for use by a later installation. 4. Known limitations and problems ---------------------------------- None 5. Documentation updates ------------------------- See the "WhatsNew7100.txt" file in the root of the CD for more details. 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.