IBM Cloud Docs
s390x virtual server images

s390x virtual server images

When you provision IBM Cloud® Virtual Servers for Virtual Private Cloud on IBM Z (s390x processor architecture) in IBM Cloud, you can select from the supported stock images. Now, IBM Hyper Protect is also supported as an operating system and the associated IBM Hyper Protect Container Runtime image can be provisioned for your IBM Cloud Hyper Protect Virtual Servers for IBM Cloud® Virtual Private Cloud instance.

The IBM Hyper Protect Container Runtime image has container runtime support and the image is not SSH enabled (is a locked down image). Even if you select and pass in an SSH key, it will not be used and the key cannot be used to connect to the instance. Container details are provided at instance creation through the contract, specified in the User Data field on the order form. Once the containers start, you can interact with the workload that is brought up on the containers. For more information, see Contract.

Available stock images

The following operating systems are available as stock images when you create a virtual server.

IBM Hyper Protect Container Runtime image

You can now choose IBM Hyper Protect as the operating system for the virtual server instance. On the create virtual server page, under Confidential computing, click the Run your workload with an OS and a profile protected by Secure Execution toggle, to activate support for secure execution images. Then, in the Operating system field, "IBM Hyper Protect" operating system and the "hyper-protect-container-runtime" image must be selected to create an IBM Cloud Hyper Protect Virtual Server for IBM Cloud VPC instance. For more information, see Confidential computing with LinuxONE.

You can choose a profile based on your requirements. You can choose from balanced, compute, and memory secure execution enabled profiles. For more information, see s390x instance profiles. Ensure that you select a secure execution enabled profile (for example, bz2e-1x4) when you enable the Run your workload with an OS and a profile protected by Secure Execution toggle. Selecting any profile that is not secure execution enabled will cause the provisioning of the virtual instance to fail.

Supported IBM Z or LinuxONE stock image operating systems

Table 1. Supported s390x stock image operating systems
Image Architectures
Ubuntu 22.04.x, 20.04.x s390x
SUSE Linux Enterprise server (SLES) 15 SP3 s390x
IBM z/OS (IBM Wazi as a Service) s390x

The IBM Wazi aaS z/OS dev and test stock image is available in the US South (Dallas), Japan (Tokyo), Brazil (São Paulo), Canada (Toronto), United Kingdom (London), Spain (Madrid), US East (Washington DC), and US South (Dallas) regions. For more information, see IBM Wazi as a Service documentation.

For more information about images for x86 processor architecture, see x86 virtual server images.

With a cloud-init enabled image, you can provide user data. In the User Data field on the order form, you can enter optional cloud-init user data for the server. For more information about user data and automation, see User data.

When using the IBM Hyper Protect Container Runtime image, container details are provided at instance creation through the contract, specified in the User Data field on the order form. Once the containers start, you can interact with the workload that is brought up on the containers. For more information, see Contract.

You can access details about each operating system, such as the url for the operating system, by using the API call, List all operating systems.

Stock image naming conventions

All IBM-provided stock, public images are named by using the following convention:

ibm-<family>-<version>-<type>-<architecture>-<build>

The following example shows the image naming convention.

ibm-hyper-protect-container-runtime-1-0-s390x-14

It is recommended that you use the latest images because they are valid for longer and have the latest security fixes. Upgrade to the latest image because the earlier images will expire soon.

The following list explains the variables that make up the components of the image name:

  • The leading prefix of ibm- is used for IBM-provided images. Custom images cannot be named with this prefix.
  • The family component provides the operating system family, such as redhat, debian or in this example hyper-protect.
  • The version component provides the operating system version, such as 18-04 for Ubuntu 18.04, or 1.0 for hyper-protect.
  • The type component provides the minimization level of the operating system image, such as minimal or full.
  • The architecture component provides the vCPU architecture that is supported by the operating system image, such as amd64 or s390x.
  • The build component is a small, non-negative integer that is incremented each time a new build of the operating system is created. For image names that are otherwise identical, the image with the highest build value is the most recent image for that operating system.

You can obtain the current list of images, including stock images, by running the following command in the command-line interface: ibmcloud is images.

The image naming convention is subject to change. The list of image names is not intended to be programmatically parsed or interpreted. You can use the GET /images API to obtain metadata in a structured format.

Custom images

You can import an image from IBM Cloud Object Storage to use for creating a new virtual server instance.

To create secure execution based custom images by using the IBM Cloud Object Storage option, see Preparing the workload. For more information about creating secure execution based images, see IBM Secure Execution for Linux.

The IBM Wazi as a Service (Wazi aaS) custom image can be created only by using IBM Wazi Image Builder, which is a separately orderable product from IBM Passport Advantage. Extra requirements are needed to use Wazi Image Builder. The image cost is the premium that is applied to cover the cost of technologies that allows for z/OS dev and test images to run on IBM Z hardware on IBM’s cloud infrastructure as a service layer.

The z/OS Wazi aaS custom image must meet the following requirements:

  • qcow2 format
  • z/OS 2.4 or z/OS 2.5 operating system
  • See Prerequisites for required PTF fixes on z/OS and other IBM software products to allow them to run as a guest of alternate IBM hypervisor, IBM Z Hypervisor as a Service (zHYPaaS).

For more information, see Bringing your own image with Wazi Image Builder.

Requirements

All custom images must meet the following requirements:

  • Contain a single file or volume
  • Is in qcow2 or vhd format
  • Is cloud-init enabled or can be booted using ESXi kickstart
  • Size doesn't exceed 250 GB
  • The minimum size is 10 GB. For any image that is less than 10 GB, the size is rounded up to 10 GB.

Next steps

After you choose a profile, it's time to plan for and create an instance.