Emaculation.com

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
wireless_appletalk_ss_bii_osx [2015/04/04 21:31] nucarwireless_appletalk_ss_bii_osx [2023/05/26 04:30] (current) nucar
Line 1: Line 1:
-====== Wireless AppleTalk Networking with SheepShaver & Basilisk II for OS X ======+====== Wireless AppleTalk Networking with SheepShaver & Basilisk II for macOS ======
  
-(Last updated April 52015.  The forum thread is [[http://www.emaculation.com/forum/viewtopic.php?f=20&t=8324|here]].)+(Last updated May 262023.  The forum thread is [[https://www.emaculation.com/forum/viewtopic.php?f=20&t=8324|here]].)
  
 ===== Introduction ===== ===== Introduction =====
  
-This guide describes networking SheepShaver and Basilisk II for OS X when the host machine is connected to the LAN by Wi-Fi.  The emulator gets the same full-fledged ethernet connection that it would have with an ethernet cable, which includes AppleTalk.  This method can also be used for networking over the Internet.  The requirement is that there must be a single machine connected to the network by ethernet running a [[http://www.emaculation.com/doku.php/bridged_openvpn_server_setup|bridge-mode OpenVPN server]].  That computer can also run a networked emulator, but it doesn't need to.  All other machines on the network can be connected either by wireless or ethernet.+This guide describes networking SheepShaver and Basilisk II for OS X when the host machine is connected to the LAN by Wi-Fi.  The emulator gets the same full-fledged Ethernet connection that it would have with an Ethernet cable, which includes AppleTalk.  This method can also be used for networking over the Internet.  The requirement is that there must be a single machine connected to the network by Ethernet running a [[https://www.emaculation.com/doku.php/bridged_openvpn_server_setup|bridge-mode OpenVPN server]].  That computer can also run a networked emulator, but it doesn't need to.  All other machines on the network can be connected either by wireless or Ethernet.
  
 ===== How It Works ===== ===== How It Works =====
  
-A bridge-mode OpenVPN server can tunnel any ethernet frame over a single port, preferably a UDP port.  Therefore, AppleTalk packets, encapsulated into UDP packets, can survive over the IP-only wireless signal.  This also implies that all ethernet activity on the network can be extended over the Internet to remote OpenVPN clients.+A bridge-mode OpenVPN server can tunnel any Ethernet frame over a single port, preferably a UDP port.  Therefore, AppleTalk packets, encapsulated into UDP packets, can survive over the IP-only wireless signal.  This also implies that all Ethernet activity on the network can be extended over the Internet to remote OpenVPN clients.
  
-Obviously the main challenge here is to set up the OpenVPN server. A bridge-mode OpenVPN server is an extremely powerful tool that everyone should know about.  It can be run using free software only and allows you to extend all layer-2 LAN communication over wireless and over the Internet.  The guide for setting up such a server in a Linux VM is here:+Obviously the main challenge here is to set up the OpenVPN server. A bridge-mode OpenVPN server is an extremely powerful tool that everyone should know about.  It can be run using free software only and allows you to extend all layer-2 LAN communication over wireless and over the Internet.  The guide for setting up such a server in a Linux VM (on a Mac or Windows PC) is here:
  
-http://www.emaculation.com/doku.php/bridged_openvpn_server_setup+https://www.emaculation.com/doku.php/bridged_openvpn_server_setup
  
 To be clear, the VPN must make use of ethernet bridging.  Most VPNs are the layer-3 routed type and will not work. To be clear, the VPN must make use of ethernet bridging.  Most VPNs are the layer-3 routed type and will not work.
- 
 ===== Connecting the Emulator to the VPN ===== ===== Connecting the Emulator to the VPN =====
  
-After connecting to the OpenVPN server, set the emulator to use tap1 as its ethernet interface, then bridge that interface as described in [[http://www.emaculation.com/doku.php/appletalk_for_sheepshaver|the AppleTalk guide]] with OpenVPN's tap0 interface instead of your ethernet interface. For example, the script for starting SheepShaver in OS X 10.7 and up could look like:+After connecting to the OpenVPN server, set the emulator to use tap1 as its Ethernet interface, then bridge that interface as described in [[https://www.emaculation.com/doku.php/appletalk_for_sheepshaver|the AppleTalk guide]] with OpenVPN's tap0 interface instead of your Ethernet interface. For example, the script for starting SheepShaver in OS X 10.7 and up could look like:
  
 <code>sudo /*path to SheepShaver folder*/SheepShaver.app/Contents/MacOS/SheepShaver & sleep 10 <code>sudo /*path to SheepShaver folder*/SheepShaver.app/Contents/MacOS/SheepShaver & sleep 10
Line 27: Line 26:
 sudo ifconfig bridge1 up</code> sudo ifconfig bridge1 up</code>
  
-Remote clients over the Internet must use the private IP addresses for the OpenVPN server side's LAN, not addresses for their own LAN, in the TCP/IP or MacTCP control panels. Note that bridge1 is used instead of bridge0 because OS X 10.9 Mavericks and later may have a "Thunderbolt Bridge" interface that uses bridge0. You can use bridge1 without having a bridge0 interface.+Remote clients over the Internet must use private IP addresses for the OpenVPN server side's LAN, not addresses for their own LAN, in the TCP/IP or MacTCP control panels. Note that bridge1 is used instead of bridge0 because OS X 10.9 Mavericks and up may have a "Thunderbolt Bridge" interface that uses bridge0. You can use bridge1 without having a bridge0 interface.
  
-In order to run the Linux VM and a networked emulator in the host OS simultaneously, the host must connect to the OpenVPN server as a client, and connect the emulator using the method above.  The regular method of bridging the ethernet interface with the emulator's TAP interface cannot be used because a single ethernet interface cannot be a member of a bridge interface in the host and a bridge interface in the VM simultaneously.  The second bridge to go up may not work properly.+In order to run the Linux VM and a networked emulator in the host OS simultaneously, the host must connect to the OpenVPN server as a client, and connect the emulator using the method above.  The regular method of bridging the Ethernet interface with the emulator's TAP interface cannot be used because a single Ethernet interface cannot be a member of a bridge interface in the host and a bridge interface in the VM simultaneously.  The second bridge to go up may not work properly.
  
 You can run multiple networked emulated machines simultaneously on the same computer.  For example, you could run multiple .sheepvm files and/or Basilisk II.  To do this, use tap2, tap3, etc., instead of tap1 for every additional emulated machine, all added to the same bridge interface.  You can simply use a separate script like the one above for each emulated machine, with "tap1" changed accordingly.  Don't forget that each emulated machine must be given a unique IP address. You can run multiple networked emulated machines simultaneously on the same computer.  For example, you could run multiple .sheepvm files and/or Basilisk II.  To do this, use tap2, tap3, etc., instead of tap1 for every additional emulated machine, all added to the same bridge interface.  You can simply use a separate script like the one above for each emulated machine, with "tap1" changed accordingly.  Don't forget that each emulated machine must be given a unique IP address.
Line 37: Line 36:
 ===== Multiplayer Games in SheepShaver and Basilisk II ===== ===== Multiplayer Games in SheepShaver and Basilisk II =====
  
-Besides AppleTalk services such as file sharing and printing discussed in our other guides, multiplayer network games can be played conveniently, and over the Internet, using this method, not requiring an ethernet cable.  It seems that SheepShaver and Basilisk II are seldom thought of as multiplayer game platforms, the way DOSBox is, but now that can change!+Besides AppleTalk services such as file sharing and printing discussed in our other guides, multiplayer network games can be played conveniently, and over the Internet, using this method, not requiring an Ethernet cable.  It seems that SheepShaver and Basilisk II are seldom thought of as multiplayer game platforms, the way DOSBox is, but now that can change!
  
-In Mac OS 8 and 9, file sharing may need to be off for games to work, which is unfortunate since it's an easy way to tell whether AppleTalk is working. Just turn it off after you've confirmed that you can see the other AppleTalking machines. In System 7, it's a good idea to install Open Transport 1.1.2 (Net Install, [[http://ftpmirror.your.org/pub/misc/apple/Apple_Software_Updates/English-North_American/Macintosh/Networking-Communications/Open_Transport/OT_1.1.2-Net_Install.sea.bin|direct link]]), found at [[http://ftpmirror.your.org/pub/misc/apple/Apple_Software_Updates/|this]] mirror of the Apple Support Area.+In Mac OS 8 and 9, file sharing may need to be off for games to work, which is unfortunate since it's an easy way to tell whether AppleTalk is working. Just turn it off after you've confirmed that you can see the other AppleTalking machines. In System 7, it's a good idea to install Open Transport 1.1.2 (Net Install, [[https://ftpmirror.your.org/pub/misc/apple/Apple_Software_Updates/English-North_American/Macintosh/Networking-Communications/Open_Transport/OT_1.1.2-Net_Install.sea.bin|direct link]]), found at [[https://ftpmirror.your.org/pub/misc/apple/Apple_Software_Updates/|this]] mirror of the Apple Support Area.
  
 This is a list of games that I've successfully played using the above method: This is a list of games that I've successfully played using the above method:
Line 45: Line 44:
   * A-10 Cuba!   * A-10 Cuba!
     * SheepShaver     * SheepShaver
-  * [[http://www.yiminee.com/ass.html|Asshole]]+  * [[https://web.archive.org/web/20211020062303/http://www.yiminee.com/ass.html|Asshole]]
     *SheepShaver, AppleTalk and TCP/IP     *SheepShaver, AppleTalk and TCP/IP
-  * [[http://bishop.mc.duke.edu/bolo/|Bolo]]+  * [[https://web.archive.org/web/20161130200618/http://bishop.mc.duke.edu/bolo/|Bolo]]
     * SheepShaver, AppleTalk and UDP/IP     * SheepShaver, AppleTalk and UDP/IP
   * F/A-18 Hornet 2.0   * F/A-18 Hornet 2.0
Line 54: Line 53:
     * SheepShaver     * SheepShaver
   * Jazz Jackrabbit 2   * Jazz Jackrabbit 2
-    * SheepShaver, needs the 1.2.6 or [[http://www.gamefront.com/files/897228|1.2.8]] update +    * SheepShaver, needs the 1.2.6 or [[https://web.archive.org/web/20160429052730/www.gamefront.com/files/897228|1.2.8]] update 
-  * [[http://trilogyrelease.bungie.org|Marathon Trilogy]]+  * [[https://trilogyrelease.bungie.org|Marathon Trilogy]]
     * SheepShaver     * SheepShaver
-  * [[http://www.emaculation.com/doku.php/system_6_hell#nettrek|NetTrek]]+  * [[https://www.emaculation.com/doku.php/system_6_hell#nettrek|NetTrek]]
     * Basilisk II, increase memory to 1000K, no sound     * Basilisk II, increase memory to 1000K, no sound
   * Spectre   * Spectre