Skip to main content
Version: v2.9.x LTS

Downloading and installing

Downloading and installing

Learn how to download and install Zowe's containers.

Downloading

You can download Zowe's containers in one of the following ways:

Downloading configuration samples

The easiest way to install and run Zowe's containers is by using the configuration samples that are provided on Zowe's website. If you don't already have these samples, you can download them by completing the following tasks:

  1. Download Zowe containerization build from zowe.org.
  2. Extract the compressed file to the system where you will run the Zowe containers.
  3. Find the samples within the extracted folder kubernetes.

Downloading container images

Downloading Zowe's container images manually is not required because this can be done automatically when applying a Kubernetes deployment configuration.

If wanted, you can download Zowe's container images manually by using the docker pull commands. This allows you to get an image from a registry or attach an image that you have downloaded directly. You can find Zowe's container images in https://zowe.jfrog.io/ui/repos/tree/General/docker-release%2Fompzowe:

  • Registry: zowe-docker-release.jfrog.io
  • Organization: ompzowe

Full image addresses include,

  • zowe-docker-release.jfrog.io/ompzowe/gateway-service:latest-ubuntu
  • zowe-docker-release.jfrog.io/ompzowe/app-server:latest-ubuntu
  • zowe-docker-release.jfrog.io/ompzowe/explorer-jes:latest-ubuntu

Therefore, you can download these manually with the docker pull commands. For example,

docker pull zowe-docker-release.jfrog.io/ompzowe/app-server:latest-ubuntu

Installing

You do not need to install the Zowe containers if you use Zowe's Kubernetes configuration samples. By default, these sample configurations will pull Zowe component images from the public Zowe docker release registry zowe-docker-release.jfrog.io directly and then start them. Your Kubernetes nodes require an Internet connection that can reach this registry.

An image could be considered "installed" when it is findable by Kubernetes. Just like downloading, this is done automatically by Kubernetes but commands such as docker pull or docker load accomplishes the same task.

Upgrading

Upgrade is an automatic process when you apply Kubernetes deployment configuration. The configuration files tell Kubernetes to automatically download the latest version of Zowe. Here, latest is the keyword for constantly updated version. For example zowe-docker-release.jfrog.io/ompzowe/gateway-service:latest-ubuntu.

Note: Automatic upgrades can fail if you have changed the workload configuration files to use a specific Zowe version. In that case, you must enter the latest version manually in the configuration file such as zowe-docker-release.jfrog.io/ompzowe/gateway-service:2.0.0-ubuntu.

If your Kubernetes nodes do not have an Internet connection, you can follow the instruction of the previous step to manually pull all images into all your Kubernetes nodes. After you have done this, you need to modify all occurrences of imagePullPolicy: Always in the sample configurations and replace them with imagePullPolicy: Never before applying them.