home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 14 Text / 14-Text.zip / COEXIST.ZIP / COEXIS.TXT
Text File  |  1992-01-19  |  19KB  |  454 lines
  1. IBM/Novell LAN Coexistence 
  2.   
  3.   
  4. Introduction 
  5. ------------ 
  6.   
  7. This section describes issues relating to the ability of IBM and Novell 
  8. communications software to share LAN hardware, particularly as it relates 
  9. to IBM's OS/2 LAN Requester v2.0 and the latest version of Novell's 
  10. Requester for OS/2. 
  11.   
  12. "Coexistence" with NetWare means that IBM and Novell communications 
  13. software share the same network hardware.  An example is IBM and Novell 
  14. communications software sharing a LAN adapter via different protocols 
  15. (such as IEEE 802.2, NetBIOS, TCP/IP, IPX). 
  16. and Database Manager) are involved. 
  17.   
  18. This document covers coexistence of the following IBM and Novell 
  19. software: 
  20.   
  21. IBM software: 
  22. OS/2 v2.0 
  23. OS/2 Extended Services v1.0 
  24. OS/2 LAN Server v2.0 
  25. OS/2 LAN Requester v2.0 
  26.   
  27. Novell software: 
  28. NetWare Requester for OS/2 v2.0 
  29.   
  30. Previous versions of the OS/2 program made it difficult for two LAN 
  31. .IFS files to be installed at one time, preventing the simultaneous 
  32. operation, or coexistence, of OS/2 LAN Requester and Novell's NetWare 
  33. Requester for OS/2.  The enhanced functionality of the OS/2 program 
  34. enables both IBM OS/2 LAN Requester and Novell NetWare Requester for 
  35. OS/2 to be installed and configured to share the same LAN adapter and 
  36. cabling. 
  37.   
  38. ODINSUP is Novell's new product to support the NDIS protocol stack on 
  39. top of the ODI interface. Installing the ODINSUP driver requires 
  40. modification of the CONFIG.SYS, NET.CFG, and PROTOCOL.INI files. 
  41. This document explains how to modify these files. 
  42.   
  43.  
  44. ODI Network Device Interface Specification (NDIS) Support 
  45. --------------------------------------------------------- 
  46.   
  47. IBM OS/2 LAN Server v2.0 and ES v1.0 support NDIS-compatible network 
  48. and protocol drivers.  This support is an enhancement over LAN Server and 
  49. Extended Edition v1.30.1, which provided NDIS-compatible communications 
  50. only for Ethernet.  Support of the NDIS architecture enables 
  51. OS/2 LAN Requester to coexist with Novell NetWare Requester for OS/2 
  52. through Novell's Open Data-Link Interface (ODI) specification using 
  53. the OS/2 v2.0 program. 
  54.   
  55. The ODI interface is similar to the NDIS interface in that it supports 
  56. multiple LAN adapters and multiple protocols on a single workstation. 
  57. The ODI interface creates a "logical network board", allowing multiple 
  58. frame formats to be sent across the same network hardware.  The main 
  59. advantage of the ODI interface over NDIS is that protocol stack drivers 
  60. (for example, for IPX, NetBIOS, TCP/IP) written to the ODI specification 
  61. are not dependent on the type of LAN hardware topology being used. 
  62.   
  63. Therefore, programmers do not have to include code in their protocol 
  64. device drivers to support specific LAN topologies. 
  65.  
  66.   
  67.     +---------+                  +---------+----------+ 
  68.     | NETWARE |                  | LAN SVR | EXTENDED | 
  69.     |REQUESTER|                  |REQUESTER| SERVICES | 
  70.     +---------+                  +---------+----------+ 
  71.     |   IPX   |                  | NETBIOS |   802.2  | 
  72.     +---------+                  +---------+----------+ 
  73.          |                       |  PROTOCOL MANAGER  | 
  74.          |                       +--------NDIS--------+ 
  75.          |                       |      ODINSUP       | 
  76.     +----------------------------+--------------------+ 
  77.     |           LSL - LINK SUPPORT LAYER              | 
  78.     +-------------------------------------------------+ 
  79.     |        ODI LAN DRIVER (I.E., TOKEN.SYS)         | 
  80.     +-------------------------------------------------+ 
  81.     |                   ADAPTER                       | 
  82.     +-------------------------------------------------+ 
  83.  
  84.   
  85. Changes to CONFIG.SYS 
  86. --------------------- 
  87.   
  88. The Novell ODINSUP driver, ODINSUP.SYS, allows OS/2 LAN Requester v2.0 
  89. to coexist with other communications software compatible with IBM's 
  90. NDIS communications configuration. 
  91.   
  92. When OS/2 LAN Requester v2.0 or Extended Services v1.0 is installed 
  93. with NetBIOS support, a LAN-adapter-specific NDIS LAN driver is 
  94. installed and loaded by the CONFIG.SYS.  For example, if your network 
  95. is an IBM Token-Ring network, the IBMTOK.OS2 NDIS MAC driver is 
  96. installed.  For communications coexistence to take place (as with OS/2 
  97. LAN Requester v2.0 and NetWare Requester for OS/2), the NDIS LAN driver 
  98. is replaced with the ODI LAN driver for IBM Token Ring (TOKEN.SYS), and 
  99. the Link Support Layer driver (LSL.SYS) must be added to support the 
  100. building of the ODI stack.  ODINSUP.SYS must be substituted into the 
  101. NDIS stack to hook into the Link support layer (LSL). 
  102.   
  103. Example 
  104. ------- 
  105.   
  106. Example 1 below is a portion of a CONFIG.SYS showing the configuration 
  107. for OS/2 LAN coexistence using the OS/2 v2.0 programs, with an 
  108. IBM Token-Ring as the primary adapter and a 3Com 3C523 Ethernet 
  109. adapter as the secondary adapter. 
  110.   
  111. The order of loading is important.  LSL.SYS and the ODI LAN driver(s) 
  112. must be loaded before ODINSUP.SYS.  The NDIS drivers PROTMAN.OS2 and 
  113. NETBIND.EXE are still required and PROTMAN.OS2 must be loaded before 
  114. ODINSUP.SYS. The protocol stack drivers (such as LANDD.OS2) must be 
  115. be loaded before ODINSUP.SYS. 
  116.   
  117. Notice in the example that the NDIS MAC driver IBMTOK.OS2 is 
  118. commented out.  Its functionality has been replaced by the 
  119. combination of LSL.SYS, TOKEN.SYS, and ODINSUP.SYS. 
  120.   
  121. NOTE: Except for the ODINSUP.SYS reference, all NetWare Requester 
  122. references shown are added automatically be the NetWare Requester 
  123. installation procedure. 
  124.   
  125.    REM ----------BEGINNING OF CONFIG.SYS---------------------- 
  126.    . 
  127.    . 
  128.    . 
  129.   *Modify the LIBPATH to include the path to the .DLL files.  This path 
  130.   *must be specified after the \MUGLIB\DLL directory entry to prevent 
  131.   *possible conflicts with the NETAPI.DLL in the C:\NETWARE directory. 
  132.    LIBPATH=C:\MUGLIB\DLL;...C:\NETWARE;... 
  133.   
  134.   *Append to the PATH statement the path to the NetWare 
  135.   *OS/2 utilities (L:\OS2). 
  136.    SET PATH=C:\IBMLAN\NETPROG;...L:\OS2;... 
  137.   
  138.   *Modify the DPATH to include the directory where the NetWare 
  139.   *message (.MSG) files were copied. 
  140.    SET DPATH=C:\IBMLAN\NETPROG;...;C:\NETWARE;... 
  141.    . 
  142.    . 
  143.    . 
  144.    REM --- NetWare Requester statements BEGIN --- 
  145.   *The Link Support Layer driver, LSL.SYS, begins the NetWare ODI 
  146.   *driver stack and must be loaded before any other NetWare driver. 
  147.    DEVICE=C:\NETWARE\LSL.SYS 
  148.    RUN=C:\NETWARE\DDAEMON.EXE 
  149.   
  150.   *The ODI LAN driver must match the adapter installed.  This example 
  151.   *is for IBM Token Ring. 
  152.    DEVICE=C:\NETWARE\TOKEN.SYS 
  153.   *Used only with TOKEN.SYS, ROUTE.SYS must load immediately after for 
  154.   *source routing. 
  155.    DEVICE=C:\NETWARE\ROUTE.SYS 
  156.   *This driver is for the 3Com 3C523 Ethernet (secondary adapter). 
  157.    DEVICE=C:\NETWARE\3C523.SYS 
  158.   
  159.   *The IPX driver must be loaded after the ODI LAN driver. 
  160.    DEVICE=C:\NETWARE\IPX.SYS 
  161.   
  162.   *The SPX driver is optional, but must be loaded to use the 
  163.   *printing utilities and Named Pipes.    It is also required to run 
  164.   *Transport Level Interface (TLI) applications. 
  165.    DEVICE=C:\NETWARE\SPX.SYS 
  166.    RUN=C:\NETWARE\SPDAEMON.EXE 
  167.   
  168.   *Named Pipe support is optional, and must be loaded after the SPX driver. 
  169.   *Two configurations are possible -- "client only" and "server". 
  170.   
  171.   *Load the NMPIPE.SYS driver for Named Pipes client-only support. 
  172.    DEVICE=C:\NETWARE\NMPIPE.SYS 
  173.   
  174.   *Load the NPSERVER.SYS driver, along with NMPIPE.SYS, for Named 
  175.   *Pipes server support. 
  176.    DEVICE=C:\NETWARE\NPSERVER.SYS 
  177.   
  178.   *NPDAEMON.EXE must be executed for both Named Pipe configurations. 
  179.   *If configured as a "server", a server name must be specified. 
  180.    RUN=C:\NETWARE\NPDAEMON.EXE   np_servername 
  181.   
  182.   *The NetWare OS/2 requester driver must be loaded after IPX, SPX, 
  183.   *and the Named Pipes drivers. 
  184.    DEVICE=C:\NETWARE\NWREQ.SYS 
  185.   
  186.   *The NetWare OS/2 Installable File System must be loaded after the 
  187.   *Requester driver. 
  188.    IFS=C:\NETWARE\NWIFS.IFS 
  189.   
  190.   *The NetWare Daemon must be loaded after the NetWare OS/2 Requester 
  191.   *driver. 
  192.    RUN=C:\NETWARE\NWDAEMON.EXE 
  193.   
  194.   *THE NETWARE NETBIOS DRIVER SHOULD NOT BE LOADED IN AN ES OR 
  195.   *LS environment. 
  196.    rem DEVICE=C:\NETWARE\NETBIOS.SYS 
  197.    rem RUN=C:\NETWARE\NBDAEMON.EXE 
  198.   
  199.   *THE NETWARE SUPPORT FOR MVDMS IS OPTIONAL, BUT IT IS REQUIRED 
  200.   *TO RUN THE DOS NETWARE UTILITIES, IE SYSCON. 
  201.    DEVICE=C:\NETWARE\VIPX.SYS 
  202.   
  203.   *The NetWare Print Spooler driver is optional.  This is required 
  204.   *only if you want to print to a NetWare network printer queue. 
  205.    RUN=C:\NETWARE\NWSPOOL.EXE 
  206.    REM --- NetWare Requester statements END --- 
  207.   
  208.    DEVICE=C:\IBMCOM\LANMSGDD.OS2 /I:C:\IBMCOM 
  209.    DEVICE=C:\IBMCOM\PROTMAN.OS2 /I:C:\IBMCOM 
  210.    DEVICE=C:\IBMCOM\PROTOCOL\LANDD.OS2 
  211.    DEVICE=C:\IBMCOM\PROTOCOL\LANDLLDD.OS2 
  212.    DEVICE=C:\IBMCOM\PROTOCOL\NETBEUI.OS2 
  213.   *The ODINSUP.SYS driver must be loaded before NETWKSTA.SYS (.200). 
  214.    DEVICE=C:\NETWARE\ODINSUP.SYS 
  215.   *The NDIS MAC driver(s) must be commented out (IBMTOK.OS2 and 
  216.   *ELNKMC.OS2 in this example). 
  217.    rem DEVICE=C:\IBMCOM\MACS\IBMTOK.OS2 
  218.    rem DEVICE=C:\IBMCOM\MACS\ELNKMC.OS2 
  219.    RUN=C:\IBMCOM\PROTOCOL\LANDLL.EXE 
  220.    RUN=C:\IBMCOM\PROTOCOL\NETBIND.EXE 
  221.    RUN=C:\IBMCOM\LANMSGEX.EXE 
  222.    DEVICE=C:\IBMLAN\NETPROG\RDRHELP.200 
  223.    IFS=C:\IBMLAN\NETPROG\NETWKSTA.200 /I:C:\IBMLAN 
  224.   *The NETBIOS.OS2 driver must be loaded after NETWKSTA.SYS (.200). 
  225.    DEVICE=C:\IBMCOM\PROTOCOL\NETBIOS.OS2 
  226.    REM ---------END OF CONFIG.SYS--------------------------- 
  227.   
  228.   
  229.   
  230. Configuration using NET.CFG 
  231. --------------------------- 
  232.   
  233. Several NetWare configuration concerns must be dealt with when 
  234. installing the ODINSUP drivers.  Most of these are resolved by modifying 
  235. the NET.CFG file.  This file is similar to the IBM OS/2 LAN Requester 
  236. IBMLAN.INI file and the NDIS parameter file PROTOCOL.INI, which contain 
  237. fields for configurable parameters.  The NET.CFG file must be modified 
  238. to update the following fields: 
  239.   
  240.    o Increase the size of the Link support buffers. 
  241.    o Specify binding information for the ODINSUP protocol driver, 
  242.      ODINSUP.SYS (required if using multiple boards or if you 
  243.      don't want the default for a particular board). 
  244.    o Enable the supported frame types for the ODI LAN driver. 
  245.   
  246. When using ODINSUP.SYS, increase the size of the LSL buffers if you want 
  247. packet sizes larger than the default of 1514.  The default value is 
  248. sufficient for Ethernet and for use with Token-ring cards supporting a 
  249. maximum 2K frame size.  For example, for Token-ring cards supporting 4K 
  250. frame sizes (newer 16/4 cards) a packet size of 4210 is recommended. 
  251.   
  252. For older cards with maximum frame size of 2K, add this statement: 
  253.   
  254.    link support 
  255.      buffers 15 1514 
  256.   
  257. For newer cards with maximum frame size of 4K, add this statement: 
  258.   
  259.     link support 
  260.      buffers 15 4210 
  261.   
  262.   
  263. When the NetWare Requester is initialized, it tries to establish a 
  264. connection with the primary network board.  Use of multiple network 
  265. boards can increase communication speed if the workstation is connected 
  266. to multiple physical networks. 
  267.   
  268. The ODINSUP driver must bind to an ODI LAN driver for network 
  269. communication to take place.  If no binding information is specified 
  270. in the NET.CFG file, ODINSUP, by default, attempts to 
  271. locate a supported ODI LAN driver.  If an ODI LAN driver is found, 
  272. ODINSUP.SYS attempts to bind to it. 
  273.   
  274. To support more than one ODI LAN driver or to specify which ODI LAN 
  275. driver to bind to requires modification to the NET.CFG file. 
  276. ODINSUP.SYS can be bound to as many as four ODI LAN drivers. 
  277.   
  278. A bind entry specifies the name of the ODI LAN driver and, optionally, 
  279. the instance number of the adapter.  The name of the ODI LAN Driver is 
  280. usually the name of the ODI LAN driver file (such as, TOKEN for 
  281. TOKEN.SYS, etc.).  If more than one LAN adapter is installed in the 
  282. workstation (such as, two 3C523 adapters), the instance number may be 
  283. required.  If an instance number is not specified, ODINSUP.SYS will bind 
  284. to the first ODI LAN driver found.  For example, if two 3C523 (3Com 
  285. Ethernet) adapters were installed, ODINSUP.SYS would bind to the first 
  286. loaded instance of the ODI LAN driver.  If not specified, the default 
  287. value for the instance number is 1. 
  288.   
  289.  Example NET.CFG: 
  290.   
  291.     link support 
  292.        buffers 15 4210 
  293.   
  294.     protocol odinsup 
  295.        bind token     ;Bind to the first instance of TOKEN ODI LAN driver 
  296.        bind 3c523 1   ;Bind to the first instance of 3C523 ODI LAN driver 
  297.        bind 3c523 2   ;Bind to the second instance of 3C523 ODI LAN driver 
  298.   
  299.   
  300. Currently, ODINSUP.SYS supports only ODI LAN drivers compatible with 
  301. Token-Ring and Ethernet LANs.  The NET.CFG file must by modified to 
  302. enable the minimum number of frame types for Token-Ring and Ethernet. 
  303. For token-ring ODI LAN drivers, the TOKEN-RING, and TOKEN-RING_SNAP 
  304. frame types must be specified.  For the Ethernet ODI LAN driver, the 
  305. ETHERNET_802.2, ETHERNET_SNAP, and ETHERNET_II frame types must be 
  306. specified.  The following is a sample NET.CFG file showing how these 
  307. frame types are specified. 
  308.   
  309.  Example NET.CFG: 
  310.   
  311.     link support 
  312.        buffers 15 4210 
  313.   
  314.     protocol odinsup 
  315.        bind token     ;Bind to the first instance of TOKEN ODI LAN driver 
  316.        bind 3c523 1   ;Bind to the first instance of 3C523 ODI LAN driver 
  317.        bind 3c523 2   ;Bind to the second instance of 3C523 ODI LAN driver 
  318.   
  319.     link driver token 
  320.        frame token-ring         ;Required 
  321.        frame token-ring_snap    ;Required 
  322.   
  323.     link driver 3c523 
  324.        frame ethernet_802.3     ;Optional 
  325.        frame ethernet_802.2     ;Required 
  326.        frame ethernet_ii        ;Required 
  327.        frame ethernet_snap      ;Required 
  328.   
  329.   
  330. The NET.CFG file can be used for other NetWare Requester configuration 
  331. requirements. Refer to the Novell booklet, "NetWare Requester for OS/2" that 
  332. that comes with the NetWare Operating System documentation for more 
  333. information on how to configure the NetWare drivers using the NET.CFG   file. 
  334. file. 
  335.   
  336. Changes to PROTOCOL.INI 
  337. ----------------------- 
  338.   
  339. The NDIS PROTOCOL.INI file is required to tell the NDIS protocol(s) 
  340. which ODINSUP driver to bind to.  Usually, all PROTOCOL.INI 
  341. information for NDIS MAC drivers can be removed, because no ODI 
  342. MAC-specific information is necessary in the PROTOCOL.INI. 
  343.   
  344. The PROTOCOL.INI must also specify sections for each NDIS protocol used. 
  345. For example, one section is the "Bindings = ..." statement, which 
  346. specifies the NDIS MAC(s) that the protocol should bind to.  The name 
  347. specified should be the name of the ODI LAN Driver installed (such 
  348. as 3C523, TOKEN, or 3C503).  If the ODI LAN Driver name starts with a 
  349. number (such as 3C523), the MAC name for the "Bindings = ..." statement 
  350. must be preceded with the letter 'x'.  Therefore, the "Bindings = ..." 
  351. statement for the 3C523 LAN driver would be "Bindings = x3C523".  If 
  352. binding to multiple ODI LAN drivers, the entries on the "Bindings = ..." 
  353. statement should be separated by a comma (such as 
  354. Bindings = TOKEN,X3C503 ). 
  355.   
  356. When an adapter instance other than the first is used (such as when 
  357. ODINSUP.SYS is bound to the second TOKEN ODI LAN Driver), the MAC name 
  358. must have the instance number appended to the end of the ODI LAN 
  359. driver name (such as TOKEN2 for the second instance, x3C5234 for the 
  360. fourth instance).  Appropriate MAC names are displayed when ODINSUP.SYS 
  361. is loaded. 
  362.   
  363. The following example is PROTOCOL.INI file for OS/2 v1.30.2 and 
  364. OS/2 v2.0 running OS/2 LAN Requester v2.0 and NetWare Requester for 
  365. OS/2.  This example shows the binding instruction changes required for 
  366. the ODINSUP driver: 
  367.   
  368.   
  369.    {PROT_MAN} 
  370.     DriverName = PROTMAN$ 
  371.   
  372.    {IBMLXCFG} 
  373.     LANDD_nif = LANDD.nif 
  374.     NETBEUI_nif = NETBEUI.nif 
  375.   
  376.    ;*----------------------------------------------* 
  377.    ;*------------- PROTOCOL SECTION ---------------* 
  378.    ;*----------------------------------------------* 
  379.   
  380.    {LANDD_nif} 
  381.     DriverName = LANDD$ 
  382.    ; Bindings = IBMTOK_nif,ELNKMC_nif 
  383.    ; For first instance of TOKEN board and first instance of 3C523 board. 
  384.     Bindings = TOKEN,x3C523 
  385.   
  386.    {NETBEUI_nif} 
  387.     DriverName = netbeui$ 
  388.    ; Bindings = IBMTOK_nif,ELNKMC_nif 
  389.    ; For first instance of TOKEN board and first instance of 3C523 board. 
  390.     Bindings = TOKEN,x3C523 
  391.   
  392.    ;*--------END OF FILE---------------------------* 
  393.   
  394. NOTE:  The above PROTOCOL.INI example is a complete file.  All portions 
  395. of the PROTOCOL.INI that are NDIS-related may be deleted or remarked out. 
  396.   
  397. The following example is PROTOCOL.INI file for OS/2 EE v1.30.1, using 
  398. the NDIS-compatible Ethernet MAC driver for the 3Com 3C523 adapter: 
  399.   
  400.    ;------------------ Protocol Manager Definition ----------------- 
  401.   
  402.    {PROTOCOL_MANAGER} 
  403.    DriverName = PROTMAN$ 
  404.   
  405.    ;---------------- IBM ETHERAND Protocol Definition -------------- 
  406.   
  407.    {ETHERAND} 
  408.    DriverName = OS2EE$ 
  409.    Bindings = x3C523    ;for first instance of 3C523 board 
  410.   
  411.    ; Bindings = x3C5232      ;for second instance of 3C523 board 
  412.   
  413.    ;---------END OF FILE----------------- 
  414.   
  415.  NOTE:  Communications Manager cannot handle an OS2EE entry such as 
  416. "Bindings = x3C523,x3C5232". 
  417.   
  418.   
  419. Limitations 
  420. ----------- 
  421.   
  422. The ODINSUP.SYS driver for OS/2 requires LSL.SYS that is dated later 
  423. than May 19, 1991.  Also, TOKEN.SYS dated earlier than Sept. 17, 1991 
  424. does not support ODINSUP.SYS. 
  425.   
  426. The ODINSUP driver is supported only for those configurations for which 
  427. an ODI-compatible LAN driver for the network adapter(s) is available. 
  428. This requirement may limit the use of ODINSUP (especially in the Ethernet 
  429. environment) because Novell ships a limited number of ODI LAN drivers 
  430. with its latest release of the NetWare Requester for OS/2.  At this time, 
  431. several ODI LAN adapter drivers are being developed by third-party 
  432. vendors, but no release data is available. 
  433.   
  434. Currently, starting the IBM OS/2 LAN Server on a machine with the 
  435. NetWare Requester drivers installed is not officially supported. 
  436. However, most environments where this configuration is attempted should 
  437. execute successfully. 
  438.       
  439. Trademarks 
  440. ---------- 
  441.   
  442. 3Com is a trademark of 3Com Corporation. 
  443. IBM is a registered trademark of International Business Machines Corporation. 
  444. NetWare and Novell are registered trademarks of Novell, Inc. 
  445. OS/2 is a trademark of International Business Machines Corporation. 
  446. Token-Ring is a trademark of International Business Machines Corporation. 
  447.   
  448.   
  449. ------------------------------------------------------------------------ 
  450. ------------------------------------------------------------------------ 
  451. ------------------------------------------------------------------------ 
  452.   
  453.   
  454.