Preparing to install an IBM Enterprise Application Runtimes, WebSphere Hybrid Edition, or Cloud Pak for Applications version of IBM Mono2Micro

IBM® Mono2Micro™ is ordered as part of IBM Enterprise Application Runtimes, IBM Cloud Pak® for Applications (Advanced, Standard, or Limited edition), or IBM WebSphere Hybrid Edition. After you order IBM Mono2Micro, an entitlement key for the software is associated with your MyIBM account. Use the key to access the Entitled Container Fulfillment Registry.

For a list of available IBM Enterprise Application Runtimes virtual processor core (VPC) offerings, see Ordering an IBM Enterprise Application Runtimes offering. For a list of available Cloud Pak for Applications VPC offerings, see Ordering a IBM Cloud Pak for Applications offering. For a list of available WebSphere Hybrid Edition virtual processor core (VPC) offerings, see Ordering a WebSphere Hybrid Edition offering.

  1. Get a key to the entitled registry.
    1. Log in to MyIBM Container Software Library with the IBMid and password that are associated with the entitled software.
    2. In the Entitlement keys section, select Copy key to copy the entitlement key to the clipboard.
  2. Set the entitled registry information.

    Run the following export commands. The <apikey> value is the same as the entitlement key from the previous step.

    export ENTITLED_REGISTRY=icr.io
export ENTITLED_REGISTRY_USER=cp
export ENTITLED_REGISTRY_KEY=<apikey>
  3. Log in to the entitled registry with the following docker login command. 
    docker login "$ENTITLED_REGISTRY" -u "$ENTITLED_REGISTRY_USER" -p "$ENTITLED_REGISTRY_KEY"

    For Podman, use podman instead of docker in the command.

    podman login "$ENTITLED_REGISTRY" -u "$ENTITLED_REGISTRY_USER" -p "$ENTITLED_REGISTRY_KEY"
  4. Download and install the Mono2Micro command line tool and install any wanted components.