Based on Natalia Jordan’s IBM Community article covering IPI PowerVS bootstrap node access, VPC networking concepts, jump host setup, SSH key configuration, and bootstrap log collection for OpenShift IPI troubleshooting
Infrastructure as Code for IBM Power systems just got easier. The IBM Power HMC Provider 1.0 is now available on the Terraform Registry, enabling administrators and automation engineers to manage IBM Power environments through Hardware Management Console (HMC) using familiar Terraform workflows.
With the provider, you can define and manage Power resources declaratively, integrate with CI/CD pipelines, and bring consistency to infrastructure provisioning across Power estates.
IBM Power Systems Virtual Server (PowerVS) is a great fit for data-intensive workloads. In this post, we’ll walk through deploying a single-node Apache Cassandra 5.0 instance on PowerVS using a RHEL 10 Bring-Your-Own-License (BYOL) image, fully automated with Terraform and a cloud-init shell script.
By the end you’ll have:
A running PowerVS LPAR (s1022) on RHEL 10
IBM Semeru Runtime (OpenJ9) for Java on ppc64le
Apache Cassandra 5.0 installed and ready to start
A public network interface for SSH access
Architecture Overview
The deployment is split into two layers:
Infrastructure (Terraform)
Resource
Purpose
ibm_pi_network
Creates a public pub-vlan network for external access
ibm_pi_instance
Provisions the LPAR using the RHEL 10 BYOL stock image
null_resource
SSHes into the instance after boot and runs the init script
Configuration (init.sh)
Once the LPAR is up, Terraform copies a templated init.sh script to the instance and executes it over SSH. The script:
Registers the OS with Red Hat Subscription Manager (RHSM)
Enables the RHEL 10 ppc64le base and appstream repos
Updates the OS and installs tooling (wget, curl, jq, etc.)
Downloads and installs IBM Semeru Java 17 LTS for ppc64le from GitHub Releases
Registers the cassandra YUM repo and installs Apache Cassandra 5.0
Drops a cassandra-manager.service systemd unit (installed but not auto-started — you control when it runs)
Prerequisites
Before you begin, make sure you have:
An IBM Cloud account with PowerVS permissions
A pre-provisioned PowerVS workspace (get the workspace GUID from the UI)
A PowerVS SSH key registered in the workspace
Red Hat credentials (RHSM username and password) for a RHEL subscription
Terraform ≥ 1.3 installed locally
The IBM Cloud CLI with the PowerVS plugin (ibmcloud plugin install power-iaas)
RHEL 10 BYOL image: This example uses the stock catalog image ID 585ca713-f303-45f0-a836-e9dd4f4c8f3b (RHEL10-BYOL) which is already available in PowerVS — no COS bucket or manual image upload required.
Repository Layout
.
├── main.tf # Provider, network, instance, and provisioner
├── variables.tf # Input variable declarations
├── outputs.tf # Instance ID and IP outputs
├── init.sh # cloud-init / SSH-executed bootstrap script
└── terraform.tfvars.example # Template — copy to terraform.tfvars
Step 1 — Configure Your Variables
Copy the example variables file and fill in your values:
Never commit terraform.tfvars to source control — it contains your IBM Cloud API key and RHSM credentials. The .gitignore in this repo already excludes it, and all three sensitive variables are declared with sensitive = true in variables.tf so Terraform redacts them from plan/apply output.
Variable Reference
Variable
Description
Default
ibmcloud_api_key
IBM Cloud API key
—
workspace_id
PowerVS workspace GUID
—
region
IBM Cloud region (e.g. us-south)
—
zone
IBM Cloud zone (e.g. dal12)
—
ssh_key_name
SSH key registered in the PowerVS workspace
—
ssh_private_key_path
Local path to the matching private key
~/.ssh/id_rsa
memory
Instance memory in GiB
16
processors
Number of virtual processors
2
rhsm_username
Red Hat Subscription Manager username
—
rhsm_password
Red Hat Subscription Manager password
—
Step 2 — Understand the Terraform Configuration
Provider
main.tf pins the IBM Cloud provider at ~> 2.4.0 and the HashiCorp null provider for the remote-exec provisioner:
terraform {
required_providers {
ibm = {
source = "IBM-Cloud/ibm"
version = "~> 2.4.0"
}
null = {
source = "hashicorp/null"
version = "~> 3.0"
}
}
}
provider "ibm" {
ibmcloud_api_key = var.ibmcloud_api_key
region = var.region
zone = var.zone
}
Public Network
A pub-vlan network is created to give the instance an external IP for SSH access:
pi_health_status = "WARNING" lets Terraform proceed even while the instance is still booting, which is normal — the null_resource provisioner handles the wait via SSH.
Remote Provisioner
After the instance is up, Terraform templates init.sh with your RHSM credentials and copies it over SSH, then executes it:
The --force flag handles re-registration gracefully if the instance was previously registered. The correct repo slugs for RHEL 10 on Power LE (ppc64le) are rhel-10-for-ppc64le-*.
Cassandra requires Java, and IBM Semeru Runtime (OpenJ9) is the recommended JVM for Power. The script fetches the latest release URL dynamically from the GitHub API:
Installing under /opt/ibm/semeru keeps it clean and separate from the system Java. The alternatives registration makes java available system-wide.
Apache Cassandra 5.0
The official Apache Cassandra RPM repo is added and the package installed. --skip-broken is used because Cassandra’s bundled JVM dependency is skipped in favour of Semeru:
Rather than auto-starting Cassandra, the script drops a custom cassandra-manager.service unit that explicitly sets JAVA_HOME to the Semeru installation. This prevents Cassandra from picking up an incorrect JVM:
The service is not enabled or auto-started — you decide when Cassandra runs.
Step 4 — Deploy
Initialize
terraform init
This downloads the IBM Cloud and null providers.
Plan
terraform plan -var-file="terraform.tfvars"
Review the output — you should see three resources being created: ibm_pi_network.public_net, ibm_pi_instance.cassandra_node, and null_resource.cassandra_init.
Apply
terraform apply -var-file="terraform.tfvars"
Total deployment time is approximately 10–15 minutes:
Credentials in terraform.tfvars — never commit this file. It is already listed in .gitignore.
Sensitive variables — ibmcloud_api_key, rhsm_username, and rhsm_password are marked sensitive = true in variables.tf, so Terraform will not print them in plan or apply output.
SSH agent forwarding — the provisioner connection uses agent = true, which relies on your local SSH agent. Make sure the private key matching ssh_key_name is loaded (ssh-add ~/.ssh/id_rsa).
Firewall — the pub-vlan network exposes the instance publicly. Consider restricting inbound access to port 22 (SSH) and Cassandra’s native transport port 9042 to trusted CIDRs via IBM Cloud security groups.
Cleaning Up
To destroy all resources created by this deployment:
terraform destroy -var-file="terraform.tfvars"
This will remove the PowerVS instance and the public network. The RHEL 10 stock image is not deleted (it is a shared catalog image, not a user-imported resource).
Summary
This walkthrough showed how to:
Use Terraform with the IBM-Cloud/ibm provider to stand up a PowerVS LPAR on RHEL 10
Bootstrap the instance via SSH using a templated shell script
Install IBM Semeru Runtime (OpenJ9) for ppc64le — the right JVM for Power
Add the official Apache Cassandra 5.0 RPM repo and install Cassandra
Register a custom systemd service that pins JAVA_HOME to the Semeru installation
The full source is available in this repository — clone it, fill in your terraform.tfvars, and you’ll have Cassandra running on PowerVS in under 15 minutes.
By default, OpenShift is a greedy scheduler, when a Pod starts it grabs the first requested resource CPU/Memory. There is a reserved bit of memory and CPU for kubelet and System services saved. A Pod may end up spanning different NUMA domains
The CPU Manager packs each Pod onto NUMA domains:.
single-numa-node a pod might fail to schedule on a node that has enough total CPU capacity but lacks enough contiguous cores. If you go to schedule a 8 vCPU pod, and you have 4vcpu on one node, and 4 vcpu on another, it won’t be able to allocate ending with a TopologyAffinityError.
restricted packs it into as few NUMA nodes as possible. This one is probably preferred as it allows for rounding.
If a Pod is idle, those cores sit idle. They won’t share the spare cycles of another Pod.
If a Pod used 100m, it’ll need to specificy round numbers now cpu: "2" in some cases.
For large workloads , CPU pinning is most effective when the pod is sized to fit within a single NUMA node. If your pod is so large that it spans multiple sockets, the benefits of pinning diminish unless the application itself is NUMA-aware.
You can see more details at OpenShift 4.20: Using CPU Manager and Topology Manager[docs.redhat.com]
Workloads run on full physical servers or are managed as virtual machines. KubeVirt brings cloud-native approach to fleet management and makes VMs first-class Kubernetes resources.
1. Physical Infrastructure
Typically, things begin with a physical server. A Baseboard Management Controller (BMC) provides hardware management, while firmware initializes CPU and memory resources. At this stage, all resources belong to a single system with no virtualization.
Key point: Physical hardware only, with no abstraction layer.
2. Traditional Virtualization
A host operating system such as RHEL, SUSE, or Ubuntu runs on the server. Libvirt and QEMU provide virtualization services, allowing multiple VMs to share the same hardware.
Key point: Virtual machines improve hardware utilization while remaining tied to individual hosts.
3. Kubernetes + KubeVirt
KubeVirt integrates virtualization into Kubernetes. Instead of managing VMs directly on each host, Kubernetes manages VM lifecycle through KubeVirt components such as Virt Operator, Virt Controller, and Virt Launcher.
Virtual machines become Kubernetes-managed workloads that can be scheduled, automated, and operated alongside containers.
Conclusion
The progression is straightforward Physical Server run Libvirt/QEMU Virtualization and are managed as a fleet with Kubernetes-Orchestrated Virtualization with KubeVirt.
One of the more common challenges in disconnected or tightly controlled on-prem OpenShift environments is certificate validation when the cluster doesn’t have direct access to external DNS resolvers.
If cert-manager’s DNS-01 validation cannot reach the appropriate DNS infrastructure, certificate issuance may fail even when the DNS records themselves are correct. In these environments, you can configure the cert-manager operator to use specific internal recursive DNS servers instead of relying on default resolver behavior.
The following patch updates the cert-manager configuration to query only the designated recursive nameservers:
This approach is particularly useful in air-gapped, restricted-network, or enterprise environments where outbound DNS traffic is blocked and all name resolution must flow through approved internal resolvers.
A small change, but often the difference between endless certificate troubleshooting and a clean, automated issuance process.
Paul Bastide, Engineering Lead, OpenShift on IBM Power
When a worker node panics, the kernel’s last words are the most valuable debugging artifact you’ll ever get — if you managed to capture them. On your OpenShift Container Platform on IBM Power or on IBM Power Virtual Server, you can capture kernel crash dumps to available persistent memory (pmem) on the nodes. kdump is able to write vmcores to a pmem-backed filesystem: it’s fast, it’s dedicated, and it keeps multi-gigabyte crash dumps off the root disk or NFS servers.
Using this document, you learn how to: create a pmem namespace with ndctl, format and mount it via MachineConfig systemd units, configure kdump through butane, trigger a crash with echo c > /proc/sysrq-trigger — and the vmcore landed exactly where it should, on /var/mnt/pmem.
Red Hat CoreOS is an immutable OS which doesn’t shift with ndctl; you can’t just use it by default. This document shows how to use a privileged pod with access to /dev and /sys, running ndctl create-namespace --mode=fsdax against the host’s NVDIMM subsystem. This day-2 action is useful when troubleshooting and not intended to be used by default – in exceptional debugging of storage problems.
When we don’t have direct access to tools on the file system, we use oneshot systemd unit, delivered by MachineConfig, that runs the privileged container to execute:
The two Condition lines are doing the heavy lifting. If /dev/pmem0 already exists, there’s nothing to do. If the node has no NVDIMM regions at all, there’s nothing that can be done. In both cases systemd skips the unit — skipped, not failed — and boot proceeds normally. That’s the behavior we want across a fleet where not every worker has pmem.
By default it pulls CentOS Stream 10 and installs ndctl on the fly. For disconnected environments or faster boots, prebuild a two-line image (FROM quay.io/centos/centos:stream10 + dnf -y install ndctl daxctl), push it to your registry, and point NDCTL_IMAGE at it — the script already passes the node’s pull secret via --authfile.
All of it — the script, the units, the crashkernel= kernel arguments, /etc/kdump.conf, and /etc/sysconfig/kdump — lives in one butane file rendered to a single MachineConfig. The full listing is in the companion setup document; render and apply is the usual two-liner:
Dumps arrive under /var/mnt/pmem/<ip>-<date>-<time>/ as vmcore, vmcore-dmesg.txt, and kexec-dmesg.log. Three habits worth adopting:
Read vmcore-dmesg.txt first. It’s the crashed kernel’s ring buffer as plain text, panic backtrace at the bottom. A large fraction of crashes are diagnosed from this file alone, no tooling required.
Use toolbox for deep analysis. This is where toolbox shines. From oc debug node/<node> → chroot /host → toolbox, you get a privileged support-tools container where you can dnf install crash plus the matching kernel-debuginfo and open the vmcore in place. Debuginfo is huge and must match the crashed kernel exactly, so in practice we often stream the dump off the node instead —
— and run crash on a RHEL box where the right debuginfo installs cleanly.
Prune automatically. Persistent memory is not infinite, and a filtered vmcore is still roughly proportional to RAM. A tiny systemd timer in the same MachineConfig deletes dump directories older than 14 days, and its ConditionPathIsMountPoint=/var/mnt/pmem means it too is a no-op on nodes without pmem.
Verifying it
After the MachineConfigPool converges:
oc debug node/worker-0
chroot /host
systemctl status kdump
cat /sys/kernel/kexec_crash_loaded # 1 means armed
findmnt /var/mnt/pmem # xfs on /dev/pmem0
And in a maintenance window, once you reboot, you can see the vmcore survived so you don’t have to wonder:
echo c > /proc/sysrq-trigger
# node dumps, reboots, and then:
find /var/mnt/pmem -type f
/var/mnt/pmem/127.0.0.1-2026-07-09-12:06:09/vmcore
/var/mnt/pmem/127.0.0.1-2026-07-09-12:06:09/vmcore-dmesg.txt
/var/mnt/pmem/127.0.0.1-2026-07-09-12:06:09/kexec-dmesg.log
One caveat for mixed fleets: on a node where the pmem mount never exists, kdump’s path /var/mnt/pmem falls back to the root filesystem. If only some of your workers carry pmem, put this MachineConfig on a dedicated pool (e.g., a worker-pmem role), or switch kdump.conf to a direct dump target (xfs /dev/pmem0 + path /) so kdump fails loudly rather than dumping to /.
Wrapping up
The pattern here generalizes beyond pmem: when RHCOS doesn’t have the tool, a privileged container run by podman from a oneshot systemd unit is how you run it at boot — with Condition* directives making the whole thing safe on nodes where it doesn’t apply. Toolbox is the interactive face of the same idea, and it earns its keep again when it’s time to open the vmcore with crash.
Credit where it’s due: the namespace-creation discovery, the kdump-to-pmem configuration, and the end-to-end crash validation are Kaushik Talathi’s work — this post just wires his findings into the boot sequence so nobody ever has to remember the privileged pod again.
Validated on OpenShift 4.18, RHCOS (RHEL 9.x, kernel 5.14.0-570.x).
The Node Tuning Operator/tuned applies it dynamically via the sysctl interface, so a reboot is typically not required. The new value takes effect immediately on the node after the profile is applied.
Disabling ASLR through a Tuned object, the setting is applied without a node reboot. You can usually observe the change within seconds after the profile becomes active.
When you need to archive files directly on an OpenShift node, zstd is a great choice because it is already available on the system and provides an excellent balance of compression ratio and performance.
Access the Target Node
Start by opening a remote shell to the node:
oc rsh node/<node-target>
Maximum Compression
To prioritize the smallest archive size, use the ultra compression level (-22) with all available CPU threads:
time tar -I 'zstd -T0 --ultra -22' -cf /tmp/archive.tar.zst /tmp/random_100m.dat
Example result:
real 0m30.007s
user 0m29.346s
sys 0m0.384s
Maximum Compression with a Single Thread
If you want to limit CPU usage, run the same compression level with a single thread:
time tar -I 'zstd -T1 --ultra -22' -cf /tmp/archive.tar.zst /tmp/random_100m.dat
Example result:
real 0m30.677s
user 0m30.322s
sys 0m0.275s
The runtime is similar, making this a viable option when CPU resources are constrained.
Fast Throughput Compression
For large files where speed is more important than archive size, use a lower compression level:
time tar -I 'zstd -T0 -1' -cf /tmp/archive.tar.zst /var/log/random_1000m.dat
Example result:
real 0m18.716s
user 0m14.327s
sys 0m16.420s
Fast Compression with One Thread
You can further reduce CPU consumption by limiting compression to a single thread:
time tar -I 'zstd -T1 -1' -cf /tmp/archive.tar.zst /var/log/random_1000m.dat
Example result:
real 0m19.121s
user 0m13.434s
sys 0m14.402s
Key Takeaways
Use --ultra -22 when achieving the highest compression ratio is the primary goal.
Use -1 for the fastest archive creation and best throughput.
-T0 allows zstd to use all available CPU threads.
-T1 limits compression to a single thread and can be useful on busy systems.
In these examples, single-threaded and multi-threaded runs showed only minor differences in elapsed time, making thread selection largely a resource-management decision.
Post-installation, the supported way to add another SSH public key for the core user on OpenShift/RHCOS nodes is by updating or creating a MachineConfig that contains all desired sshAuthorizedKeys. The Machine Config Operator (MCO) then rolls the change out to the targeted MachineConfigPool.
Note: OpenShift commonly uses 99-worker-ssh and 99-master-ssh to manage SSH keys for the core user.
Export the existing MachineConfig for worker
oc get machineconfig 99-worker-ssh -o yaml > 99-worker-ssh.yaml
Add the second public key
Edit the file and ensure both keys are present under sshAuthorizedKeys.
Important: The sshAuthorizedKeys list is authoritative. Include the existing key(s) plus the new key. Do not provide only the new key unless you want to remove the old ones. The MCO only supports modifying sshAuthorizedKeys for the core user.
Apply the MachineConfig
oc apply -f 99-worker-ssh.yaml
The Machine Config Operator will render a new configuration and update the nodes in the associated MachineConfigPool.
Watch the rollout
Check the MachineConfigPool:
oc get mcp
Watch until the pool reports:
UPDATED=True
UPDATING=False
DEGRADED=False
Verify one of the nodes
ssh core@<node-ip>
Using either the original key or the newly added key.
You can also verify on the node:
oc debug node/<node-name>
chroot /host
cat /home/core/.ssh/authorized_keys
The file should contain both public keys
This will add both public keys to the core user on all worker nodes.