Magfest ubersystem simple deploy

This is the officially supported method of setting up a development environment for Magfest's ubersystem. It will get you a deployment config that is using the same plugins, and nearly identical configuration, as our production servers. Once deployed, you can run a command to update all repositories to the latest changes from github.

Getting started

First, install all this stuff:

• Git
• VirtualBox
• Vagrant

It's recommended that you have a fast internet connection, at least 4gb of RAM, and a fast PC for this.

Choose an event

This deploy supports multiple events with different configuration. Pick an event from the list of valid events (examples: 'magstock', 'labs', 'prime')

Windows-specific setup

1. open a git BASH terminal by clicking Start menu and typing 'git bash'. You should see a black command prompt window with green text.

2. clone this repository (this repository is named 'simple-rams-deploy') somewhere on your local computer. You can do this by opening a command prompt and running the following commands:

   cd C:\wherever\you\want\your\project\to\live\
   
   git clone https://github.com/magfest/simple-rams-deploy
   
   cd simple-rams-deploy
   

   (More Instructions if you need them)

3. Follow the section named 'Common Instructions' below.

Linux/Mac instructions

1. clone this repository (this repository is named 'simple-rams-deploy') somewhere on your local computer. You can do this by opening a command prompt and running the following commands:

   cd /home/myusername/somewhere/
   
   git clone https://github.com/magfest/simple-rams-deploy
   
   cd simple-rams-deploy
   

   (More Instructions if you need them)

2. Follow the section named 'Common Instructions' below.

Common instructions (Windows/Linux/Mac/Cygwin/MingW)

1. type ./install-unix.sh insert-your-event-name-here from the terminal.
   For example, to install magstock, you would type: ./install-unix.sh magstock
2. after the deploy is finished, open a web browser to http://localhost:8000/uber/accounts/insert_test_admin. This will create a default username/password
3. now you can login to ubersystem with username 'magfest@example.com' and password 'magfest'

Installation complete!

To SSH into the machine

1. cd ubersystem-deploy
2. type vagrant ssh to access the running machine

Now that things are fully installed, check out the docs here for more info on what to do next: https://github.com/magfest/ubersystem-deploy/blob/master/DEVELOPING.md

Troubleshooting

• If you have previous deployments, you must ensure those VMs are stopped. Either type 'vagrant halt' from their ubersystem-deploy directories, or open the Virtualbox program from the start menu and power off any running VMs

• If you see any Virtualbox errors like 'unable to start virtual machine' when starting the process, or anything about 'VMX' or 'hardware acceleration', you may need to make sure that hardware virtualization acceleration / extensions is enabled in your computer's BIOS.