TO: Users of IBM APPN Topology Integrator, the Beta Version for OS/2 WARP SUBJECT: Programming Request for Price Quotation TBA Version 2, Release 01, Modification Level 01 MEMO TO USER DESIGNATION ----------- PRODUCT NUMBER: P-RPQ TBA PRODUCT NAME: IBM APPN Topology Integrator DESCRIPTION: The following sections describe: o What is the IBM APPN Topolgy Integrator o Ordering, Service, and Publications information o How the IBM APPN Topology Integrator is packaged o How to install the IBM APPN Topology Integrator o How to configure the IBM APPN Topology Integrator o Recommended references DESCRIPTION ___________ The IBM APPN Topology Integrator is a network management agent application which provides CMIP agent appearances for SNMP agents. Receiving a list of target SNMP agents and respective SNMP polling values from a front-end user application, the APPN Integrator employs the abstract translation approach to perform its proxy duties on any agents it has discovered. This "Memo To User" document describes the following: o The requirements for the RUNTIME environments of the APPN Integrator o The installation steps of the APPN Integrator for the RUNTIME environment. The IBM APPN Topology Integrator is available on the following platforms: o OS/2 WARP ORDERING INFORMATION ____________________ Contact your Marketing Representative to order the Beta Version. PROGRAM SERVICES ________________ To report problems with the IBM APPN Topology Integrator, call 1-919-254-4443. Your call will be received by the IBM APPN Topology Integrator development team. You will be contacted within one business day with a reply. THE IBM APPN TOPOLOGY INTEGRATOR PUBLICATIONS _____________________________________________ The following documentation is available for the APPN Topology Integrator: o Memo To User o APPN Topology Integrator User's Guide Version 2 Release 1 HOW THE IBM APPN TOPOLOGY INTEGRATOR IS PACKAGED _______________________________________________ The following files are available with the IBM APPN Topology Integrator product: OS/2 WARP FILES The following file bundles the IBM APPN Topology Integrator runtime code required to run on an OS/2 WARP machine. IBMinteg.ZIP Memo_To_User This file contains general information about the product and the installation procedures. It is a softcopy version of this document. SOFTWARE REQUIREMENTS _____________________ The following software is required for the IBM APPN Topology Integrator on your RUNTIME systems. o For OS/2 WARP - OS/2 WARP operating system (TCP/IP 3.0) or OS/2 Warp Connect - VisualAge C++ "runtime" for the RUNTIME system - HPFS formatted disk drive for the runtime system - Communications Manager/2 (CM/2) Version 1.1 - if using SNA as communications protocol to the SNMP agents, then - AnyNet Sockets for OS/2 V2.00.2 or - AnyNet Sockets for OS/2 Gateway V1.01.7 (available in Beta) HARDWARE AND STORAGE REQUIREMENTS _________________________________ Below are the disk and memory requirements for the runtime environment. +-------------------------------------------------+ | Table 1. Storage Requirements based on | | 15 objects/1500 instances | +------------------------+------------------------+ | PLATFORM SUPPORTED | RUN TIME | +------------------------+------------------------+ | OS/2 | DISK= 7 MB, RAM= 8 MB | +------------------------+------------------------+ For more than 1500 instances, add 1 Meg RAM and 2 Meg free disk space to the RUNTIME SYSTEM for each additional set of 1500 instances. (Assuming the instances have an average number of attributes) INSTALLATION PROCEDURE ______________________ Installation of the IBM APPN Topology Integrator is the responsibility of the user. If you encounter any problems, contact the IBM APPN Topology Integrator development team at 1-919-254-4443. INSTALLING THE APPN INTEGRATOR ON AN OS/2 SYSTEM ________________________________________________ 1. Create a runtime subdirectory to store the zipped file. Example: c:\IBMinteg 2. cd c:\IBMinteg 3. FTP to the server on the Internet You should have received the following information when you ordered the product. If not, call 1-919-254-4443. o machine name: ftp.raleigh.ibm.com o userid: anonymous o password: n/a o directory: nswww/paf/integ 4. Once you have accessed the correct machine, do the following: o set ftp mode to BINARY - "bi". DON'T FORGET THIS STEP. o get the following files: IBMinteg.ZIP PKUNZIP.EXE Memo_To_User 5. Unzip the IBMinteg.ZIP file by issuing PKUNZIP IBMinteg.ZIP 6. Verify all files are present. acse.dat actitbl.dat actrtbl.dat ansit214.dat ansit227.dat ansit228.dat appnint.exe appnint.txt attrtbl.dat authinfo.dat awp315.dat awp7376.dat awp7609.dat bntutil.dll cmipmsf.dat cmipwrks.dat cmot.dat crun31.dat crun32.dat crun33.dat crun41.dat crun43.dat cwerrlog.exe cwerrors.txt cwgdmo.tbl cwsna.exe cwsyntax.lst direct.dat dis386.dll dmi.dat exceptq.dll filelist g774.dat gmi.dat integ001.dll integ001.txt integpm.exe lnv2mbs.dll m3100.dat notitbl.dat notrtbl.dat nv2snmp.dll op1vol1.dat op1vol2.dat op1vol4.dat parmtbl.dat pres.dat q821.dat q822.dat rose.dat snmpcomm.dll x738.dat x739.dat x740.dat __cminfo __lpinfo __npinfo CONFIGURATION CONCERNS (BEFORE GETTING STARTED) _______________________________________________ o For VTAM - Specify OSIMGMT=YES start option to invoke name and address mapping via the CMIP Services Directory Definition File in VTAM. - The CMIP Services Directory Definition File must contain an entry for each host machine for which the Integrator will act as proxy agent. NetView will subsequently route CMIP requests to the Integrator, which will in turn route SNMP requests to the agent. The following is an example of an entry: class managed object name '1.3.18.0.2.4.6=AS400_NETID;1.3.18.0.0.2032=AS400_CPNAME' aetitle '1.3.18.0.2.4.6=INTEG_NETID;2.9.3.2.7.4=(name INTEG_CPNAME);& 1.3.18.0.2.4.12=OSISMASE' NOTE: VTAM does not permit spaces between the "&" (line continuation character) and the next character on the next line. Refer to Chapter 5, "User-Defined Tables and Data Filter" in the VTAM V4R3 Resource Definition Reference. o For CM/2 - The Maximum Link Stations Supported on the adapter configuration on the PS/2 needs to be increased depending on your network size. - It is recommended that at least one link be defined on the PS/2 on which the APPN Integrator resides to a monitored network node. Network availability will be improved by any additional links defined on the PS/2. - Configure the APPN Integrator with the following settings: network polling interval - no more frequent than 1 minute local polling interval - no more frequent than 5 minute response interval - at least 30 secs o For AnyNet - Set AS/400 Network Attribute ALWANYNET= *YES. - In the AS/400 Controller Description, it is preferred to set the APPN node type to the correct node type instead of LEARN. - In the AS/400 Controller Description, set the Switched Disconnect parameter to NO. - IMPORTANT: Your IP over SNA (IPS) addresses must use a separate network (or subnetwork) from any other networks (or subnetworks) that are in use. - Information on how to configure and verify Sockets over SNA addresses and routes on the AS/400 can be found in the IBM redbook "AS/400 AnyNet Scenarios" (GG24-2531), pp. 23 and 80-85. - Before starting the Integrator application, it is recommended that all AnyNet routes and targets be verified using FTP. Note: AS/400 does not support PING. If FTP to a host fails with: a. the message "No Route To Host," ensure that AnyNet is started on the PS/2. b. the message "Connection to server refused," ensure that the Line, Controller, and Device are active. c. none of the above, vary off/on the Device, Controller, and Line (in that order). - After AnyNet installation on OS/2, ensure that the SXSTART.CMD has the following line: start /c /min sx log -f sx.log logfile 100000 dgtimeout 90 retrytime 0 gwLim S1YXMACG4 RECOMMENDED REFERENCE MANUALS _____________________________ o Managing Your APPN Environments Using NetView, GG24-2559 o VTAM V4R3 Resource Definition Reference, SC31-6552 o AS/400 AnyNet Scenarios, GG24-2531