DCOS - Local Installation on a Remote Ubuntu Server 14.04 with Port Forwarding

You can use this guide to install DCOS and test some features on a remote Ubuntu Server. Please note that this guide is not for a full scale installation. What you will end up with is a testing environment to see what can be done with DCOS. I utilized local installation for decision making purposes before continuing with full scale deployment.

Here is the link to official quick start guide:

Caution! Do not use repositories to install Vagrant and VirtualBox

For starters, you need to install Git, Vagrant, and VirtualBox. You shouldn’t trust package managers for Vagrant and VirtualBox installation, they install outdated versions which DCOS complains and refuses to run. Instead, get the latest versions from official sources and install using following commands:

wget http://download.virtualbox.org/virtualbox/5.1.12/virtualbox-5.1_5.1.12-112440~Ubuntu~trusty_amd64.deb

(replace 5.1.12 with the latest version. Check it from http://download.virtualbox.org/virtualbox/)

dpkg -i virtualbox-5.1_5.1.12-112440~Ubuntu~trusty_amd64.deb

You can use the following command to check VirtualBox version:

vboxmanage --version
wget https://releases.hashicorp.com/vagrant/1.9.1/vagrant_1.9.1_x86_64.deb

(replace 1.9.1 with the latest version. Check it from here: https://www.vagrantup.com/downloads.html)

dpkg -i vagrant_1.9.1_x86_64.deb

You can use the following command to check Vagrant version:

vagrant --version

Then all you need to do is:

git clone https://github.com/dcos/dcos-vagrant
cd dcos-vagrant
cp VagrantConfig-1m-1a-1p.yaml VagrantConfig.yaml
vagrant up
Port forwarding for remote access to management interface

Hopefully DCOS will start to run, and you are able to reach the management interface on http://m1.dcos/. If this is a remote server, you should be able to curl this web page from local command line interface (i.e. ssh), but you need a little trick to access the management interface remotely. The web server runs on a virtual machine (master node) with ip address (NAT). Using VirtualBox’s port forwarding option, you can forward your physical machine’s fictitious port to the master node’s port 80 using:

vboxmanage controlvm "m1.dcos" natpf1 "m1.dcos,tcp,[ip address],51800,,80"

(Replace [ip address] with your physical machine’s ip address, you can also change the port 51800 to whatever you prefer)

If you have firewall enabled:

ufw allow 51800

This rule will not persist if you destroy your machines ("vagrant destroy"), so you need to run the port forwarding command every time you deploy DCOS virtual machines with "vagrant up" command.

Now you can reach DCOS management console from your web browser. Just type in

http://[ip address]:51800

Hope this guide helps you, and if you have suggestions or feedbacks, please leave a comment below.

Kerem Kayabay

Read more posts by this author.


Subscribe to Pseudo Factory

Get the latest posts delivered right to your inbox.

or subscribe via RSS with Feedly!