PEC-REP/Current/PulsePEGuide/Upgrade - Revision history

WikiSysop at 16:01, March 29, 2023

2023-03-29T16:01:59Z

WikiSysop at 14:15, August 30, 2022

2022-08-30T14:15:58Z

WikiSysop at 15:46, August 15, 2022

2022-08-15T15:46:01Z

WikiSysop at 19:31, April 11, 2022

2022-04-11T19:31:08Z

Tgilchri: Published

2022-03-30T19:15:25Z

Published

Tgilchri at 13:30, March 30, 2022

2022-03-30T13:30:39Z

Olena.chapovska@genesys.com: Published

2021-07-01T01:09:51Z

Published

New page

{{Article
|Standalone=No
|DisplayName=Upgrade, rollback, or uninstall
|TocName=Upgrade, rollback, or uninstall
|Context=Learn how to upgrade, rollback or uninstall Genesys Pulse. Service supports Helm rolling upgrade strategy.
|ComingSoon=No
|Section={{Section
|sectionHeading=Upgrade Genesys Pulse
|alignment=Vertical
|structuredtext=Upgrade <image-version> and <chart-versions> inputs and follow instructions for installing helm charts in {{Link-SomewhereInThisVersion|manual=PulsePEGuide|topic=Configure}} and {{Link-SomewhereInThisVersion|manual=PulsePEGuide|topic=Provision}}.
|Status=No
}}{{Section
|sectionHeading=Rollback Genesys Pulse
|alignment=Vertical
|structuredtext=Downgrade <image-version> and <chart-versions> inputs and follow instructions for installing helm charts in {{Link-SomewhereInThisVersion|manual=PulsePEGuide|topic=Configure}} and {{Link-SomewhereInThisVersion|manual=PulsePEGuide|topic=Provision}}.
|Status=No
}}{{Section
|sectionHeading=Uninstall Genesys Pulse
|alignment=Vertical
|structuredtext====Delete ConfigMaps and Secrets===

*delete pulse-postgres-configmap configmap <source lang="text">source .shared_init_variables
oc delete configmap pulse-postgres-configmap --namespace="${NAMESPACE}"</source>

*delete pulse-redis-configmap configmap <source lang="text">source .shared_init_variables
oc delete configmap pulse-postgres-configmap --namespace="${NAMESPACE}"</source>

*delete pulse-postgres-secret secret <source lang="text">source .shared_init_variables
oc delete secret pulse-postgres-secret --namespace="${NAMESPACE}" </source>

*delete pulse-redis-secret secret <source lang="text">source .shared_init_variables
oc delete secret pulse-redis-secret --namespace="${NAMESPACE}"</source>

*delete pulse-gws-secret secret <source lang="text">source .shared_init_variables
oc delete secret pulse-gws-secret --namespace="${NAMESPACE}"</source>

===Uninstall Helm charts===

*Uninstall init chart <source lang="text">source .shared_init_variables
helm uninstall init --namespace="${NAMESPACE}"</source>

*Uninstall pulse chart <source lang="text">source .shared_init_variables
helm uninstall pulse --namespace="${NAMESPACE}"</source>

*Uninstall init-tenant chart <source lang="text">source .tenant_init_variables
helm uninstall "pulse-init-tenant-${TENANT_SID}" \
--namespace="${NAMESPACE}"</source>
*Uninstall dcu chart <source lang="text">source .tenant_init_variables
helm uninstall "pulse-dcu-${TENANT_SID}" \
--namespace="${NAMESPACE}"</source>
*Uninstall lds chart <source lang="text">source .tenant_init_variables
helm uninstall "pulse-lds-${TENANT_SID}" \
--namespace="${NAMESPACE}"</source>
*Uninstall permissions chart <source lang="text">source .tenant_init_variables
helm uninstall "pulse-permissions-${TENANT_SID}" \
--namespace="${NAMESPACE}"</source>

===Delete shared db and db user===
{{NoteFormat|All Genesys Pulse data contained in your Genesys Pulse database will be lost after execution of the below steps.|3}}

*Save as <tt>delete_shared_db_user.sql</tt> <source lang="text">DROP DATABASE "${DB_NAME_SHARED}";
DROP USER "${DB_USER_SHARED}@${DB_HOST}";</source>
*Run<source lang="text">source .shared_init_variables

envsubst < ./delete_shared_db_user.sql | \
PGPASSWORD="${DB_PASSWORD_SUPERUSER}" psql -h "${DB_HOST}" -p "${DB_PORT}" -U "${DB_NAME_SUPERUSER}" -f -</source>
|Status=No
}}
|PEPageType=2cad3824-b3b9-43aa-a726-143cc1aaefe2
}}

