rhim/install

Contiv Installer

Contiv Installation for Docker Swarm & Kubernetes 1.4+

Docker Swarm installation

Pre-requisites

• 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 Installation

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.

Kubernetes 1.4 installation

Pre-requisites

• 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/.

Contiv Installation

• 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.