Player/Stage Install Script

A couple of bash scripts to automate the installation process of Player 3 and Stage 4 for Ubuntu, as well as the Vagrantfile used to build the vagrant box.

tl;dr: I just want to use Player/Stage

To jump-start, see Installing via vagrant below. You do not need to clone this repo.

What's New

This is a fork of the original Player/Stage Install Script at samueljackson92/player-stage-install-script. It contains the following changes:

• Player 3.0.2 and Stage 4.1.1 are used
• A Vagrantfile has been added to simplify installation in a Ubuntu-based virtual machine using Vagrant. However, a preconfigured box is already available.
• The install script now uses git and subversion to pull the sources instead of using wget if these tools are installed. This should counteract SourceForge's wonky download behavior.

Installing via vagrant (recommended)

To use the preconfigured Player/Stage box, first install Vagrant. Next, create a Vagrantfile with the following content in your project root:

# -*- mode: ruby -*-
# vi: set ft=ruby :

Vagrant.configure(2) do |config|
  config.vm.box = "sunside/playerstage"
end

To bring up the virtual machine, type:

$ vagrant up

which will download the box (if necessary) and start the VM. To connect to it, type:

$ vagrant ssh

You can then execute player and stage commands.

g++, make, cmake etc. are already installed. By default, Vagrant will mount your current working directory to the /vagrant directory within the box. In the easiest case, you just cd /vagrant and build your project.

To shut down the virtual machine (without deleting it), type

$ vagrant halt

More information on how to use Vagrant can be found at the Getting Started tutorial on www.vagrantup.com.

Manual Installation

These scripts will automatically update bashrc with correct paths as well as downloading, compiling and installing Player and Stage from source. The script effectively automates the commands outlined in the following two guides:

• Upgrading to Ubuntu 11.10 with player/stage
• Installing Player/Stage in Ubuntu (Natty Narwhal)

This script should work with Ubuntu from 11.04+. I've tested it on a fresh install of Ubuntu 12.04 64 bit in a VM and it seems to work fine. I'm unsure if it will work with versions of Ubuntu below 11.04.

Update

The script has now been patched to fix a minor compliation bug with Ubuntu 12.10.

Pre-Install

Before installing Player/Stage, ensure that all other versions of Player/Stage have been removed from the machine. If compiled from source this can be done by entering into the directory where Player or Stage was built and running:

$ sudo make uninstall

Also check that any old files relating to Player or Stage have been removed from both /usr/local/lib and /usr/local/lib64 in case this mucks with the paths. Finally, make sure that any path varaibles relating to Player/Stage are removed from the bashrc.

Installing Player/Stage

First, either clone the git repo or download a tarball/zip file containing the files and extract them. Then cd into the directory. Change the two scripts to have executable permissions using the following command:

$ chmod +x update-bashrc.sh player-stage-install.sh

Next, run update-bashrc.sh. This adds the path variables stored in path.txt to the bashrc. It's important to do this so that Player/Stage can find each other correctly.

$ ./update-bashrc.sh

Finally, run the player-stage-install.sh script to download, compile and install Player/Stage. The script should get all of the required dependancies if they are not already installed on the system. It will then create a folder called src in the home directory where Player/Stage will be downloaded, complied and installed to the system. Run it with the following.

$ ./player-stage-install.sh

If all works as intended, Player/Stage should then be correctly setup for use with CS264's assignment files.