z/OS Container Extensions (zCX) Everything you need to get started quickly. Get started - Play overview Transcript
IBM® z/OS® Container Extensions (IBM zCX) makes it possible to integrate Linux on IBM Z applications with z/OS. Application developers can develop and data centers can operate popular open source packages, Linux applications, IBM software, and third-party software together with z/OS applications and data. IBM provides a Linux distribution configured to run Docker CE. IBM supplied support code will simplify installation and operation. Clients can participate with their own Linux applications that can easily be packaged in Docker format and deployed in the same way as open source, IBM, and vendor packages. Container Extensions runs on IBM z14™ and later systems. Announcements

Learn about zCX performance benefits compared to x86

Read the report
Big picture 1. Decide whether zCX is the right solution for you. 2. Prepare your system and plan for your zCX instance. 3. Provision a zCX instance using the z/OSMF workflow. 4. Deploy your first Linux container in your zCX instance. 5. Manage and maintain your zCX instance. Architecture This diagram illustrates the architecture of a multiple-zCX deployment running on z/OS. Click the diagram to expand it. How to get started
Overview Use the following resources and references to consider whether zCX is the right solution for your IBM z/OS system. Use this infographic to determine if zCX is a good fit for your software Learn about how zCX is similar to and different from Linux on IBM Z See what others think about zCX
Start the zCX Trial to experience zCX in your own environment without purchasing IBM Container Hosting Foundation for z/OS or IBM Container Hosting Foundation (hardware feature code 0104). The zCX Trial enables full zCX capability for 90 days on your z/OS 2.4 and z14 or higher. Download APAR OA58969 to start the trial. Learn more about the zCX Trial Download APAR OA58969
Overview

Now that you have decided to use zCX, it is time to prepare your system to support zCX and plan for your zCX instance. zCX requires IBM z14™ or later servers with z/OS V2R4 or higher and z/OS Management Facility (z/OSMF) configured and running on your system.

IBM Container Hosting Foundation for z/OS (5655-HZ1) provides required service and support for the underlying Linux kernel and zCX appliance, as well as unlimited zCX usage in the central processor complex (CPC) across all LPARs. If you have an IBM z14 or IBM z15 processor, as an alternative to IBM Container Hosting Foundation for z/OS, you can order Container Hosting Foundation, hardware feature code 0104, from the eConfig Fulfillment System.

Use the steps below to help your z/OS team decide on allocations and variables needed for your zCX instances.

Overview

Once all the decisions in the planning phase have been decided, you are ready to provision your zCX instance using a z/OS Management Facility (z/OSMF) workflow.

The first workflow step asks you to provide the information needed to provision your zCX instance. You can input the variables manually, or using a workflow variables input properties file that you prepare beforehand. The remaining steps of the workflow can be automated.

See the instructions for running zCX workflows
Planning See the variables needed to provision a zCX instance. Prepare your workflow variables input properties file. If you do not have z/OSMF installed on your system, use the z/OSMF Configuration Guide.
Overview

Now you are ready to log in to your zCX instance and deploy a Docker container.

Visit the Open Mainframe Project, Ambitus, for additional resources to promote collaboration and knowledge sharing of open source technologies that modernize and expand the IBM Z platform ecosystem.

Ambitus Github
Planning If you are using local user management, you must create and give permission to anyone who will be using the zCX instance. Using local user management Learn how to log in to the container and issue Docker commands View available IBM Z Docker containers in Docker Hub
Steps
  1. Log in to the Docker Command Line Interface (CLI)
  2. Pull in a Docker image to the container
  3. Create a container from a Docker image
Overview

z/OSMF has additional workflows to manage the lifecycle of your zCX appliance, including deprovisioning a zCX instance.

There is diagnostic information available for zCX should you encounter any problems.

Capabilities for extending zCX use include clustering and orchestration, creating a swarm cluster of zCX instances using the Docker CLI, and deploying Docker containers in a zCX swarm cluster using the Docker CLI. Future releases of zCX plan to include support for Kubernetes clustering.

View the IBM z/OS hybrid cloud enablement statement of direction
Frequently asked questions Click a category to see the questions.
Q: What are the benefits of z/OS Container Extensions?

A: z/OS Container Extensions expands and modernizes the z/OS software ecosystem to include Linux on IBM Z applications. Most applications (including Systems Management components and development tools) that are currently only available to run on Linux will be able to run on z/OS as Docker containers. zCX runs Linux on IBM Z applications on z/OS, using existing z/OS operations staff and reusing the existing z/OS environment. zCX maintains operational control within z/OS and z/OS Qualities of Service (scalability, availability, integrated disaster recovery, backup, WLM, and integration with z/OS security).

Q: How is Container Extensions different from Linux on IBM Z?

