SMCP 5.12 Release Notes
Platform9 SMCP 5.12
2025-04-23
Component | Version |
---|---|
Airctl | v-5.12.1-3802903 |
Workload Clusters | |
Kubernetes 1.29 | 1.29.2-pmk.247 |
Kubernetes 1.30 | 1.30.4-pmk.146 |
Kubernetes 1.31 | 1.31.5-pmk.82 |
Management cluster | |
Kubernetes 1.30 | 1.30.4-pmk.146 |
Features/Enhancements
Deprecations, Feature Removal and EOL information
Following Operating Systems are no longer supported with SMCP 5.12 and above.
- RHEL 8.6
- RHEL 8.7
- Centos 7.9
The pods related to the legacy cluster API (pf9-capi) implementation have been removed
Bug Fixes
service-account-issuer
).
Kube-scheduler
and kube-controller
open to all interfaces (ported from SMCP 5.11.1 patch)
Known Issues
5.12
similarly) requires the following commands to be run to update host-side components:
airctl configure-hosts --reset-pf9-managed-docker-conf --skip-docker-install --skip-docker-img-import --verbose
airctl upgrade-hosts --verbose
Impact__: For Ubuntu 22, the above procedure breaks the host connection from the management cluster, terminates the pf9-comms, leading to management cluster upgrade failure.
Workaround__: For Ubuntu 22, reversing the order of the two commands works; run the upgrade-hosts
first, then the configure-hosts
airctl upgrade --config airctl-config.yaml --verbose
), the sunpike-kube-apiserver
pod enters a CrashLoopBackOff
state following the successful execution of the airctl upgrade step. While the pod eventually reconciles itself, it may take an extended duration (30+
minutes or more).
Impact: This delay can disrupt cluster operations, leading to prolonged upgrade timelines and potential downtime for services dependent on the sunpike-kube-apiserver
.
Workaround: Manually restarting the sunpike-kube-apiserver
pod resolves the issue and significantly reduces reconciliation time.
Impact__: Post-reboot, the management cluster node remains non-functional until manual intervention is performed.
Workaround__: To recover the node, run the following commands on the affected node:
sudo systemctl stop pf9-nodeletd
sudo /opt/pf9/nodelet/nodeletd phases restart
systemd-resolved
is disabled, the symbolic link /etc/resolv.conf
pointing to /run/systemd/resolve/stub-resolv.conf
does not recover after a node reboot on the management cluster.
Impact__: In an environment with no DNS server available, DNS information in the /etc/resolv.conf
doesn't recover, resulting in DNS resolution failure; hence, the cluster won't recover.
Workaround__: To ensure DNS functionality persists after a reboot, follow these steps before a node is rebooted.
- Remove the symbolic link /etc/resolv.conf (
sudo rm /etc/resolv.conf
) . Manually create a new /etc/resolv.conf (sudo nano /etc/resolv.conf
) with the required DNS entries. This step is critical if no DNS server is running in the cluster. - Add the following DNS entries (replace with your preferred DNS servers if needed):
- nameserver <node_ip>
iptables-services
as a dependency. With recent updates to the upstream repositories, installation will fail due to a missing dependency on iptables-legacy-*
packages.
Workaround: (On Rocky Linux 9) Users will need to install the legacy packages by running dnf install iptables
or dnf install iptables-utils
on workload cluster nodes. Since this is a recent upstream change, a solution will be provided in upcoming releases by packaging the required packages along with pf9-kube
package.
SMCP 5.12 Kubernetes Components List
Component | Kubernetes 1.31 | Kubernetes 1.30 | Kubernetes 1.29 |
---|---|---|---|
KUBERNETES BUILD VERSION | 1.31.5-pmk.82 | 1.30.4-pmk.146 | 1.29.2-pmk.247 |
CONTAINERD | 1.7.13 | 1.7.13 | 1.7.13 |
RUNC | 1.1.12 | 1.1.12 | 1.1.12 |
CORE-DNS | 1.11.1 | 1.11.1 | 1.11.1 |
METRICS SERVER | 0.6.4 | 0.6.4 | 0.6.4 |
METAL LB | 0.14.9 | 0.14.9 | 0.14.9 |
KUBERNETES DASHBOARD | 2.7.0 | 2.7.0 | 2.7.0 |
CLUSTER AUTO-SCALER AWS | 1.28.0 | 1.28.0 | 1.28.0 |
FLANNEL | 0.24.2 | 0.24.2 | 0.24.2 |
CALICO | 3.27.2 | 3.27.2 | 3.27.2 |
ETCD | 3.5.12 | 3.5.12 | 3.5.12 |
CNI PLUGINS | 1.4.0 | 1.4.0 | 1.4.0 |
KUBEVIRT | 1.0.0 | 1.0.0 | 1.0.0 |
KUBEVIRT CDI | 1.57.0 | 1.57.0 | 1.57.0 |
ADVANCED NETWORKING OPERATOR (LUIGI) | 0.5.8 | 0.5.8 | 0.5.8 |
MONITORING - PROMETHEUS OPERATOR | 0.68.1 | 0.68.1 | 0.68.1 |
PROFILE AGENT | 2.0.2 | 2.0.2 | 2.0.2 |
METAL3 | 1.1.1 | 1.1.1 | 1.1.1 |
Platform9 CLI
The pf9ctl
release 1.31 is available for customers who use pf9ctl
instead of equivalent airctl commands to onboard nodes.
It can be installed by running the following command.
bash <(curl -sL https://pmkft-assets.s3-us-west-1.amazonaws.com/pf9ctl_setup)