IBM Networking Support Home | Products & services | Support & downloads | My account Select a country Networking hardware Networking Support Downloads Tech Tips FAQs Tech Docs Forum Subscribe User ID : Anonymous LoginRegisterSearch Networking SupportFeedback DI2504 Information: Installation and Usage Instructions Date: 06/22/2000 Applies to Product(s): 2210 - MRS V3.4 Configuration Program ************************************************************************** (C) COPYRIGHT International Business Machines Corp. 1998,2000 All Rights Reserved. Licensed Materials - Property of IBM. ************************************************************************** FILE: README IBM 2210 Nways Multiprotocol Routing Services Configuration Program Version 3.4 is a replacement for IBM Nways Multiprotocol Routing Services Configuration Program Version 3.3. The Nways Multiprotocol Access, Routing, and Switched Services Configuration Program User's Guide is available separately (GC30-3830). Contents: 1. Readme and informational files 2. Installation Hardware and Software Requirements Obtaining the Configuration Program Electronically Procedure for Installing the Configuration Program 3. Starting the Configuration Program 4. Basic Guidelines for Using the Configuration Program 5. Sending/Retrieving the Configuration File 6. Problem Determination 1. Readme and informational files Readme.txt - this file Release.txt - new functions in this release - restrictions for the release - any migration considerations from earlier releases Content.txt - one for every PTF in a given release, cumulative - a summary of whether the PTF introduces new function or is required to match a certain operational code PTF - for the GA level, the content document would refer to the release notes and state what Config Program PTF(s) in prior releases this covers - for every PTF, add at the top of the file the APARs that were added in this PTF 2. INSTALLATION Hardware and Software Requirements AIX a. RS/6000 Model 250/410 or better with minimum 80Mhz CPU(uni-processor only) b. 64 MB RAM (minimum) c. CD-ROM d. 38 MB free disk space. Additionally, you will need 1 to 3 MB for each configuration file. e. Graphics (1024 x 768 x 256 colors) display. f. 3-button mouse g. AIX for RS/6000 Version 4.1.5 or higher, AIXWindows, and Environment/6000. h. The AIX Common Desktop Environment Package (X11.Dt) is required for help. The Migration Tool, Conversion Program on AIX has special font requirements. You need to have /usr/lib/X11/fonts/75dpi/ in the list of directories. If you do not have this directory in your Xstation Font Path, then from your Xstation type: xset fp+ /usr/lib/X11/fonts/75dpi/ This will add the Conversion Program font directory to your Xstation Font Path. You may place the above line in your .profile for future use. OS/2 a. IBM PC-compatible with Intel Pentium ** 166 MHz or higher processor (See Note 1) b. 48 MB RAM (minimum) c. CD-ROM d. 33 MB free disk space. Additionally, you will need 1 to 3 MB for each configuration file. e. 10 MB for Swapper space f. SVGA (1024x768x256 colors) display. g. OS/2 3.0 or higher, IBM TCP/IP 1.2.1 for OS/2 or higher Microsoft Windows 95/98 or Windows NT a. IBM PC-compatible with Intel Pentium ** 166 MHz or higher processor (See Note 1) b. 48 MB RAM (minimum) c. CD-ROM d. 37 MB free disk space. Additionally, you will need 1 to 3 MB for each configuration file. e. SVGA (1024x768x256 colors) display. f. Microsoft Windows 95/98 or Windows NT. Notes: 1. More memory and better processors will improve the program's performance. 2. You must make sure that TCP/IP is installed and running before using the "Single Send or Retrieve" or "Multiple Send or Retrieve" functions. Obtaining the Configuration Program Electronically You can obtain the Configuration Program electronically, from http://www.networking.ibm.com/support/downloads/2210 Steps to obtain the Configuration Program electronically: 1. From the URL above, select 2210 Configuration Program then select the desired code level under MRS V3.4 Configuration Program 2. Select from Files in the Package at the bottom of the screen to download the files. AIX 1. Download the mrsaix.lpp file to a temporary directory. OS/2 1. Download the mrsos2.cmd file to a temporary directory. Windows 1. Download the mrswin.exe file to a temporary directory. Procedure for Installing the Configuration Program Install on AIX 1. Log on as the "root" user 2. If you are installing from the CD-ROM a. Insert the CD into your CD-ROM drive b. Mount the CD-ROM. 1. create directory /cdrom if one does not exist 2. mount -v cdrfs -r /dev/cd0 /cdrom 4. Change to the directory where the INSTALLP file mrsaix.lpp is located. On the CD-ROM it will be in the /cdrom/config/aix directory. If you downloaded the mrsaix.lpp file from the IBM Networking home page, change to the directory where the file exists. 5. Run SMIT and do the following: Note: The following steps are slightly different depending on your level of AIX. AIX 4.2 Procedure: a. Select "Software Installation and Maintenance." b. Select "Install and Update Software." c. Select "Install and Update from Latest Available Software." d. Select "Input device/directory for software." 1. Enter the fully qualified filename of the INSTALLP file from the CD or the web. CD-ROM. (Note that if you are in that directory already this becomes './mrsaix.lpp'. 2. Press PF4 to list the software and select the installation program. 3. Select OK. 4. Select OK. e. Select Done. f. Select Cancel. AIX 4.1.5 Procedure: a. Select "Software Installation and Maintenance." b. Select "Install and Update Software" c. Select "Install/Update Selectable Software (Custom Install)" d. Select "Install Software Products at Latest Level." e. Select "Install New Software Products at Latest Level." 1. Enter the fully qualified filename of the INSTALLP file from the CD or the web. (Note that if you are in that directory already this becomes './mrsaix.lpp'. 2. Press PF4 to list the software and select the installation program. 3. Select OK. 4. Select OK. f. Select Done g. Select Cancel. 6. Unmount the CD-ROM unmount /cdrom 7. Exit root user. The Configuration Program was installed in the /usr/lpp/mrsv34 directory. Install on OS/2 1. Open an OS/2 command window. 2. If installing from the CD-ROM, change to the /config directory on the CD-ROM. 3. If installing after downloading the OS/2 installation command from the IBM Networking page, change to the directory into which the file was downloaded. 4. From an OS/2 Command Window, enter mrsos2.cmd and follow the prompts that appear on the screen to complete the installation. Install on Windows 1. If installing from the CD-ROM, insert the appropriate CD-ROM into the CD-ROM drive. If autoread is on, the installation program starts and displays an installation dialog. Otherwise, change to the /config/win directory and run setup on the CD-ROM. 2. If installing after downloading the Windows installation file from the IBM Networking page, change to the directory into which the file was downloaded and run the mrswin.exe cmd to install the product. 3. Starting the Configuration Program AIX 1. X-Windows must be running on the workstation. Enter xinit to start X-Windows, if not already started. 2. Change to the directory /usr/lpp/mrsv34 which will contain the Configuration Program. 3. Type config and press ENTER. * For AIX users, if you experience panel distortion problems, please read the problem determination section for resolution. OS/2 1. Locate and open the Configuration Program folder, MRS V3.4 Config Programs. 2. Double-click on the Configuration Program icon, MRS V3.4 Config Program. Windows 1. Select the Configuration Program under Windows, select Start->Programs->Mrsv3.4->MRSV3.4 From the Navigation Window, under the Help pulldown, there is a Tutorial available to help a new user get familiar with using the Configuration Program. The Tutorial is also available in the Configuration Window when 'Router' is selected from the Navigation Window. 4. Basic Guidelines for Using the Configuration Program This section is not a complete user's manual, but is intended to provide some common guidance in using the configuration program. After you start the configuration program and clear the copyright notice, you will see two windows: the left-hand window is the Navigation window and the right-hand window is the Configuration window. The Configuration Program is designed as a point-and-click interfaces. You select items from the Navigation Window and then fill in information on the Configuration Window. Using the Mouse The mouse is the main tool you use to move through the various lists and panels in the Configuration Program. Examples: . Left - to select an item in a panel . Right - On the Navigation Window - Display a pop-up menu for a selected item - You may select the 'Validate' option to display validation message(s) for an item with '?' next to it. On Notebook pages - You may select the 'Validate' option to display validation message(s) for all the notebook pages. F1 (Help) - to request help To obtain help on a panel: 1. Select an item in the Navigation Window. 2. Press F1. To obtain help on a parameter, a button, or a drop-down list: 1. Select the parameter field or button by tabbing to the field, button, or list. 2. Press F1. Extended Selection to delete multiple entries 1. Hold Left mouse button and Ctrl key simultaneously to select multiple entries on a list 2. Click on the Delete button on the panel Configuring Device Interfaces 1. From the Navigation Window, click on the '+' next to Devices or double clicking the left mouse button to expand the folder; then select Interfaces. 2. From the Device Interfaces panel, select an interface 3. To change Data link, select click on the Data link column of the selected interface, click on the pull-down menu to select the desired data link. To refresh the panel for the new data link, click the empty column next to the Data link. Configuring Interfaces Panels that have more than one columns 1. From one of the Interfaces panel, select the desired interface 2. Click on the column header of the feature you want to configure. As an example, Configuring APPN Interfaces 1. From the APPN Interfaces panel, select the desired interface 2. Click on the Configure column header to configure the APPN Port. 3. Click on the Stations column header to configure the APPN Link Stations. Hints: From the Navigation Window, expand the Protocols folder to configure APPN, and further expand the APPN folder, you'll find the APPN Interfaces item. 5. Sending/Retrieving the Configuration file Note: It helps to step through the Configuration Program as you read this. You MUST make sure that TCP/IP is installed and RUNNING before using the "Communications Single" and/or "Communications Multiple" functions. The Communications function will communicate with the router using the SNMP protocol. The router must be set up with an IP Address and have a SNMP community with access defined as WRITE_READ_TRAP for send and restart. For retrieve and query, the community access can be READ_TRAP or WRITE_READ_TRAP. The single send will send the configuration that is currently open. The IP destination and community fields will default to what is defined in the configuration. The timeout value is the maximum number of seconds the send function will wait for a response. Select the appropriate action(s): 1. Send the configuration to the router 2. Restart the router immediately or later 3. Send the configuration and then restart the router 4. Query the router for the System Description. 5. Retrieve the configuration from the router. For single router restart, the time initializes to the current time so the router will restart immediately. However the 'Date' and 'Time' fields can be changed to any date and time. For multiple router restart, the dates and times initialize to the last entered dates and times for each row in the selected send list. The 'All' button will apply the date and time specified in the 'Restart at' area to each row in the list. The 'Selected' button will only apply the date and time specified in the 'Restart at' area to the row selected. The date and time fields in the table may also be directly edited. If the Restart box is selected for a row and the date and time field are empty, the date and time will default to the date and time in the 'Restart at' area. Note: If the restart is sent to the router with a date and time earlier than the current date and time on the workstation (for example yesterday's date), the router will be restarted immediately. The delayed restart time is sent to the router in the form of seconds (xx). The router will restart at xx seconds from when he receives the packet (within a two minute window). Therefore if there are many hops to the destination or the network traffic is heavy, the router may restart later than expected. If a timeout error occurs, check that: 1. the IP Destination address is correct 2. there is a route to the IP address 3. the community exists 4. the timeout value is large enough If an error with the SNMP packet occurs, check that: 1. the community has WRITE_READ_TRAP access 2. for multiple send, the configuration exists in the database Router configuration format(.cfg file readable by 221x router) If you did not save ".csf" files using the previous versions of the Configuration Programs, you should find a copy of the Configuration Program which matches your router software to create ".csf" files. The Configuration Program checks the level of the configuration at the beginning of a READ ROUTER CONFIGURATION, and will terminate the read if the level of the configuration does not match the level of the Configuration Program. 6. Problem Determination The file, walkback.log is created when an internal execution error occurs in the program. The contents of this file should be given to IBM support when a problem with the Configuration program is reported. The configuration files in all formats available should also be given to IBM support to assist with problem determination. NOTE: The above mentioned file is written to the directory from which the Configuration Program was started. Known Problems on Windows a. There is a known problem in the Configuration Program that might occur due to placement of the Guided Configuration Help window in relation to the Configuration window. If the Guided Configuration help window overlays the ENTIRE Configuration window and the user selects another item in the Navigation window, the following error message might appear: "Runtime error: UndefinedObject does not understand setForeground: See the file walkback.log for more information. Do you wish to exit?" If this occurs, do the following: (1) Select "No" on the Error Message panel. This error does not effect accuracy or funcationality of the configuration Program If you select "Yes" as your response, the configuration Program will exit and terminate. (2) Position the Guided Configuration help window so that it DOES NOT overlay the entire Configuration window. You can do this by resizing and repositioning the Guided Configuration help window, or by turning Guided Configuration off by selecting Options->Guided Configuration in the Navigation window. b. For Windows users who launch multiple versions of the Configuration Program, your help system might not function correctly unless your HELP path is set to include the current directory. Windows NT users: (1) Select Start->Settings->Control Panel (2) Select and double click the System Icon (3) Select the Environment Tab (4) Select HELP from the System Variable list (5) Add " .; " to the Value entry field in addition to what is already listed (Do not enter the quotation marks) (6) Click the Set Button Windows 95 users: (1) Add the following statement to either the Config.sys or Autoexec.bat files which exist on your system: SET HELP=.;%HELP% (2) Shutdown and Reboot your system for this change to take effect. Trademarks The following items are trademarks of the IBM Corporation in the United States or other countries of both: AIX RS/6000 Operating System/2 OS/2 Nways Microsoft, Windows, Windows NT, and the Windows 95 logo are trademarks or registered trademarks of Microsoft Corporation. Other company, product, and services names may be trademarks or service marks of others. THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS. (C) Copyright IBM Corporation 2000. All rights reserved. Provide your feedback on the Networking Technical Support pages. About IBM | Privacy | Terms of use | Contact