HP-UX SNAplus2 Upgrade Guide HP-UX 11i v1, and 11i v2 Edition 4 Manufacturing Part Number: J6380-90005 September 2005 United States © Copyright 2005 Hewlett-Packard Development Company L.P. All rights reserved.
Legal Notices The information in this document is subject to change without notice. Hewlett-Packard makes no warranty of any kind with regard to this manual, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Hewlett-Packard shall not be held liable for errors contained herein or direct, indirect, special, incidental or consequential damages in connection with the furnishing, performance, or use of this material.
DiskAccess is a registered trademark of Intergraph. EXCURSION is a trademark of Digital Equipment Corporation. Exeed is a registered trademark of Hummingbird Communications Ltd. eXodus is a trademark of White Pine Software, Inc. Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. Hewlett-Packard is independent of Sun Microsystems. MS-DOS and Microsoft are U.S. registered trademarks of Microsoft Corporation.
X Window System is a trademark of the Massachusetts Institute of Technology. This product includes software developed by the Apache Software Foundation. This documentation is based on information from the Apache SoftwareFoundation (http://www.apache.org). This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.openssl.org). This product includes cryptographic software written by Eric Young (eay@cryptsoft.com).
Contents 1. Overview of Upgrading Upgrade Paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Client-Server Compatibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 Preparing for Upgrading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 2. Upgrading from Earlier Versions of SNAplus2 to R7 Summary of Changes Between Releases . . .
Contents vi
Preface SNAplus2 is a software product that enables a server running HP-UX to exchange information with other nodes on an SNA network. The HP-UX SNAplus2 Upgrade Guide contains information on upgrading an existing SNAplus2 system to a later SNAplus2 Release.
Audience This guide addresses the network administrator responsible for planning, configuring, and monitoring the operation of an HP 9000 SNA data communications network. This guide assumes that you have knowledge of the following: • SNA (Systems Network Architecture) and APPN (Advanced Peer-to-Peer Networking) concepts. For a list of books that provide this information, see “Related Publications”. • SNAplus2 concepts and administration tools (see the HP-UX SNAplus2 Administration Guide).
Typographic Conventions Table 1 shows the typographic styles used in this document. Table 1 Typographic Conventions Special Element Sample of Topography Document title HP-UX SNAplus2 Administration Guide File or path name /usr/spool/uucp/myfile.
SNaplus2 Publications SNAplus2 publications include user guides, administrator guides, and programmer guides. The following sections describe the contents of each book. Publications for Users SNAplus2 provides the following user guides: HP-UX SNAplus2 General Information Provides an introduction to SNAplus2 and explains key product concepts and features.
HP-UX SNAplus2 Upgrade Guide (this guide) Provides information about upgrading to the current version of SNAplus2 from previous versions. It includes information about converting configuration files, rebuilding applications that use the SNAplus2 application program interfaces (APIs), and changes in other SNAplus2 functions. HP-UX SNAplus2 Administration Guide Explains how to enable, configure, and manage SNAplus2.
HP-UX SNAplus2 LUA Programmers Guide Contains the information you need to write applications using the Conventional LU Application Programming Interface (LUA). HP-UX SNAplus2 CSV Programmers Guide Contains the information you need to write application programs using the Common Service Verbs (CSV) application program interface (API). HP-UX SNAplus2 MS Programmers Guide Contains the information you need to write applications using the Management Services (MS) API.
1 Overview of Upgrading This chapter describes the enhancements offered by SNAplus2 R7.0, the possible upgrade paths, and client/server compatibility when upgrading your SNAplus2 system. This upgrade guide only applies to upgrading from the previous versions of SNAplus2.
Overview of Upgrading SNAplus. SNAplus is obsolete and no longer supported. If you are using SNAplus and want to move to the new SNAplus2 release of R7, you must upgrade your operating system to HP-UX 11i or later, remove the SNAplus products using swremove and then install the new SNAplus2 R7 release.
Overview of Upgrading Upgrade Paths Upgrade Paths The following table specifies the direct upgrade paths available with Y for Yes or N for No from previous versions of SNAplus2. Table 1-1 Upgrade Paths To From SNAplus2 R7 11iv1 SNAplus2 R7 11iv2 SNAplus2 R6 11.
Overview of Upgrading Client-Server Compatibility Client-Server Compatibility The following table specifies the compatibility (Y for Yes or N for No) between SNAplus2 client applications and SNAplus2 servers. Client applications are 3270, RJE, API programs, or administration programs running on an SNAplus2 client or server. (The first figure given for the client applications indicates the version of HP-UX running on the client computer, for example, an R6 client running under HP-UX 11.00).
Overview of Upgrading Preparing for Upgrading Preparing for Upgrading Before you begin, you will need to know the following information, have made some preliminary decisions, and have performed some preliminary actions: • Determine the type of upgrade.
Overview of Upgrading Preparing for Upgrading 6 Chapter 1
2 Upgrading from Earlier Versions of SNAplus2 to R7 This chapter describes how to upgrade an SNAplus2 system from earlier versions of SNAplus2 to SNAplus2 R7.
Upgrading from Earlier Versions of SNAplus2 to R7 Summary of Changes Between Releases Summary of Changes Between Releases A Release 7 system can read all Release 6 configuration files, and can run all applications built for Release 6. However, a Release 6 system cannot read a Release 7 configuration file, and cannot run an application that has been recompiled with Release 7 headers.
Upgrading from Earlier Versions of SNAplus2 to R7 Planning the Upgrade Process for a Client/Server System Planning the Upgrade Process for a Client/Server System If your SNAplus2 Release 7 system is a client/server system, you have a choice of upgrade strategies. The appropriate strategy depends on the structure of your SNAplus2 Release 7 system and the way you use it. This section describes the options available and provides information to help you select the most appropriate strategy.
Upgrading from Earlier Versions of SNAplus2 to R7 Planning the Upgrade Process for a Client/Server System Save the following files before upgrading the operating system: • sna_domn.cfg (located at: /etc/opt/sna) • sna_code.cfg (located at: /etc/opt/sna) • *.sty (located at: current directory) • *.stu (located at: current directory) If you are not upgrading the Operating System, the configuration files are saved and restored during the upgrade to R7.
Upgrading from Earlier Versions of SNAplus2 to R7 Upgrading a Complete Client/Server System in One Pass Upgrading a Complete Client/Server System in One Pass It is better to upgrade the complete client/server system in one pass instead of a phased upgrade. To upgrade the system in one pass, follow this procedure: Step 1. Log in as root. Step 2. Stop the SNAplus2 software on all servers and clients. Step 3. Install the new version of the SNAplus2 software on all servers and HP-UX clients.
Upgrading from Earlier Versions of SNAplus2 to R7 Phased Upgrade of a Running Client/Server System Phased Upgrade of a Running Client/Server System If you are currently running SNAplus2 Release 6 as a client/server system, you may need to keep the system running while you are upgrading to Release R7 to provide the minimum disruption to users.
Upgrading from Earlier Versions of SNAplus2 to R7 Phased Upgrade of a Running Client/Server System Restrictions in a Mixed Network of Current-Level and Back-Level Computers The only restrictions in support for programs on back-level computers are as follows: • Current-level clients cannot connect to back-level servers. • Applications that are recompiled with current-level header files cannot run on back-level servers or clients.
Upgrading from Earlier Versions of SNAplus2 to R7 Phased Upgrade of a Running Client/Server System Step 2. Stop the SNAplus2 software on the master server, if it is running, by entering the command: /opt/sna/bin/snap stop Step 3. Install the new version of the SNAplus2 software on the master server: a. Run the swinstall utility to copy the software from the installation media. swinstall will rebuild the kernel.
Upgrading from Earlier Versions of SNAplus2 to R7 Phased Upgrade of a Running Client/Server System d. Double-click on the "SNAplus2 Installation" icon. (SNAplus2 Installation may take a few minutes to come up.) Verify the configuration, if the operating system has not been upgraded. If the upgrade process includes an upgrade to the operating system, SNAplus2 must be reconfigured. (Do this in SAM by double-clicking the entry “SNAplus2 Environment”.) For assistance, use the SNAplus2 installation online help.
Upgrading from Earlier Versions of SNAplus2 to R7 Phased Upgrade of a Running Client/Server System For each Windows client in turn, use the procedure in “Upgrading a Windows Client”. Changing the Configuration during the Upgrade Process While the network contains both Release 6 and Release 7 computers, you can manage both using Release 6 administration tools, as long as you are not using any new Release 7 features.
Upgrading from Earlier Versions of SNAplus2 to R7 Upgrading a Windows Client Upgrading a Windows Client The upgrade process for Windows clients requires that a current-level server is available and started. To upgrade the client, use the following procedure: Step 1. Stop SNAplus2 applications running on the client. Step 2. Check that the NAP (Network Access Process) is not running on the client. Step 3.
Upgrading from Earlier Versions of SNAplus2 to R7 Upgrading a Windows Client 18 Chapter 2
3 Porting Application Programs This chapter provides information about how to port applications written for back-level SNAplus2 APIs for use with the current-level SNAplus2 API libraries.
Porting Application Programs Overview of Porting Applications Overview of Porting Applications The SNAplus2 API libraries have been designed to be backward-compatible, and to include all the functions that were available in the back-level software as well as new functions specific to the current-level software. When upgrading from Release 6 to Release 7, you can run existing applications without any change to the application.
4 Changes in SNAplus2 Functions in R7 This chapter provides you a summary of the important features of SNAplus2 R7 release.
Changes in SNAplus2 Functions in R7 This chapter provides information about the following: 22 • “SNAplus2 Node Types” on page 23 • “SNAplus2 Connectivity” on page 24 • “SNAplus2 API” on page 25 Chapter 4
Changes in SNAplus2 Functions in R7 SNAplus2 Node Types SNAplus2 Node Types SNAplus2 R7 supports the following additional node types: • Network Node SNAplus2 can now operate as a Network Node, End Node or, a Len Node depending on its configuration. It takes full advantage of the APPN facilities including dynamic configuration and resource location. • Branch Network Node (uses Branch Extender) SNAplus2 combines the functions of both Network Node and End Node.
Changes in SNAplus2 Functions in R7 SNAplus2 Connectivity SNAplus2 Connectivity SNAplus2 provides the following new connectivity options: • High Performance Routing (HPR) HPR is an extension of the APPN architecture. HPR provides the following functionality: — Rapid Transport Protocol (RTP) minimizes the processing cycles and storage requirements when routing network layer packets through intermediate nodes on a session route.
Changes in SNAplus2 Functions in R7 SNAplus2 API SNAplus2 API SNAplus2 supports the following additional APIs: • Advanced Program to Program Communication (APPC) Application Suite (ASUITE) ASUITE is a set of APPC applications. Use ASUITE to perform functions such as file transfer and others. • Full Duplex APPC Full Duplex APPC is an addition to the existing APPC interface that allows transaction programs (TP) to send and receive data at the same time.
Changes in SNAplus2 Functions in R7 SNAplus2 API 26 Chapter 4
Index A Adding New Servers, 16 API, 25 ASUITE, 25 Automatic Network Routing, 24 B Branch Network Node, 23 C Client-Server Compatibility, 4 Connectivity, 24 D documentation set, x downgrade, 3 H High Performance Routing, 24 HPR, 24 HPR over IP, 24 Session Level interface, 25 SNA (Systems Network Architecture) concepts, viii SNAplus, 2 Summary of Changes, 8 swinstall, 11 swremove, 2 Systems Network Architecture (SNA) concepts, viii T typographic conventions, ix U Upgrade in one pass, 11 Upgrade Paths, 3 Upgr
Index 28