A: zCX gives z/OS environments the ability to deploy Linux on IBM Z applications as Docker containers for workloads with an affinity to z/OS. It is not a replacement for traditional Linux on IBM Z environments.

If you are a client with Linux on IBM Z installations, you will continue to run those installations. If you are a z/OS client that used to, but no longer has a Linux on IBM Z installation, you should consider zCX. If you are a z/OS client that has never had a Linux on IBM Z installation, then zCX Extensions is a low effort way to try Linux on IBM Z.

Q: Can I install the APAR and enable the 90-day zCX trial in more than one LPAR or on more than one CPC?

A: You can use the 90-day zCX Trial no more than one time per sysplex. The sysplex can span multiple CPCs.

Q: What are some zCX use cases?

A: z/OS software ecosystem expansion: Latest microservices, non-SQL databases, analytics frameworks, ICP, application server environment, and emerging programming languages and environments.

Systems management: Centralization of UI portals for management products and databases
z/OS modernization: Open source application development utilities.

Q: Are there samples and resources that I can look at to get started?

A: Yes. Visit the Open Mainframe Project, Ambitus, for samples, build recipes, and other resources to promote collaboration and knowledge sharing of open source technologies to modernize and expand the IBM Z platform.

Open Mainframe Project Ambitus
Q: Do application developers require knowledge of z/OS to create and deploy Linux on IBM Z applications to run in z/OS Container Extensions?

A: Applications will look like Docker applications to the developer, not z/OS applications. If your application comes from Linux on IBM Z, then no z/OS skills are required. Docker and Linux knowledge are all that is required.

Q: Does Container Extensions make use of Kubernetes?

A: No, not at this time. The initial release of zCX for IBM z/OS V2.4 provides Docker Swarm as support for Docker cluster management. IBM’s future plans intend to include Kubernetes clustering for the orchestration, scalability, and management of zCX with compatible cloud platforms.

Q: Will there be performance data published for zCX?

A: There is currently no plan to publish performance data for the zCX environment because performance is heavily reliant on individual configuration, workload, and networking characteristics.

Q: What are the costs associated with z/OS Container Extensions?

A: zCX is a base element of z/OS. There is no additional software cost for zCX itself beyond z/OS. Associated costs are IBM Container Hosting Foundation for z/OS (or the alternative FC 0104 for an IBM z14 or IBM z15), possible hardware costs for zIIPs, and any software licensing of Linux on IBM Z applications running inside zCX. For more information, see Program Directory for IBM Container Hosting Foundation for z/OS.

Q: On which engine types can z/OS Container Extensions run?

A: z/OS Container Extensions address spaces are zIIP-eligible. Most zCX processing (including Docker containers deployed within zCX) can be dispatched on available zIIP processors. Some zCX processing will be dispatched on standard processors. This will generally be a much smaller percentage of processor cycles compared to what can execute on zIIPs. Running the Acme Air benchmark on zCX, up to 98% of the zCX CPU consumption was measured to be zIIP eligible. (See note below.)

A good first assumption is that the new work running in the zCX environment will be 95% zIIP-eligible. However, your zCX environment may be more or less zIIP eligible depending on characteristics of the workload. Capacity planning should be based on the measured zIIP eligibility of your specific zCX applications. zCX can be deployed exclusively on standard processors if no zIIP processors are available. See "Exploiting zIIP and general purpose processors for zCX workloads" in the IBM z/OS Container Extensions Guide for more information.

Note: Results were extrapolated from internal IBM benchmarks performed in a controlled environment using a single z14 z/OS 2.4 LPAR with TCP/IP inbound workload queuing (IWQ) for inbound traffic and two zCX containers: one running Node.js and one running a MongoDB database. zIIP eligibility is based on the CPU consumption of the work running on the zCX address spaces and the associated work on the TCPIP and VTAM address spaces. Results may vary.

Q: Are licenses required for applications running inside z/OS Container Extensions?

A: Yes, any licenses that you would procure to run applications in a traditional Linux on IBM Z environment will also be required to run those same applications inside zCX. Licenses are the same as those used for traditional Linux on IBM Z applications. If you are using an application on both Linux on IBM Z and zCX environments, ensure you have enough licensed capacity available to run the application on all the cores on which it will be active.

Q: Is Processor Value Unit (PVU) Licensing effective for IBM applications running inside z/OS Container Extensions?

A: Yes, whatever PVU licensing is in effect for IBM software in the traditional Linux on IBM Z environment is also in effect for zCX. Both General Purpose and zIIP engines are counted as cores.

PVU licensing for Passport Advantage® Products
Q: Will subcapacity pricing for Linux on IBM Z IBM SW (Passport Advantage products) be supported in zCX?

