alternate-install-methods.md

Alternate Install Methods

DC/OS supports 3 primary installation methods:

• Advanced - command line manual installation (default)
• CLI - command line automated installation using SSH
• GUI - browser-based installer

By default, DC/OS Vagrant uses the Advanced installation method, with tweaks specific to Vagrant. But the other two methods are also supported, for experimentation and automated testing.

Advanced Installer

The advanced installer is supported and fully automated.

For the official documentation, see the GUI DC/OS Installation Guide

Optionally, export the following environment variable before performing vagrant up:

export DCOS_INSTALL_METHOD=ssh_pull

Then follow the normal DC/OS Vagrant Deploy Steps.

Note: Advanced Installer supports both Public and Private Agent Nodes.

CLI Installer

The CLI installer is supported and fully automated.

For the official documentation, see the GUI DC/OS Installation Guide

First, export the following environment variable before performing vagrant up:

export DCOS_INSTALL_METHOD=ssh_push

Then follow the normal DC/OS Vagrant Deploy Steps.

Note: CLI Installer does not currently support Public Agent Nodes.

GUI Installer

The GUI installer support is experimental (DC/OS master only) and requires manual intervention to fill out and navigate the web forms. GUI installation is primarily supported on DC/OS Vagrant to facilitate testing of the GUI installer and serves no real benefit to other users over the other fully automated methods.

For the official documentation, see the GUI DC/OS Installation Guide

First, export the following environment variable before performing vagrant up:

export DCOS_INSTALL_METHOD=web

Then follow the normal DC/OS Vagrant Deploy Steps.

Note: GUI Installer does not currently support Public Agent Nodes.

After vagrant up, when the installer says Starting DCOS installer in web mode, open the DC/OS GUI Installer at http://boot.dcos:9000/.

On the next page, the installer prompts you with form fields. The values to enter into these field can be found at the pre-generated dcos/config.yaml and dcos/ip-detect files that should be at the root of the dcos-vagrant repo (copied there by the vagrant provisioner).

1. Enter the Master Private IPs from dcos/config.yaml - master_list.
2. Enter the Agent IPs from dcos/config.yaml - agent_list.
3. Enter the first Master Public IP from dcos/config.yaml - master_list[0] prefixed with http:// (auto-filled).
4. Enter the SSH Username from dcos/config.yaml - ssh_user.
5. Enter the SSH Listening Port from dcos/config.yaml - ssh_port (auto-filled).
6. Enter the Private SSH Key from .vagrant/dcos/private_key_vagrant (auto-filled).
7. Enter the Upstream DNS Servers dcos/config.yaml - resolvers (auto-filled).
8. Select Custom Script for IP Detect Script and select dcos/ip-detect.

Finally, select Run Pre-Flight and navigate through the subsequent prompts.