Downloading IBM Optim Data Privacy

To acquire the containerized IBM® Optim assets, you must download them from IBM Passport Advantage®.

Who needs to complete this task?: A system administrator with non-root access must download the installation packages. The administrator should operate as a standard user, without using sudo or switching to the root user.

Tip: It is a good practice to create a designated installation user for downloading and installing IBM Optim Data Privacy.

Before you begin

Verify that you have access to download from IBM Passport Advantage. Before you begin, ensure that you have an IBMid and that your company’s Passport Advantage primary contact grants you permission to download IBM Optim Data Privacy. If you do not have an IBMid, create one on the Passport Advantage site.

Downloading and extracting the installation package

To download and extract the IBM Optim installation package:

On the host machine, create a working directory where you base all of your container activity: downloads, installation, running, and more. Give the directory a meaningful name, such as /optim-data-privacy.
In a web browser, go to Passport Advantage Online for Customers.
Search for IBM Optim Data Privacy 2.0.0 or search by the part number.
Download the installation archive file: IBM-optim-data-privacy-2.0.0.tgz.
Extract the archive into your working directory:
```
tar -xzf IBM-optim-data-privacy-2.0.0.tgz
```
After extraction, the working directory contains an entitlements folder, which holds the product entitlement files required for installation.

Important: The installation scripts, Podman Compose files, and Keycloak realm configuration are not included in the downloaded archive. They are embedded in the optim-metadb container image and must be extracted separately. For instructions, see the online or offline installation topic.

Contents of the downloaded archive

After extraction, the working directory contains the following:

entitlements/: A folder that contains product entitlement files required to authenticate with IBM Container Registry (ICR) and to activate licenses during installation.

Note: The installation scripts (setup-optim.sh, optim-imagetar.sh), Podman Compose files (optim-compose.yaml, optim-compose-icr.yaml), the sample.env file, and the Keycloak /realm configuration are obtained by extracting them from the optim-metadb container image as part of the installation procedure. After that extraction step, these files are present in your working directory alongside the entitlements/ folder.

Container images (offline installation only)

For offline (air-gapped) installations, container image .tar files are not included in the download package. They are produced on a separate internet-connected (bastion) machine by running scripts/optim-imagetar.sh, which pulls the images from ICR and saves them locally. The following image files are created:

IBM-optim-core-api-2.0.0.tar
IBM-optim-metadb-2.0.0.tar
IBM-optim-runtime-2.0.0.tar
IBM-optim-spark-2.0.0.tar
IBM-optim-ui-2.0.0.tar
IBM-optim-keycloak-2.0.0.tar
IBM-optim-catalog-2.0.0.tar
IBM-optim-flight-service-13.2.230-amd64.tar

For instructions on producing these files, see Installing IBM Optim Data Privacy by using offline mode.