Installing Panamax

Short URL: http://j.mp/pmx_install

Panamax is comprised of the Panamax Client which can be used to create new Panamax Templates and deploy Templates and Images locally. If you require to deploy templates to remote infrastructure (not local) be sure to also install the Panamax Remote Agent on the remote infrastructure you need to deploy to.

Panamax Client - Local Installation (Recommended)

Panamax is currently in BETA

Local Client Installation Requirements

VirtualBox 4.3 or higher

Vagrant 1.6 or higher

The Panamax installer creates a VM in VirtualBox called panamax-vm. This VM is built on CoreOS.

NOTE: The panamax-vm runs with 2 CPUs and 1GB of RAM by default. These may need to be increased based on the number of containers you have running on your VM or the resources they consume. Templates may specify system recommendations for proper performance in their documentation. Reference the list of all available commands, aliases and parameters on how to change your VM's specs to increase CPUs and RAM.

Mac OS X 10.9.0 or higher

Before installing, please review these installation notes.

To install Panamax on Mac, you should use a package management system. You can use Homebrew (recommended) or MacPorts. Here are the steps:

Using Homebrew

On your terminal window, run:

$ brew install http://download.panamax.io/installer/brew/panamax.rb

If Error: Calling Formula.sha1 is disabled!, run:

$ brew install https://raw.githubusercontent.com/pamri/panamax-coreos/896e6d3820c897f208ee58ba4ba2d5825b420504/panamax.rb

Using MacPorts

On your terminal window, run:

$ curl http://download.panamax.io/installer/ubuntu.sh | bash

Common to both

Install and run Panamax!

$ panamax init

After the installation, Panamax will open a browser window automatically. For a menu of all commands available to you, simply run:

$ panamax

List of all available commands, aliases and parameters for the Panamax Installer. Release Notes

Upgrade Panamax

To upgrade Panamax to a newer version please run the following on your terminal window:

brew upgrade http://download.panamax.io/installer/brew/panamax.rb && panamax reinstall

To check the version of Panamax, run the following on your terminal window:

panamax info

Ubuntu Linux 12.04 or higher

Before installing, please review these installation notes.

Ubuntu Desktop Users: Download and run the script as shown.

$ curl http://download.panamax.io/installer/ubuntu.sh | bash

After the installation, you can open a browser window at http://panamax.local:3000/, to view Panamax.

For a menu of all commands available to you, simply run:

$ panamax

List of all available commands, aliases and parameters for the Panamax Installer. Release Notes

Arch Linux

See Ubuntu instructions.

Debian 6.0 or higher

See Ubuntu instructions.

Windows with Cygwin

Before installing, please review these installation notes.

Method #1

Prerequisites

Windows 7.1+ 64bit
Cygwin (with/add rsync and openssh packages)
Vagrant 1.6.5 NOTE: V1.7.0 does not work (tested on 1.6.5)
VirtualBox 4.3.10+ (tested on 4.3.20)

Install CoreOS VM in VirtualBox

Open Cygwin64 terminal on Windows machine
Run $ mkdir panamax-vagrant && cd panamax-vagrant
Run $ vagrant -v, $ rsync --version to confirm that they are working and are in your PATH
Run $ curl -O http://download.panamax.io/installer/panamax-demo.tar.gz && tar -C . -zxvf panamax-demo.tar.gz && mv Vagrantfile-win Vagrantfile
Run $ vagrant up
After install, port forward guest (CoreOS) port 3000 to host (Windows) port 3000 in the VirtualBox GUI | Network | Port Forwarding on the panamax-vm or run on the terminal:

$ VBoxManage controlvm panamax-vm natpf1 rule1,tcp,,3000,,3000
Browse to localhost:3000 on your windows machine to view Panamax!

Reinstall, Restart, Update Panamax

Run $ vagrant ssh from the panamax-vagrant directory on Windows machine.
When on the CoreOS, run $ sudo su
Change the directory to panamax: $ cd /var/panamax
Run $ ./coreos
Make your selection

List of all available commands, aliases and parameters for the Panamax Installer. Release Notes

Method #2

FIRST: install vagrant >= 1.6 on your windows OS and install virtualbox >= 1.4.3+ on your windows OS.

Then, in your cygwin terminal, symlink your Virtualbox.exe and VBoxManage.exe files like so:

ln -s /cygdrive/c/Program\ Files/Oracle/VirtualBox/VirtualBox.exe /usr/bin/virtualbox
ln -s /cygdrive/c/Program\ Files/Oracle/VirtualBox/VBoxManage.exe /usr/bin/VBoxManage

Panamax will then use the native windows application.

You may also need to install additional cygwin packages. I had to add the bc package as well. You can do that by adding apt-cyg or by re-running the cygwin installer (this installer won't overwrite anything, just add packages). To add packages (like the bc package) inside the cygwin terminal run:

wget http://apt-cyg.googlecode.com/svn/trunk/apt-cyg
chmod +x apt-cyg
mv apt-cyg /usr/local/bin/
apt-cyg install bc

Please use the following instructions to install Panamax on Windows that has Cygwin installed. A big thanks to Alan Kent for providing the instructions via his blog post.

Run the following commands from inside a Cygwin bash terminal window:

$ mkdir ~/.panamax
$ cd ~/.panamax
$ curl -O http://download.panamax.io/installer/panamax-latest.tar.gz
$ mkdir -p ~/.panamax && tar -C ~/.panamax -zxvf panamax-latest.tar.gz
$ ./panamax init

After the installation, you can open a browser window at http://panamax.local:3000/, to view Panamax.

For a menu of all commands available to you, simply run:

$ ./panamax

List of all available commands, aliases and parameters for the Panamax Installer. Release Notes