View source for OpenShift 3.6 Installation

=External=

* https://docs.openshift.com/container-platform/3.6/install_config/index.html

=Internal=

* [[OpenShift_Installation#Subjects|OpenShift Installation]]
* [[OpenShift_3.5_Installation|OpenShift 3.5 Installation]]
* [[OpenShift_Concepts#Installation|OpenShift Installation Concepts]]

=Overview=

This document covers OpenShit Container Platform 3.6 advanced installation procedure. The procedure it is largely based on https://docs.openshift.com/container-platform/3.6/install_config/index.html and contains additional details observed during an actual installation process on KVM guests.

=Location=

 noper430:/root/environments/ocp36
 RackStation:/base/NovaOrdis/Archive/yyyy.mm.dd-ocp36

=Hardware Requirements=

{{External|https://docs.openshift.com/container-platform/3.6/install_config/install/prerequisites.html#hardware}}

=System and Environment Prerequisites=

The pre-requisites and all preparatory steps presented in the following link are also addressed in this procedure. The links are provided for reference only:

{{External|https://docs.openshift.com/container-platform/3.6/install_config/install/prerequisites.html}}

{{External|https://docs.openshift.com/container-platform/3.6/install_config/install/host_preparation.html}}

=Virtualization Host Preparation=

* [[OpenShift 3.6 Virtualization Host Preparation|Virtualization Host Preparation]]

=Guest Template Preparation=

Create VM templates, in this order:

* [[OpenShift 3.6 Basic Guest Template|Basic Guest Template]]
* [[OpenShift 3.6 Generic Guest Template|Generic Guest Template]]

=Cloud Provider-Specific Configuration=

* https://docs.openshift.com/container-platform/3.6/install_config/configuring_aws.html#install-config-configuring-aws
* https://docs.openshift.com/container-platform/3.6/install_config/configuring_openstack.html#install-config-configuring-openstack
* https://docs.openshift.com/container-platform/3.6/install_config/configuring_gce.html#install-config-configuring-gce

=Guest Configuration=

* [[OpenShift 3.6 Ingress Guest Configuration|Ingress Guest Configuration]]
* [[OpenShift 3.6 Support Guest Configuration|Support Guest Configuration]]
* [[OpenShift 3.6 Node Guest Configuration|OpenShift Node Guest Configuration]]

=External DNS Setup=

An [[OpenShift_Concepts#External_DNS_Server|external DNS server]] is required. Controlling a registrar (such as http://godaddy.com) DNS zone will provide all capabilities needed to set up external DNS address resolution. A valid alternative, though more complex, is to install a dedicated public DNS server. The DNS server must be available to all OpenShift environment nodes, and also to external clients than need to resolve public names such as the master public web console and API URL, the public wildcard name of the environment, the [[OpenShift_Concepts#Router|application router]] public DNS name, etc. A combination of a public DNS server that resolves public addresses and an internal DNS server, deployed as part of the environment, usually on the support node, tasked with resolving internal addresses is also a workable solution. This installation procedure includes installation of the bind DNS server on the support node - see [[#bind_DNS_Server_Installation|bind DNS server installation]] section below.

==Wildcard Domain for Application Traffic==

The DNS server that resolves the public addresses will need to be capable to support [[DNS_Concepts#Wildcard_Sub-Domain|wildcard sub-domains]] and resolve the public wildcard DNS entry to the public IP address of the [[OpenShift Concepts#Node|node]] that executes the [[OpenShift_Concepts#Router|default router]], or of the public ingress node that proxies to the default router. If the environment has multiple routers, an external load balancer is required, and the wildcard record must contain the public IP address of the host that runs the load balancer. The name of the wildcard domain will be later specified during the advanced installation procedure in the Ansible inventory file as [[OpenShift_hosts#openshift_master_default_subdomain|openshift_master_default_subdomain]].

Configuration procedures:
* [[Bind_Operations_-_Set_Up_DNS_Server#Declare_a_Wildcard_DNS_Domain|Declare a Wildcard Subdomain for bind]]
* [[godaddy.com#Setting_Up_a_Wildcard_DNS|Setting Up a Wildcard DNS at godaddy.com]]

=OpenShift Advanced Installation=

{{External|https://docs.openshift.com/container-platform/3.6/install_config/install/advanced_install.html#install-config-install-advanced-install}}

==The Support Node==

Execute the installation as "ansible" from the support node. 

As "root" on "support":

 cd /usr/share/ansible
 chgrp -R ansible /usr/share/ansible
 chmod -R g+w /usr/share/ansible
 chgrp ansible /etc/ansible/
 chmod g+w /etc/ansible/

The support node needs at least 1 GB or RAM to run the installation process.

Create an ansible key pair on "support" and disseminate it to all other nodes. As "ansible": 

 cd
 ssh-keygen -q -b 2048 -f ~/.ssh/id_rsa -t rsa

==Configure Ansible Inventory File==

{{Internal|OpenShift hosts|OpenShift Ansible hosts Inventory File}}

=Pre-Flight=

On the support node, as "root":

 cd /tmp
 rm -r tmp* yum*
 rm /usr/share/ansible/openshift-ansible/playbooks/byo/config.retry

As "ansible":

 cd /etc/ansible
 ansible all -m ping
 ansible nodes -m shell -a "systemctl status docker"
 ansible nodes -m shell -a "docker version"
 ansible nodes -m shell -a "pvs"
 ansible nodes -m shell -a "vgs"
 ansible nodes -m shell -a "lvs"
 ansible nodes -m shell -a "nslookup something.apps.openshift.novaordis.io"

 ansible nodes -m shell -a "mkdir /mnt/tmp"
 ansible nodes -m shell -a "mount -t nfs support.ocp36.local:/nfs /mnt/tmp"
 ansible nodes -m shell -a "hostname > /mnt/tmp/\$(hostname).txt"
 ansible nodes -m shell -a "umount /mnt/tmp"
 for i in /nfs/*.ocp36.local.txt; do echo $i; cat $i; done

=Snapshot the Guest Images for the Entire Environment=

On the virtualization host:

 virsh vol-list main-storage-pool --details
 ./stop-ose36
 virsh list --all

{{Internal|Qemu-img#Take_a_Snapshot|qemu-img snapshot}}


{{Error|[[OSC3.6TODEPLETE]]}}