home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / NBR11I.ZIP / NBRIDGE.DOC < prev    next >
Text File  |  1992-11-12  |  39KB  |  1,105 lines

  1.  
  2.         NBridge.Doc for NIC Bridge Version 1.1i
  3.  
  4.         Nov 12 1992
  5.  
  6.  
  7.  
  8.         Copyright (c) Eighth Layer Systems 1990-1992.
  9.         All rights reserved.
  10.  
  11.  
  12.  
  13. Warning:  The possibility of file corruption exists when using any software.
  14.           Please take whatever steps are required to protect vital files.
  15.  
  16.  
  17.  
  18.  
  19.  
  20.         This documentation is formatted with 23 line pages. It contains
  21. IBM PC type block graphics characters.
  22.  
  23.  
  24.         ┌──────────┐
  25.         │ CONTENTS │
  26.         └──────────┘
  27.  
  28.  
  29.             RELEASE NOTES..................................................  4
  30.  
  31.             INTRODUCTION............Definitions............................  5
  32.                                     Files Included.........................  6
  33.                                     NBridge Drivers........................ 10
  34.                                     SRTok Drivers.......................... 11
  35.                                     NBr Bridge Utility..................... 14
  36.                                     NicSetup Setup Utility................. 15
  37.  
  38.             CONSIDERATIONS..........Ethernet Transparent Bridging.......... 16
  39.                                     Token Ring Source Routing Bridging..... 21
  40.  
  41.             SETUP/MAIN CONFIGURATION....................................... 31
  42.  
  43.             OPERATION...................................................... 36
  44.  
  45.             NBRIDGE PARAMETERS............................................. 37
  46.  
  47.  
  48.             SRTOK PARAMETERS............................................... 43
  49.  
  50.             ACKNOWLEDGEMENTS............................................... 48
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.         ┌───────────────┐
  71.         │ RELEASE NOTES │
  72.         └───────────────┘
  73.  
  74.         - The Install.Exe utility can be used to upgrade recent releases
  75.           of the software by installing over a previous version.
  76.  
  77.         - The NBridge CUSTOMFILTER parameter is now documented.
  78.  
  79.         - The SRTok SRBC parameter is now documented.
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.         ┌──────────────┐
  94.         │ INTRODUCTION │
  95.         └──────────────┘
  96.  
  97.         ─────────────
  98.          Definitions
  99.         ─────────────
  100.  
  101.         The term "LanRoot" denotes the directory under which all network
  102. software is installed. For MS Lan Manager this is \LANMAN.DOS for DOS or
  103. \LANMAN for OS/2. For IBM Lan Server this is \IBMLAN for OS/2.
  104.  
  105.         NIC is a common network industry acronym for Network Interface Card.
  106. This is the Ethernet, Token Ring or other adapter which connects PCs to a
  107. network. NIC Async allows an asynchronous serial port to be used as a NIC.
  108.  
  109.         MAC is an acronym for Medium Access Control. Network adapter drivers
  110. are often referred to as MAC drivers.
  111.  
  112.         NDIS is an acronym for the Microsoft/3Com Network Driver Interface
  113. Specification. This is a software interface designed to allow multiple network
  114. protocols to control network adapter drivers. NIC Async adheres to the NDIS
  115. version 2.01 specifications.
  116.         ────────────────
  117.          Files Included
  118.         ────────────────
  119.  
  120.         The following files are included on the Install Disk:
  121.  
  122.  
  123.     \Readme  .Doc       NIC Bridge/Async introductory document
  124.     \NBridge .Doc       This NIC Bridge document
  125.     \Tune    .Doc       Tuning document
  126.  
  127.     \Readme  .Bat       DOS batch file for NicDoc.Exe
  128.     \Readme  .Cmd       OS/2 command file for NicDoc.Exe
  129.  
  130.     \NicDoc  .Exe       NIC Bridge/Async DOS & OS/2 Documentation Viewer
  131.     \Install .Exe       NIC Bridge/Async DOS & OS/2 Install Utility
  132.  
  133.     \NicSetup.Exe       NIC Bridge/Async DOS & OS/2 Setup Utility
  134.     \NicCfg  .Exe       NIC Bridge/Async DOS & OS/2 Configuration Utility
  135.  
  136.  
  137.  
  138.  
  139.  
  140.     \NBr     .Exe       NIC Bridge DOS & OS/2 Full Screen Interface
  141.  
  142.  
  143.     \NBridge .DOS       DOS  NIC Bridge Driver for 386 & up
  144.     \NBridge .D86       DOS  NIC Bridge Driver for 8086 & up
  145.  
  146.     \NBridge .OS2       OS/2 NIC Bridge Driver for 386 & up on OS/2 1.2 & up
  147.     \NBridge .O86       OS/2 NIC Bridge Driver for 286 & up or OS/2 1.1
  148.  
  149.  
  150.     \SRTok   .DOS       DOS  Src Route Driver for 386 & up
  151.     \SRTok   .D86       DOS  Src Route Driver for 8086 & up
  152.  
  153.     \SRTok   .OS2       OS/2 Src Route Driver for 386 & up on OS/2 1.2 & up
  154.     \SRTok   .O86       OS/2 Src Route Driver for 286 & up or OS/2 1.1
  155.  
  156.  
  157.     \Ethern  .DOS       DOS  Dummy Ethernet Driver
  158.     \Ethern  .OS2       OS/2 Dummy Ethernet Driver
  159.  
  160.  
  161.  
  162.  
  163.     \Protman\Protman .DOS       DOS  Protocol Manager Driver
  164.     \Protman\Protman .OS2       OS/2 Protocol Manager Driver
  165.  
  166.     \Protman\Protman .Exe       DOS  Protocol Manager Transient Portion
  167.  
  168.     \Protman\Pro     .Msg       Protocol Manager Message File
  169.     \Protman\Proh    .Msg       Protocol Manager Help Message File
  170.  
  171.     \Protman\NetbindD.Exe       DOS  Protocol Manager Netbind Utility
  172.     \Protman\NetbindO.Exe       OS/2 Protocol Manager Netbind Utility
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.     \MSLM\Protocol.BD           DOS  Protocol.Ini for NIC Bridge
  187.     \MSLM\Protocol.BO           OS/2 Protocol.Ini for NIC Bridge
  188.  
  189.     \MSLM\NBridge .XD           DOS   386 NBridge.Xif
  190.     \MSLM\NBridge .XD8          DOS  8086 NBridge.Xif
  191.     \MSLM\NBridge .XO           OS/2  386 NBridge.Xif
  192.     \MSLM\NBridge .XO8          OS/2 8086 NBridge.Xif
  193.  
  194.  
  195.     \MSLM\Protocol.SD           DOS  Protocol.Ini for Src Route Token driver
  196.     \MSLM\Protocol.SO           OS/2 Protocol.Ini for Src Route Token driver
  197.  
  198.     \MSLM\SRTok   .ND           DOS   386 SRTok.Nif
  199.     \MSLM\SRTok   .ND8          DOS  8086 SRTok.Nif
  200.     \MSLM\SRTok   .NO           OS/2  386 SRTok.Nif
  201.     \MSLM\SRTok   .NO8          OS/2 8086 SRTok.Nif
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.         ─────────────────
  209.          NBridge Drivers
  210.         ─────────────────
  211.  
  212.         The DOS and OS/2 drivers NBridge.DOS and NBridge.OS2 are the "engine"
  213. of NIC Bridge and the vast majority of work is done within them. They are NDIS
  214. protocol level drivers and can be bound to multiple MAC level drivers to
  215. provide bridging between them. They do NOT provide the NetBIOS interface that
  216. protocol drivers such as MS/IBM NetBEUI or 3Com NBP do.
  217.  
  218.         The NBridge drivers can be bound to a maximum of 9 MAC level drivers.
  219. These MAC level drivers may be NAsync serial port drivers, SRTok Token Ring
  220. drivers or NDIS ethernet adapter drivers.
  221.  
  222.  
  223.         If you need support for PCs based on 80286 or lesser CPUs you will
  224. have to use the slower drivers: NBridge.D86 for DOS or NBridge.O86 for OS/2.
  225. The slower OS/2 driver is also required on OS/2 versions prior to version 1.2.
  226.  
  227.  
  228.  
  229.  
  230.  
  231.         ───────────────
  232.          SRTok Drivers
  233.         ───────────────
  234.  
  235.         The DOS and OS/2 drivers SRTok.DOS and SRTok.OS2 are required to use
  236. NIC Bridge in Source Routing mode on a Token Ring Network. The NDIS specs
  237. provide for adapter drivers to advertise themselves as providing Source
  238. Routing Bridge capability but no such drivers are readily available. These
  239. drivers provide this capability for IBM Token Ring adapters.
  240.  
  241.         If you need support for PCs based on 80286 or lesser CPUs you will
  242. have to use the slower drivers: SRTok.D86 for DOS or SRTok.O86 for OS/2.
  243. The slower OS/2 driver is also required on OS/2 versions prior to version 1.2.
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.         These drivers should work with all IBM Token Ring Adapters except for
  256. the original "IBM Token-Ring Adapter" and the new Bus Mastering adapter.
  257. Specifically the drivers should work with any of the following:
  258.  
  259.                 "IBM Token-Ring Network Adapter II"
  260.                 "IBM Token-Ring Network Adapter II/A"
  261.                 "IBM Token-Ring Network 16/4 Adapter"
  262.                 "IBM Token-Ring Network 16/4 Adapter/A"
  263.                 "IBM Token-Ring Network PS/2 Model P70 386 Adapter/A"
  264.  
  265.         At this time the SRTok drivers have been tested and verified with the
  266. "IBM Token-Ring Network Adapter II", "IBM Token-Ring Network 16/4 Adapter"
  267. and "IBM Token-Ring Network 16/4 Adapter/A" cards.
  268.  
  269.         The SRTok drivers are not currently supported for any use other than
  270. with NIC Bridge. IE, no other NDIS protocol drivers may be bound to SRTok.
  271. Thus, given that only 2 IBM Token Ring Adapters may be installed in a single
  272. PC, a two port local bridge configuration with the SRTok drivers will NOT be
  273. able to act as a network workstation or server unless it does so via a non-IBM
  274. Token Ring adapter.
  275.  
  276.  
  277.  
  278.         A workstation or server may act as a remote bridge with 2 IBM Token
  279. Ring adapters: 1 for the workstation/server functions and 1 for the bridge
  280. function.
  281.  
  282.         The use of "RAM paging" is not currently supported by these drivers,
  283. nor is the use of shared interrupts on MCA machines. It is generally best to
  284. set the adapter for the maximum available "Shared RAM Size". This is usually
  285. 16 KBytes on 4 Megabit per second cards and 64 KBytes on 4/16 cards.
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.         ────────────────────
  301.          NBr Bridge Utility
  302.         ────────────────────
  303.  
  304.         The bridge utility NBr.Exe provides a full-screen interface to view
  305. NIC Bridge statistics, NDIS statistics and other information provided by the
  306. network card drivers. It runs under both DOS & OS/2.
  307.  
  308.         In addition to the function keys shown at the bottom of the Nbr
  309. display, shortcut keys to the menu are implemented. These include Alt-O for
  310. the Options menu, Alt-M for the Mode menu and Alt-A for the Adapter menu.
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.         ────────────────────────
  324.          NicSetup Setup Utility
  325.         ────────────────────────
  326.  
  327.         The setup utility NicSetup.Exe can be used to setup NIC Bridge on
  328. standalone or networked PCs. It runs under both DOS & OS/2.
  329.  
  330.         Please refer to the Setup & Configuration section for further details
  331. on use of the NicSetup utility.
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.         ┌────────────────┐
  347.         │ CONSIDERATIONS │
  348.         └────────────────┘
  349.  
  350.         ───────────────────────────────
  351.          Ethernet Transparent Bridging
  352.         ───────────────────────────────
  353.  
  354.         NIC Bridge can provide MAC Level transparent bridging when used in
  355. conjunction with virtually any NDIS Ethernet driver and adapters. Installed
  356. on a PC with two Ethernet cards this can provide local bridging. With the
  357. NIC Async drivers on a PC with one Ethernet card a multi-port remote bridge
  358. can be configured. A remote bridge configuration may be used to link distant
  359. networks or to provide remote access to the local network by standalone PCs.
  360.  
  361.         Transparent bridging is so named because network protocol software
  362. needs no knowledge of the bridge's existence. The bridge operates by putting
  363. the Ethernet adapters into "promiscuous" mode where every network packet is
  364. seen. By monitoring these packets the bridge learns where network stations are
  365. by looking at the IEEE source addresses of the packets. When a packet must
  366. cross the bridge to reach it's destination the bridge recognises this and
  367. forwards the received packet to the proper adapter. Broadcast packets are
  368. forwarded to all adapters except the source adapter.
  369.  
  370.         On busy networks this constant monitoring of all packets can use all
  371. of the PC's CPU power. For this reason it is recommended that a dedicated PC
  372. be used for transparent bridging on busy networks. It is further recommended
  373. that high quality adapters and drivers be used with NIC Bridge. The high data
  374. rates that the bridge is capable of can expose rare bugs in drivers. A list of
  375. which adapters and drivers are fastest and most compatible with NIC Bridge
  376. will be compiled and maintained. Testing has been done mostly with 3Com 3C503
  377. Etherlink II adapters. The 3C503 drivers have been found to be very stable.
  378.  
  379.         The promiscuous mode necessary for transparent bridging is available
  380. on most true Ethernet NDIS drivers. Many NDIS drivers which merely emulate an
  381. Ethernet driver do not support promiscuous mode however. These drivers include
  382. those for Arcnet and FDDI. Among the true Ethernet NDIS drivers included with
  383. MS Lanman 2.1 only the Spider Systems Ethernet SC-100E driver appears to lack
  384. promiscuous mode.
  385.  
  386.         Some Ethernet NDIS drivers provide a feature known as "Loopback". This
  387. causes an adapter driver to appear to receive packets which it has transmitted
  388. and can reduce the performance of NIC Bridge. Although they may otherwise be
  389. excellent, the drivers from Accton, DCA, Western Digital and Ungermann Bass
  390. provide Loopback and may be less than ideal for bridging.
  391.  
  392.  
  393.         The address learning responsibility of a transparent bridge requires
  394. the use of an address table. The current version of NBridge allows a maximum
  395. of 256 network addresses to be stored. This should present no problems except
  396. on very busy, very large networks.
  397.  
  398.  
  399.         It should be noted that the NAsync drivers on a server acting as a
  400. remote bridge may need to be bound to server protocols as well as the NBridge
  401. protocol. This is because the NBridge protocol provides remote access to the
  402. external network, but not local protocols on the PC on which it is installed.
  403.  
  404.         One exception to this occurs when using a second network adapter
  405. exclusively for bridging, as the second adapter provides full access to all
  406. protocols bound to the first adapter. Another potential exception occurs when
  407. the adapter driver fully supports loopback in promiscuous mode.
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.         No special parameters are required for NIC Async when used with NIC
  417. Bridge in transparent bridge mode. The [NASYNC_NIF] parameter MAC_TYPE should
  418. be set to it's default of "DIX+802.3".
  419.  
  420.         The following Protocol.Ini parameters are relevant for a transparent
  421. bridge configuration and are set in the [NBRIDGE_XIF] section of Protocol.Ini.
  422.  
  423.  
  424.     ; Only allowed parameter for Drivername.
  425.  
  426.   DRIVERNAME    = NBRIDGE$
  427.  
  428.  
  429.      ; "TRANSPARENT" required for transparent bridging.
  430.  
  431.   BRIDGEMODE    = "TRANSPARENT"
  432.  
  433.  
  434.     ; 1 Binding specified for each port of the bridge.
  435.     ; This example is for a combined local and remote bridge.
  436.  
  437.   BINDINGS      = "ELNKII_NIF", "ELNKII_NIF2, "NASYNC_NIF", "NASYNC_NIF2"
  438.  
  439.     ; Enables Bridging for each NIC driver. Order identical to BINDINGS.
  440.     ;  Allowed: "YES" or "NO".
  441.     ;  Default:  "YES" for all.
  442.  
  443.  BRIDGE_MAC      = YES, YES, YES, YES, YES, YES, YES, YES, YES
  444.  
  445.  
  446.     ; Enables Packet Capture for each NIC driver. Order identical to BINDINGS.
  447.     ;  Allowed: "YES" or "NO".
  448.     ;  Default:  "YES" for all.
  449.     ;  Recommend "NO" for high-performance production use.
  450.  
  451.  CAPTURE_MAC     = YES, YES, YES, YES, YES, YES, YES, YES, YES
  452.  
  453.  
  454.     ; Filters Broadcasts rcvd by each NIC driver. Order identical to BINDINGS.
  455.     ;  Allowed: "YES" or "NO".
  456.     ;  Default:  "NO" for all.
  457.     ; Set "YES" ONLY on local NICS to eliminate broadcast traffic.
  458.     ; Note: "YES" does not allow correct operation of MS TCP/IP.
  459.  
  460.   FILTERBC_MAC  = NO, NO, NO, NO, NO, NO, NO, NO, NO
  461.         ────────────────────────────────────
  462.          Token Ring Source Routing Bridging
  463.         ────────────────────────────────────
  464.  
  465.         NIC Bridge provides Source Routing bridging when used in conjunction
  466. with the SRTok driver and an IBM Token Ring Adapter. Installed on a PC with
  467. two IBM Token Ring Adapters this can provide local Source Routing bridging.
  468. With the NIC Async drivers on a PC with one IBM card a multi-port remote
  469. Source Routing bridge can be configured. A remote bridge configuration may be
  470. used to link distant networks or to provide remote access to the local network
  471. by standalone PCs. Note that an IBM adapter is only required on the bridge PC.
  472. Other stations on the network can use virtually any Token Ring adapter.
  473.  
  474.         Source Routing Bridging is so named because the source of a network
  475. packet must explicity specify the route the packet will take through bridges.
  476. Thus the network protocol software must explicitly support Source Routing.
  477. Protocols such as MS/IBM NetBEUI support this but 3Com NBP does not.
  478.  
  479.         The bridge operates by putting the Token Ring adapter into Source
  480. Routing Bridge mode, where only packets needed to be forwarded by the bridge
  481. are seen. The bridge then forwards received packets to the proper adapter.
  482.  
  483.  
  484.  
  485.         Because Source Routing Bridge mode on the IBM Token Ring adapters
  486. can be set to only cause packets which need forwarding to be received, busy
  487. networks are less of a problem. It is still recommended, however, that a
  488. dedicated PC be used for Source Routing bridging on busy networks.
  489.  
  490.         The Source Routing architecture requires that each ring in the Token
  491. Ring inter-network be assigned a ring number from 0 to decimal 4095. The IBM
  492. scheme for Source Routing Bridging on IBM Token Ring adapters requires that
  493. the adapter be programmed with the "Local Ring Number" for the ring that
  494. adapter is connected to, and an "Other Ring Number" for the ring another
  495. adapter in the same bridge PC is connected to.
  496.  
  497.         This generally restricts IBM Token Ring adapter Source Routing bridges
  498. to supporting only two adapters. As only two IBM adapters may be installed in
  499. a single PC this is no problem for a local bridge based on IBM adapters. This
  500. is however a problem for a multi-port remote bridge.
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.         NIC Bridge tackles this problem by using the concept of an "Internal
  509. Ring" in the bridge. This Internal Ring has no stations on it, only virtual
  510. internal bridges. The diagram following shows this.
  511.  
  512.         Note that all "bridges" shown are virtual bridges within NIC Bridge.
  513. This configuration employs two IBM Token Ring adapters and three serial ports
  514. for a total of five ports. The local rings, Ring 1 and Ring 2 are each served
  515. by one of the IBM Token Ring adapters. Ring 3 is the internal ring and exists
  516. in a logical sense only. The remote rings, Rings 4-6, are served by one of the
  517. three serial ports.
  518.  
  519.         This "Internal Ring" scheme allows the use of a common "Other Ring
  520. Number" for all ports and thus allows multiple port configurations. The only
  521. potential disadvantage to this scheme is that two "bridges" must be crossed
  522. by a packet moving from one port to another. As a "Hop limit", or maximum
  523. crossed bridged count, of 8 is used in Source Routing, this 2 bridge hop will
  524. limit the number of bridges a packet may cross to 4, rather than 8. As a
  525. remote bridge must exist at each end of a serial link, the actual limit to
  526. the maximum number of serial links a packet may cross is 2.
  527.  
  528.  
  529.  
  530.  
  531.         { LS = Local Station, RS = Remote Station }
  532.  
  533.       LOCAL RINGS              SHARED  RING      REMOTE  RINGS
  534.         (Wired)                 (Internal)          (Async)
  535.     ┌───┐     ┌───┐
  536. ┌───┤LS1├─────┤LS2├───┐         ┌────────┐         ┌───────┐
  537. │   └───┘     └───┘ ┌─┴─────────┴─┐    ┌─┴─────────┴─┐   ┌─┴─┐
  538. │     Ring 1        │ Loc Bridge 1│    │ Rem Bridge 1│   │RS1│ Ring 4
  539. │   ┌───┐     ┌───┐ └─┬─────────┬─┘    └─┬─────────┬─┘   └─┬─┘
  540. └───┤LS3├─────┤LS4├───┘         │        │         └───────┘
  541.     └───┘     └───┘             │ Ring 3 │         ┌───────┐
  542.                                 │      ┌─┴─────────┴─┐   ┌─┴─┐
  543.                                 │      │ Rem Bridge 2│   │RS2│ Ring 5
  544.                                 │      └─┬─────────┬─┘   └─┬─┘
  545.     ┌───┐     ┌───┐             │        │         └───────┘
  546. ┌───┤LS5├─────┤LS6├───┐         │        │         ┌───────┐
  547. │   └───┘     └───┘ ┌─┴─────────┴─┐    ┌─┴─────────┴─┐   ┌─┴─┐
  548. │     Ring 2        │ Loc Bridge 2│    │ Rem Bridge 3│   │RS3│ Ring 6
  549. │   ┌───┐     ┌───┐ └─┬─────────┬─┘    └─┬─────────┬─┘   └─┬─┘
  550. └───┤LS7├─────┤LS8├───┘         │        │         └───────┘
  551.     └───┘     └───┘             └────────┘
  552.  
  553.  
  554.         It should be noted that remote Source Routing bridging from one
  555. network to another requires attention to ring numbering. A two port remote
  556. bridge, for example, requires three ring numbers: a local ring number, an
  557. internal ring number and a serial port ring number. All three of these must
  558. be different from each other and all other rings accessible via bridges.
  559.  
  560.         The asynchronous serial data path between two remote bridges, however,
  561. acts as if it is a single ring. Thus, the serial port ring number of two
  562. remote bridges which connect must be identical. This is illustrated below.
  563.  
  564.  
  565. ┌──────────┐ ┌──────────┐ ┌──────────┐
  566. │  LOCAL   │ │ INTERNAL │ │  SERIAL  │
  567. │          ├─┤          ├─┤          ├─┐
  568. │ Ring # 1 │ │ Ring # 2 │ │ Ring # 3 │ │ Serial Data Path
  569. └──────────┘ └──────────┘ └──────────┘ │
  570.                         ┌──────────────┘
  571.                         │ ┌──────────┐ ┌──────────┐ ┌──────────┐
  572.                         │ │  SERIAL  │ │ INTERNAL │ │  LOCAL   │
  573.                         └─┤          ├─┤          ├─┤          │
  574.                           │ Ring # 3 │ │ Ring # 4 │ │ Ring # 5 │
  575.                           └──────────┘ └──────────┘ └──────────┘
  576.  
  577.         NIC Async must be configured to appear as a Token Ring adapter when
  578. used with NIC Bridge in Source Routing bridge mode. This applies to the NAsync
  579. drivers loaded on the bridge as well as those loaded on remote PCs.
  580.  
  581.         This can be done by changing the MAC_TYPE parameter in the
  582. [NASYNC_NIF] section of Protocol.Ini from the default of "DIX+802.3" to
  583. "802.5".
  584.  
  585.  
  586.  
  587.     ; NIC Async parameter in [NASYNC_NIF] section of Protocol.Ini
  588.     ;  required for driver installed on Bridge PC AND remote PC.
  589.     ; Ensure "802.5" exactly, default is "DIX+802.3" for Ethernet.
  590.  
  591.   MAC_TYPE      = "802.5"
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.         The following Protocol.Ini parameters are relevant for a Source
  601. Routing bridge configuration. These are set in the [NBRIDGE_XIF] section of
  602. Protocol.Ini.
  603.  
  604.  
  605.     ; Only allowed parameter for Drivername.
  606.  
  607.   DRIVERNAME    = NBRIDGE$
  608.  
  609.  
  610.      ; "SOURCEROUTING" required for Source Routing bridging.
  611.  
  612.   BRIDGEMODE    = "SOURCEROUTING"
  613.  
  614.  
  615.     ; Internal Ring number for virtual ring connecting all internal bridges.
  616.     ;  Allowed:  0x0 - 0x0FFF or 0 - 4095.
  617.     ;  Use any valid unassigned Ring Number.
  618.  
  619.   INTERNALRING  = 1110
  620.  
  621.  
  622.  
  623.     ; 1 Binding specified for each port of the bridge.
  624.     ; This example is for a combined local and remote bridge.
  625.  
  626.   BINDINGS      = "SRTOK_NIF", "SRTOK_NIF2, "NASYNC_NIF", "NASYNC_NIF2"
  627.  
  628.  
  629.     ; Enables Bridging for each NIC driver. Order identical to BINDINGS.
  630.     ;  Allowed: "YES" or "NO".
  631.     ;  Default:  "YES" for all.
  632.  
  633.   BRIDGE_MAC    = YES, YES, YES, YES, YES, YES, YES, YES, YES
  634.  
  635.  
  636.     ; Enables Packet Capture for each NIC driver. Order identical to BINDINGS.
  637.     ;  Allowed: "YES" or "NO".
  638.     ;  Default:  "YES" for all.
  639.     ;  Recommend "NO" for high-performance production use.
  640.  
  641.   CAPTURE_MAC   = YES, YES, YES, YES, YES, YES, YES, YES, YES
  642.  
  643.  
  644.  
  645.  
  646.     ; Ring number for each NIC driver bound. Order identical to BINDINGS.
  647.     ;  Allowed:  0x0 - 0x0FFF or 0 - 4095.
  648.     ;  If you already have SR Bridges assigned Ring Numbers MUST match these.
  649.  
  650.   RING_MAC      = 1111, 1112, 1113, 1114, 1115, 1116, 1117, 1118, 1119
  651.  
  652.  
  653.     ; Filters Broadcasts rcvd by each NIC driver. Order identical to BINDINGS.
  654.     ;  Allowed: "YES" or "NO".
  655.     ;  Default:  "NO" for all.
  656.     ; Set to yes ONLY on local NICS to eliminate broadcast traffic.
  657.     ; Note: "YES" does not allow correct operation of MS TCP/IP.
  658.  
  659.   FILTERBC_MAC  = NO, NO, NO, NO, NO, NO, NO, NO, NO
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.         The SRTok driver Protocol.Ini parameters are the same as those for
  670. the IBM Token Ring NDIS driver. The following parameters are those that are
  671. most important and are set in the [SRTOK_NIF] section of Protocol.Ini.
  672.  
  673.  
  674.     ; SRTOK$ for first adapter, SRTOK2$ for second adapter.
  675.   DRIVERNAME    = SRTOK$
  676.  
  677.     ; Required to set non-default Ram address.
  678.   RAM           = 0xD800
  679.  
  680.     ; Either Primary or Alternate adapter, NOT BOTH ! Default = PRIMARY.
  681.   PRIMARY
  682.  ;ALTERNATE
  683.  
  684.  
  685.     ; Setting SRBC = NO allows single route broadcasts to be filtered.
  686.   SRBC = YES
  687.  
  688.  
  689.  
  690.  
  691.         ┌──────────────────────────┐
  692.         │ SETUP/MAIN CONFIGURATION │
  693.         └──────────────────────────┘
  694.  
  695.     To setup and configure NIC Bridge:
  696.  
  697.  
  698. 1)      Install Lan Manager or Lan Server if needed on this PC. Ensure that
  699.         all local Ethernet and Token Ring adapters have been configured
  700.         properly.
  701.  
  702. 2)      Install NIC Bridge/Async on the PC. With the NIC Bridge/Async install
  703.         disk inserted into the A: drive the command "A:\Install" will initiate
  704.         the installation procedure. When this is complete the PC should be
  705.         rebooted.
  706.  
  707. 3)      If remote ethernet bridging will be provided and this PC is a server,
  708.         NIC Async must be setup and configured. This will provide remote
  709.         access to this server, while the bridge component provides access to
  710.         other servers. Token ring bridges should not have NIC Async installed.
  711.         as the second Token Ring adapter provides access to this server. Refer
  712.         to the NIC Async document for NIC Async installation instructions.
  713.  
  714.  
  715. 4)      If this will be an ethernet bridge, any device drivers required for
  716.         your ethernet adapter should be copied to the NICDIR directory,
  717.         normally C:\NIC11.
  718.  
  719.         Run NicSetup.Exe and ensure that the General Configuration information
  720.         displayed is appropriate. Option 2 "Change General Configuration" may
  721.         be used to make any changes.
  722.  
  723.         Select option 3 to "Setup NIC Bridge" and answer the prompts with
  724.         appropriate selections.
  725.  
  726.  
  727.         If setting up an Ethernet bridge:
  728.  
  729.           If your network adapter is not listed as a selection, specify the
  730.           "Dummy Ethernet Driver". This will require Config.Sys lines of the
  731.           form "DEVICE = C:\NIC11\ETHERN...." be replaced with entries for
  732.           your ethernet adapter driver. The Protocol.Ini [ETHERN_NIF] sections
  733.           will also have to be modified to set the appropriate options for
  734.           that adapter driver.
  735.  
  736.  
  737.  
  738. 5)      Before rebooting your PC, the Protocol.Ini file may need modification.
  739.         This can be done with the NicCfg.Exe utility. Within NicCfg select
  740.         "Config", "Bridge". When each screen of options is appropriate
  741.         press the <Enter> key.
  742.  
  743.         The Ring Number variables are important only when the bridge
  744.         is setup as a source routing bridge.
  745.  
  746.         Other Bridge options may be left at default or changed as appropriate
  747.         for your environment. Press <Enter> to save the options.
  748.  
  749.  
  750.  
  751.         If Source Routing is being used, select "Config", "SR Token 1" to
  752.         configure the Source Routing Token Ring driver. Ensure that the Ram
  753.         Address selected is available on your PC.
  754.  
  755.         Other SRTOK options may be left at default or changed as appropriate
  756.         for your environment. Press <Enter> to save the options.
  757.  
  758.  
  759.  
  760.  
  761.         If this is a remote bridge select "Config", "Async 1". When each
  762.         screen of options is appropriate press the <Enter> key. Repeat this
  763.         for "Async 2" and all other serial ports configured.
  764.  
  765.  
  766.         The MAC Type option should be set to Ethernet unless this is a Source
  767.         Routing bridge when it should be set to Token Ring.
  768.  
  769.  
  770.         The Network address value should be unique among all network addresses
  771.         in use on the network. Remember to set a DIFFERENT Network address on
  772.         the host and all clients.
  773.  
  774.         Other options may be left at default or changed as appropriate for
  775.         your environment.
  776.  
  777.         Exit NicCfg with the <F3> key.
  778.  
  779.         Inspect and edit Protocol.Ini to ensure any Ethernet adapter drivers
  780.         are configured as desired. Note that many ethernet adapters use IRQ 3
  781.         by default and that this will interfere with COM2.
  782.  
  783.  
  784. 6)      All servers and workstations which will use remote resources or
  785.         be remotely accessed must be tuned for low speed operation.
  786.  
  787.         Run NicSetup.Exe and select option 4 to tune NetBEUI and the LAN
  788.         software for low speed operation on all servers and workstations
  789.         which will communicate via a remote bridge. NicSetup.Exe may be
  790.         copied to and run from a floppy disk to perform this on servers.
  791.  
  792. 7)      Reboot the PC and ensure that all drivers load properly.
  793.  
  794.  
  795.  
  796.  
  797.         NOTE:   Running the MS Lan Manager Setup.Exe or IBM Lan Server
  798.                 LanInst.Exe utilities after NIC Bridge is setup and
  799.                 configured by cause information in Config.Sys and
  800.                 Protocol.Ini to be deleted. This will require that
  801.                 the NIC Bridge setup and configuration be repeated.
  802.  
  803.  
  804.  
  805.  
  806.         ┌───────────┐
  807.         │ OPERATION │
  808.         └───────────┘
  809.  
  810.         The NIC Bridge PC should start and run normally. The Device driver(s)
  811. should load from Config.Sys and display ID messages. Note that should any of
  812. the drivers cause problems booting a PC, installation of the driver may be
  813. aborted by holding down the Alt-Key.
  814.  
  815.         No errors should be produced when NetBind is run (or when the
  816. NETWKSTA.SYS IFS is loaded). If you get any errors, inspect the Protocol.Ini
  817. file for configuration errors and/or try changing the adapter settings. If the
  818. Netbind has succeeded the bridge should now be operational.
  819.  
  820.         Executing NBr.Exe will provide a screen showing the bridge statistics.
  821. Note that when the NAsync drivers are in a "Closed" state, packets will still
  822. appear to be forwarded to them. It is only when a client connects to the host
  823. bridge that these packets are actually forwarded through the serial port.
  824.  
  825.  
  826.  
  827.  
  828.  
  829.         ┌────────────────────┐
  830.         │ NBRIDGE PARAMETERS │
  831.         └────────────────────┘
  832.  
  833.         The following pages detail Protocol.Ini parameters for the NBridge
  834. driver. Defaults are shown. Parameter values shown in quotes are ASCII string
  835. parameters. All other parameters are numeric. Numeric parameters preceded with
  836. "0x" are hexadecimal values while all others are decimal values.
  837.  
  838.     REQUIRED NDIS PARAMETERS:
  839.  
  840.  
  841.                 ; Required parameter
  842.                 ; Range: NBRIDGE$ only
  843.  
  844.         DRIVERNAME      = "NBRIDGE$"
  845.  
  846.  
  847.                 ; Required parameter
  848.                 ; 1 Binding specified for each port of the bridge.
  849.                 ; Form: "Driver1_NIF", "Driver2_NIF", etc. up to 9 ports
  850.  
  851.         BINDINGS        = No Default
  852.  
  853.     GENERAL PARAMETERS:
  854.  
  855.                 ; Configures Transparent Ethernet or Source Routing
  856.                 ;  Token Ring bridge mode.
  857.                 ; Range: "TRANSPARENT" or "SOURCEROUTING"
  858.  
  859.         BRIDGEMODE      = "TRANSPARENT"
  860.  
  861.  
  862.                 ; Enables Bridging for each NIC driver.
  863.                 ; Order identical to BINDINGS.
  864.                 ; Range: "YES" or "NO"
  865.  
  866.         BRIDGE_MAC      ="YES","YES","YES","YES","YES","YES","YES","YES","YES"
  867.  
  868.  
  869.                 ; Enables Packet Capture for each NIC driver.
  870.                 ; Order identical to BINDINGS.
  871.                 ; Range: "YES" or "NO"
  872.  
  873.         CAPTURE_MAC     ="YES","YES","YES","YES","YES","YES","YES","YES","YES"
  874.  
  875.  
  876.                 ; Enables filtering broadcasts received by each NIC driver.
  877.                 ; Order identical to BINDINGS.
  878.                 ; Range: "YES" or "NO"
  879.                 ; Set "YES" ONLY on local NICS to eliminate broadcast traffic.
  880.                 ; Note: "YES" does not allow correct operation of MS TCP/IP.
  881.  
  882.         FILTERBC_MAC    = "NO", "NO", "NO", "NO", "NO", "NO", "NO", "NO", "NO"
  883.  
  884.  
  885.                 ; Each CUSTOMFILTER parameter configures one condition whereby
  886.                 ;  packets which would normally be forwarded are filtered.
  887.                 ; Up to 16 individual CUSTOMFILTER lines may be configured.
  888.                 ; Each custom filter consists of a string of 8 - 58 characters
  889.                 ;  representing a hexadecimal string of 4 - 29 bytes.
  890.                 ; The first byte represents the offset in the packet used
  891.                 ;  for filtering criteria.
  892.                 ; The second and third bytes represent a mask to determine
  893.                 ;  which bridge ports the filter shall affect.
  894.                 ; The subsequent bytes represent the filtering criteria.
  895.                 ; See the following pages for examples.
  896.  
  897.          CUSTOMFILTER   = No Default
  898.  
  899.                 ; The example below filters all Ethernet packets with a
  900.                 ;  destination address of 02608C010203. The offset of 00
  901.                 ;  corresponds to the beginning of the destination address
  902.                 ;  in an Ethernet packet. The mask value of FFFF prevents
  903.                 ;  packets matching the filter criteria from being forwarded
  904.                 ;  on all bridge ports.
  905.  
  906.         CUSTOMFILTER    = "00FFFF02608C010203"
  907.                            00                   offset = 0 = dest address
  908.                              FFFF               Filter on all ports
  909.                                  02608C010203   match value
  910.  
  911.  
  912.                 ; The example below filters Ethernet packets with a source
  913.                 ;  address of 02608C010203 from MAC 2, 1 and 0. MAC 1 and 2
  914.                 ;  are the ports corresponding to the first and second drivers
  915.                 ;  bound to NBridge. MAC 0 is the virtual packet capture port.
  916.  
  917.         CUSTOMFILTER    = "06000702608C010203"
  918.                            06                   offset = 6 = source address
  919.                              0007               Filter on MAC 2, 1 and 0
  920.                                  02608C010203   match value
  921.  
  922.                 ; The example below filters all Token Ring packets with a
  923.                 ;  destination address of 10005A010203. The offset of 02
  924.                 ;  corresponds to the beginning of the destination address
  925.                 ;  in a Token Ring packet. Note that the destination address
  926.                 ;  of a Token Ring packet begins at offset 02, after the start
  927.                 ;  delimiter and access control bytes of Token Ring.
  928.  
  929.         CUSTOMFILTER    = "02FFFF10005A010203"
  930.                            02                   offset = 2 = dest address
  931.                              FFFF               Filter on all ports
  932.                                  10005A010203   match value
  933.  
  934.  
  935.                 ; The example below filters all source routed Token Ring
  936.                 ;  packets with a source address of 10005A010203. Note that
  937.                 ;  the highest bit of the source address is set to accomodate
  938.                 ;  the source routing bit of Token Ring.
  939.  
  940.         CUSTOMFILTER    = "08FFFF90005A010203"
  941.                            08                   offset = 8 = source address
  942.                              FFFF               Filter on all ports
  943.                                  90005A010203   match value
  944.  
  945.     SOURCE ROUTING PARAMETERS:
  946.  
  947.  
  948.                 ; Internal Ring number for virtual ring connecting internal
  949.                 ;  bridges in Source Routing Token Ring bridge mode.
  950.                 ; Range:  0 - 4095
  951.                 ; Use any valid unassigned Ring Number
  952.  
  953.         INTERNALRING    = 1110
  954.  
  955.  
  956.  
  957.  
  958.                 ; Ring number for each NIC driver.
  959.                 ; Order identical to BINDINGS.
  960.                 ; Range:  0 - 4095
  961.                 ; If you already have Source Routing Bridges the assigned
  962.                 ;  Ring Numbers MUST match these on Local
  963.  
  964.         RING_MAC        = 1111, 1112, 1113, 1114, 1115, 1116, 1117, 1118, 1119
  965.  
  966.  
  967.         ┌──────────────────┐
  968.         │ SRTOK PARAMETERS │
  969.         └──────────────────┘
  970.  
  971.         The following pages detail Protocol.Ini parameters for the SRTok
  972. driver. Defaults are shown. Parameter values shown in quotes are ASCII string
  973. parameters. All other parameters are numeric. Numeric parameters preceded with
  974. "0x" are hexadecimal values while all others are decimal values.
  975.  
  976.  
  977.  
  978.     REQUIRED NDIS PARAMETERS:
  979.  
  980.  
  981.                 ; First driver is "SRTOK$", second is "SRTOK2$", etc.
  982.                 ; Range: SRTOK$ - SRTOK2$
  983.                 ; Only required parameter
  984.  
  985.         DRIVERNAME      = "SRTOK$"
  986.  
  987.  
  988.  
  989.  
  990.  
  991.     GENERAL PARAMETERS:
  992.  
  993.  
  994.                 ; Sets Primary or Alternate adapter
  995.                 ; Do not set both ! (semicolon starts remark line)
  996.                 ; PRIMARY is default
  997.  
  998.         PRIMARY
  999.        ;ALTERNATE
  1000.  
  1001.  
  1002.                 ; Sets adapter Ram address
  1003.                 ; Range: 0x0000 - 0xFFFC where low 2 bits = 0
  1004.  
  1005.         RAM             = 0xD800
  1006.  
  1007.  
  1008.                 ; Maximum queued transmits
  1009.                 ; Range: 1 - 32
  1010.  
  1011.         MAXTRANSMITS    = 8
  1012.  
  1013.  
  1014.                 ; Sets the adapter product identification
  1015.                 ; Range: exactly 36 hex digits
  1016.  
  1017.         PRODUCTID = "0110F0F0F0F0F0F0F0F0F0F0F0F0F0F0F0F0"
  1018.  
  1019.  
  1020.                 ; Enables reception of Single Route Broadcasts
  1021.                 ; Range: "YES" or "NO"
  1022.  
  1023.         SRBC            = "YES"
  1024.  
  1025.  
  1026.                 ; Enables Early Token Release feature on 16 Mbps rings
  1027.                 ; Range: "YES" or "NO"
  1028.  
  1029.         EARLYRELEASE = "NO"
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.     IBM ISA TOKEN RING ADAPTER SWITCH SETTINGS:
  1038.  
  1039.         Off = Up   = U
  1040.         On  = Down = D
  1041.  
  1042.                 ┌────────────┐
  1043.                 │123456789111│  Switch Block
  1044.                 │         012│
  1045.                 └────────────┘
  1046.  
  1047.                             D    (12)       4  Mbps Ring Speed
  1048.                             U               16 Mbps Ring Speed
  1049.  
  1050.                           DD     (10,11)    8  KB Shared RAM size
  1051.                           UD                16 KB Shared RAM size
  1052.                           DU                32 KB Shared RAM size
  1053.                           UU                64 KB Shared RAM size
  1054.  
  1055.                          U       (9)        Primary Adapter
  1056.                          D                  Alternate Adapter
  1057.  
  1058.  
  1059.  
  1060.         Off = Up   = U
  1061.         On  = Down = D
  1062.  
  1063.                 ┌────────────┐
  1064.                 │123456789111│  Switch Block
  1065.                 │         012│
  1066.                 └────────────┘
  1067.  
  1068.                        DD        (7,8)      IRQ 2
  1069.                        DU                   IRQ 3
  1070.                        UD                   IRQ 6
  1071.                        UU                   IRQ 7
  1072.  
  1073.                  UDDDDD          (1-6)      ROM @ C000
  1074.                  UDDUDD                     ROM @ C800
  1075.                  UDUDDD                     ROM @ D000
  1076.                  UDUUDD                     ROM @ D800
  1077.                  UUDDDD                     ROM @ E000
  1078.                  UUDUDD                     ROM @ E800
  1079.  
  1080.  
  1081.  
  1082.         ┌──────────────────┐
  1083.         │ ACKNOWLEDGEMENTS │
  1084.         └──────────────────┘
  1085.  
  1086.         All trademarks are the property of their owners.
  1087.  
  1088.         This includes, but is not limited to, the trademarks
  1089.         of 3Com, IBM, Microsoft, and Hayes.
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104. ;
  1105.