Prerequisites

1. Set the hostname of the OIM in the “hostname.domain name” format.

Hostname requirements

• The hostname should not contain the following characters: , (comma), . (period) or _ (underscore). However, the domain name is allowed with commas and periods.

• The hostname cannot start or end with a hyphen (-).

• No upper case characters are allowed in the hostname.

• The hostname cannot start with a number.

• The hostname and the domain name (that is: hostname00000x.domain.xxx) cumulatively cannot exceed 64 characters. For example, if the node_name provided in input/provision_config.yml is ‘node’, and the domain_name provided is ‘omnia.test’, Omnia will set the hostname of a target cluster node to ‘node000001.omnia.test’. Omnia appends 6 digits to the hostname to individually name each target node.

For example, controlplane.omnia.test is acceptable.

hostnamectl set-hostname controlplane.omnia.test

2. Creating user registries

Note

• The user_registry in input/local_repo_config.yml supports only nerdctl and docker registries.

• If you define the cert_path variable, ensure that it points to the absolute path of the user registry certificate present on the Omnia OIM.

• To avoid docker pull limits, provide docker credentials (docker_username, docker_password) in input/provision_config_credentials.yml.

Caution

In order to download the software images from an user registry, the user needs to ensure that the user_registry address provided in input/local_repo_config.yml is accessible from the Omnia OIM. If the user_registry is not accessible from the OIM, Omnia will download all the software images listed in input/software_config.json to the Omnia-registry. Use the curl -k <user_registry> to check.

Images listed in user_registry in input/local_repo_config.yml are accessed from user defined registries. To ensure that the OIM can correctly access the registry, ensure that the following naming convention is used to save the image:

<host>/<image name>:v<version number>

Therefore, for the image of calico/cni version 1.2 available on quay.io that has been pulled to a local host: server1.omnia.test, the accepted user registry name is:

server1.omnia.test:5001/calico/cni:v1.2

Omnia will not be able to configure access to any registries that do not follow this naming convention. Do not include any other extraneous information in the registry name.

Instructions to pull images from the user registries in the form of a digest:

• Images pulled from gcr.io does not have a tag, but a digest value.

  Image pulled from gcr.io

  {
         "package": "gcr.io/knative-releases/knative.dev/serving/cmd/webhook",
         "digest": "7b138c73fcaaf0b9bb2d414b8a89a780f8c09371d24c6f57969be1694acf4aaa",
         "type": "image"
  },
  

• While pushing these images to user_registry, user needs to manually enter a tag as shown in the sample below. Tags make the image unique to Omnia user_registry. If not provided, image will be accessed from the gcr.io registry, that is, from the internet.

  Add “tag” value as “omnia” in <software>.json file while pushing the image to user_registry

  {
          "package": "gcr.io/knative-releases/knative.dev/serving/cmd/webhook",
          "tag": "omnia",
          "type": "image"
  },
  

• For “kserve” and “kubeflow” images sourced from gcr.io, Omnia updates the digest tag to omnia-kserve and omnia-kubeflow while pushing the images to user_registry.

Note

• Enable a repository from your RHEL subscription, run the following commands:

  subscription-manager repos --enable=rhel-8-for-x86_64-appstream-rpms
  subscription-manager repos --enable=rhel-8-for-x86_64-baseos-rpms
  

• Enable an offline repository by creating a .repo file in /etc/yum.repos.d/. Refer the below sample content:

  [RHEL-8-appstream]
  
  name=Red Hat AppStream repo
  
  baseurl=http://xx.yy.zz/pub/Distros/RedHat/RHEL8/8.6/AppStream/x86_64/os/
  
  enabled=1
  
  gpgcheck=0
  
  [RHEL-8-baseos]
  
  name=Red Hat BaseOS repo
  
  baseurl=http://xx.yy.zz/pub/Distros/RedHat/RHEL8/8.6/BaseOS/x86_64/os/
  
  enabled=1
  
  gpgcheck=0
  

• Verify your changes by running:

  yum repolist enabled
  Updating Subscription Management repositories.
  Unable to read consumer identity
  This system is not registered with an entitlement server. You can use subscription-manager to register.
      repo id                                                           repo name
      RHEL-8-appstream-partners                                         Red Hat Enterprise Linux 8.6.0 Partners (AppStream)
      RHEL-8-baseos-partners                                            Red Hat Enterprise Linux 8.6.0 Partners (BaseOS)
  

If you have any feedback about Omnia documentation, please reach out at omnia.readme@dell.com.