> For the complete documentation index, see [llms.txt](https://platform9.com/kb/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://platform9.com/kb/generic/frequently-asked-questions/platform9-upgrades-process-and-impacts.md).

# Platform9 Upgrades - Process and Impact

## Problem

One of the most frequent questions we receive is what is the impact of a Platform9 upgrade on the environment and how does it impact existing resources.

This article should hopefully provide the information you require to make an informed decision while scheduling an upgrade.

## Environment

* Platform9 Managed OpenStack - All Versions
* Platform9 Managed Kubernetes - All Versions
* Platform9 Private Cloud Director - All Versions

## Answer

The Upgrade Processes for our managed offerings follow a similar path with a slight variation that is required because of the difference in products:

**Customer Impact -** During a Platform9 upgrade, the customer's workloads are not affected. The only impact to the customer is the inability to provide or make changes to resources (i.e. VM's, Kubernetes clusters, etc) through the management plane or the API. Only Platform9 services that enable management of the hosts through the management plane are upgraded, customer workloads are unaffected.

* ### **Platform9 Managed OpenStack** and **Platform9 Private Cloud Director** **- Management Plane Upgrade:**

{% hint style="warning" %}
Management Plane Upgrades will only be started if the Host Package Version matches the Management Plane Version
{% endhint %}

The Management Plane hosts controller APIs for the OpenStack product. During this process, the deployment is upgraded with the newer release version and new host-side packages are stored for the hypervisors to download during the host upgrade phase.

* **Impact:**
  * The UI is unavailable for the duration of the upgrade.
  * All API services are unavailable during the upgrade.
  * That includes the Authentication service as well.
  * Create, Read, Update, Delete operations will not be possible.
  * Workloads running on VMs **will not be impacted.** However, there will be very minimal network disruptions to the VM connectivity as some services are restarted.
* ### **Platform9 Managed OpenStack** and **Platform9 Private Cloud Director** **- Host Upgrades:**

Once the Management Plane upgrades are complete, the host upgrades are kicked sequentially. All Platform9 and OpenStack packages will be upgraded to the version matching the Management Plane. The general rule of thumb is 10 mins for every 15 hosts.

* **Impact**
  * No specific unavailability. However, there will be very minimal network disruptions to the VM connectivity as some services are restarted.
  * Workloads running on VMs will not be impacted.
  * Workloads running on VMs **will not be impacted.** However, there will be very minimal network disruptions (around 4 to 10 sec)to the VM connectivity as some services are restarted.
* ### **Platform9 Managed Kubernetes** - **Management Plane Upgrade:**

The Management Plane hosts qbert API for the Kubernetes product. During this process, the deployment is upgraded with the newer release version and new host-side packages are stored for the hypervisors to download during the host upgrade phase.

* **Impact:**
  * The UI is unavailable for the duration of the upgrade.
  * All API services are unavailable during the upgrade. That includes the Authentication service as well
  * Create, Update, Delete operations will not be possible for Clusters during this time.
* ### **Platform9 Managed Kubernetes - Host Upgrades:**

Once the Management Plane upgrades are complete the host upgrades are kicked sequentially. Only the pf9-hostagent service package is upgraded during this time. Impact:

* **Impact:**
  * No specific unavailability
* **Cluster Upgrades**
  * Once the Management Plane and Host Upgrades are complete, this concludes the Platform9 part of the upgrade process.
  * Cluster upgrades can be performed by the customer at their own convenience.
  * Cluster upgrades will upgrade the **pf9-kube** package on the cluster nodes to match the Management Plane.
* **Cluster Upgrade Internals:**
  * Ensure that all Platform9 management components (`pf9-hostagent, pf9-comms, pf9-sidekick`) are active and healthy before starting the upgrade, and verify their health again after the upgrade is completed
  * First, the masters will get upgraded - control plane entities (kube-proxy, kubeDNS etc and anything deployed on k8s as a Daemonset)
  * Things that run natively on a host (kubelet, flannel if running as process) don’t get upgraded until the node itself is upgraded - thus the cluster is still functioning.
  * Worker nodes are drained, cordoned, upgraded then un-cordoned.
  * Networking is upgraded before the pods are scheduled again.
  * **Impact:**
    * During this rolling upgrade, nodes will be drained and upgrade in a rolling fashion so, in order to not incur any downtime, it is advised to have multiple replicas of your applications.
    * When the masters are getting upgraded, you will notice a 5-10 minute blip when trying to access the cluster (e.g. kubectl) at this time, this is due to the VIP moving from upgrading master to the next active master (for BareOS deployments)
    * We would encourage you to go through the [Cluster Upgrade documentation](https://docs.platform9.com/v5.1/kubernetes/upgrade-cluster) in our Knowledge repository for additional information.

In summary, Platform9 upgrades are designed to preserve running workloads while temporarily limiting management access and, in some cases, causing brief network or control plane interruptions. Schedule upgrades during a maintenance window, and confirm that your applications are deployed with sufficient redundancy before proceeding.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://platform9.com/kb/generic/frequently-asked-questions/platform9-upgrades-process-and-impacts.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