@@ Line 62: / Line 62: @@
 helm uninstall pulse-lds-vq-<tenant-sid> --namespace=pulse</source>
 *permissions: <source lang="bash">helm uninstall pulse-permissions-<tenant-sid> --namespace=pulse</source>
 {{NoteFormat|If you want to remove all custom Pulse dashboard configurations (shared or personal) and all widget templates, you must manually delete the Pulse database schema, which also deletes all data in the schema. }}
 }}

@@ Line 50: / Line 50: @@
 If installation is successful, the command finishes with exit code <tt>0</tt>.
-<!--
 You can optionally omit the argument <tt>--version="<chart-version>"</tt> to upgrade to the latest available version.
--->
 |UninstallExt=For example, to uninstall:
@@ Line 70: / Line 70: @@
 *pulse-redis-secret secret<source lang="bash">kubectl delete secret pulse-redis-secret -n="pulse"</source>
 *pulse-gws-secret secret <source lang="bash">kubectl delete secret pulse-gws-secret -n="pulse"</source>
-<!--
-{{NoteFormat|If you also want to remove any custom Pulse dashboard configurations (shared or personal) and widget templates, you must manually delete the Pulse database schema.}}
+{{NoteFormat|If you want to remove all custom Pulse dashboard configurations (shared or personal) and all widget templates, you must manually delete the Pulse database schema, which also deletes all data in the schema. }}
 }}

