Preparing To Install OpenShift on Bare Metal

Prepare Your Workstation For Bootstrap

Before you proceed, you need to setup your workstation for running the Bootstrap node. Or, if you have a NUC available, then you can set it up as a KVM host and run the bootstrap there. These instructions assume that you are using your workstation.

Set Up a MacBook for Qemu with Bridged Network

Set Up Bare Metal Cluster Configuration

As before, I’m being intentionally prescriptive here to help ensure success the first time you try this.

  1. copy the cluster config file from ${HOME}/okd-lab/kamarotos/examples/domain-configs/bare-metal-basic.yaml:

    cd ${HOME}/okd-lab/kamarotos
    git pull
    cp ${HOME}/okd-lab/kamarotos/examples/domain-configs/bare-metal-basic.yaml ${HOME}/okd-lab/lab-config/domain-configs/dev.yaml
    
  2. Read the MAC address off of the bottom of each NUC and add it to the cluster config file:

    Edit ${HOME}/okd-lab/lab-config/domain-configs/dev.yaml and replace YOUR_HOST_MAC_HERE with the MAC address of each NUC.

    Note: Use lower case letters in the MAC.

  3. You need to know whether you have NVME or SATA SSDs in the NUC.

    1. If you have an NVME drive installed in the NUC, you do not need to modify anything.

    2. If you have SATA M.2 drive instead of NVME then edit: ${OKD_LAB_PATH}/lab-config/domain-configs/dev.yaml, and replace nvme0n1 with sda.

    3. If you have more than one drive installed, then edit: ${OKD_LAB_PATH}/lab-config/domain-configs/dev.yaml, and replace disk2: NA with disk2: nvme0n2 or disk2: sdb as appropriate

  4. Set the OpenShift version for the lab to the latest available:

    labcli --latest -d=dev
    
  5. Replace the value of BOOTSTRAP_BRIDGE:

    Edit ${HOME}/okd-lab/lab-config/domain-configs/dev.yaml and replace BOOTSTRAP_BRIDGE with the ${BOOTSTRAP_BRIDGE} that you set in the step: Prepare Your Workstation For Bootstrap

  6. Your OpenShift cluster configuration YAML file should look similar to this:

    cluster:
      name: okd4
      cluster-cidr: 10.100.0.0/14
      service-cidr: 172.30.0.0/16
      local-registry: nexus.my.awesome.lab:5001
      proxy-registry: nexus.my.awesome.lab:5000
      remote-registry: quay.io/openshift/okd
      butane-version: v0.14.0
      butane-spec-version: 1.4.0
      ingress-ip-addr: 10.11.13.2
    bootstrap:
      metal: true
      mac-addr: "52:54:00:a1:b2:c3"
      boot-dev: sda
      ip-addr: 10.11.13.49
      bridge-dev: en6
      node-spec:
        memory: 12288
        cpu: 2
        root_vol: 50
    control-plane:
      metal: true
      okd-hosts:
      - mac-addr: "1c:69:11:22:33:44"
        boot-dev: /dev/sda
        ip-addr: 10.11.13.60
      - mac-addr: "1c:69:ab:cd:12:34"
        boot-dev: /dev/sda
        ip-addr: 10.11.13.61
      - mac-addr: "1c:69:fe:dc:ba:21"
        boot-dev: /dev/sda
        ip-addr: 10.11.13.62
    

Now We are Ready To Prepare a Disconnected Install of OpenShift

Preparing to Install OpenShift - Mirror OKD Images