To install an OpenShift cluster with an installer-provisioned infrastructure, follow the instructions below.

This is one of the two methods to install an OpenShift cluster. The other method is to install the cluster with a user-provisioned infrastructure (see Installing OpenShift 4 with User-Provisioned Infrastructure). You can use only one of the two methods.

Prepare install-config.yaml

  1. Generate install-config.yaml with the following command:
    openshift-install --dir=$MY_CLUSTER create install-config
  2. Edit $MY_CLUSTER/install-config.yaml to update the networking section.
    • Change networkType to ncp.
    • Set the cidr value under clusterNetwork.
An example of install-config.yaml:
apiVersion: v1
baseDomain: openshift.test
- architecture: amd64
  hyperthreading: Enabled
  name: worker
  platform: {}
  replicas: 3
  architecture: amd64
  hyperthreading: Enabled
  name: master
  platform: {}
  replicas: 3
  creationTimestamp: null
  name: ipi
  networkType: ncp
  - cidr:
    hostPrefix: 24
    cluster: cluster
    datacenter: dc
    defaultDatastore: vsanDatastore
    network: openshift-segment
    password: pass
    username: user
    vCenter: my-vc.local
publish: External
pullSecret: 'xxx'
sshKey: 'ssh-rsa xxx'
You can validate your DNS configuration before installing OpenShift. Here is a sample DNS zone database:
$TTL    604800
$ORIGIN openshift.test.
@       IN      SOA     dns1.openshift.test. root.openshift.test. (
                              2         ; Serial
                         604800         ; Refresh
                          86400         ; Retry
                        2419200         ; Expire
                         604800 )       ; Negative Cache TTL
; main domain name servers
@       IN      NS      localhost.
@       IN      A
@       IN      AAAA    ::1
        IN      NS      dns1.openshift.test.
; recors for name servers above
dns1    IN      A
; sub-domain definitions
$ORIGIN ipi.openshift.test.
api IN A
apps IN A
; sub-domain definitions
$ORIGIN apps.ipi.openshift.test.
* IN A

Prepare the manifest files

  • Move the operator yaml files from deploy/openshift4 to $MY_CLUSTER/manifests.
  • Edit the operator configurations in configmap.yaml.
  • Add the operator image and NCP image in operator.yaml.

Create the cluster

Run the following command:
openshift-install create cluster --dir=$MY_CLUSTER
The installation log messages are in $MY_CLUSTER/.openshift_install.log. If the installation fails, check the log for error messages and make changes to the environment accordingly. Then re-run the installation with the following command:
openshift-install wait-for install-complete