@@ Line 1: / Line 1: @@
-{{Article
+{{ArticlePEServiceUpgrade
-|Standalone=No
+|ServiceId=1875e48e-d547-469f-b025-7ce3ca8b0f83
-|DisplayName=Upgrade, rollback, or uninstall
+|UpgradeStrategy=40f069a2-01ae-4027-9aef-13f54bc53613
-|TocName=Upgrade, rollback, or uninstall
+|AddIncluded=No
-|Context=Learn how to upgrade, rollback, or uninstall Genesys Pulse. Service supports Helm rolling upgrade strategy.
+|OptionalPreparatorySteps=Use the following commands to get the updated Helm charts in your repository:
-|ComingSoon=No
+<source lang="bash">helm repo update
-|Section={{Section
+helm search repo pulsehelmrepo/<chart></source>
-|sectionHeading=Upgrade Genesys Pulse
+where <chart> is the name of the Helm chart you need.
-|anchor=upgrade
+To update {{Link-SomewhereInThisVersion|manual=PulsePEGuide|topic=Configure|display text=shared}} and {{Link-SomewhereInThisVersion|manual=PulsePEGuide|topic=Provision|display text=tenant}} provisioning, run the command for each of the following charts:
-#To delete pulse-postgres-configmap configmap, run the following command: <source lang="text">
+*init
-oc delete configmap pulse-postgres-configmap -n="pulse"</source>
+*pulse
-#To delete pulse-redis-configmap configmap, run the following command: <source lang="text">
+*init-tenant
-oc delete configmap pulse-redis-configmap -n="pulse"</source>
+*dcu
-#To delete pulse-postgres-secret secret, run the following command: <source lang="text">
+*lds
-oc delete secret pulse-postgres-secret -n="pulse"</source>
+*permissions
-===Uninstall Helm charts===
+For example, for the '''pulse''' Helm chart:
-#To uninstall init chart, run the following command:
+The following sections describe recommended arguments to use when you run the Helm upgrade command:
-#:<source lang="bash">helm uninstall pulse-init --namespace=pulse</source>
-#To uninstall pulse chart, run the following command:
+===={{Link-SomewhereInThisVersion|manual=PulsePEGuide|topic=Configure|display text=Shared provisioning}}====
-#:<source lang="bash">helm uninstall pulse --namespace=pulse</source>
+When you run the Helm upgrade command for Shared provisioning:
-#To uninstall init-tenant chart, run the following command:
-#:<source lang="bash">helm uninstall pulse-init-tenant-<tenant-sid> --namespace=pulse</source>
+*For the '''init''' Helm chart, set the '''wait''' and '''wait-for-jobs''' flags, so that Helm  waits until all jobs have completed before reporting success:
-#To uninstall dcu chart, run the following command:
+*:<source lang="bash">helm upgrade --install pulse-init pulsehelmrepo/init --wait --wait-for-jobs --version=<chart-version> --namespace=pulse -f values-override-init.yaml</source>
-#:<source lang="bash">helm uninstall pulse-dcu-<tenant-sid> --namespace=pulse</source>
+*:This command also updates the schema, if an update is required.
-#To uninstall lds chart, run the following command:
+*For the '''pulse''' Helm chart, set the '''wait''' flag, so that Helm waits until all pods and other Kubernetes resources in the replica set are in Ready state before reporting success:
-#:<source lang="bash">helm uninstall pulse-lds-<tenant-sid> --namespace=pulse</source>
+*:<source lang="bash">helm upgrade --install pulse pulsehelmrepo/pulse --wait --version=<chart-version>  --namespace=pulse -f values-override-pulse.yaml</source>
-#:<source lang="bash">helm uninstall pulse-lds-vq-<tenant-sid> --namespace=pulse</source>
-#To uninstall permissions chart, run the following command:
+If installation is successful, the command finishes with exit code <tt>0</tt>.
-#:<source lang="bash">helm uninstall pulse-permissions-<tenant-sid> --namespace=pulse</source>
-|Status=No
+===={{Link-SomewhereInThisVersion|manual=PulsePEGuide|topic=Provision|display text=Tenant provisioning}}====
-}}
+When you run the Helm upgrade command for Shared provisioning:
-|PEPageType=2cad3824-b3b9-43aa-a726-143cc1aaefe2
 }}

@@ Line 3: / Line 3: @@
 |DisplayName=Upgrade, rollback, or uninstall
 |TocName=Upgrade, rollback, or uninstall
-|Context=Learn how to upgrade, rollback or uninstall Genesys Pulse. Service supports Helm rolling upgrade strategy.
+|Context=Learn how to upgrade, rollback, or uninstall Genesys Pulse. Service supports Helm rolling upgrade strategy.
 |ComingSoon=No
 |Section={{Section
 |sectionHeading=Upgrade Genesys Pulse
 |alignment=Vertical
-|structuredtext=Upgrade <image-version> and <chart-versions> inputs and follow instructions for installing helm charts in {{Link-SomewhereInThisVersion|manual=PulsePEGuide|topic=Configure}} and  {{Link-SomewhereInThisVersion|manual=PulsePEGuide|topic=Provision}}.
+|structuredtext=Update the <image-version> and <chart-versions> inputs with information for the new release, and follow instructions for installing helm charts in {{Link-SomewhereInThisVersion|manual=PulsePEGuide|topic=Configure}} and  {{Link-SomewhereInThisVersion|manual=PulsePEGuide|topic=Provision}}.
 |Status=No
 }}{{Section
 |sectionHeading=Rollback Genesys Pulse
 |alignment=Vertical
-|structuredtext=Downgrade <image-version> and <chart-versions> inputs and follow instructions for installing helm charts in {{Link-SomewhereInThisVersion|manual=PulsePEGuide|topic=Configure}} and {{Link-SomewhereInThisVersion|manual=PulsePEGuide|topic=Provision}}.
+|structuredtext=Update the <image-version> and <chart-versions> inputs with information for the target release, and follow instructions for installing helm charts in {{Link-SomewhereInThisVersion|manual=PulsePEGuide|topic=Configure}} and {{Link-SomewhereInThisVersion|manual=PulsePEGuide|topic=Provision}}.
 |Status=No
 }}{{Section
@@ Line 21: / Line 23: @@
 |structuredtext====Delete ConfigMaps and Secrets===
-#delete pulse-postgres-configmap configmap <source lang="text">
+#To delete pulse-postgres-configmap configmap, run the following command: <source lang="text">
 oc delete configmap pulse-postgres-configmap -n="pulse"</source>
-#delete pulse-redis-configmap configmap <source lang="text">
+#To delete pulse-redis-configmap configmap, run the following command: <source lang="text">
 oc delete configmap pulse-redis-configmap -n="pulse"</source>
-#delete pulse-postgres-secret secret <source lang="text">
+#To delete pulse-postgres-secret secret, run the following command: <source lang="text">
 oc delete secret pulse-postgres-secret -n="pulse"</source>
-#delete pulse-redis-secret secret <source lang="text">
+#To delete pulse-redis-secret secret, run the following command: <source lang="text">
 oc delete secret pulse-redis-secret -n="pulse"</source>
-#delete pulse-gws-secret secret <source lang="text">
+#To delete pulse-gws-secret secret, run the following command: <source lang="text">
 oc delete secret pulse-gws-secret -n="pulse"</source>
 ===Uninstall Helm charts===
-#Uninstall init chart:
 #:<source lang="bash">helm uninstall pulse-init --namespace=pulse</source>
-#Uninstall pulse chart
+#To uninstall pulse chart, run the following command:
 #:<source lang="bash">helm uninstall pulse --namespace=pulse</source>
-#Uninstall init-tenant chart:
+#To uninstall init-tenant chart, run the following command:
 #:<source lang="bash">helm uninstall pulse-init-tenant-<tenant-sid> --namespace=pulse</source>
-#Uninstall dcu chart:
+#To uninstall dcu chart, run the following command:
 #:<source lang="bash">helm uninstall pulse-dcu-<tenant-sid> --namespace=pulse</source>
-#Uninstall lds chart:
+#To uninstall lds chart, run the following command:
 #:<source lang="bash">helm uninstall pulse-lds-<tenant-sid> --namespace=pulse</source>
 #:<source lang="bash">helm uninstall pulse-lds-vq-<tenant-sid> --namespace=pulse</source>
-#Uninstall permissions chart:
+#To uninstall permissions chart, run the following command:
 #:<source lang="bash">helm uninstall pulse-permissions-<tenant-sid> --namespace=pulse</source>
 |Status=No

@@ Line 21: / Line 21: @@
 |structuredtext====Delete ConfigMaps and Secrets===
-*delete pulse-postgres-configmap configmap <source lang="text">source .shared_init_variables
+#delete pulse-postgres-configmap configmap <source lang="text">
-oc delete configmap pulse-postgres-configmap --namespace="${NAMESPACE}"</source>
+oc delete configmap pulse-postgres-configmap -n="pulse"</source>
+#delete pulse-redis-configmap configmap <source lang="text">
-*delete pulse-redis-configmap configmap <source lang="text">source .shared_init_variables
+oc delete configmap pulse-redis-configmap -n="pulse"</source>
-oc delete configmap pulse-postgres-configmap --namespace="${NAMESPACE}"</source>
+#delete pulse-postgres-secret secret <source lang="text">
+oc delete secret pulse-postgres-secret -n="pulse"</source>
-*delete pulse-postgres-secret secret <source lang="text">source .shared_init_variables
+#delete pulse-redis-secret secret <source lang="text">
-oc delete secret pulse-postgres-secret --namespace="${NAMESPACE}" </source>
+oc delete secret pulse-redis-secret -n="pulse"</source>
+#delete pulse-gws-secret secret <source lang="text">
-*delete pulse-redis-secret secret <source lang="text">source .shared_init_variables
+oc delete secret pulse-gws-secret -n="pulse"</source>
 ===Uninstall Helm charts===
+#Uninstall init chart:
-*Uninstall init chart <source lang="text">source .shared_init_variables
+#:<source lang="bash">helm uninstall pulse-init --namespace=pulse</source>
-helm uninstall init --namespace="${NAMESPACE}"</source>
+#Uninstall pulse chart
+#:<source lang="bash">helm uninstall pulse --namespace=pulse</source>
-*Uninstall pulse chart <source lang="text">source .shared_init_variables
+#Uninstall init-tenant chart:
-helm uninstall pulse --namespace="${NAMESPACE}"</source>
+#:<source lang="bash">helm uninstall pulse-init-tenant-<tenant-sid> --namespace=pulse</source>
+#Uninstall dcu chart:
-*Uninstall init-tenant chart <source lang="text">source .tenant_init_variables
+#:<source lang="bash">helm uninstall pulse-dcu-<tenant-sid> --namespace=pulse</source>
-helm uninstall "pulse-init-tenant-${TENANT_SID}" \
+#Uninstall lds chart:
-      --namespace="${NAMESPACE}"</source>
+#:<source lang="bash">helm uninstall pulse-lds-<tenant-sid> --namespace=pulse</source>
-*Uninstall dcu chart <source lang="text">source .tenant_init_variables
+#:<source lang="bash">helm uninstall pulse-lds-vq-<tenant-sid> --namespace=pulse</source>
-helm uninstall "pulse-dcu-${TENANT_SID}" \
+#Uninstall permissions chart:
-     --namespace="${NAMESPACE}"</source>
+#:<source lang="bash">helm uninstall pulse-permissions-<tenant-sid> --namespace=pulse</source>
 |Status=No
 }}
 |PEPageType=2cad3824-b3b9-43aa-a726-143cc1aaefe2
 }}