This is the top level document that serves as a guide to other documents that capture the installation of IBM Cloud Private v3.1.0/v3.1.1 on Red Hat Enterprise Linux v7. (RHEL v7.3, 7.4 or 7.5)
Getting Started Overview - A high level view of deploying an ICP cluster.
General System Requirements - The detailed CPU, memory and file system requirements for the machines that make up the ICP cluster are described in this document.
Basic RHEL Configuration - A guide that describes the basic RHEL configuration needed by IBM Cloud Private.
Additional Packages - Itemized list of certain packages that are very useful to install on ICP cluster nodes. Some packages are only needed on the boot node, whether that is a dedicated node, or a master node is used as the boot node.
Configure passwordless SSH Configure passwordless ssh for root from the boot node to all cluster member nodes including the boot node. This allows Ansible to be used for various pre-installation steps. This is also a pre-requisite to running the ICP inception install process.
Special RHEL Configuration - Things that need to be configured for IBM Cloud Private that are not usually part of a stock RHEL configuration.
Install Docker Instructions for installing Docker using the installation executable provided with ICP at Passport Advantage (external) or eXtreme Leverage (IBM internal)
Outline for Sample HA Installation - An outline of the steps involved in standing up an ICP environment. Details for each step are not provided in this document. See other documents for details.
Install ICP 3.1.0 - ICP 3.1.0 installation guide given all the pre-installation steps have been completed, i.e., basic and special RHEL configuration, Docker installation, etc. A document that describes the specific steps for an ICP 2.1.0.3 installation is still part of the collection, but no longer linked in this top level guide.
ICP config.yaml details Typical config.yaml settings used for non-HA and HA deployments of ICP.
GlusterFS for shared storage running on RHEL - This document describes the installation of a GlusterFS cluster and the supporting Heketi server as well as the allocation of shared volumes for use by the ICP master nodes when an HA topology is deployed.
Configure Kubernetes Storage Class for GlussterFS Details on configuring a Kubernetes Storage Class that uses the GlusterFS provisioner that uses the Heketi server.
Update Prometheus Resources from Default Settings - This document describes the resource updates made to the Prometheus deployment to resolve the out of memory issue that occurs with larger ICP implementations.
Prometheus Alerts - This document provides a base set of alerts for ICP environments.
Kibana Updates - This document provides a procedure to update Kibana to support custom cluster names. This is required if you change the cluster_domain setting in the config.yaml.
RHEL 7 Installation - A sample - Step-by-step guide to installing RHEL 7 on VM deployed on VMware ESX hosts. This is intended merely as a sample for people who are not familiar with a RHEL installation.
RHEL 7 Network Interface Overview - Background on RHEL 7 network interface administration for people not experienced with Linux and RHEL.
RHEL 7 System Parameters Overview - Background on Linux system parameters for people not experienced with Linux and RHEL.
Yum Repository Configuration - Guidance on configuring yum repositories for those not experienced with RHEL.
Install NTP - Steps to install the ntpd, should it be needed. See also the Ansible playbook, install-ntp.yaml.
Kubernetes Basics - Rudimentary Kubernetes information sufficient to get started in the context of using ICP.
Docker Basics - Rudimentary Docker information sufficient to get started in the context of using ICP.
Getting Started with Ansible - Rudimentary Ansible information sufficient to get started in the context of deploying ICP.
Getting Started with Heketi Client - Rudimentary information sufficient to get started using the Heketi client in the context of ICP.
ICP Networks, DNS, PKI certificates and LDAP - A collection of notes regarding the topics of networks, DNS, PKI certificates and LDAP in the context of an ICP deployment.
Install Python Docker Support - Steps to install Python Docker support libraries for those who want to interact with Docker in the context of a Python script. Completely optional, and not needed for ICP deployment or administration.