Difference between revisions of "PEC-REP/Current/GCXIPEGuide/Upgrade"

From Genesys Documentation
Jump to: navigation, search
Line 2: Line 2:
 
|Standalone=No
 
|Standalone=No
 
|DisplayName=Upgrade, rollback, or uninstall GCXI
 
|DisplayName=Upgrade, rollback, or uninstall GCXI
−
|Context=Learn how to upgrade, rollback or uninstall Genesys Customer Experience Insights (GCXI).
+
|Context=Learn how to upgrade, rollback, or uninstall Genesys Customer Experience Insights (GCXI).
 
|ComingSoon=No
 
|ComingSoon=No
 
|Section={{Section
 
|Section={{Section
 
|sectionHeading=Upgrade GCXI
 
|sectionHeading=Upgrade GCXI
 
|alignment=Vertical
 
|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.
+
|structuredtext=In scenarios where you have previously deployed GCXI using Helm, use the instructions in this procedure to upgrade to a newer GCXI release.
  
 
===Prerequisites===
 
===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'''.  
 
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:  
+
#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:  
 
#:<source lang="LANGUAGE">mkdir helm_<folder></source>
 
#:<source lang="LANGUAGE">mkdir helm_<folder></source>
−
#:where &lt;folder&gt; is the folder in which to extract the Helm package. For example '''018.00'''.
+
#:where &lt;folder&gt; is the folder in which to extract the Helm package. For example: '''018.00'''.
−
#Execute the following command to extract the Helm package:
+
#To extract the Helm package, run the following command:
 
#:<source lang="bash">tar xvzf <helm IP file name> -C helm_<folder></source>
 
#:<source lang="bash">tar xvzf <helm IP file name> -C helm_<folder></source>
−
#:where &lt;folder&gt; is the folder you created in the previous step, and &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:
 
#:For example:
 
#:<source lang="bash">mkdir helm_018.00; tar xvzf gcxi-9.0.018.00.tgz -C helm_018.00</source>
 
#:<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:
+
#To remove Ingress, run the following command:
 
#:<source lang="bash">helm delete gcxi-nginx -n ingress-nginx</source>
 
#:<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.
 
#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:
+
#Navigate to the new folder (for example, using the CD command), and run the following command:
 
#:<source lang="bash">helm upgrade --debug gcxi-helm gcxi/ --namespace gcxi --create-namespace -f values-test.yaml</source>
 
#:<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:
+
#To configure Ingress, run the following command:
 
#:<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>
 
#:<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
 
|Status=No
Line 35: Line 35:
 
}}{{Section
 
}}{{Section
 
|sectionHeading=Uninstall GCXI
 
|sectionHeading=Uninstall GCXI
−
|anchor=uninstall
 
 
|alignment=Vertical
 
|alignment=Vertical
 
|structuredtext=Complete the following steps to remove GCXI:
 
|structuredtext=Complete the following steps to remove GCXI:
Line 43: Line 42:
 
#Execute the following command to remove GCXI:
 
#Execute the following command to remove GCXI:
 
#:<source lang="bash">helm uninstall gcxi-helm -n gcxi</source>
 
#:<source lang="bash">helm uninstall gcxi-helm -n gcxi</source>
 +
<!--Question for reviewers: OR, should it be?:
 +
<source lang="bash">helm uninstall gcxi-oc -n gcxi</source>-->
 
|Status=No
 
|Status=No
 
}}
 
}}
 
|PEPageType=2cad3824-b3b9-43aa-a726-143cc1aaefe2
 
|PEPageType=2cad3824-b3b9-43aa-a726-143cc1aaefe2
 
}}
 
}}

Revision as of 16:45, April 8, 2022

This topic is part of the manual Genesys Customer Experience Insights Private Edition Guide for version Current of Reporting.

Learn how to upgrade, rollback, or uninstall Genesys Customer Experience Insights (GCXI).

Upgrade GCXI

In scenarios where you have previously deployed GCXI using Helm, use the instructions in this procedure to upgrade to a newer GCXI release.

Prerequisites

Obtain the Helm installation package (IP) before you begin. The Helm IP has a file name in the format gcxi-<release>.tgz, for example gcxi-018.00.tgz.

  1. 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: 
    mkdir helm_<folder>
    where <folder> is the folder in which to extract the Helm package. For example: 018.00.
  2. To extract the Helm package, run the following command: 
    tar xvzf <helm IP file name> -C helm_<folder>
    where:
    <folder> is the folder you created in the previous step.
    <helm IP file name> is the name of the gcxi Helm package you are installing.
    For example:
    mkdir helm_018.00; tar xvzf gcxi-9.0.018.00.tgz -C helm_018.00
  3. To remove Ingress, run the following command: 
    helm delete gcxi-nginx -n ingress-nginx
  4. From the folder where you deployed the previous release of GCXI using Helm, copy the file values-test.yaml into the new folder.
  5. Navigate to the new folder (for example, using the CD command), and run the following command: 
    helm upgrade --debug gcxi-helm gcxi/ --namespace gcxi --create-namespace -f values-test.yaml
  6. To configure Ingress, run the following command: 
    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

Rollback GCXI

No rollback procedure is available.

Uninstall GCXI

Complete the following steps to remove GCXI:

  1. Execute the following command to remove Ingress: 
    helm delete gcxi-nginx -n ingress-nginx
  2. Execute the following command to remove GCXI: 
    helm uninstall gcxi-helm -n gcxi
Retrieved from "https://all.docs.genesys.com/PEC-REP/Current/GCXIPEGuide/Upgrade (2025-06-20 13:37:21)"
Comments or questions about this documentation? Contact us for support!