NetFinity ESCON Adapter MAINTENANCE Kit 1.0 07-JAN-99 Maintenance Description ----------------------- 1.1 The PCI ESCON adapter may not work properly in certain hardware platforms. 1.2 SYMPTOMS: Under Netware, unloading the PBXAAPI.NLM after active connections were established will hang the server. This is noticed when the CHLDOWN.NCF is used. Also, when shutting down the server (i.e. DOWN and EXIT), the server will hang after typing the EXIT. Under Windows NT no problems were reported. 1.3 SOLUTION: The solution involves flashing the POST section of the firmware on the ESCON adapter with v5.8 POST code or newer. To update or view the POST flash level, a version of the CHLTOOL utility which has the "LOAD POST" capability (included with this kit) will be needed. NOTE: It is recommended this update be applied to all ESCON adapters with a POST version of 5.7 or below. Compatibility Requirements -------------------------- 2.1 The CHLTOOL utility supplied with this maintenance kit is compatible with the following ESCON Adapter Driver levels. Novell NetWare: APCA Channel Drivers Version 5.30 Microsoft Windows NT: NT Channel Drivers Version 5.30 *** CAUTION *** Do NOT apply the CHLTOOL update unless you are at these levels. The revision of Windows NT files replaced as a result of applying this maintenance kit will change from v5.3.0 to v5.3.1. The Netware Installed Products list will change from v5.3.0 to v5.3.1 after applying this kit. Newer drivers (i.e. 5.4.x and above) will already have a version of the CHLTOOL utility with "LOAD POST" capability. If the current version of CHLTOOL on your system already has the "LOAD POST" feature then DO NOT update your system with the CHLTOOL contained in this kit. Use "HELP TEST" under the CHLTOOL utility to determine whether or not it has the "LOAD POST" feature. If it does then simply use the existing CHLTOOL and verify whether or not the POST code on your system requires the update and proceed accordingly. (See installation steps below.) Installation on Novell NetWare Servers -------------------------------------- 3.1 If you are running any Netware NLM's that use the ESCON Adapter, please unload them first before proceeding. If you are running NetWare for SAA, type SAADOWN, CHLDOWN, and then CSDOWN. For TCP/IP Pass-Through, just type CHLDOWN. Before proceeding, make sure the following NLMs are unloaded by typing: UNLOAD CHLTOOL.NLM UNLOAD BTICTL.NLM UNLOAD PBXAAPI.NLM 3.2 Move or copy the following NLM files to a safe backup location. sys:system\BTICTL.NLM sys:system\CHLTOOL.NLM sys:system\PBXAAPI.NLM 3.3 From a client PC, MAP a drive to the SYS: volume of the Server. 3.4 Copy the self extracting file, ESCON531.EXE to the SYS:CHANNEL directory. 3.5 From an MS-DOS command prompt, change to the SYS:CHANNEL directory and run the ESCON531.EXE file as follows: ESCON531 -d This creates two sub-directories with files (NW531 and NT531). It also copies PBSAPOST.HEX and ESCON531.TXT into the SYS:CHANNEL directory. 3.6 From the Netware console type LOAD INSTALL. Select PRODUCT OPTIONS, and then select VIEW/CONFIGURE/REMOVE Installed Products. 3.7 Hit the INS key to install a new product. Hit the F3 key to specify a new path, and enter SYS:CHANNEL\NW531. Select install on this SERVER. You should get an Installation Completed indication. 3.8 At the Netware Console prompt (:) type LOAD PBXAAPI . The PBXAAPI.NLM will be loaded. 3.9 At the Netware Console prompt (:) type LOAD CHLTOOL . The CHLTOOL.NLM will be loaded. 3.10 At the Netware Console prompt (:) type CHLTOOL . The screen will clear and the CHLTOOL> prompt will appear. 3.11 Identify which ODI slot the ESCON adapter is in, as follows. At the CHLTOOL> prompt type the following line: SHOW ALL Slot number can be omitted in the following steps if only one ESCON adapter is in the system. 3.12 To identify what version of POST is currently loaded on the adapter, At the CHLTOOL> prompt type the following line: SHOW VERSION INFO SLOT=x (where (x)=the ODI slot number from above) Look for a line that looks like the following: Name:...... POST-C Rev 5.8 PBSA If the revision is 5.8 or higher, flash is not needed, stop here. 3.13 At the CHLTOOL> prompt type the following line: LOAD POST SYS:CHANNEL\PBSAPOST.HEX SLOT=x (where (x)=the ODI slot number from above) When loading completes (several seconds), the console will display the CHLTOOL command prompt. Repeat this process for each ESCON adapter (ODI slot number) needing this maintenance update. 3.14 Type EXIT to exit CHLTOOL. 3.15 You must now DOWN the SERVER, EXIT to the DOS prompt, power off, and perform a Hardware REBOOT on the SERVER for the changes to take effect. Installation on Microsoft Windows NT Servers -------------------------------------------- 4.1 If you are running Microsoft SNA Server, stop the SNA Service. 4.2 If you are running TCP/IP Pass-Through, open the CONTROL PANEL, open the DEVICES icon, arrow down the list to TCP/IP Pass-Through, click the STOP button. The TCP/IP Pass-Through device should stop. 4.3 If you are running a VPPA driver, open the CONTROL PANEL, open the DEVICES icon, arrow down the list to VPPA, click the STARTUP button, select the DISABLED box, click OK, and then click CLOSE. NOTE - Attempting to STOP the VPPA driver (rather than DISABLE it) will result in an error condition, and is not recommended. 4.4 Move or copy the following files to a safe backup location. C:\CHANNEL\CHLTOOL.EXE C:\WINNT\SYSTEM32\DRIVERS\BTIPBSA.SYS 4.5 Copy the self extracting file, ESCON531.EXE to the C:\CHANNEL directory. 4.6 From an MS-DOS command prompt, change to the C:\CHANNEL directory and run the ESCON531.EXE file as follows: ESCON531 -d This creates two sub-directories with files (NW531 and NT531). It also copies PBSAPOST.HEX and ESCON531.TXT into the C:\CHANNEL directory. 4.7 Copy the file named C:\CHANNEL\NT531\CHLTOOL.EXE to the C:\CHANNEL directory. 4.8 Copy the file named C:\CHANNEL\NT531\BTIPBSA.SYS to the C:\WINNT\SYSTEM32\DRIVERS directory. 4.9 Shut down and REBOOT the SERVER. 4.10 Start an MS-DOS session and change to directory C:\CHANNEL. 4.11 At the MS-DOS CMD prompt, type: CHLTOOL . The screen will clear and the CHLTOOL> prompt will appear. 4.12 Identify which slot the ESCON adapter is in, as follows. At the CHLTOOL> prompt type the following line: SHOW ALL Slot number can be omitted in the following steps if only one ESCON adapter is in the system. 4.13 To identify what version of POST is currently loaded on the adapter, At the CHLTOOL> prompt type the following line: SHOW VERSION INFO SLOT=x (where (x)=the ENCODED slot number from above) Look for a line that looks like the following: Name:...... POST-C Rev 5.8 PBSA If the revision is 5.8 or higher, flash is not needed, goto step 4.16. 4.14 At the CHLTOOL> prompt type the following line: LOAD POST PBSAPOST.HEX SLOT=x (where (x)=the ENCODED slot number from above) When loading completes (several seconds), the console will display the CHLTOOL command prompt. Repeat this process for each ESCON adapter (ENCODED slot number) needing this maintenance update. 4.15 Type EXIT to exit CHLTOOL. 4.16 If you were running a VPPA driver and disabled it in step 4.3 above, open the CONTROL PANEL, open the DEVICES icon, arrow down the list to VPPA, click the STARTUP button, select the AUTOMATIC box, click OK, and click CLOSE. 4.17 You must now shut down the SERVER and perform a Hardware REBOOT on the SERVER for the changes to take effect. ***End of README.TXT***