Before mirroring the images, you must connect to the internet so that you can download
the corresponding CASE files.
About this task
Important: If your bastion host, portable compute device, or portable storage device
must connect to the internet through a proxy, you must set environment variables on the machine that
accesses the internet through the proxy server. For more information, see
Setting up proxy environment variables.
Procedure
- Connect your host to the internet and disconnect it from the local air-gapped
network.
- Download the Cloud Pak for Business Automation images to your
host.
-
From IBM Catalog Management Plug-in (ibm-pak) v1.4, you can download the CASE files from
cp.icr.io/cpopen
. You can view the current config of the plug-in by running the
following command:
oc ibm-pak config
The output lists all the configured repositories. The default repository from where the CASE
files are downloaded has an asterisk mark (*) against the Name
field.
-
You can then run the following command to configure a repository that downloads the CASE files
from the cp.icr.io
registry (an OCI-compliant registry) before you run the
oc ibm-pak get
command.
oc ibm-pak config repo 'IBM Cloud-Pak OCI registry' -r oci:cp.icr.io/cpopen --enable
The command sets 'IBM Cloud-Pak OCI registry' as the default repository.
-
You can list all the available CASE files to download by running the following command:
oc ibm-pak list
To get more help about the list command, run the following command:
oc ibm-pak list --help
-
Get the cp4ba-case-to-be-mirrored.txt file for 22.0.2, or an interim fix,
from the Cloud Pak for Business Automation CASE
images technote, and rename the file to
cp4ba-case-to-be-mirrored.yaml.
The YAML file lists all of the dependent case images with their respective pinned versions. After
you downloaded the text file, you must rename the file to
cp4ba-case-to-be-mirrored.yaml.
mv -v cp4ba-case-to-be-mirrored-<latest_ifix>.txt cp4ba-case-to-be-mirrored.yaml
-
When you are ready to start the download of the CASE files, run the following command:
oc ibm-pak get -c file://<absolute path to file>/cp4ba-case-to-be-mirrored.yaml
The <absolute path to file> needs to be a path starting from
"/". For example, "/opt".
By default, the root directory that is used by the ibm-pak plug-in is
~/.ibm-pak. Therefore, by default, the Cloud Pak for Business Automation CASE is downloaded
to ~/.ibm-pak/data/cases/$CASE_NAME/$CASE_VERSION.
Tip: You can configure the root directory by setting the
IBMPAK_HOME
environment variable.
-
To list the versions of all the downloaded CASE files, you can run the following command:
oc ibm-pak list --downloaded
If IBMPAK_HOME
is set, the downloaded CASE is located in
$IBMPAK_HOME/.ibm-pak/data/cases/$CASE_NAME/$CASE_VERSION. The logs files can
be found in $IBMPAK_HOME/.ibm-pak/logs/oc-ibm_pak.log.
Results
Your host is now configured with the Cloud Pak for Business Automation CASE files.
What to do next
You can now go ahead and mirror the images to your local registry. For more information, see
Mirroring images to a private registry.