PrivateEdition/Current/TenantPEGuide/Upgrade - Revision history

WikiSysop at 17:30, October 7, 2022

2022-10-07T17:30:52Z

WikiSysop at 13:45, April 13, 2022

2022-04-13T13:45:38Z

WikiSysop at 13:15, April 13, 2022

2022-04-13T13:15:40Z

Corinne.hicks@genesys.com: Published

2021-06-30T20:38:29Z

Published

New page

{{Article
|Standalone=No
|DisplayName=Upgrade, rollback, or uninstall the Tenant Service
|TocName=Upgrade, rollback, or uninstall
|Context=Learn how to upgrade, rollback or uninstall the Tenant Service.
|ComingSoon=No
|Section={{Section
|sectionHeading=Upgrade the Tenant Service
|alignment=Vertical
|structuredtext={{Notices|Notice=PEComingSoon}}
|Status=No
}}{{Section
|sectionHeading=Rollback the Tenant Service
|alignment=Vertical
|structuredtext={{Notices|Notice=PEComingSoon}}
|Status=No
}}{{Section
|sectionHeading=Uninstall the Tenant Service
|alignment=Vertical
|structuredtext={{Notices|Notice=PEComingSoon}}
|Status=No
}}
|PEPageType=2cad3824-b3b9-43aa-a726-143cc1aaefe2
}}