A: Yes, sub-capacity pricing is supported through the IBM License Metric Tool.

For more information on IBM License Metric Tool enablement on zCX, refer to Using the IBM License Metric Tool for sub-capacity pricing.

Use of IBM License Metric Tool is now mandatory for sub-capacity pricing for the zCX environment. Manual reporting is no longer acceptable.

Q: What can run in z/OS Container Extensions?

A: Anything with s390x architecture (the IBM Z opcode set) in Docker hub can be run in zCX. The code is binary compatible between Linux on IBM Z and Container Extensions.

In addition to open source packages, there will likely be IBM and third-party software available. It is intended that clients can participate with their own Linux applications, which can easily be packaged in Docker format and deployed in the same as open source, IBM, and vendor packages.

Q: On which engine types can z/OS Container Extensions run?

A: z/OS Container Extensions address spaces are zIIP-eligible. Most zCX processing (including Docker containers deployed within zCX) can be dispatched on available zIIP processors. Some zCX processing will be dispatched on standard processors. This will generally be a much smaller percentage of processor cycles compared to what can execute on zIIPs. Running the Acme Air benchmark on zCX, up to 98% of the zCX CPU consumption was measured to be zIIP eligible. (See note.)

A good first assumption is that the new work running in the zCX environment will be 95% zIIP-eligible. However, your zCX environment may be more or less zIIP eligible depending on characteristics of the workload. Capacity planning should be based on the measured zIIP eligibility of your specific zCX applications. zCX can be deployed exclusively on standard processors if no zIIP processors are available. See "Exploiting zIIP and general purpose processors for zCX workloads" in the IBM z/OS Container Extensions Guide for more information.

Note: Results were extrapolated from internal IBM benchmarks performed in a controlled environment using a single z14 z/OS 2.4 LPAR with TCP/IP inbound workload queuing (IWQ) for inbound traffic and two zCX containers: one running Node.js and one running a MongoDB database. zIIP eligibility is based on the CPU consumption of the work running on the zCX address spaces and the associated work on the TCPIP and VTAM address spaces. Results may vary.

Documentation Comprehensive content collection

Read the comprehensive content collection about z/OS Container Extensions.

Explore the collection
Technical resources Journey to AI on IBM Z and LinuxONE

Get started on your journey to AI on IBM Z and LinuxONE.

Explore the content solution
IBM Communities

Sharing information about zCX and insights into deploying Linux on IBM Z containerized applications inside z/OS.

Join the Community
Terminal Talk Podcast

Episode 79 of Terminal Talk by Frank and Jeff features Gary Puchkoff of IBM Z discussing z/OS Container Extensions (zCX). Search for “Terminal Talk” in iTunes, Google Play, or your favorite podcast app, or click the link below.

Listen to the podcast (30:39)
Terminal Talk podcast

Episode 77 of Terminal Talk by Frank and Jeff features Joe Bostian of IBM Z discussing open source on Z.Search for “Terminal Talk” in iTunes, Google Play, or your favorite podcast app, or click the link below.

Listen to the podcast (35:12)
Terminal Talk podcast

This episode of Terminal Talk by Frank and Jeff features Anthony Giorgio of IBM Z discussing the what, how, and why of zCX including its latest developments.

Listen to the podcast (39:13)
Docker

Learn about Docker containers through the Resources tab on Docker’s website.

Visit docker.com
IBM Systems Lab Services

Learn how IBM Systems Lab Services can help you install Docker containers for z/OS using zCX.

Read more
IBM Garage for Systems & Washington Systems Center zCX Workshop

Learn how to onboard and leverage z/OS Container Extensions in a custom workshop.

Learn more about zCX workshops
Mainframe, Performance, Topics Podcast

Marna Walle of IBM Z discusses zCX performance enhancements.

Listen to the podcast (49:39)
Terminal Talk Podcast

Gary Puchkoff and Allison Moshier explain how z/OS Container Extensions has advanced recently and give a peek of things to come.

New Listen to the podcast (27:13)
Comprehensive content collection

Read the comprehensive content collection about z/OS Container Extensions.

Explore the collection
Tutorial Video

An overview of how to plan for zCX and the required resources

Watch the video (07:49)
Tutorial Video

A demonstration of how to provision zCX using z/OSMF

Watch the video (06:24)
Tutorial Video

Provisioning a zCX appliance

Watch the video (10:08)
Tutorial Video

An introduction to understanding and using Docker

Watch the video (04:53)
Ambitus Github

A zCX open source Github repository with example images of Portainer, Jupyterhub, Dev Toolkit, and Grafana

Visit the repository
IBM Redbooks

Getting started with z/OS Container Extensions and Docker

Read the IBM Redbook
IBM Redbooks

