1In this directory you will find the setup files to setup a network boot environment for EmptyEpsilon. 2 3READ FIRST 4========== 5Do you know the following terms: 6 71. Linux 8 92. PXE 10 113. Commandline 12 134. DHCP 14 15If not. Do not try to use this. You can seriously screw up your system if you do not know what you are doing. 16 17What is this? 18============= 19 20It's a setup script for a network boot environment. Just about any computer build after the year 2000 has the feature to boot from the network. This means these computers do not need any actual harddisk to run. 21 22Why is this useful for EmptyEpsilon? Well, it ensures that every computer runs the exact same version of EmptyEpsilon. 23You only have to update a single machine and restart all others to get the latest version running wiht minimal fuzz. 24It also reduces the amount of hardware dependencies, as only a single machine needs a working harddrive. 25As harddrives are usually the first thing to break in a computer, this makes it easier to get donor computers for a setup. 26We use a lot of donor laptops which no longer have harddisks and/or batteries. 27 28With some added configuration, you can also have all these machines auto-connect to a server and reduce the overal setup times of your games. Which is more of an advanced use. 29 30It DOES require a time investment before hand. Just installing this system takes about 3 hours. However, it saves us about 30 minutes in setup time when we want to run the game with 6 clients. As we no longer have to copy anything. 31 32It also requires a wired network. Network booting does not work on wireless. The largest bit of our setup time is laying down all the cables. 33 34This runs a DHCP server, as network booting does DHCP, this means it will require a stand alone network, or two network cards. The default setup is a stand-alone setup. 35 36Installation 37============ 38Start of by doing a fresh OS install of Linux Debian, Jessie. Use the "Netinstall" and only install the base system with standard utilities. No graphical shell, no server features. 39 40Copy the "build_netboot_system.sh" script to the freshly installed machine. And make sure it has internet. 41 42Run the "build_netboot_system.sh" script as root. This will take a long time as it will install extra tools, will download a whole extra Linux install for the network boot environment and compile EmptyEpsilon in this environment from source. 43 44This "build_netboot_system.sh" script will setup your machine to have the network card serve DHCP. After running this it is not yet active, but on next reboot it will hand out IP addresses and mess up your local network. You have been warned! 45 46So, before rebooting, disconnect the network cable, and then reboot. After rebooting, hook up a seperate stand-alone network with your clients connected. 47 48For each client, you need to enable network booting in the BIOS. Every machine I've seen so far can do this, but it depends on the BIOS where and how this needs to be enabled. 49If it is an option, and you are in the BIOS settings anyhow, check if you can boot up the machine on power connection. This saves you pressing the power button. Note: While this feature is present in a lot of computers, it does not always function. So do not depend on it. 50 51Boot the client machines from the network with the new BIOS setup. And enjoy your easy EmptyEpsilon setup. 52 53Configuration 54============= 55A tool called "config_manager.py" is provided. It is located in your home directory after the build_netboot_system.sh. This tool can be used to quickly edit and administrate different option.ini files per client. Start it with "python config_manager.py" 56 57Per default, each client will show their name in the top left corner of the main menu. And per default each client has their MAC address as name. 58 59The "config_manager.py" tool can set different names per client, with the "setname" command. Example "setname 00b0d0a6b323 Red_shirt" will name the machine with that mac address to "Red_shirt", 60if that client is rebooted, it will show "Red_shirt" in the top left corner. 61 62The "config_manager.py" tool can also reboot machines, restart EE on machines, set autoconnect-to-crew-position settings. And for more advanced uses, open option.ini files directly in an text editor, execute any command on remote machines. 63 64Doing updates/changes/use internet 65================================== 66The "build_netboot_system.sh" script will install 3 helper scripts in your home directory. 67 68If you run "dhcp_client.sh", the network port in the machine will switch to client mode and will stop serving DHCP request. This means you can hook it back up to your normal network, and access the internet from this machine. This will not stay this way if you reboot. 69 70If you run "dhcp_server.sh", the network port is put back in dhcp mode, undoing the "dhcp_client.sh" script. Combined these scripts can be used to switch between serving EE, and having internet. 71 72If you run "update.sh", it will try to update your local EmptyEpsilon installation. This requires internet, so you need "dhcp_client.sh" first. 73 74distcc 75====== 76The clients are setup for distributed compiling of EmptyEpsilon. Which means every on computer can assist in the build of EmptyEpsilon. 77This reduced the compile time from 20 minutes to 3 minutes in my case. However, I haven't setup scripts to do this yet. As this wasn't 100% reliable yet.