@@ Line 1: / Line 1: @@
-{{Article
+{{ArticlePEServiceUpgrade
-|Standalone=No
+|ServiceId=c4749716-a442-4050-ab1a-ca34e082b5c0
-|DisplayName=Upgrade, rollback, or uninstall the Tenant Service
+|UpgradeStrategy=40f069a2-01ae-4027-9aef-13f54bc53613
-|TocName=Upgrade, rollback, or uninstall
+|AddIncluded=No
-|Context=Learn how to upgrade, rollback or uninstall the Tenant Service.
+|OptionalServiceIntro=Tenant Service uses a rolling upgrade process. When multiple Tenant nodes are deployed, you can perform an upgrade to your existing deployment without causing a complete service outage. Tenant instances are rolled over, one by one, affecting only a portion of your agents each time.
 Upgrading the master Tenant instance (node "0", which is responsible for <tt>write</tt> access to the provisioning data) causes a temporary degradation of functionality with no <tt>write</tt> access until instance "0" is restored.
@@ Line 17: / Line 10: @@
 Genesys recommends performing a backup of the backend database for Tenant Service before upgrading.
 To perform an upgrade, follow the deployment process – use the same <tt>helm upgrade</tt> command and the same mandatory parameters. Remember to update the Tenant image(s) and Helm charts version tags in the '''values.yaml''' file. The upgrade is performed automatically, one node at a time (if '''node count''' is > 1). When you upgrade the primary node, the Tenant configuration updates automatically.
-For information about the deployment process, see {{Link-SomewhereInThisVersion|manual=TenantPEGuide|topic=Deploy|anchor=Scenarios|display text=Deployment scenarios}} and {{Link-SomewhereInThisVersion|manual=TenantPEGuide|topic=Deploy|anchor=DeployService|display text=Deploy the service}}.
+For information about the deployment process, see [[Draft:PrivateEdition/Current/TenantPEGuide/Deploy#Scenarios|Deployment scenarios]] and [[Draft:PrivateEdition/Current/TenantPEGuide/Deploy#DeployService|Deploy the service]].
 ====Multiple regions/locations/clusters====
 Genesys recommends performing a backup of the backend database for Tenant Service before you upgrade the master region.
 To perform an upgrade, follow the deployment process – use the same <tt>helm upgrade</tt> command and the same mandatory parameters. Remember to update the Tenant image(s) and Helm charts version tags in the '''values.yaml''' file for every location. When you upgrade the master node in the master region, the Tenant configuration updates automatically.
-For information about the deployment process, see {{Link-SomewhereInThisVersion|manual=TenantPEGuide|topic=Deploy|anchor=Scenarios|display text=Deployment scenarios}} and {{Link-SomewhereInThisVersion|manual=TenantPEGuide|topic=Deploy|anchor=DeployService|display text=Deploy the service}}.
+==Backend upgrade==
-|Status=No
+When you perform an upgrade to Tenant Service, Tenant Service provisioning is done automatically, as part of the <tt>helm upgrade</tt> step. There is no need to make any provisioning changes, unless noted in Release Notes for a particular version.
 If you must perform an upgrade or maintenance to the database management system (DBMS) that Tenant Service uses to store its provisioning data, then the DBMS upgrade or maintenance can be performed in place, separate from Tenant Service. Perform the DBMS upgrade according to the vendor's instructions, making sure that:
 *Tenant Service is disconnected from the backend during maintenance, and
-*you specify the same parameters that were provisioned during the Tenant Service upgrade in order for Tenant Service to access the updated database.
+*you specify the same parameters that were provisioned during the Tenant Service upgrade in order for Tenant Service to access the updated database.
 Be aware that the Tenant Service is in a degraded state (no <tt>write</tt> access to provisioning) during the database upgrade.
@@ Line 42: / Line 34: @@
 If the database upgrade involves moving to a new DBMS instance with new parameters, then you trigger this as part of the Tenant Service upgrade. Both the new database and the new values for the database parameters (specified in the '''values.yaml''' file used for the <tt>helm upgrade</tt> step) must be ready and available before you trigger the Tenant Service upgrade.
-If you're performing an upgrade or maintenance to the Redis backend that is shared with the core Voice platform, and you require a change to the Redis connection parameters, first scale Tenant Service down to a single instance (setting the <tt>replicaCount</tt> parameter in the '''values.yaml''' file), then perform the Redis backend maintenance or upgrade, and finally, trigger a restart of the Tenant Service. After that's complete, you can scale up Tenant Service again.
+If you're performing an upgrade or maintenance to the Redis backend that is shared with the core Voice platform, and you require a change to the Redis connection parameters, first scale Tenant Service down to a single instance (setting the <tt>replicaCount</tt> parameter in the '''values.yaml''' file), then perform the Redis backend maintenance or upgrade, and finally, trigger a restart of the Tenant Service. After that's complete, you can scale up Tenant Service again.
-|Status=No
+|RollUpdUpgradeExt=When you perform an upgrade to Tenant Service, Tenant Service provisioning is done automatically, as part of the <tt>helm upgrade</tt> step. There is no need to make any provisioning changes, unless noted in Release Notes for a particular version.
-}}{{Section
+|Standalone=No
 }}

@@ Line 18: / Line 18: @@
 To perform an upgrade, follow the deployment process – use the same <tt>helm upgrade</tt> command and the same mandatory parameters. Remember to update the Tenant image(s) and Helm charts version tags in the '''values.yaml''' file. The upgrade is performed automatically, one node at a time (if '''node count''' is > 1). When you upgrade the primary node, the Tenant configuration updates automatically.
 ====Multiple regions/locations/clusters====
 Genesys recommends performing a backup of the backend database for Tenant Service before you upgrade the master region.
 To perform an upgrade, follow the deployment process – use the same <tt>helm upgrade</tt> command and the same mandatory parameters. Remember to update the Tenant image(s) and Helm charts version tags in the '''values.yaml''' file for every location. When you upgrade the master node in the master region, the Tenant configuration updates automatically.
 |Status=No
 }}{{Section

@@ Line 8: / Line 8: @@
 |sectionHeading=Upgrade the Tenant Service
 |alignment=Vertical
-|structuredtext={{Notices|Notice=PEComingSoon}}
+|structuredtext=This page describes supported upgrade and migration paths for Voice Tenant Service.
 |Status=No
 }}{{Section
 |sectionHeading=Rollback the Tenant Service
 |alignment=Vertical
-|structuredtext={{Notices|Notice=PEComingSoon}}
+|structuredtext=To roll back the Tenant Service to a previous version, use the <tt>helm rollback</tt> command. For more information, see the [https://helm.sh/docs/helm/helm_rollback/ Helm documentation].
 |Status=No
 }}{{Section
 |sectionHeading=Uninstall the Tenant Service
 |alignment=Vertical
-|structuredtext={{Notices|Notice=PEComingSoon}}
+|structuredtext=To uninstall the Tenant Service, use the <tt>helm uninstall</tt> command. For more information, see the [https://helm.sh/docs/helm/helm_uninstall/ Helm documentation].
 |Status=No
 }}
 |PEPageType=2cad3824-b3b9-43aa-a726-143cc1aaefe2
 }}