- Supported operating systems are CentOS 7.x or RHEL 7.x.
- Docker needs to be installed on the host where the installer is being run.
- Install a docker swarm cluster (or) Use the Contiv installer to install the scheduler stack after installing docker on a node external to the cluster where the scheduler stack is being installed.
Contiv swarm installer is launched from a host external to the cluster. Here is the reference layout. All the nodes need to be accessible to the installer host.
┌─────────────────────────────────────────────────────────────────────┐
│ ##### # # # ##### ####### ####### ###### │
│ # # # # # # # # # # # │
│ # # # # # # # # # │
│ # # # # ##### # ##### ###### │
│ # # # # # # # # # │
│ # # # # # # # # # # # │
│ ##### ####### ##### ##### # ####### # # │
│ │
│ │
│ ┌────────────────────┐ │
│ │ │ │
┌──────── SSH ──┼─────────────────────────────────────────▶ Worker Node │ │
│ │ ┌────────────────────┐ │ │ │
│ │ │ │ └────────────────────┘ │
│ │ ┌──────▶ Master Node │ │
│ │ │ │ │ ┌────────────────────┐ │
│ │ │ └────────────────────┘ │ │ │
┌────────────┴────────────┐ │ │ │ Worker Node ◀──────┼────────┐
│ │ │ │ │ │ │ │
│ Install Host │ │ │ ┌────────────────────┐ │ │ │ │
│(Ansible based installer,│ │ │ │ └────────────────────┘ │ │
│ running in a docker │───┼── SSH ─▶ Master Node │ │ │
│ container) │ │ │ │ ┌────────────────────┐ │ │
│ │ │ │ └────────────────────┘ │ │ │ │
│ │ │ │ │ Worker Node │◀─────┼────────┤
└────────────┬────────────┘ │ │ │ │ │ │
│ │ │ ┌────────────────────┐ │ │ │ │
│ │ │ │ │ └────────────────────┘ │ │
│ │ └──────▶ Master Node │ │ │
│ │ │ │ ┌────────────────────┐ │ │
│ │ └────────────────────┘ │ │ │ │
├───────── SSH ─┼─────────────────────────────────────────▶ Worker Node │ │ │
│ │ │ │ │ │
│ │ └────────────────────┘ │ │
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│ │
│ │
└─────────────────────────────────────────────── SSH ──────────────────────────────────────────┘
- Download the install bundle
<TODO add a location here>
. This is of the form contiv-VERSIONTAG.tgz. - Extract the install bundle
tar xvzf contiv-VERSIONTAG.tgz
- cd to the extracted folder
cd contiv-VERSIONTAG
- To load the installer container image run
docker load -i contiv-install-image.tar
- Run
./install/ansible/install_swarm.sh -f <host config file> -n <contiv master> -e <ansible ssh key> -a <additional ansible options>
to install Contiv without the scheduler stack. - Run
./install/ansible/install_swarm.sh -f <host config file> -n <contiv master> -e <ansible ssh key> -a <additional ansible options> -i
to install Contiv with the scheduler stack. - To specify a user to user for the Ansible ssh login, specify "-u " as the additional andible option.
- Example host config file is available at install/ansible/cfg.yml
- To see additional install options run
./install/ansible/install_swarm.sh
.
- Supported operating systems are CentOS 7.x or RHEL 7.x.
- Install kubernetes 1.4 or higher using http://kubernetes.io/docs/getting-started-guides/kubeadm/.
- Download the install bundle
<TODO add a location here>
. - Extract the install bundle.
- Run
sudo ./install/k8s/install.sh -n $contiv_master
. where $contiv_master is the IP to be used for the Contiv proxy. - To see additional install options run
./install/ansible/install.sh
.