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

WikiSysop at 12:15, February 16, 2023

2023-02-16T12:15:40Z

WikiSysop at 12:00, February 16, 2023

2023-02-16T12:00:42Z

WikiSysop at 16:45, April 8, 2022

2022-04-08T16:45:34Z

Tgilchri at 13:30, March 30, 2022

2022-03-30T13:30:57Z

Tony.gilchrist@genesys.com: Published

2021-09-01T18:29:59Z

Published

Tony.gilchrist@genesys.com: Published

2021-06-29T19:46:11Z

Published

New page

{{Article
|Standalone=No
|DisplayName=Upgrade, rollback, or uninstall GCXI
|TocName=Upgrade, rollback, or uninstall
|Context=Learn how to upgrade, rollback or uninstall Genesys Customer Experience Insights (GCXI).
|ComingSoon=No
|Section={{Section
|sectionHeading=Upgrade GCXI
|alignment=Vertical
|structuredtext=In scenarios where you have previously deployed Genesys CX Insights using Helm, use the instructions in this procedure to upgrade to a newer Genesys CX Insights release.

===Prerequisites===
Obtain the Helm installation package (IP) before you begin. The Helm IP has a file name in the format gcxi-<nowiki>&</nowiki>lt;release<nowiki>&</nowiki>gt;.tgz, for example '''gcxi-018.00.tgz'''.

#On the Control Plane node, set the current directory to the helm folder, and execute the following command to create a subfolder to differentiate this release from others:
#:<source lang="LANGUAGE">mkdir helm_<folder></source>
#:where <folder> is the folder in which to extract the Helm package. For example '''018.00'''.
#Execute the following command to extract the Helm package:
#:<source lang="bash">tar xvzf <helm IP file name> -C helm_<folder></source>
#:where <folder> is the folder you created in the previous step, and <helm IP file name> is the name of the gcxi Helm package you are installing.
#:For example:
#:<source lang="bash">mkdir helm_018.00; tar xvzf gcxi-9.0.018.00.tgz -C helm_018.00</source>
#Execute the following command to remove Ingress:
#:<source lang="bash">helm delete gcxi-nginx -n ingress-nginx</source>
#From the folder where you deployed the previous release of GCXI using Helm, copy the file '''values-test.yaml''' into the new folder.
#Navigate to the new folder (for example, using the CD command), and execute the following command:
#:<source lang="bash">helm upgrade --debug gcxi-helm gcxi/ --namespace gcxi --create-namespace -f values-test.yaml</source>
#Execute the following command to configure Ingress:
#:<source lang="bash">helm install --debug --set controller.kind=DaemonSet --set controller.hostNetwork=true --set tcp.34952=gcxi/gcxi:mstr --set tcp.8180=gcxi/gcxi:metrics gcxi-nginx ingress-nginx/ingress-nginx --create-namespace -n ingress-nginx</source>
|Status=No
}}{{Section
|sectionHeading=Rollback GCXI
|alignment=Vertical
|structuredtext=No rollback procedure is available.
|Status=No
}}{{Section
|sectionHeading=Uninstall GCXI
|alignment=Vertical
|structuredtext=Complete the following steps to remove GCXI:
#Execute the following command to remove Ingress:
#:<source lang="bash">helm delete gcxi-nginx -n ingress-nginx</source>
#Execute the following command to remove GCXI:
#:<source lang="bash">helm uninstall gcxi-helm -n gcxi</source>
|Status=No
}}
|PEPageType=2cad3824-b3b9-43aa-a726-143cc1aaefe2
}}

@@ Line 48: / Line 48: @@
 ===Restoring from a backup===
 Ensure that backup files (pgdump) are present in the '''gcxi-shared''' mount location. If they are in another location, you must set the RESTORE_TAG variable in the '''gcxi-restore.yaml''' file.
 You must stop the GCXI pods before performing a restore operation. Stop the pods using the following command:

@@ Line 1: / Line 1: @@
-{{Article
+{{ArticlePEServiceUpgrade
-|Standalone=No
+|ServiceId=1f419ea4-5e6e-4052-abc1-c56ff55106e2
-|DisplayName=Upgrade, rollback, or uninstall GCXI
+|AddIncluded=Yes
-|Context=Learn how to upgrade, rollback, or uninstall Genesys Customer Experience Insights (GCXI).
+|IncludedServiceUpgradeStrategy={{IncludedServiceUpgradeStrategy
-|ComingSoon=No
+|IncludedServiceId=4e6a78a6-ecb9-4886-8819-016d7f81b06f
-|Section={{Section
+|IncludedServiceUpgradeStrategy=40f069a2-01ae-4027-9aef-13f54bc53613
-|sectionHeading=Upgrade GCXI
+}}{{IncludedServiceUpgradeStrategy
-|alignment=Vertical
+|IncludedServiceId=5462861b-e347-4eaa-b621-9795838ee431
-|structuredtext=In scenarios where you have previously deployed GCXI using Helm, use the instructions in this procedure to upgrade to a newer GCXI release.
+|IncludedServiceUpgradeStrategy=40f069a2-01ae-4027-9aef-13f54bc53613
-===Prerequisites===
+The following steps provide detailed information about preparing to upgrade GCXI:
 #On the Control Plane node, set the current directory to the helm folder, and run the following command to create a subfolder to differentiate this release from others:
@@ Line 17: / Line 19: @@
 #To extract the Helm package, run the following command:
 #:<source lang="bash">tar xvzf <helm IP file name> -C helm_<folder></source>
-#:where:<br/>&lt;folder&gt; is the folder you created in the previous step.<br/> &lt;helm IP file name&gt; is the name of the gcxi Helm package you are installing.
+#:where:<br />&lt;folder&gt; is the folder you created in the previous step.<br /> &lt;helm IP file name&gt; is the name of the gcxi Helm package you are installing.
 #:For example:
 #:<source lang="bash">mkdir helm_018.00; tar xvzf gcxi-9.0.018.00.tgz -C helm_018.00</source>
 #From the folder where you deployed the previous release of GCXI using Helm, copy the file '''values-test.yaml''' into the new folder.
-#Execute the following command to remove Ingress:
+==Back up the meta database==
-#:<source lang="bash">helm delete gcxi-nginx -n ingress-nginx</source>
-#Execute the following command to remove GCXI:
+The GCXI upgrade process automatically backs up your meta database before upgrading to the new release of GCXI. However, GCXI also provides additional options to back up the contents of your meta database, including:
-#:<source lang="bash">helm uninstall gcxi-helm -n gcxi</source>
+*Scheduled backup using the container option BACKUP_HOUR.
 <!--Question for reviewers: OR, should it be?:
 <source lang="bash">helm uninstall gcxi-oc -n gcxi</source>-->
-|Status=No
-}}
+====RAA example====
-|PEPageType=2cad3824-b3b9-43aa-a726-143cc1aaefe2
+<source lang="bash">helm uninstall gcxi-raa-lab</source>
 }}

@@ Line 35: / Line 35: @@
 }}{{Section
 |sectionHeading=Uninstall GCXI
 |alignment=Vertical
 |structuredtext=Complete the following steps to remove GCXI: