DIGITAL SNA Domain_Gateway______________________________________ Installation (DIGITAL UNIX) Part Number: AA-QCLBB-TE July 1997 This document describes how to install the Domain Gateway software on an Alpha system running the DIGITAL UNIX operating system. Revision/Update Information: This is a revised manual. Operating System: DIGITAL UNIX Software Version: DIGITAL SNA Domain Gateway V2.1 Electronic Data Systems Corporation and Digital Equipment Corporation make no representations that the use of their products in the manner described in this publication will not infringe on existing or future patent rights, nor do the descriptions contained in this publication imply the granting of licenses to make, use, or sell equipment or software in accordance with the description. Possession, use, or copying of the software described in this publication is authorized only pursuant to a valid written license from DIGITAL or an authorized sublicensor. The information in this document is subject to change without notice and should not be construed as a commitment from Electronic Data Systems Corporation or Digital Equipment Corporation. Electronic Data Systems Corporation and Digital Equipment Corporation assume no responsibility for any errors that may appear in this document. © 1997 Electronic Data Systems Corporation. All Rights Reserved. © 1994 Digital Equipment Corporation. All Rights Reserved. DIGITAL conducts its business in a manner that conserves the environment and protects the safety and health of its employees, customers, and the community. The following are trademarks of Digital Equipment Corporation: DEC, DIGITAL SNA Domain Gateway, DECnet, DIGITAL, OpenVMS, VAX, the AlphaGeneration logo, and the DIGITAL logo. The following are third-party trademarks: IBM is a registered trademark of International Business Machines Corporation. UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company Ltd. This document is available on CD-ROM. _________________________________________________________________ Contents Preface................................................... v 1 Preparing to Install the DIGITAL SNA Domain Gateway Software 1.1 Inspecting the Distribution Kit............... 1-1 1.2 System Requirements........................... 1-1 1.2.1 Required Hardware......................... 1-1 1.2.2 Required Software......................... 1-2 1.2.3 Installation Time......................... 1-2 1.3 Preparing to Install.......................... 1-2 1.3.1 Checking the Currently Installed Version Level..................................... 1-3 1.3.2 Obtaining Superuser Privileges............ 1-3 1.3.3 Verifying Disk Space...................... 1-3 1.3.4 Backing Up Your System.................... 1-4 1.3.5 Reading the Release Notes................. 1-4 1.3.6 Registering the Product Authorization Key (PAK)..................................... 1-4 1.4 Special Considerations for Installing the Domain Gateway Software....................... 1-6 1.5 Stopping the Installation..................... 1-7 2 Installing the DIGITAL SNA Domain Gateway Software 2.1 Installation from the CD-ROM or Your Network....................................... 2-1 2.1.1 Installing from a CD-ROM Drive............ 2-1 2.1.2 Configuring the Domain Gateway Software... 2-5 2.1.3 Installing over the Local Area Network with RIS.................................. 2-6 2.2 Possible Installation Errors.................. 2-6 iii 3 After Installing the DIGITAL SNA Domain Gateway Software 3.1 Running the Domain Gateway Installation Verification Procedures (IVPs)................ 3-1 3.1.1 The Load Host Subset IVP.................. 3-1 3.1.2 The Management Host Subset IVP............ 3-2 3.1.3 IVP Error Messages........................ 3-2 3.2 Preparing the IBM SNA Environment............. 3-3 3.3 Configuring and Loading the Domain Gateway Product....................................... 3-3 3.4 Running the Primary Logical Unit Installation Verification Procedure........................ 3-4 3.5 Deleting the Domain Gateway Software from Your System........................................ 3-7 3.6 Determining and Reporting Problems............ 3-8 A Sample Installation Dialog A.1 Sample Load Host Installation................. A-1 A.2 Sample Management Host Installation........... A-4 B Files Installed on Your System B.1 Files Created................................. B-1 B.2 Softlinks Created............................. B-2 iv _________________________________________________________________ Preface The DIGITAL SNA Domain Gateway-CT and DIGITAL SNA Domain Gateway-ST are combination hardware and software systems that allow communication between non-SNA networks (DECnet and TCP/IP) and IBM SNA (Systems Network Architecture) networks. This manual explains how to install the Domain Gateway software on Alpha processors that are running the DIGITAL UNIX operating system. Keep this document with your distribution kit. You will need it if you need to reinstall the Domain Gateway software. Intended Audience The audience for this guide is the system manager responsible for installing the Domain Gateway software. Document Structure This guide is organized as follows: Chapter 1 Describes the operating system and hardware requirements for the Domain Gateway installation and related procedures that you must complete before installing the Domain Gateway software. Chapter 2 Describes the step-by-step instructions for the installation. v Chapter 3 Describes the Installation Verification Procedure (IVP) and postinstallation procedures that you must complete in order to use the Domain Gateway product. Appendix A Contains a sample listing of a Domain Gateway software installation. Appendix B Contains a list of files added to your system as a result of installing the Domain Gateway software. Associated Documents The DIGITAL SNA Domain Gateway product documentation consists of the following six manuals: two installation manuals, a planning and configuration manual, a management manual, an NCL reference manual, and a manual describing the modifications necessary to IBM systems that communicate with the Gateway. This manual, Domain Gateway Installation (DIGITAL UNIX), and the Domain Gateway Installation (OpenVMS) manual describe the steps you take to install the Domain Gateway software. The Domain Gateway Planning and Configuration manual describes the activities you need to do to plan for a Domain Gateway. The manual contains a series of worksheets that allow you to organize all the information you need to configure a Gateway. The manual then describes how to use the Configuration utility to create a Gateway configuration file. Finally, the manual describes how to create a loadable management file and how to load this file and the system image onto the Gateway hardware. The Domain Gateway Management manual describes the tasks necessary to monitor and modify a running Domain Gateway. The Domain Gateway NCL Reference manual describes, in a reference format, the Network Control Language (NCL) commands used to manage the SNA components of the Domain Gateway. It also describes the event logging messages generated by these components. vi The Domain Gateway Guide to IBM Resource Definition manual describes, in detail, the modifications that an IBM system programmer needs to make to all IBM systems that communicate with the Domain Gateway. These changes are made to the IBM communications software (called VTAM), the IBM operating system, and IBM programs. This manual should be made available to IBM system programmers responsible for IBM systems that communicate with the Gateway. The system programmers will also want to read the management manual. vii Before you use the manuals in the DIGITAL SNA Domain Gateway documentation set, you should be familiar with the material in the following IBM manuals: o Systems Network Architecture-Concepts and Products (GC30-3072-x) o Systems Network Architecture-Technical Overview (GC30- 3073-x) In addition to the SNA material in those two IBM manuals, you should have available the following VTAM manuals: o Planning and Reference for Netview Network Control Program Virtual Telecommunications Access Method (SC31- 6092-x) o VTAM Network Implementation Guide (SC31-6404-x for VTAM V3R3) The DEC ChannelServer (DESNA) documentation consists of the following manuals: o DEC ChannelServer Hardware Installation Guide o DEC ChannelServer Hardware Troubleshooting Guide The DEC ChannelServer II (DESNB) documentation consists of the following manuals: o DEC ChannelServer II Installation o DEC ChannelServer II Problem Solving The DEC MicroServer (DEMSA) documentation consists of the following manual: o Installing the DEC MicroServer The DEC MicroServer-SP (DEMSB) documentation consists of the following manual: o Installing the DEC MicroServer-SP In addition, the following DECnet/OSI manuals contain information about general DECnet concepts and the Network Control Language (NCL): o DECnet/OSI Network Management o DECnet/OSI Network Control Language Reference viii Conventions This guide uses the following conventions: Special This special type indicates system output or type user input. System output is in black type; user input is in bold type. lowercase Lowercase italics in command syntax or examples italics indicate variables for which either the user or the system supplies a value. [ ] Brackets in command syntax statements indicate that the enclosed values are optional. You can enter none or one. Default values apply for unspecified options. (Do not type the brackets when you enter a command.) Brackets are not, however, optional in the syntax of a directory name in a file specification or in the syntax of a substring specification in an assignment statement. Press the Return key. The Return key, which you must press to execute commands, is assumed in command examples and therefore is not always shown in command displays. Hold down the Ctrl key while pressing the key specified by x. % The standard DIGITAL UNIX system prompt. # The standard DIGITAL UNIX superuser prompt. ix 1 _________________________________________________________________ Preparing to Install the DIGITAL SNA Domain Gateway Software This chapter discusses the planning you must do prior to installing the DIGITAL SNA Domain Gateway product. Planning issues covered here include an overview of the installation procedure, system requirements, software license Product Authorization Key requirements, and other system dependencies. 1.1 Inspecting the Distribution Kit The software Bill of Materials (BOM) included with your Domain Gateway media distribution kit lists the contents of the kit. Carefully compare the items you received with the items listed in the BOM. If any components are missing or damaged, contact your DIGITAL representative before continuing with the installation. The DIGITAL SNA Domain Gateway product provides online release notes. DIGITAL strongly recommends that you read the release notes before proceeding with the installation. For more information about accessing the release notes, see Section 1.3.5. 1.2 System Requirements This section lists and describes the hardware and software requirements your site must meet in order to install the Domain Gateway software. 1.2.1 Required Hardware To install the Domain Gateway software successfully, you must have the following minimum hardware configuration: o Alpha workstation or server See the Software Product Description (SPD) for a list of the processors that support the Domain Gateway software. The SPD ships with the software distribution kit. Preparing to Install the DIGITAL SNA Domain Gateway Software 1-1 In addition to the Alpha workstation or server, you need a DEC ChannelServer (DESNA) or DEC ChannelServer II (DESNB) for a Domain Gateway-CT or a DEC MicroServer (DEMSA) or DEC MicroServer-SP (DEMSB) for a Domain Gateway-ST. 1.2.2 Required Software The following software is required to support the Domain Gateway software: o DIGITAL UNIX o DECnet/OSI for DIGITAL UNIX If the entire DECnet/OSI product is not installed you must install the following subsets: DNABASEnnn DECnet/OSI Base Components DNANETMANnnn DECnet/OSI Network Management DNAMOPnnn DECnet/OSI MOP Utilities (load hosts only) CTABASEnnn CTF Collector Components CTAANALnnn CTF User Environment ZZAUTILnnn DECnet OSF/1 WAN Utilities See the SPD for a complete list of software and versions required to support the Domain Gateway software. 1.2.3 Installation Time Installation of the Domain Gateway software requires about 15 minutes. 1.3 Preparing to Install Before you begin the actual installation, prepare your system for the Domain Gateway software. Preparation includes the following activities: 1. For maintenance releases, checking the currently installed version level. 2. Obtaining superuser privileges. 3. Checking for sufficient system disk space. 4. Optionally, backing up your system disk. DIGITAL strongly recommends that you perform a full system backup before installation. 1-2 Preparing to Install the DIGITAL SNA Domain Gateway Software 5. Reading the product's release notes. 6. Registering your Product Authorization Key (PAK). 1.3.1 Checking the Currently Installed Version Level If you are installing a maintenance release, you should verify that the version you are about to install is greater than the version currently on your system. To check the version of the currently installed Domain Gateway software, use one of the the following commands: On Gateway load hosts: # what -s /usr/sbin/snapu5_configure On Gateway management nodes: # what -s /usr/sbin/snap 1.3.2 Obtaining Superuser Privileges To install the Domain Gateway software, you must have superuser privileges. To acquire these privileges, issue the following command followed by the root password. See the DIGITAL UNIX system manager documentation for more details. % su password: password # 1.3.3 Verifying Disk Space Check the free disk space on your system. You must have sufficient free space to install the Domain Gateway software. The installation will fail if there is insufficient space for copying the software from the distribution media. Minimum space requirements for the Domain Gateway software are as follows: o 2 Mb in the /usr partition. To check the free space in the /usr partition, enter the following command: # df -k /usr Preparing to Install the DIGITAL SNA Domain Gateway Software 1-3 1.3.4 Backing Up Your System Before installing the Domain Gateway software, back up your system disk. See the document DIGITAL UNIX Guide to System Administration for further details. 1.3.5 Reading the Release Notes Before you install the Domain Gateway software, you should read the product release notes. To access the release notes, do the following: 1. Determine the location of the Domain Gateway files on the Consolidated Software Distribution CD-ROM. See the master index table in the document Consolidated Software Distribution Disk User's Guide for the directory containing the files. 2. Insert the CD-ROM into the drive and mount the disk using the drive's device name. If you do not know the device name, issue the following command to list available drives. The drive will be either RRD40 or RRD42. # file /dev/rr*c To mount the disk, issue the following command, where dev-name is the device name of your drive. # mount -r -d /de/dev-name /mnt 3. Search the directory on the CD-ROM where the Domain Gateway files are located for the files SNAPU5*.release_ notes*. 1.3.6 Registering the Product Authorization Key (PAK) Before you install and run the Domain Gateway software, you must first register a License Product Authorization Key (License PAK) using the License Management Facility (LMF). The License PAK may be shipped along with the kit if you ordered the license and media together; otherwise, it is shipped separately to a location based on your license order. If you are installing prerequisite or optional software along with the Domain Gateway software, review the PAK status and install PAKs for any prerequisite or optional software before you install the Domain Gateway software. 1-4 Preparing to Install the DIGITAL SNA Domain Gateway Software You must register and load your license for the Domain Gateway soft before you start the installation in order to use the software. To register the Domain Gateway software license PAK using LMF, proceed as follows: 1. Log on to your system as superuser. % su password: password # 2. Issue the following command from the superuser prompt (#). Press after the confirmation message appears: # lmfsetup Register PAK (type q or quit to exit) [template] 3. After you confirm the procedure, the system prompts you for information related to the fields on your software PAK form. Using the information from your PAK form, reply to each question. Any fields left blank in your PAK should be left blank when you key in the data. 4. After you have answered all questions, the system issues the following completion message. Enter quit and press : Register PAK (type q or quit to exit) [template] quit 5. After leaving lmfsetup, issue the following reset command: # lmf reset 6. If you attempted to load a PAK when a previous PAK was already installed, a message similar to the following appears: Combine SNA-DOMAIN-GATEWAY auth-num with SNA-DOMAIN-GATEWAY auth-num 7. After completing the LMF procedure, verify your registration: # lmf list Preparing to Install the DIGITAL SNA Domain Gateway Software 1-5 For further information concerning the use of the LMF software or for more details about obtaining a license and PAK, see the document DIGITAL UNIX Guide to Software License Management. You can also reference the lmf and lmfsetup man pages (lmf(8) and lmfsetup(8)). This completes the preinstallation procedure for the Domain Gateway software. Chapter 2 describes the actual installation process. 1.4 Special Considerations for Installing the Domain Gateway Software This section describes the special installation requirements for the DIGITAL SNA Domain Gateway product. Before you install the Domain Gateway software, you must select the network nodes where you wish to load the software. A network using the DIGITAL SNA Domain Gateway product has the following nodes: o Gateway node: For the Domain Gateway-CT, this is a DEC ChannelServer or DEC ChannelServer II running the Domain Gateway-CT software. For the Domain Gateway-ST, this is a DEC MicroServer or DEC MicroServer-SP running the Domain Gateway-ST software. o Gateway load host node: This is either a DECnet/OSI for DIGITAL UNIX node or a DIGITAL UNIX node with the DECnet/OSI management software from which you load the Domain Gateway system image onto the Gateway node. You must install both the Domain Gateway load host subset and the Domain Gateway management host subset on the load host node. o Gateway management node: This is either a DECnet/OSI for DIGITAL UNIX node or or a DIGITAL UNIX node with the DECnet/OSI management software from which you manage the operation of the DIGITAL SNA Domain Gateway product. You must install the Domain Gateway management subset on a Gateway management node. You can have multiple Gateway management nodes for a single Gateway. 1-6 Preparing to Install the DIGITAL SNA Domain Gateway Software o Gateway access node: This is a non-SNA node with one or more access routine products installed. The access node must be running the version of the operating system (OpenVMS, DIGITAL UNIX, ULTRIX, or MS-DOS) that the particular access routines require. Many of the access routines suggest that you install the Gateway management software on the access node to aid in access routine problem resolution. See the SPDs for the individual access routines for information about the required operating system and the network software versions. ________________________ Notes ________________________ You must perform a license PAK load on each node on which you plan to install the Domain Gateway load host software kit. You do not need to license those nodes where you will install only the Domain Gateway management software kit. Each new version of the Domain Gateway software contains new versions of the SNAP and CTF utilities included in the management software. Therefore, you should install the new version of the management software on all nodes where you have previously installed the management software kit. ______________________________________________________ 1.5 Stopping the Installation To stop the installation at any time, press . You must then delete files created up to this point interactively. The directories and files created during the Domain Gateway software installation are listed in Appendix B. Preparing to Install the DIGITAL SNA Domain Gateway Software 1-7 2 _________________________________________________________________ Installing the DIGITAL SNA Domain Gateway Software This chapter describes the procedure for installing the DIGITAL SNA Domain Gateway software. Before installing the software, you must register your software license PAK using LMF; see Chapter 1 for details. 2.1 Installation from the CD-ROM or Your Network You can install the Domain Gateway software from two locations: the Consolidated Software Distribution CD-ROM or a remote node in your local area network using the Remote Installation Service (RIS). 2.1.1 Installing from a CD-ROM Drive To install the Domain Gateway software from the Consolidated Software Distribution CD-ROM, do the following: 1. Locate the Domain Gateway distribution files. Determine the location of the Domain Gateway files on the CD-ROM. See the master index table in the document Consolidated Software Distribution Disk User's Guide for the directory containing the files. 2. Mount the distribution kit. Insert the CD-ROM into the drive and mount the disk using the drive's device name. If you do not know the device name, issue the following command to list available drives. The drive will be either RRD40 or RRD42. # file /dev/rr*c To mount the disk, issue the following command, where dev-name is the device name of your drive. # mount -r -d /dev/dev-name /mnt Installing the DIGITAL SNA Domain Gateway Software 2-1 3. Invoke the setld utility. # setld -l /mnt/SNAPU5210/kit To start the installation, at the the superuser prompt, use the preceding command to invoke the setld utility. 4. Select the software subsets you wish to install. After you enter the setld command, the system displays the following messages. *** Enter subset selections *** The following subsets are mandatory and will be installed automatically unless you choose to exit without installing any subsets: * DIGITAL SNA Domain Gateway Management Host kit The subsets listed below are optional: There may be more optional subsets than can be presented on a single screen. If this is the case, you can choose subsets screen by screen or all at once on the last screen. All of the choices you make will be collected for your confirmation before any subsets are installed. 1) DIGITAL SNA Domain Gateway Load Host kit 2) DIGITAL SNA TN3270 Server kit Or you may choose one of the following options: 3) ALL mandatory and all optional subsets 4) MANDATORY subsets only 5) CANCEL selections and redisplay menus 6) EXIT without installing any subsets Enter your choices or press RETURN to redisplay menus. Choices (for example, 1 2 4-6): 3 You are installing the following mandatory subsets: DIGITAL SNA Domain Gateway Management Host kit You are installing the following optional subsets: DIGITAL SNA Domain Gateway Load Host kit DIGITAL SNA TN3270 Server kit Is this correct? (y/n): y 5. Read file the space verification messages. 2-2 Installing the DIGITAL SNA Domain Gateway Software Once you verify your selection, the system displays a series of messages detailing the progress of the installation. First, the procedure checks the file system for the required space: Checking file system space required to install selected subsets: File system space checked OK. 6. Monitor the installation messages. Next, the procedure installs the requested components from the distribution kit. The messages that follow assume that you are installing both the DIGITAL SNA Domain Gateway Load Host kit and the DIGITAL SNA Domain Gateway Management Host kit. 3 subset(s) will be installed. Loading 1 of 3 subset(s).... DIGITAL SNA Domain Gateway V2.1-0 for DIGITAL UNIX (c) Electronic Data Systems Corporation 1995, 1997. All Rights Reserved. (c) Digital Equipment Corporation 1992, 1994. All Rights Reserved. This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, duplication or dissemination of this software and media is authorized only pursuant to a valid written license from Digital Equipment Corporation or an authorized sublicensor. RESTRICTED RIGHTS: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in Subparagraph (c)(1)(ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable. DIGITAL SNA Domain Gateway Management Host kit Copying from /mnt/SNAPU5210/kit (disk) Verifying Loading 2 of 3 subset(s).... DIGITAL SNA Domain Gateway V2.1-0 Load Host for DIGITAL UNIX (c) Electronic Data Systems Corporation 1995, 1997. All Rights Reserved. (c) Digital Equipment Corporation 1992, 1994. All Rights Reserved. Installing the DIGITAL SNA Domain Gateway Software 2-3 DIGITAL SNA Domain Gateway Load Host kit Copying from /mnt/SNAPU5210/kit (disk) Verifying Loading 3 of 3 subset(s).... DIGITAL SNA TN3270 Server V2.1-0 for DIGITAl UNIX (c) Electronic Data Systems Corporation 1995, 1997. All Rights Reserved. (c) Digital Equipment Corporation 1992, 1994. All Rights Reserved. DIGITAL SNA TN3270 Server kit Copying from /mnt/SNAPU5210/kit (disk) Verifying 3 of 3 subsets installed successfully. DIGITAL SNA Domain Gateway V2.1-0 Management for DIGITAL UNIX Creating softlinks for SNAPU5MGMT210 ... done. Add DIGITAL SNA Domain Gateway ncl help ... Updating /usr/share/dna/ncl_help.txt Release notes may be found in /usr/sna/SNAPU5_V21-0_release_notes DIGITAL SNA Domain Gateway V2.1-0 Management for DIGITAL UNIX installed Configuring "DIGITAL SNA Domain Gateway Management Host kit" (SNAPU5MGMT210) DIGITAL SNA Domain Gateway V2.1-0 Load Host for DIGITAL UNIX Creating softlinks for SNAPU5LOAD210 ... done. DIGITAL SNA Domain Gateway V2.1-0 Load Host for DIGITAL UNIX installed Configuring "DIGITAL SNA Domain Gateway Load Host kit" (SNAPU5LOAD210) ********************* N O T E *********************** * * * You must register a licensed PAK for DIGITAL SNA * * Domain Gateway for DIGITAL UNIX before you begin * * using this product. * * * * If you have not done so, after the installation, * * use your specific PAK data to register and load * * the license with the following commands: * * * * lmfsetup * * lmf reset * * * ********************************************************** 2-4 Installing the DIGITAL SNA Domain Gateway Software To complete the installation of the DIGITAL SNA Domain Gateway software, please do the following: - Read the release notes contained in: /usr/sna/SNAPU5_V21-0_release_notes.ps - (postscript) /usr/sna/SNAPU5_V21-0_release_notes - (plain text) - Configure the DIGITAL SNA Domain Gateway software by executing the command: # /usr/sbin/snapu5_configure - Configure the DIGITAL SNA TN3270 server software by executing the command: # /usr/sbin/tn3270_config Refer to the DIGITAL SNA Domain Gateway Planning and Configuration manual for details. DIGITAL SNA TN3270 Server V2.1-0 for DIGITAL UNIX Creating softlinks for SNAPU5TN3270S210 ... done. DIGITAL SNA TN3270 Server V2.1-0 for DIGITAL UNIX installed. Configuring "DIGITAL SNA TN3270 Server kit" (SNAPU5TN3270S210) # 2.1.2 Configuring the Domain Gateway Software After you have successfully installed the Domain Gateway software and before you can begin to use the Gateway, you must generate a configuration file and load the Gateway. To configure the Gateway, do the following tasks: o Configure the necessary DECnet or TCP/IP information on the Gateway's load host. o Using the command /usr/sbin/snapu5_configure, invoke the Configuration utility and generate the NCL script file that contains a human-readable form of all the commands used to configure the Gateway software image. o Create the loadable management file. This file contains the NCL commands from the script file in a machine- readable form. Installing the DIGITAL SNA Domain Gateway Software 2-5 o Load the Gateway using the NCL BOOT or LOAD command. ___________________ When Upgrading ___________________ If you are upgrading your software from a previous version of the Domain Gateway product and your configuration is not changing, you do not need to reconfigure the Gateway. Your existing loadable management files are fully compatible with this version. To use the new Gateway system image file on an upgraded load host, you must update the MOP client database by changing the system image file name from /usr/sna/snapu5_ct0xx to /usr/sna/snapu5_ct or /usr/sna/snapu5_st0xx to /usr/sna/snapu5_st. For more information, see Chapter 13 in the Domain Gateway Planning and Configuration manual. ______________________________________________________ Refer to the Domain Gateway Planning and Configuration manual for information about configuring and loading the Gateway. 2.1.3 Installing over the Local Area Network with RIS If you are installing the Domain Gateway software over your local area network, use the Remote Installation Service (RIS) utility. See the Reference Pages in Section 8 of the document Guide to Sharing Software on LAN for RIS requirements. Issue the following command, where host-name is the name of the node from which you are loading the software. # setld -l host-name: The installation then proceeds as described in Section 2.1.1. 2.2 Possible Installation Errors If an error occurs during the installation procedure, the procedure displays one of the following three failure messages: 2-6 Installing the DIGITAL SNA Domain Gateway Software File system space check This error indicates that the installation procedure did not find enough space in the /usr partition. You should increase the available space to at least 2 MB and retry the installation. Platform check The Domain Gateway software must be installed on a Alpha processor. This error indicates that the installation procedure detected a processor other than an Alpha processor. Operating system check This error indicates that the installation procedure detected a processor running an unsupported version of DIGITAL UNIX operating system. See the SPD for the versions of the DIGITAL UNIX operating system supported by the Domain Gateway software. Installing the DIGITAL SNA Domain Gateway Software 2-7 3 _________________________________________________________________ After Installing the DIGITAL SNA Domain Gateway Software This chapter describes the procedures for running the DIGITAL SNA Domain Gateway IVP, deleting the files created during the installation, and reporting problems to DIGITAL. 3.1 Running the Domain Gateway Installation Verification Procedures (IVPs) You can run the Domain Gateway IVPs at any time. 3.1.1 The Load Host Subset IVP To use the Domain Gateway Load Host subset IVP, use the following command: # setld -v SNAPU5LOAD210 After you enter the setld command, the system displays the following messages. DIGITAL SNA Domain Gateway Load Host kit (SNAPU5LOAD210) Beginning IVP for DIGITAL SNA Domain Gateway V2.1-0 Load Host for DIGITAL UNIX (c) Electronic Data Systems Corporation. 1995, 1997. All Rights Reserved. (c) Digital Equipment Corporation. 1992, 1994. All Rights Reserved. This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, duplication or dissemination of this software and media is authorized only pursuant to a valid written license from Digital Equipment Corporation or an authorized sublicensor. RESTRICTED RIGHTS: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in Subparagraph (c)(1)(ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable. Verifying files are in their correct locations. DIGITAL SNA Domain Gateway V2.1-0 Load Host for DIGITAL UNIX IVP succeeded. After Installing the DIGITAL SNA Domain Gateway Software 3-1 3.1.2 The Management Host Subset IVP To use the Domain Gateway Management Host subset IVP, use the following command: # setld -v SNAPU5MGMT210 After you enter the setld command, the system displays the following messages. DIGITAL SNA Domain Gateway Management Host kit (SNAPU5MGMT210) Beginning IVP for DIGITAL SNA Domain Gateway V2.1-0 Management for DIGITAL UNIX (c) Electronic Data Systems Corporation. 1995, 1997. All Rights Reserved. (c) Digital Equipment Corporation. 1992, 1994. All Rights Reserved. This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, duplication or dissemination of this software and media is authorized only pursuant to a valid written license from Digital Equipment Corporation or an authorized sublicensor. RESTRICTED RIGHTS: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in Subparagraph (c)(1)(ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable. Verifying files are in their correct locations. DIGITAL SNA Domain Gateway V2.1-0 Management for DIGITAL UNIX IVP succeeded. 3.1.3 IVP Error Messages If the IVPs detect an error condition, they display one of the following lines: DIGITAL SNA Domain Gateway V2.1-0 Load Host for DIGITAL UNIX IVP failed DIGITAL SNA Domain Gateway V2.1-0 Management Host for DIGITAL UNXI IVP failed This line is preceded by one of the following error messages: Files are missing from the system The IVP detected missing files. You should reinstall the product. If this fails to correct the problem, see Section 3.6. 3-2 After Installing the DIGITAL SNA Domain Gateway Software The IVP run failed The IVP procedure failed to run. Check that the LMF PAK is installed and retry. If the IVP fails again, reinstall the product. If this fails to correct the problem, see Section 3.6. 3.2 Preparing the IBM SNA Environment You must define specific system and network resources on the IBM system before you can use the Domain Gateway software. The Domain Gateway Guide to IBM Resource Definition explains how to define these resources to establish communication between the Domain Gateway product and the IBM system. ________________________ Note ________________________ Because IBM system programmers configure and perform maintenance on their systems according to set schedules, you should give them as much advance notice as possible to prepare for the Domain Gateway installation. Because the configuration process for the Domain Gateway has the option of accepting a VTAM or NCP PATH file, the IBM configuration should be completed before you configure the Gateway. ______________________________________________________ 3.3 Configuring and Loading the Domain Gateway Product After you have successfully installed the Domain Gateway software and before you can begin to use the Gateway, you must generate a configuration file and load the Gateway. To configure the Gateway, do the following tasks: o Configure the load host with the necessary DECnet and TCP/IP information for the Gateway. o Using the command /usr/sbin/snapu5_configure, invoke the Configuration utility and generate the NCL script file that contains a human-readable form of all the commands used to configure the Gateway software image. o Create the loadable management file. This file contains the NCL commands from the script file in a machine- readable form. After Installing the DIGITAL SNA Domain Gateway Software 3-3 o Load the Gateway using the NCL BOOT or LOAD command on the load host. Refer to the Domain Gateway Planning and Configuration manual for information about planning, configuring, and loading the Gateway. 3.4 Running the Primary Logical Unit Installation Verification Procedure The Domain Gateway software includes an Installation Verification Procedure (IVP) to test the functionality of a primary logical unit (PLU) on the Gateway. ________________________ Note ________________________ You must configure the Gateway and configure the adjacent IBM system before running this IVP. ______________________________________________________ To run the IVP, do the following: 1. Create an SNA ACCESS SERVER OBJECT entity that references a numbered DECnet object or TCP/IP port on the Gateway's load host. For example, to create the OBJECT entity ivp90 on the Gateway ashfld referencing DECnet object 90 on the load host dec:.ldhost, use the following command. ncl> create node ashfld sna access server object ivp90 - _ncl> transport= decnet, node = dec:.ldhost, number = 90 To create the OBJECT entity ivp90 on the Gateway ashfld referencing TCP/IP port 90 on the load host ldhost.lkg.dec.com use the following command. ncl> create node ashfld sna access server object ivp90 - _ncl> transport = tcpip, internet node = ldhost.lkg.dec.com, _ncl> port = 90 ________________________ Note ________________________ If you specified a privileged user name and password for the network management entity on the Gateway (the DECnet object obj19 or the IP services application cml), you must reference them when you use NCL. For 3-4 After Installing the DIGITAL SNA Domain Gateway Software example, if the user name is system and the password is letmein, then you would use the command: ncl> set ncl default access by user = system, password = letmein ______________________________________________________ 2. Create an SNA LU SERVICES LU entity that is a primary LU (PLU) and that references the OBJECT entity you just defined. For example, to create the LU entity IVPLU (assuming the Gateway's PU is DEC30), use the following command. ncl> create node ashfld sna lu services lu ivplu - _ncl> pu = dec30, - _ncl> capability = primary, - _ncl> object = ivp90 3. Enable the LU entity you just created. For example, to enable the LU entity IVPLU, use the following command. ncl> enable node ashfld sna lu services lu ivplu 4. Create the object you just referenced on the load host. To create the object, use the usr/sna/snapu5_ivp3270 program as shown here: # /usr/sna/snapu5_ivp3270 DIGITAL SNA 3270 Installation Verification Program V2.1-0 Transport: DECnet or TCP/IP [DECnet] : TCP/IP Port Number [108] : 90 Creating Task Object "90=" Setting required privileges Invoking GAI_OPEN... Declaring the Object ... Awaiting a connection ... 5. Connect to the Gateway's PLU using the USS screen of a 3270 SNA networked terminal on the adjacent IBM system. Enter the command LOG APPLID in response to the SELECT SYSTEM ====> prompt. For example, to connect to the PLU IVPLU, use the following command. After Installing the DIGITAL SNA Domain Gateway Software 3-5 SELECT SYSTEM ====> LOG APPLID (IVPLU) 6. Verify the correct response at the 3270 terminal. You should see the following: DECnet/SNA 3270 Installation Verification Program Terminal ..... T1228005 Network ...... USDEC101 Primary LU ... IVPLU Logon Mode ... MCAUTO Gateway ...... ASHFLD Press PA1 to logoff. 7. Verify the correct response on the load host. You should see the following on the load host: GAP Version 3.0 Object = ASHFLD Undeclaring Object ... Getting the Connect... Connect Information: Primary = 1 Init = 1 SBind = 1 USS = 0 Queue = 0 Orig Mod = IVPLU Orig Unit = USDEC101.T1228005 Dest Mod = Dest Unit = Acc Name = Log Mode = MCAUTO User Data = Auth Term = USDEC101.T1228005 Auth User = Auth Pass = Prog Name = DIGITAL SNA Domain Gateway Proc Id = 00000000 3-6 After Installing the DIGITAL SNA Domain Gateway Software Sending the Connect Response... Getting the Suggested Bind ... TS Profile is 03 Read Size Set to 263 (85) Sending the BIND request ... Receiving the BIND response ... TS Profile is now 03 Sending the SDT request ... Receiving the SDT response ... Sending the screen write request ... Receiving a response ... RH was 830100 Receiving a response ... 8. Log off the 3270 terminal by entering PA1. 9. Verify the correct response on the load host. You should see the following on the load host: RH was 0390A0 Sending the UNBIND request ... Receiving the UNBIND response ... Closing the port ... Invoking GAI_OPEN... Declaring the Object ... Awaiting a connection ... 10. Either run another test using the LOG APPLID command on the 3270 terminal or terminate the snapu5_ivp3270 program on the load host by entering a . 3.5 Deleting the Domain Gateway Software from Your System You may find it necessary to delete the Domain Gateway files from your system. To delete the software from your system, log in as superuser and issue the setld command with the -d option After Installing the DIGITAL SNA Domain Gateway Software 3-7 To delete the software on Gateway load hosts, use the following commands: # setld -d SNAPU5LOAD210 # setld -d SNAPU5MGMT210 To delete the software on Gateway management hosts, use the following command: # setld -d SNAPU5MGMT210 To delete the TN3270 Server software, use the following command: # setld -d SNAPU5TN3270S210 3.6 Determining and Reporting Problems If you encounter a problem while using the DIGITAL SNA Domain Gateway software, report it to DIGITAL. First, determine the version of the Domain Gateway software (see Section 1.3.1) and the DIGITAL UNIX operating system software. Then, depending on the nature of the problem and the type of support you have, you can take one of the following actions: o Call DIGITAL if your software contract or warranty agreement entitles you to telephone support. o Submit a Software Performance Report (SPR). o Fill out and submit a Reader's Comments form if the problem has to do with the documentation. There is a Reader's Comments form at the back of each manual. Use the form from the manual in which you found the error. Include the section and page number. Review the Software Product Description (SPD) and Warranty Addendum for an explanation of the warranty. If you encounter a problem during the warranty period, report the problem as just indicated or follow alternate instructions provided by DIGITAL for reporting SPD nonconformance problems. 3-8 After Installing the DIGITAL SNA Domain Gateway Software A _________________________________________________________________ Sample Installation Dialog This appendix contains two sample installation dialogs for the DIGITAL SNA Domain Gateway software. A.1 Sample Load Host Installation This sample shows the dialog used to install the Domain Gateway software on a Gateway load host. # mount -r -d /dev/dev-name /mnt # setld -l /mnt/SNAPU5210/kit *** Enter subset selections *** The following subsets are mandatory and will be installed automatically unless you choose to exit without installing any subsets: * DIGITAL SNA Domain Gateway Management Host kit The subsets listed below are optional: There may be more optional subsets than can be presented on a single screen. If this is the case, you can choose subsets screen by screen or all at once on the last screen. All of the choices you make will be collected for your confirmation before any subsets are installed. 1) DIGITAL SNA Domain Gateway Load Host kit 2) DIGITAL SNA TN3270 Server kit Or you may choose one of the following options: 3) ALL mandatory and all optional subsets 4) MANDATORY subsets only 5) CANCEL selections and redisplay menus 6) EXIT without installing any subsets Enter your choices or press RETURN to redisplay menus. Choices (for example, 1 2 4-6): 3 You are installing the following mandatory subsets: Sample Installation Dialog A-1 DIGITAL SNA Domain Gateway Management Host kit You are installing the following optional subsets: DIGITAL SNA Domain Gateway Load Host kit DIGITAL SNA TN3270 Server kit Is this correct? (y/n): y Checking file system space required to install selected subsets: File system space checked OK. 3 subset(s) will be installed. Loading 1 of 3 subset(s).... DIGITAL SNA Domain Gateway V2.1-0 Management for DIGITAL UNIX (c) Electronic Data Systems Corporation. 1995, 1997. All Rights Reserved. (c) Digital Equipment Corporation. 1992, 1994. All Rights Reserved. This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, duplication or dissemination of this software and media is authorized only pursuant to a valid written license from Digital Equipment Corporation or an authorized sublicensor. RESTRICTED RIGHTS: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in Subparagraph (c)(1)(ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable. DIGITAL SNA Domain Gateway Management Host kit Copying from /mnt/SNAPU5210/kit (disk) Verifying Loading 2 of 3 subset(s).... DIGITAL SNA Domain Gateway V2.1-0 Load Host for DIGITAL UNIX (c) Electronic Data Systems Corporation. 1995, 1997. All Rights Reserved. (c) Digital Equipment Corporation. 1992, 1994. All Rights Reserved. DIGITAL SNA Domain Gateway Load Host kit Copying from /mnt/SNAPU5210/kit (disk) Verifying Loading 3 of 3 subset(s).... DIGITAL SNA TN3270 Server V2.1-0 for DIGITAL UNIX A-2 Sample Installation Dialog (c) Electronic Data Systems Corporation. 1995, 1997. All Rights Reserved. (c) Digital Equipment Corporation. 1992, 1994. All Rights Reserved. DIGITAL SNA TN3270 Server kit Copying from /mnt/SNAPU5210/kit (disk) Verifying 3 of 3 subset(s) installed successfully. DIGITAL SNA Domain Gateway V2.1-0 Management for DIGITAL UNIX Creating softlinks for SNAPU5MGMT210 ... done. Add DIGITAL SNA Domain Gateway ncl help ... Updating /usr/share/dna/ncl_help.txt Release notes may be found in /usr/sna/SNAPU5_V21-0_release_notes DIGITAL SNA Domain Gateway V2.1-0 Management for DIGITAL UNIX installed Configuring "DIGITAL SNA Domain Gateway Management Host kit" (SNAPU5MGMT210) DIGITAL SNA Domain Gateway V2.1-0 Load Host for DIGITAL UNIX Creating softlinks for SNAPU5LOAD210 ... done. DIGITAL SNA Domain Gateway V2.1-0 Load Host for DIGITAL UNIX installed Configuring "DIGITAL SNA Domain Gateway Load Host kit" (SNAPU5LOAD210) ********************* N O T E *********************** * * * You must register a licensed PAK for DIGITAL SNA * * Domain Gateway for DIGITAL UNIX before you begin * * using this product. * * * * If you have not done so, after the installation, * * use your specific PAK data to register and load * * the license with the following commands: * * * * lmfsetup * * lmf reset * * * ********************************************************** To complete the installation of the DIGITAL SNA Domain Gateway software, please do the following: - Read the release notes contained in: /usr/sna/SNAPU5_V21-0_release_notes.ps - (postscript) /usr/sna/SNAPU5_V21-0_release_notes - (plain text) Sample Installation Dialog A-3 - Configure the DIGITAL SNA Domain Gateway software by executing the command: # /usr/sbin/snapu5_configure - Configure the DIGITAL SNA TN3270 server software by executing the command: # /usr/sbin/tn3270_config Refer to the DIGITAL SNA Domain Gateway Planning and Configuration manual for details. DIGITAL SNA TN3270 Server V2.1-0 for DIGITAL UNIX Creating softlinks for SNAPU5TN3270S210 ... done. DIGITAL SNA TN3270 Server V2.1-0 for DIGITAL UNIX installed. Configuring "DIGITAL SNA TN3270 Server kit" (SNAPU5TN3270S210) A.2 Sample Management Host Installation This sample shows the dialog used to install the Domain Gateway software on a Gateway management host. # mount -r -d /dev/dev-name /mnt # setld -l /mnt/SNAPU5210/kit *** Enter subset selections *** The following subsets are mandatory and will be installed automatically unless you choose to exit without installing any subsets: * DIGITAL SNA Domain Gateway Management Host kit The subsets listed below are optional: There may be more optional subsets than can be presented on a single screen. If this is the case, you can choose subsets screen by screen or all at once on the last screen. All of the choices you make will be collected for your confirmation before any subsets are installed. 1) DIGITAL SNA Domain Gateway Load Host kit 2) DIGITAL SNA TN3270 Server kit Or you may choose one of the following options: 3) ALL mandatory and all optional subsets 4) MANDATORY subsets only 5) CANCEL selections and redisplay menus 6) EXIT without installing any subsets A-4 Sample Installation Dialog Enter your choices or press RETURN to redisplay menus. Choices (for example, 1 2 4-6): 4 You are installing the following mandatory subsets: DIGITAL SNA Domain Gateway Management Host kit Is this correct? (y/n): y 1 subset(s) will be installed. Loading 1 of 1 subset(s).... DIGITAL SNA Domain Gateway V2.1-0 Management for DIGITAL UNIX (c) Electronic Data Systems Corporation. 1995, 1997. All Rights Reserved. (c) Digital Equipment Corporation. 1992, 1994. All Rights Reserved. This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, duplication or dissemination of this software and media is authorized only pursuant to a valid written license from Digital Equipment Corporation or an authorized sublicensor. RESTRICTED RIGHTS: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in Subparagraph (c)(1)(ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable. DIGITAL SNA Domain Gateway Management Host kit Copying from /mnt/SNAPU5210/kit (disk) Verifying 1 of 1 subset(s) installed successfully. DIGITAL SNA Domain Gateway V2.1-0 Management for DIGITAL UNIX Creating softlinks for SNAPU5MGMT210 ... done. Add DIGITAL SNA Domain Gateway ncl help ... Updating /usr/share/dna/ncl_help.txt Release notes may be found in /usr/sna/SNAPU5_V21-0_release_notes DIGITAL SNA Domain Gateway V2.1-0 Management for DIGITAL UNIX installed Configuring "DIGITAL SNA Domain Gateway Management Host kit" (SNAPU5MGMT210) Sample Installation Dialog A-5 B _________________________________________________________________ Files Installed on Your System This appendix describes the files and softlinks created when you install DIGITAL SNA Domain Gateway software. B.1 Files Created The Domain Gateway installation procedure installs a number of files on your system. The following list contains the names of all files created on your system when the Domain Gateway load host software or Gateway management node software is installed. o /usr/sbin/snapu5_ctf o /usr/sbin/snap o /usr/sbin/snapu5_ncl o /usr/share/dna/dict/snapu5.hlp o /usr/sna/SNAPU5_V21-0_release_notes o /usr/sna/SNAPU5_v21-0_release_notes.ps o /usr/sna/snapu5_ivp3270 The following list contains the names of additional files created on your system when the Gateway load host software is installed. o /usr/sbin/snapu5_configure o /usr/sna/snapu5_ct.sys o /usr/sna/snapu5_st.sys o /usr/sna/snapu5_desnx.sys o /usr/sna/snacsa_mdm.sys (if not already installed) o /usr/sna/snapu5_default_logon_modes.ncl Files Installed on Your System B-1 The following list contains the names of additional files created on your system when the TN3270 Server software is installed. o /usr/sbin/tn3270_config o /usr/sbin/tn3270_server o /sbin/init.d/tn3270 o /sbin/rc3.d/S91tn3270 B.2 Softlinks Created The installation procedure creates softlinks for each file it installs. ________________________ Notes ________________________ The NCL help file (SYS$HELP:NCLHELP.HLB) is modified to contain help for the following entities: o The CHANNEL module entity and its subentities o The SDLC module entity and its subentities o The SNA ACCESS SERVER module entity and its subentities o The SNA PU SERVICES module entity and its subentities o The SNA SSCP SERVICES module entity and its subentities o The SNA LU SERVICES module entity and its subentities o The TCP module entity and its subentities o The IP SERVICE module entity and its subentities ______________________________________________________ B-2 Files Installed on Your System