1. INTRODUCTION 2. INSTALLATION 3. CONNECTING TO YOUR NETWORK 4. REQUIREMENTS 5. CONFIGURATION 5.1 DHCP CONFIGURATION 5.2 STATIC IP CONFIGURATION 5.3 X-BOX CONFIGURATION MENU 6. STARTING A GAME 7. ENDING A GAME 8. TROUBLESHOOTING 9. SUPPORT 10. DISCLAIMER 1. INTRODUCTION This document is intended for configuration and use of the XBoxGW bootdisk. XBoxGW is an application that was developed to expand the capabilities of System Link games for the Microsoft XBOX. 2. INSTALLATION Instructions on how to install the images on boot disks are available at: http://www.xboxgw.com/docs.html 3. CONNECTING TO YOUR NETWORK Instructions and graphics on how to connect your Microsoft XBox to your network in the required configuration is available at: http://www.xboxgw.com/docs.html 4. REQUIREMENTS A Microsoft XBOX, of course! XBOXGW currently only runs on Linux. Because of the amount of traffic these games generate, a Broadband Internet connection is required. Since XBOXGW is very similar to a bridge, is requires a promiscuous network. A promiscuous network means that the Linux box where XBOXGW is running, must be able to receive all LAN packets. This requires that the ethernet network between the Linux Box and your XBOX must be on a HUB or a cross-over cable. If you have a firewall or run NAT, you must open up your firewall to allow the following ports. Inbound: TCP port 7601 (Only required for server mode) Inbound: UDP port 7602 (Required for client and server) Outbound: TCP port 7601 (Only required for client mode) Outbound: UDP port 7602 (Required for client and sever) If you need help configuring your Router for FIREWALL or NAT please contact the manufacturer of your hardware or the forums. Don't email us asking how, WE DON'T KNOW! 5. CONFIGURATION Before you begin we expect you by this point to have installed XBoxGW onto the 2 disks. Instructions are above incase you missed it. Insert Disk #1 of the XBoxGW Bootup software. Either turn on or reboot your PC. You should see a message upon bootup: XBoXGW................................. A bunch of other boot messages will scroll by. The aren't important right now. There is serveral options you need to know before you start configuring XBoxGW. 1. You must know if your on DHCP or have a static IP. 2. Choose 1 or 2 network card configuration. When the bootup says, "Please insert Disk #2 and then press the RETURN key..." Take Disk #1 out of the PC and insert Disk #2 and press return or enter. *If you can't press enter you may have a USB keyboard. Please try the PS2 keyboard port on your PC instead. Next you will see: Please wait. Loading XBoxGW Software......... RAMDISK: Compressed image found at block 1 *If you get errors here, you may have a bad floppy disk. Remake your Disk #2 and reboot. XBoxGW: Attempting to setup ethernet interfaces.... Please wait, attempting to load config from floppy.....Not Found XBoxGw: Configure eth0? [Y/N] Y Perform DHCP for this interface? [N] If you using DHCP say yes. If you have a static IP address say no. 5.1 DHCP CONFIG DHCP should receive your IP parameters from the server and fill in your information into the blanks like in the example below. XBoxGw: Configure eth0? [Y/N] Y Perform DHCP for this interface? [N] Y DHCP Computer Name: [] yourhostnamehere Please wait, waiting for DHCP to complete....Complete! IP Address: [192.168.0.5] *enter key if correct* Netmask : [255.255.255.0] *enter key if correct* Broadcast : [192.168.0.255] *enter key if correct* Interface eth0: IP Address: 192.168.0.5 Netmask : 255.255.255.0 Broadcast : 192.168.0.255 Is this correct? [Y/N] Y Default Gateway: [192.168.0.1] *enter key if correct* DHCP Computer Name: [] yourhostnamehere Please wait, waiting for DHCP to complete....Complete! Name Server: [1.1.1.1] *enter key if correct* *Name server is the same as DNS server. XBoxGW: Done configureing Ethernet Interfaces.... Save current configuration for next boot? [Y/N] *Answering yes will save eth0 config for next boot. 5.2 STATIC IP CONFIGURATION This configuration is for static IPs. If you don't know your IP you can get the information from Window on the command prompt by entering the following 'ipconfig /all'. Copy down all the information and enter it into the appropriate areas in the XBoxGW config. XBoxGw: Configure eth0? [Y/N] Y Perform DHCP for this interface? [N] N IP Address: [N/A] 192.168.0.5 Netmask : [N/A] 255.255.255.0 Broadcast : [N/A] 192.168.0.255 Interface eth0: IP Address: 192.168.0.5 Netmask : 255.255.255.0 Broadcast : 192.168.0.255 Is this correct? [Y/N] Y Default Gateway: [N/A] 192.168.0.1 Name Server: [N/A] 1.2.3.4 *Name server is the same as DNS server. XBoxGW: Done configureing Ethernet Interfaces.... Save current configuration for next boot? [Y/N] *Answering yes will save eth0 config for next boot. 5.3 X-BOX CONFIGURATION MENU There is only a few changes from default you need you know about to make XBox Gateway work for you. ***** X-BOX Gateway Configuration ***** Version 1.05- 5 Global Information | |-- (1) XBox Eth Interface : eth0 |-- (2) Initial Debug : 0x00000001 |-- (3) Ping Interval : 10 seconds |-- (4) CLI Port : 7603 |-- (5) Server Control Port: 7601 |-- (6) Server Game Port : 7602 |-- (7) Client Game Port : 7602 |-- (8) Server Game Proto : UDP |-- (9) Server Password : Server Information | | |-- (1) Address : 0.0.0.0 |-- (2) Control Port : 7601 |-- (3) Game Port : 7602 |-- (4) Game Proto : UDP |-- (5) Password : Choose: (C)hange Global Config, (E)dit Server Config, (D)one? In the 1 network card configuration make sure your 'XBox Eth Interface' is set to eth0. This is your only valid interface. Don't change the ports and protocols unless you make the server on the remote side of XBoxGW the same config. You won't be able to connect if both sides aren't the same. In the 2 network card configuration make sure your 'XBox Eth Interface' is set to eth1. Your eth0 will be your connection to the internet so don't mix the two up. You can set a Password on the server. No clients will be able to connet to the game unless the passwords match. Think of the 'Global Information' as your local configuration. The 'Server Information' is the Remote site you could be connecting to. It's very easy to change the fields of the config. C will change the parameters of the 'Global Config'. While E edits the server config. For example: Choose: (C)hange Global Config, (E)dit Server Config, (D)one? E Change Item Number: 1 IP Address: Old: 192.168.1.1 New: 192.168.2.3 After you press return you will see your changes input in the config. 6. STARTING A GAME At the 'X-BOX Gateway Configuration' menu press D Choose: (C)hange Global Config, (E)dit Server Config, (D)one? D Save current config to floppy? [Y/N] Y *Yes will write your 'X-BOX Gateway Configuration' data to the disk, No will just continue with the active configuration. Start daemon in (S)erver Mode or (C)lient Mode? 'S' will put XBoxGW in server mode so others may connect to you. 'C' will connect to the server you have selected in your 'Server Information' Once your connected to the remote XBoxGW system (Client or Server) you will see pings on your screen of how fast the connection is between Client and Server. The Server side XBoxGW system should now Start a game on the XBox. The remote XBoxGW client side should try to join the game. If all goes well you should be able to play now. If you have a problem seeing or joining the game. Check out the troubleshooting section of this document. 7. ENDING A GAME Type quit at the in game menu. ie: [BootDisk : XBOX GW SERVER]> quit 8. TROUBLESHOOTING There are some obvious things that may go wrong when attempting to bring up a link with a remote user. The two main ones are: 1) Firewall issues 2) Ethernet switch between XBOX and Linux Server instead of a HUB. We have attempted to make it very easy to detect both of these problems. The first step in troubleshooting a connection, so to get the output of this command from both sides: At the in game menu type 'status': [BootDisk : XBOX GW SERVER]> status With this output, you can verify the following fields look correct: Mode: CLIENT - In Client Mode SERVER - In Server Mode Your X-BOX MAC - This is the detected MAC address of your X-BOX. If this is all 00's, then your X-BOX hasn't been detected yet. State: Connected - This means the remote side has connected, but has not sent a registeration packet yet. If stuck in this state, it is suggested to bring down and back up the remote link. If this does not help, please contact support@xboxgw.com Registered - This means the remote side has registered, however the UDP Game Port test has not passed yet Active - This means the remote side has registered, and that the UDP Game Port test has passed. Bad Password - This means the remote side attemptd to register, but did not have the correct password Stage: Unknown - No packets have been seen from an XBOX yet, on the local network configured Broadcast - The "game stage" is in its Broadcast stage. This is where its either looking for players, or a game Point-To-Point - The XBOX has entered a stage where it is talking directly to another XBOX, no more broadcasts. **NOTE** This stage is most useful in detecting whether you have an ethernet switch or an ethernet hub. If the stage goes to Broadcast, and never goes Point-To-Point when you attempt to join a game, then it is more than likely because you have a switch, or the xbox is not directly connected to your linux box. For more details on how to solve this issue, please see the REQUIREMENTS section of this document. Type: This is for our use in troubleshooting problems. X-BOX MAC: This is the MAC address of the XBOX on the remote network UDP Test: Passed - The UDP test has passed (This side has received a UDP pkt). Failed - This side has not received a UDP packet yet. **NOTE** This stage is most useful in detecting firewall problems. This test MUST be in "Passed" state on BOTH the client side, and the server side. Whatever side shows failed, means it did not receive a UDP packet from the remote side. Its firewall should be checked. Packets Received: Number of packets received from remote side Packages Sent: Number of packets sent to remote side Pings: Number of pings sent/received from remote side Last Ping: The time of the last ping. If none of the above information helps you troubleshoot your probem, please post it to our forums with a detailed description of your problem. 9. SUPPORT Support is available on http://www.xboxgw.com on the forums. Email support is at support@xboxgw.com. 10. DISCLAIMER All trademarks belonging to Microsoft are fully owned by Microsoft Corp. We have no Affiliation with Microsoft. There is no guarantees with this software. It's free! Use it, enjoy it. Frag your friends with it. Use at your own risk.