home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: OtherApp / OtherApp.zip / vpc50.zip / vswitch.txt < prev   
Text File  |  2002-03-29  |  11KB  |  272 lines
  1.                  Virtual PC for OS/2 Virtual Switch
  2.                  ==================================
  3.  
  4.  
  5. (C) 2001-2002 InnoTek Systemberatung GmbH
  6.  
  7.  
  8. 1. Overview
  9. -----------
  10.  
  11. Virtual PC for OS/2 allows you to execute additional operating
  12. systems on top of your OS/2 system. Virtual PC provides access to
  13. your system through virtual hardware making it a very flexible and
  14. powerful solution.
  15.  
  16. Virtual Switch Networking is the most powerful way of connecting
  17. your guest systems to an Ethernet network. It assigns a unique
  18. MAC address to your virtual machine, allowing it to use arbitrary
  19. network protocols and even act as a server. For other machine in
  20. the network, the virtual machine appears as an additional network
  21. station and it is indistinguishable from a "real" PC.
  22.  
  23. Note that while Virtual Switch Networking gives you more power
  24. and flexibility, it also means additional administration. The
  25. virtual machine uses a MAC address of its own and therefore needs
  26. a unique IP address etc. For typical TCP/IP requirements, the
  27. Shared Networking (NAT) is recommended.
  28.  
  29. 1.1 Technical Background
  30. ------------------------
  31.  
  32. The Virtual Switch driver works by hooking between a physical
  33. Ethernet card driver and software protocols such as TCP/IP,
  34. IEEE 802.2 or NETBIOS. It switches the Ethernet card to the
  35. so called "promiscuous mode". Normally, an Ethernet chip will
  36. listen to all frames on the physical medium but only report
  37. such frames that are either destined to its own MAC address
  38. (UAA, universally administered address or LAA, locally
  39. administered address), broadcast frames or multicast frames
  40. matching the criteria stored by the protocol drivers in its
  41. multicast table. All other frames will be ignored. In
  42. promiscuous mode, the chip will pick up all frames, regardless
  43. of where they are destined to. This is useful for network
  44. traffic monitors and the Virtual Switch. The Virtual Switch
  45. driver will get all frames from the Ethernet chip and first
  46. look at the type of frame (unicast, multicast, broadcast).
  47. For unicast frames, it will examine the destination MAC
  48. address and see if it destined to any of the registered
  49. virtual machines. For these frames and broadcast and
  50. multicast frames, they will be passed on to Virtual PC.
  51.  
  52. The Virtual Switch driver also contains logic to allow a
  53. virtual machine to communicate with another virtual machine
  54. on the same host PC (again including full support for
  55. broadcast and multicast frames) and to the host system
  56. itself.
  57.  
  58. The Virtual Switch has been implemented in a way that causes
  59. no impact on your host system's operation. Host system
  60. networking will work like it did before. The Virtual Switch
  61. will not cause any notable performance impact.
  62. Also, the Virtual Switch will only put the Ethernet card
  63. into promiscuous mode if there are one or more virtual
  64. machines running.
  65.  
  66. It is "common knowledge" that promiscuous mode makes the
  67. system slow. However, this is pretty much nonsense. First
  68. of all, Virtual PC will only turn on promiscuous mode if
  69. necessary and even when turned on, the performance hit is
  70. so minimal that you will not notice any degradation. A
  71. system that is capable of running Virtual PC is so fast,
  72. that handling the additional frames on the Ethernet is not
  73. a problem at all. A typical Ethernet is a switched Ethernet.
  74. There, even in promiscuous mode, only frames destined to
  75. the local system or systems connected to the same port of
  76. the next switch can be found.
  77.  
  78.  
  79. 2. Prerequisites
  80. ----------------
  81.  
  82. 2.1 Hardware
  83. ------------
  84.  
  85. OS/2 supported Ethernet card with a device driver capable of
  86. operating it in promiscuous mode. Even though the Realtek 8139
  87. OS/2 driver does not support promiscuous mode, the Virtual
  88. Switch driver includes a special workaround to enable
  89. promiscuous mode on this popular chipset.
  90.  
  91. Currently, only Ethernet cards (and other cards such as
  92. WaveLAN 802.11b that use Ethernet frames) are supported. Token
  93. Ring is not supported at this time as it is fundamentelly
  94. different from Ethernet and not compatible with how the Virtual
  95. Switch works. InnoTek is working on providing Token Ring support
  96. in a future version of the product.
  97.  
  98. 2.2 Software
  99. ------------
  100.  
  101. OS/2 Warp 4 with networking support (MPTS/LAPS) is required
  102. for the Virtual Switch to operate.
  103.  
  104.  
  105. 3. Installation
  106. ---------------
  107.  
  108. 3.1 Automatic Installation
  109. --------------------------
  110.  
  111. During Virtual PC for OS/2 installation, you can also configure
  112. Virtual Switch networking. The automatic installation will allow
  113. you to attach the Virtual Switch to one network card (NIC) and
  114. also allow you to uninstall the Virtual Switch at any time.
  115.  
  116. The Virtual Switch attaches to a given NIC. The installer will
  117. present a list of NICs configured (read from PROTOCOL.INI with
  118. NIC names taken from NIF files) and allow you to choose the card
  119. the Virtual Switch will be attached to.
  120.  
  121. The installation program will automatically make the required
  122. changes to CONFIG.SYS and PROTOCOL.INI. You can undo those changes
  123. at any time by opening the Virtual PC setup program from the
  124. Virtual PC folder and removing the Virtual Switch.
  125.  
  126. 3.2 Manual Installation
  127. -----------------------
  128.  
  129. Currently, advanced setup options for Virtual Switch networking
  130. have to be done manually in MPTS. Usually, the automatic
  131. installation is sufficient.
  132.  
  133. Before installation, please make a backup copy of
  134. \IBMCOM\PROTOCOL.INI.
  135.  
  136. Open MPTS either through the program object in the system setup
  137. folder or launching mpts.exe.
  138.  
  139. Go to the networking configuration screen. This screen contains
  140. 3 listboxes and a number of buttons. The upper left listbox contains
  141. the list of registered MAC drivers (media access control, NDIS driver
  142. for network cards). Click on "Other adapters..." and select the
  143. Virtual Switch directory. This will add an additional network card
  144. called "InnoTek Virtual Switch MAC" to the list.
  145.  
  146. The upper right listbox contains a list of registered NDIS protocol
  147. drivers. Click on the "Other protocols..." button and select the
  148. Virtual Switch directory. This will add a new protocol called
  149. "InnoTek Virtual Switch Protocol" to the list.
  150.  
  151. The lower listbox contains the current configuration. It will
  152. show the MAC drivers and the protocols bound to each MAC driver.
  153. Assuming you have an IBM 10/100 PCI Ethernet card and use TCP/IP
  154. as well as NETBIOS over TCP/IP, it will look as following:
  155.  
  156. IBM 10/100 Ethernet PCI Adapter...........
  157.      0 - IBM TCP/IP
  158.      0 - IBM OS/2 NETBIOS OVER TCP/IP
  159.  
  160. The Virtual Switch operates by hooking between the protocol
  161. drivers and the MAC driver. In order to do this, you have to
  162. carefully change the binding as follows.
  163.  
  164. Select the MAC driver you want to install the Virtual Switch
  165. for (for instructions on how to support multiple MACs read the
  166. following section after following the procedures described
  167. here).
  168.  
  169. Now select the "InnoTek Virtual Switch MAC" in the upper left
  170. listbox and press the "Change" button. Confirm the following
  171. message. This will cause your protocols to be bound to the
  172. Virtual Switch driver.
  173.  
  174. Now select your original MAC in the upper left listbox and click
  175. add. It will appear in the lower list. Select the entry in this
  176. list.
  177.  
  178. Now select the "InnoTek Virtual Switch Protocol" in the upper
  179. right listbox and click "Add". For the IBM PCI card, your
  180. bindings will now look as follows:
  181.  
  182. InnoTek Virtual Switch MAC...........
  183.      0 - IBM TCP/IP
  184.      0 - IBM OS/2 NETBIOS OVER TCP/IP
  185.  
  186. IBM 10/100 Ethernet PCI Adapter...........
  187.      0 - InnoTek Virtual Switch Protocol
  188.  
  189. Save your changes in MPTS and when exiting, allow MPTS to change
  190. your CONFIG.SYS. It will make a backup copy first and then install
  191. the Virtual Switch driver (switch.os2).
  192.  
  193. NOTE: Due to a problem, you might have to manually copy vswch1.msg
  194. from this archive to \IBMCOM. If the file does not exist after the
  195. steps above, please copy it manually.
  196.  
  197. 3.1.1 Multiple Ethernet cards
  198. -----------------------------
  199.  
  200. In order to support more than one Ethernet card with the Virtual
  201. Switch driver, you have change the bindings for each card like
  202. described in the last section. However, you have to add the  MAC
  203. and Protocol drivers from the "AdditionalDrivers" first to the
  204. upper left and upper right listboxes. They will then appear
  205. as "InnoTek Virtual Switch MAC 2" to "InnoTek Virtual Switch MAC 4"
  206. and "InnoTek Virtual Switch Protocol 2" to
  207. "InnoTek Virtual Switch Protocol 4".
  208.  
  209. They allow up to 4 Ethernet cards to use the Virtual Switch. This
  210. is due to the OS/2 limit of 8 MAC drivers. As for each physical
  211. MAC driver, the Virtual Switch MAC driver has to be installed,
  212. only 4 Ethernet cards can be supported.
  213.  
  214. Note that you always use the appropriate MAC and Protocol driver.
  215. The order does not matter, you just have to make sure that if you
  216. use e.g. the MAC 3 driver for the original protocols, you have to
  217. bind the Protocol 3 driver to the original MAC.
  218.  
  219. Be very careful with the setup and make sure the bindings are
  220. correct - otherwise you will experience problems!
  221.  
  222.  
  223. 4. Configuration
  224. ----------------
  225.  
  226. Typically, the Virtual Switch does not need any configuration other
  227. than the intial install described above. There are a few options
  228. that are helpful in some configurations.
  229.  
  230. The Virtual Switch will report a name of the Ethernet card to the
  231. Virtual PC application. The name will be taken from the PROTOCOL.INI
  232. NIF section. Usually this is not a pretty or even recognizable name.
  233. Therefore it is possible to assign a better name to a card by
  234. defining the "Adaptername" setting for the Virtual Switch MAC driver.
  235. To do so, just click on "Edit" below the lower listbox after
  236. selecting the appropriate InnoTek Virtual Switch MAC driver.
  237.  
  238. For system equipped with a Realtek 8139 100MBit PCI Ethernet card,
  239. a special workaround exists to enable promiscuous mode. This is
  240. required in order to communicate with external systems. The
  241. Realtek drivers for OS/2 all handle promiscuous mode
  242. incorrectly. As this is a very popular chipset, we have decided
  243. to provide a workaround. It is enabled by setting the
  244. "Realtek 8139" property of the Virtual Switch MAC driver to
  245. "YES". Choose "Edit" after selecting the appropriate Virtual
  246. Switch MAC driver line in the lower listbox.
  247.  
  248.  
  249. 5. RAS
  250. ------
  251.  
  252. In order to diagnose the Virtual Switch operation, you can have a
  253. look at the LANTRAN.LOG file. This can be viewed by issueing
  254.  
  255. type lantran.log
  256.  
  257. in an OS/2 command window. The Virtual Switch will output different
  258. messages into this file. It will give you information about the
  259. installed switching, bindings including sucess and error messages.
  260.  
  261. Also, it will show when virtual machines using the Virtual Switch
  262. are started and stopped including the MAC address used for them.
  263.  
  264.  
  265. 6. Copyrights
  266. -------------
  267.  
  268. (C) 2001-2002 InnoTek(R) Systemberatung GmbH
  269. http://www.innotek.de
  270.  
  271. 2002-03-31
  272.