Zonama - The living planet, or in our world an easily deployed development environment for working on the server code of swgemu's Core3 (https://www.swgemu.com/)
In general you should not worry about what branch you're on. The bootstrap script will do this for you. That said knowledge is power so here's a summary of the branches in this repo:
- release-1.5 - Stable, Box 1.5 (Debian 9), Jan 1, 2018 to ...
- release-1.4 - Legacy, Box 1.4.5 (Debian 8), Dec 31, 2016 to Dec 31, 2017
- master - Current bleeding edge mess, much pain here padawan
- Virtualization enabled cpu (Check your BIOS if virtualbox fails to boot box)
- 64 Bit Host
- 2 Host Cores
- 6 Gigs Host Ram
- Dynamically sized 40G HD (Approx 15G on first boot) (Usually $HOME/ZonamaDev)
- 2.5Gb in your $HOME directory for base box image (On windows this is usually C:\ )
- Guest must be configured for at least 2Gb Ram, 128Mb Video Memory and 2 Cores
Launch Git Bash: Start -> Programs -> Git Bash or Right click in desired directory -> Git Bash
Type:
curl -Lk http://downloads.zonamaserver.org/zonamadev/bootstrap.sh | bash
Watch for instructions.
Type:
git clone -b release-1.5 https://github.com/Zonama/ZonamaDev.git
cd ZonamaDev/fasttrack
./setup.sh
Watch for instructions.
First install git, curl, and zlib1g-dev via
sudo apt-get install git curl zlib1g-dev
Next install Vagrant and VirtualBox through their websites:
Choose linux version (use 14.04 ubuntu as Linux Mint is based on 14.04)
Download the debian package for vagrant. (The versions in the apt-get repos are older, and unsupported for ZonamaDev)
Install downloaded packages:
sudo dpkg -i <pathtofile>/<nameoffile>
Type:
curl -Lk http://downloads.zonamaserver.org/zonamadev/bootstrap.sh | bash
Watch for error messages, and resolve any unmet dependancy problems. Each distro of linux has different versions: For example, on Debian Testing (Stretch) install should be able to do apt-get virtualbox and vagrant.
The system should update on reboot, please reboot the vm:
- via the applications menu "Loggout -> Restart"
- via host control: vagrant reload
- via terminal: sudo init 6
To uninstall and re-install fresh on the host system type:
curl -Lk http://downloads.zonamaserver.org/zonamadev/bootstrap.sh | bash -s destroy
To uninstall on the host system type:
curl -Lk http://downloads.zonamaserver.org/zonamadev/bootstrap.sh | bash -s uninstall
As an example to install release-1.5 before it becomes mainline:
curl -Lk http://downloads.zonamaserver.org/zonamadev/bootstrap.sh | bash -s release 1.5
As an example to QA a new branch called "feature-lotto-numbers-1":
curl -Lk http://downloads.zonamaserver.org/zonamadev/bootstrap.sh | bash -s branch feature-lotto-numbers-1
On the host (usually Windows or OSX) in the ~/ZonamdaDev/fasttrack directory you can create a simple YAML file that sets cores and/or ram:
Example config.yml:
cores: 8
ram: 8192
The config.yml is ignored in .gitignore so you can "set it and forget it".
You can also setup a "bridged" network interface if you want the server to be directly on your LAN:
bridge: "auto"
```
Under windows you can do 'auto' and it usually picks the right interface on OSX you will need to choose the right
interface often "en0":
````yaml
bridge: "en0"
```
The next time you do vagrant reload or vagrant up these settings will take effect.
### For More Information
Please see [The Wiki](https://github.com/Zonama/ZonamaDev/wiki)