Welcome to the Red Hat Ansible Certified Content for IBM® Z® content solution, your homepage for technical resources.
Red Hat® Ansible Certified Content for IBM Z helps you connect IBM Z to your wider enterprise automation strategy through the Ansible Automation Platform ecosystem. The Red Hat Ansible Certified Content available in Ansible Automation Hub and Galaxy provides a wide range of Ansible collections that enables development and operations automation on z/OS®, z/OS
Today, we offer collections for z/OS core, IBM
Setting up z/OS to be an Ansible-managed node is simple. Ansible is an agentless architecture, which means that there’s no server-side component that needs to be installed on any managed node.
All you'll need is
After you’ve done that, any machine you are using as your Ansible control node will be able to connect to z/OS and drive the automation of your choosing.
IBM Z Open Automation Utilities (ZOA Utilities) helps z/OS developers automate tasks that access MVS™ resources. It enables easier calling of MVS utilities compared with JCL by providing a natural coding experience on z/OS UNIX System Services and interfaces in modern programming languages.
This support requires z/OS V2R3 or later.
Follow these steps to set up your z/OS server, which is the managed (target) node:
- Enable OpenSSH and perform ssh-keys setup.
- Install IBM Open Enterprise SDK for Python.
- Install IBM Z Open Automation Utilities (ZOAU).
For detailed version number requirements read the requirements documentation.
If your organization has access to Ansible Galaxy or Ansible Automation Hub, you can install directly from the public repositories.
Use the following ansible-galaxy command to install a collection hosted in Galaxy on your control node:
Find the correct installation command for the Red Hat Ansible Certified Content for IBM Z collection you are interested in on that respective collection's Ansible Galaxy page.
If your organization does not allow access to Ansible Galaxy or Automation Hub, then you might set up an internal Galaxy server and pull the approved content to share internally so that you can host a subset of content. You can modify the configuration to point to your internal Galaxy server.
To configure access to Automation Hub and Private Galaxy server, use the same instructions that you use to configure your client to point to Automation Hub. When hosting a private Galaxy server or pointing to Hub, the available content is not always consistent with what is available on the community Galaxy server.
Galaxy contains our community editions which represent our latest features and their progression to becoming certified in Automation Hub. Populating a private Galaxy repository depends on your particular scanning and content cloning process.
You can use the
Follow these steps to install or update Ansible on your control machine. Then install the z/OS core collection from Ansible Galaxy.
- Install Python 3.5 or later.
- Install Ansible on your local machine.
$ sudo pip3 install ansible
- Verify that Ansible is installed on your machine.
$ ansible --version
If you already have Ansible installed on the control node, you can update it to the latest version.
- Update Ansible.
$ sudo pip3 install ansible –upgrade
- Verify that Ansible is updated.
$ ansible --version
Install the z/OS core collection
Once you have Ansible installed, use the following command to install the Red Hat Ansible Certified collection:
Use RedHat Ansible Certified Content for IBM Z collections to automate tasks on your IBM Z environments. Start by referring to the included module documentation and examples provided with each of our modules. Use the ansible-doc command to view the documentation to learn about each of the modules, such as zos_data_set, by issuing ansible-doc ibm.ibm_zos_core.zos_data_set or by visiting the module documentation page.
With Red Hat Ansible Certified Content for IBM Z, documentation for all of your collections are in a single unified place. Explore documentation content across all IBM Z collections, including getting started and troubleshooting information specific to IBM Z environments.
An Ansible playbook consists of organized instructions, referred to as tasks and roles, that define work for a managed node (host) to be automated using Ansible.
To get started automating on IBM Z with playbooks tailored to many IBM Z use cases, there is the Ansible content for IBM Z sample playbook repository. Users can then edit these samples to fit their own needs, accelerating use and adoption of ansible amongst teams. You can also contribute playbooks to the sample playbook repository to help the community learn Ansible.
Let's start with this sample playbook from the Ansible for IBM Z sample playbooks repository as an example. This playbook performs the following steps:
- Create a data set and populate with JCL on the target z/OS system
- Submit job on z/OS
- Query job submission and review output
- Delete data set to clean up the z/OS system
Follow these steps to run a playbook:
- Edit the ansible.cfg file to include
pipelining = true.
- Modify the sample inventory to add the z/OS host, user, and Python location.
- Update the host_vars in the zos_host.yml file to point to locations on ZOAU and Python on z/OS.
- Run the Ansible playbook using the following command:
ansible-playbook -i inventory <sample>.yaml
You've just run your first Ansible playbook for IBM Z!
Users are able to:
• Integrate IBM Z into an enterprise automation strategy in a consistent way
• Enable a common approach for hybrid applications and infrastructure management
• Enable transparent visibility of IBM Z automation when orchestrated by Ansible
• Drive best practices to manage automation in source control to move towards infrastructure as code
• Leverage Ansible and Python skills, which are readily available in the marketplace and can be applied to z/OS
• Use modules to codify key maintenance and operational tasks for IBM Z software so that you can focus on what you’re trying to accomplish, rather than worry about how to write JCL, for example
A: Red Hat® Ansible Certified Content for IBM Z collections will be developed in the open, and when content is ready for use it is released to Ansible Galaxy for community adoption. Content in Ansible Galaxy is supported by the robust open source community who recognizes Ansible as a leader in automation. Once contributors review community usage, feedback, and are satisfied with the content published, the collection will then be released to Ansible Automation Hub as certified and IBM supported for Red Hat® Ansible Automation Platform subscribers.
Absolutely! More collection and content will be made available in support of
These content collections are accelerators to make automating z/OS with Ansible even easier. Ansible is a powerful tool, that can be used out of the box to build your own automation. With Python as the core language for Ansible modules, it's easy for developers to build and contribute their own modules in support of any automation strategy.
A: Ansible is a powerful IT automation tool that is quick and easy to learn. Get started by checking out Ansible's Getting Started website.
It is up to each enterprise to determine its strategy for how it evolves the set of tools and technologies that it uses. The good news with Ansible is that it integrates with a wide range of technologies across the hybrid multicloud landscape, and across IBM Z. You can use Ansible automation to integrate with what you have or build new playbooks with certified collections to create something new.
Leverage your existing JCL, REXX, and z/OSMF assets or most anything else using Ansible as the driver to automate Z. The choice is yours.
• Minor updates to the introduction, including the addition of z/OSMF to the list of collections.
• Updated documentation link to point to the sample playbook for z/OSMF
• Major content update with additional technical resources and link to IBM Z Trial
• Updated documentation links to point to the sample playbook for
• Released the IBM Z System Automation Collection, IBM z/OS CICS Collection, IBM Z Hardware Management Console Collection
• Updated the Ansible prerequisites section to include IBM Python
• Introduced a What’s New section
• Included a link to a Terminal Talk Podcast “Ansible for z/OS”
Released IBM z/OS IMS collection v1.0.0-beta1 and beta2 to automate routine system operation tasks with Ansible. The IMS collection facilitates database administration tasks and integrates application changes into a CI/CD pipeline for application deployment and delivery and more.
Read the blog
Released IBM z/OS core collection v1.1.0-beta1 to extend the library of Ansible modules to provide the ability to automate several operations including data access, encode data on z/OS and more.
Read the blog
Released of IBM z/OS core collection v1.0.0, as part of the Red Hat Ansible Certified content for IBM Z. IBM z/OS core collection enables automating development and deployment of your new applications and features in z/OS.
Read the blog