Install, configure, and use the IBM z/OS Management Facility (z/OSMF).

Read the IBM Redbook
Service Management Unite (SMU)

Download the Service Management Unite (SMU) image directly into z/OS using z/OS Container Extensions (IBM enterprise account required).

Learn more
IDC White paper

Transforming a Corporate Datacenter into a Modern Environment: Kubernetes as a Foundation for Hybrid Cloud.

Read the whitepaper
Grafana for zCX

A Grafana dashboard template for monitoring your zCX instances.

View the dashboard
IBM Z Hot Topics

Learn about the 90-day zCX Trial.

Read the article
z/OS Communications Server Performance Summary Report

Understand configuration and impacts of zCX in the V2R4 report.

Read the report
Tutorial video

A demonstration of Docker image development in zCX.

Watch the video (02:48)
IBM Z Hot Topics

Getting Better Performance for Your zCX Containers.

Read the article
IBM Redbooks

IBM z/OS Container Extensions (zCX) Use Cases.

Download the IBM Redbook
Example video

A demonstration of using JupyterHub and zCX.

Watch the video (02:41)
Running IBM Aspera on zCX View the use case Running MQ Client Concentrator on zCX View the use case Running IBM Service Management Unite on zCX View the use case Running App Connect Enterprise on zCX View the use case Systems Magazine Article

Learn how IBM used zCX to modernize our own internal tool.

Read the article
MQ for z/OS Performance Report

Use cases with z/OS Container Extensions

Read the report
IBM IT Economics Consulting and Research

Learn about zCX performance benefits compared to x86

Read the report
IBM Z and LinuxONE container registry

Learn about container images for IBM Z and LinuxONE

See the container registry
Secure your z/OS ecosystem with zCX

Learn about running IBM Security Guardium Key Lifecycle Manager (GKLM) on zCX

New View the use case
Simplify workload scheduling management with zCX

Learn about running IBM Z Workload Scheduler Dynamic Workload Console, IBM Z Workload Scheduler Agent and File Proxy on zCX

New View the use case
Related solutions zCX Foundation for Red Hat OpenShift

Deploy containerized Linux-on-Z applications in a Red Hat OpenShift cluster on z/OS with zCX.

Journey to AI on IBM Z and LinuxONE

Build and train models anywhere, and deploy them on IBM Z and LinuxONE infrastructure.

What's new

Links to IBM Z Hot Topics articles were changed to reflect the move of Hot Topics to IBM Docs.

An Architecture topic was added to the Big Picture section.

The contents of the Learn more section were integrated into the How to get started section, and the Learn more section was removed.

The link to the documentation in the Documentation section was updated.

The Planning for zCX tab of the How to get started section now reflects the new support for the z/OS NFS server.

A new podcast resource was added to the About zCX tab of the Technical resources section.

The FAQs were organized into categories.

The How to get started and FAQ sections were updated to make clear that FC 0104 is avaialble for the IBM z14 and IBM z15 only.

New resources were added to the Use cases tab of the Technical resources section.

The zCX Foundation for Red Hat OpenShift content solution was added as a related content solution.

The link to the IBM Z and LinuxONE Container Image Registry in the FAQ section was updated.

A link to information about enabling Container Hosting Foundation was added to the Planning for zCX tab in the How to get started section.

New z/OS Container Extensions overview video.

Transcript added for z/OS Container Extensions overview video.

A new IBM Z Hot Topics article, Getting Better Performance for Your zCX Containers, was added to the Tutorial & instruction tab of the Technical resources section.

The links for other IBM Z Hot Topics acrticles, on the About zCX and Tutorial & instruction tabs in the Technical resources section, were updated to find the articles on the new IBM Z Hot Topics website.

Updates for the new IBM Container Hosting Foundation for z/OS were made to the Planning for zCX tab of the How to get started section and the Frequently Asked Questions section.

The Big Picture has been modified for accessibility.

Added new resources to the About zCX tab of the Technical resources section.

Changes were made to the Technical resources section as a result of the digital transformation of IBM Systems magazine content.

Added new resources to the About zCX and Use cases tabs of the Technical resources section.

IBM Systems Lab Services was added to the About zXC tab of the Technical resources section.

z/OS Communications Server Performance Summary Report was added to the Tutorial & instruction tab of the Technical resources section.

Tutorial video of Docker image development in zCX was added to the Tutorial & instruction tab of the Technical resources section.

Third tab of Technical resources section was changed from Events to Use cases.

Example video of using JupyterHub and zCX was added to the Use cases tab of the Technical resources section.

IBM Z Hot Topics article on the 90-day zCX Trial was added to the Tutorial & instruction tab of the Technical resources section.

Rate this content solution