Home > Workload Solutions > Container Platforms > Red Hat OpenShift Container Platform > Guides > Implementation Guide—Red Hat OpenShift Container Platform 4.12 on Intel-powered Dell Infrastructure > Agent-based installer deployment of the cluster
The agent-based installer can run offline and is useful for clusters that are in a restricted network without Internet access.
A mirror registry is required for disconnected installations. The container images must be mirrored before you start the deployment. Various options are available for the mirror registry, including Red Hat Quay, JFrog Artifactory, and Harbor. For more information, see About disconnected installation mirroring - Disconnected installation mirroring | Installing | OpenShift Container Platform 4.12.
Dell Technologies recommends a highly available setup for the OpenShift mirror registry. An alternative is to deploy and configure a mirror registry that is a small-scale version of Red Hat Quay, as described in the following section of this guide.
Note: The following section describes the process for mirroring only the OpenShift Container Platform image repository that is needed for cluster deployment. For information about mirroring the custom catalogs that are required for operator installation, see Mirroring operator catalogs for use with disconnected clusters.
Ensure that:
To install a mirror registry for Red Hat OpenShift:
tar -xvf mirror-registry.tar.gz
./mirror-registry install --quayHostname <fqdn of the mirror registry host> --quayRoot <installation directory>/quay
Use an absolute path for quayRoot when running the mirror registry script.
Note: Make a note of the credentials for init user in the output of the preceding command. These credentials are required for access to the mirror registry CLI and user interface (UI).
podman login -u init -p <password> https://<fqdn of the mirror registry host>:8443
Note: If there is a certificate issue, copy the rootCA.pem that is in the <installation directory>/quay/quay-rootCA folder to /etc/pki/ca-trust/source/anchors and run the update-ca-trust command to update the certificates.
https://<fqdn of the mirror registry host>:8443
cat ./pull-secret | jq . > <path>/<pull_secret_file_in_json>
echo -n '<user_name>:<password>' | base64 -w0
"auths": {
"<mirror_registry>": {
"auth": "<credentials in base64 format generated in previous step>",
"email": "<email id>"
}
},
Ensure that the mirror registry host has Internet access. Then perform the following steps:
#Export the release version, change the version as required:
OCP_RELEASE=4.12.13
#Export the local registry name and host port:
LOCAL_REGISTRY='<fqdn of the mirror registry host>:8443'
#Export the local repository name:
LOCAL_REPOSITORY='ocp4/openshift412'
#Export the name of the repository to mirror:
PRODUCT_REPO='openshift-release-dev'
#Export the path to your registry pull secret:
LOCAL_SECRET_JSON='<path to pullsecret file in json format>'
#Export the release mirror:
RELEASE_NAME="ocp-release"
#Export the type of architecture for your server:
ARCHITECTURE=x86_64
oc adm release mirror -a ${LOCAL_SECRET_JSON} --from=quay.io/${PRODUCT_REPO}/${RELEASE_NAME}:${OCP_RELEASE}-${ARCHITECTURE} --to=${LOCAL_REGISTRY}/${LOCAL_REPOSITORY} --to-release-image=${LOCAL_REGISTRY}/${LOCAL_REPOSITORY}:${OCP_RELEASE}-${ARCHITECTURE}
This command pulls the release information as a digest. The command output includes the imageContentSources data that is required during the cluster installation. The information about mirrors is unique to the mirrored repository.
imageContentSources:
- mirrors:
- ipi-prov.dcws.lab:8443/ocp4/openshift412
source: quay.io/openshift-release-dev/ocp-release
- mirrors:
- ipi-prov.dcws.lab:8443/ocp4/openshift412
source: quay.io/openshift-release-dev/ocp-v4.0-art-dev
The CSAH node is used for running the installer.
To start the deployment:
https://mirror.openshift.com/pub/openshift-v4/x86_64/clients/ocp/stable/openshift-install-linux.tar.gz
The images version that is already downloaded in the mirror registry should match that version. For example, if you want to deploy a cluster on version 4.12.13, ensure that you have downloaded the 4.12.13 images into the mirror registry.
wget https://mirror.openshift.com/pub/openshift-v4/x86_64/clients/ocp/4.12.13/openshift-install-linux.tar.gz
tar -xzvf openshift-install-linux.tar.gz
cp openshift-install /usr/local/bin
sudo dnf install /usr/bin/nmstatectl -y
mkdir ~/dir-install
Note: Ensure that the file names are install-config.yaml and agent-config.yaml and that the files are present in the installation directory.
tr -d '[:space:]' < <pull scret file in json format>
openshift-install --dir dir-install/ agent create image
openshift-install --dir dir-install/ agent wait-for bootstrap-complete --log-level=debug
openshift-install --dir dir-install agent wait-for install-complete
The following figure shows the command output following a successful installation: