Setup platform development machine

Note - work in progress: trying to find a solution for using the platform-dev hostname; this is currently giving problems when the Rancher network agent is started

Basic Ubuntu installation

1. Download Ubuntu Server 14.04 LTS: http://www.ubuntu.com/download/server

2. Create new VirtualBox virtual machine:

• Type: Linux, Version: Ubuntu (64 bit)

• Memory: 2GB+

• Create a virtual hard drive, VDI, dynamically allocated, 16GB

3. Update settings:

• Storage > CD: select downloaded Ubuntu iso

• Network > Adapter 1: attached to bridged adapter

4. Start the virtual machine and install Ubuntu:

• Set timezone to UTC

• Install OpenSSH server

5. After reboot, login to check the assigned IP address

6. SSH into the freshly installed Ubuntu installation, and update:

    sudo apt-get update
    sudo apt-get dist-upgrade
   

Install Docker

1. Download and run Docker installation script:

    wget -qO- https://get.docker.com/ | sh
   

Also see: https://docs.docker.com/installation/ubuntulinux/

Create snapshot

1. Shutdown the virtual machine.

2. Open the Snapshots view and click on 'Take Snapshot'.

Install Rancher

Management Interface

1. Start the Rancher management server:

    sudo docker run -d --restart=always -p 8080:8080 --name rancher-mgmt rancher/server:v0.25.0
   

2. Browse to the management interface: http://{{vm ip}}:8080

3. Enable Access Control

Also see: http://rancherio.github.io/rancher/docs/installing-rancher/installing-server/

Agent

1. Go to the add custom host page: <http://{[vm ip}}:8080/static/infrastructure/hosts/add/custom>

2. Add all labels:

    mgmt=true
    platform=true
    backend=true
    frontend=true
   

3. Copy-paste the docker run command from step 4 in an editor and add the following parameter:

    -e CATTLE_AGENT_IP={{vm ip}}
   

4. Run the amended command on the virtual machine.

5. Wait 1-2 minutes for the agent to finish the initial run.