// Module included in the following assemblies:
//
// assembly-upgrading.adoc

[id='upgrading-enmasse-using-bundle-{context}']
= Upgrading {ProductName} using a YAML bundle

.Prerequisites

* A new release of {ProductName}. For more information, see link:{BookUrlBase}{BaseProductVersion}{BookNameUrl}#downloading-messaging[Downloading {ProductName}].

.Procedure

ifeval::["{cmdcli}" == "oc"]
. Log in as a service operator:
+
[subs="attributes",options="nowrap"]
----
oc login -u system:admin
----

. Select the project where {ProductName} is installed:
+
[subs="+quotes,attributes",options="nowrap"]
----
oc project _{ProductNamespace}_
----
endif::[]
ifeval::["{cmdcli}" == "kubectl"]
. Select the namespace where {ProductName} is installed:
+
[options="nowrap",subs="+quotes,attributes"]
----
{cmdcli} config set-context $(kubectl config current-context) --namespace=_{ProductNamespace}_
----
endif::[]

. Apply the new release bundle:
+
[subs="attributes",options="nowrap"]
----
{cmdcli} apply -f install/bundles/{ProductBundleName}
----

. Monitor pods while they are restarted:
+
[subs="attributes",options="nowrap"]
----
{cmdcli} get pods -w
----
+
The pods restart and become active within several minutes.

