OpenShift 3.6 Support Guest Configuration: Difference between revisions

From NovaOrdis Knowledge Base
Jump to navigation Jump to search
No edit summary
 
(18 intermediate revisions by the same user not shown)
Line 5: Line 5:
=Clone the Generic Template=
=Clone the Generic Template=


Use the [[OpenShift_3.6_Generic_Guest_Template#Overview|basic template]] as a base image and clone it, as described below.  
Use the [[OpenShift_3.6_Generic_Guest_Template#Overview|generic template]] as a base image and clone it, as described below.  


While cloning the guest, make sure to:
While cloning the guest, make sure to:
* Adjust the memory and the number of virtual CPUs.
* Adjust the memory and the number of virtual CPUs.
* Remove docker and docker storage.
* Remove docker storage support from domain definition, but replace it with NFS storage support.
* Provision NFS storage.


{{Internal|Linux Virtualization Cloning a KVM Guest Virtual Machine|Cloning a Guest}}
{{Internal|Linux Virtualization Cloning a KVM Guest Virtual Machine|Cloning a Guest}}
Line 16: Line 15:
The process will produce a ocp36.ingress.
The process will produce a ocp36.ingress.


=Resources=


Verify the memory and the number of virtual CPUs.


===Support Host Configuration===
=Remove Docker=


====Clone the Template====
systemctl stop docker
systemctl stop docker-storage-setup.service
systemctl disable docker
systemctl disable docker-storage-setup.service
yum remove docker


Clone the template following the procedure described here [[Linux_Virtualization_Cloning_a_KVM_Guest_Virtual_Machine|Cloning a KVM Guest]]. While cloning, consider the following:
Reset the storage, in case docker got to initialize it.
* Adjust the memory and the number of virtual CPUs.
 
* The support host needs an additional block storage device, but it won't be used for Docker storage and it will be different in size.
vgremove docker_vg
pvremove /dev/vdb1
fdisk /dev/vdb
 
=Prepare File System For NFS=
 
The NFS server will serve storage for [[OpenShift_Concepts#Persistent_Volume|persistent volumes]], [[OpenShift Concepts#Metrics|metrics]] and [[OpenShift Concepts#Logging|logging]]. Build a dedicated storage device to be shared via NFS, but do not export individual volumes; the OpenShift installer will do that automatically.  


====Post-Cloning====
Create the partition:


* Turn off docker and disable it
fdisk /dev/vdb
* Remove the docker logical volume
Command (m for help): n
* Replace the docker storage with nfs storage - it should still be /dev/vdb1
Partition type:
  p  primary (0 primary, 0 extended, 4 free)
  e  extended
Select (default p): p
Partition number (1-4, default 1): 1
First sector (2048-167772159, default 2048):
Using default value 2048
Last sector, +sectors or +size{K,M,G} (2048-167772159, default 167772159):
Using default value 167772159
Partition 1 of type Linux and of size 80 GiB is set
Command (m for help): w
The partition table has been altered!


====NFS Server Installation====
Create the filesystem:


Install and configure an NFS server. The NFS server will serve storage for [[OpenShift_Concepts#Persistent_Volume|persistent volumes]], [[OpenShift Concepts#Metrics|metrics]] and [[OpenShift Concepts#Logging|logging]]. Build a dedicated storage device to be shared via NFS, but do not export individual volumes; the OpenShift installer will do that automatically. At this stage, make sure the storage is mounted, NFS server binaries are installed, and iptables is correctly configured to allow NFS to serve storage. A summary of these steps is presented in [[Provisioning and Installing a New Filesystem on a New Logical Volume]] and [[Linux NFS Installation|NFS Server Installation]]. All steps of the procedure must be executed, less the export part.
  mkfs.xfs /dev/vdb1


====bind DNS Server Installation====
Follow the NFS server installation procedure, exposing it as /nfs. At this stage, make sure the storage is mounted,  NFS server binaries are installed, and iptables is correctly configured to allow NFS to serve storage, and the NFS server starts at boot. The exports themselves will be configured by OpenShift.
<span id='bind_DNS_Server'></span>


{{Error|During the next iteration, consider installing the DNS server on "in", as "in" is always on, and the load balancer also runs on "in" and it needs internal name resolution. Also make haproxy dependent on named.}}
{{Internal|Linux NFS Installation|Linux NFS Installation}}


{{Error|Consider using master SkyDNS as the only name forwarder to the support DNS server.}}
=bind DNS Server Installation=


{{Internal|Bind_Operations_-_Set_Up_DNS_Server|bind DNS Server Installation}}
{{Internal|Bind_Operations_-_Set_Up_DNS_Server|bind DNS Server Installation}}

Latest revision as of 04:15, 9 November 2017

Internal

Clone the Generic Template

Use the generic template as a base image and clone it, as described below.

While cloning the guest, make sure to:

  • Adjust the memory and the number of virtual CPUs.
  • Remove docker storage support from domain definition, but replace it with NFS storage support.
Cloning a Guest

The process will produce a ocp36.ingress.

Resources

Verify the memory and the number of virtual CPUs.

Remove Docker

systemctl stop docker
systemctl stop docker-storage-setup.service
systemctl disable docker
systemctl disable docker-storage-setup.service
yum remove docker

Reset the storage, in case docker got to initialize it. 

vgremove docker_vg
pvremove /dev/vdb1
fdisk /dev/vdb

Prepare File System For NFS

The NFS server will serve storage for persistent volumes, metrics and logging. Build a dedicated storage device to be shared via NFS, but do not export individual volumes; the OpenShift installer will do that automatically.

Create the partition: 

fdisk /dev/vdb
Command (m for help): n
Partition type:
  p   primary (0 primary, 0 extended, 4 free)
  e   extended
Select (default p): p
Partition number (1-4, default 1): 1
First sector (2048-167772159, default 2048):
Using default value 2048
Last sector, +sectors or +size{K,M,G} (2048-167772159, default 167772159):
Using default value 167772159
Partition 1 of type Linux and of size 80 GiB is set

Command (m for help): w

The partition table has been altered!

Create the filesystem: 

mkfs.xfs /dev/vdb1

Follow the NFS server installation procedure, exposing it as /nfs. At this stage, make sure the storage is mounted, NFS server binaries are installed, and iptables is correctly configured to allow NFS to serve storage, and the NFS server starts at boot. The exports themselves will be configured by OpenShift.

Linux NFS Installation

bind DNS Server Installation

bind DNS Server Installation
Retrieved from "https://kb.novaordis.com/index.php?title=OpenShift_3.6_Support_Guest_Configuration&oldid=30722"