WikiSysop: Created page with "{{ArticlePEServiceUpgrade |ServiceId=3b2bdfd2-9eb1-4a99-a181-356f2704bc02 |UpgradeStrategy=40f069a2-01ae-4027-9aef-13f54bc53613 |AddIncluded=No |OptionalServiceIntro={{JDNote|..."

2022-06-08T21:15:39Z

Created page with "{{ArticlePEServiceUpgrade |ServiceId=3b2bdfd2-9eb1-4a99-a181-356f2704bc02 |UpgradeStrategy=40f069a2-01ae-4027-9aef-13f54bc53613 |AddIncluded=No |OptionalServiceIntro={{JDNote|..."

New page

{{ArticlePEServiceUpgrade
|ServiceId=3b2bdfd2-9eb1-4a99-a181-356f2704bc02
|UpgradeStrategy=40f069a2-01ae-4027-9aef-13f54bc53613
|AddIncluded=No
|OptionalServiceIntro={{JDNote|Links to the PDM in the content below are provided by a template ([[Template:PDMLink|link]]), which you will need to update to link to the PE PDM when it's published. Use the following links (which repeat the markup used below) to test the updated template when the time comes: {{GIMPDMLink}} and {{GIMPDMLink|page=AboutDataExport|linkText=About Data Export}}.}}

In general, upgrades for the three Genesys Info Mart services are released at the same time, but this is not necessarily the case. Note that the respective release packages have different release numbers.

As long as you remain within the range of N-2 releases for each service, the Genesys Info Mart services can inter-operate with one another. However, if upgraded releases for all the Genesys Info Mart services are available, Genesys recommends that you upgrade them all during the same upgrade cycle.

Upgrading GIM might or might not require migrating the Info Mart database as well, depending on whether there are schema changes. If database migration is required, the upgraded GIM service automatically launches the migration job. GIM upgrade and database migration do not interfere with aggregation or other queries in progress. Robust backward compatibility means that an upgraded or rolled-back GIM service can operate with either a migrated or a nonmigrated Info Mart database, even with a half-migrated database if the migration job did not complete successfully.
|SchedulingConsiderations=Do not attempt to upgrade a service unless all the Genesys Info Mart services are operating normally.

Upgrading the services potentially affects the availability of Info Mart data. Plan a time when this eventuality is least disruptive to your operations.

If you are upgrading all the services during the same upgrade cycle, upgrade GIM first, then GSP, then GCA.
|OptionalPreparatorySteps=#Review the Reporting and Analytics Aggregates (RAA) and Genesys CX Insights (GCXI) release notes and release advisories, for information about the possible impact of Genesys Info Mart migration on aggregation, as well as workarounds or additional steps to take during Genesys Info Mart migration.

In addition, if you are upgrading the GIM service:

#Review the "New in the Info Mart Database" and "Summary of Info Mart Schema Changes" pages in the {{GIMPDMLink}}, to identify whether there are schema changes that will necessitate migration of the Info Mart database as part of a GIM upgrade. If so, and if you use the Data Export capability, decide whether you want to update your export views to include new data available in the migrated database.
#If you do want to update your export views, do so after the GIM upgrade is complete (see [[{{FULLPAGENAME}}#UpdateExportViews|Update export views]]).
#For reference purposes, identify and make notes of any custom changes that you made to the Info Mart database—for example, table spaces, partitions, additional indexes, views, or permissions.
#:Database migration might involve creating new tables or replacing some tables with views. You will need to re-create any custom database objects or permissions that become lost or invalidated during the update process.
#Ensure that a recent backup of the Info Mart database is available in case you need to roll back a database migration.
|RollUpdUpgradeExt=When you upgrade GIM and GSP, increase the Helm timeout value from the default 5 minutes to 15 minutes or longer. For GIM, you need a longer timeout to accommodate possible database migration, which can take a significant amount of time if, for example, new indexes are being added. For GSP, you need to allow sufficient time for GSP to run the process to create a pre-upgrade hook, to ensure that state information is correctly preserved when the previous instance shuts down.

====Examples====

*GIM and GIM Monitoring: <source lang="text">helm upgrade --install gim gim-100.0.116+2900.tgz -f gim-values.yaml -n gim --timeout 15m
helm upgrade --install gim-monitoring gim-monitoring-100.0.116+2900.tgz -n gim</source>
*GSP: <source lang="text">helm upgrade --install gsp gsp-100.0.100+1400.tgz -f gsp-values.yaml -n gsp --timeout 15m</source>
*GCA and GCA Monitoring:
*:<source lang="text">helm upgrade --install gca gca-100.0.100+2300.tgz -f gca-values.yaml -n gca
helm upgrade --install gca-monitoring gca-monitoring-100.0.100+2300.tgz -n gca</source>
|RollUpdVerifyExt=Monitor the operations dashboard for the status of services and job execution. Genesys Info Mart does not report the Ready state for a pod until the pod is operational. The GIM service does not report the Ready state until the first post-upgrade transformation job has completed successfully.

To verify that an upgraded GIM is successfully populating the Info Mart database, use the '''{{Link-SomewhereInThisVersion|manual=GIMPEGuide|topic=GIMMetrics|anchor=Metrics|display text=gim_kafka_timestamp_behind}}''' metric to track data latency and validate that there is no growing backlog. To validate successful database migration, you can query the database directly to verify that schema changes (for example, new tables or columns) have been implemented and the new database objects are being populated.

If Genesys Info Mart is operating normally after an upgrade in which there were schema changes, but the migration job either did not run or else did not complete successfully, a transitory condition (for example, losing connection to the database or exceeding the Helm timeout for executing the job) was the likely cause of the migration job failure. Simply restart the GIM pod. The GIM service detects the out-of-date schema and restarts the migration job, which picks up from where it left off.

If a new pod does not start and/or operate successfully, Genesys recommends that you roll back to the previous version, so that Genesys Info Mart can continue operating while you investigate the reasons for failure. Rolling back the GIM service does not affect the Info Mart database.

If there are issues with a third-party dependency, such as Kafka or PostgreSQL, then rollback will not work until you resolve the third-party issue.

Contact [https://www.genesys.com/customer-care Genesys Customer Care] if you cannot resolve an upgrade issue.
|RollUpdRollbackExt=When you roll back GIM and GSP, increase the Helm timeout value from the default 5 minutes to 15 minutes or longer.

====Examples====

*GIM: <source lang="text">helm rollback gim --timeout 15m</source>
*GSP: <source lang="text">helm rollback gsp --timeout 15m</source>
*GCA: <source lang="text">helm rollback gca</source>
|OptPostUpgradeProc=No routine post-upgrade procedures are required, but you might want to update your export views for Data Export if there were schema changes.
{{AnchorDiv|UpdateExportViews}}
===Update export views===
If you use the Data Export feature, your data will continue to be exported using the export views in effect before GIM was upgraded, regardless of whether the upgrade was associated with schema changes that triggered migration of the Info Mart database.

If you want your exported data to reflect the schema changes (for example, new tables or columns), you must update your export views. Execute the following command, which forces GIM to rerun the migration job with the '''make-export-views''' parameter:
<source lang="text">kubectl exec <gim-pod> -n < gim-namespace> -- ./entrypoint.sh -job Job_MigrateGIM -make-export-views</source>
You might also need to update your target schema and change your import processing to accommodate the Info Mart schema changes. For more information, see {{GIMPDMLink|page=AboutDataExport|linkText=About Data Export}}.
|UninstallExt=For example:
<source lang="text">helm uninstall gsp -n gsp</source>

Uninstalling the Genesys Info Mart services can be useful if, say, you have completed a beta testing program and want to clean up your environment and free up resources.

Uninstalling any of the Genesys Info Mart services does not affect the Info Mart database or any files on the S3-compatible storage location GIM uses for Data Export.

Uninstalling GIM does not affect aggregation that may be in process and does not directly affect GCXI reports. However, of course, the Info Mart database on which GCXI reporting is based will no longer be updated.

Uninstalling GSP does not remove all state-related Kubernetes resources (ConfigMaps) referring to files on the S3-compatible storage that GSP uses during processing. If you are uninstalling GSP preparatory to re-installing it, execute the following command to clear these resources:
<source lang="text">kubectl delete cm --selector='app=<gsp.fullname>’</source>
where <tt><gsp.fullname></tt> is the service name calculated by the '''gsp.fullname macro'''. If you did not override the default release name, then <tt><gsp.fullname></tt> is <tt>gsp</tt>.
}}

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

WikiSysop: Created page with "{{ArticlePEServiceUpgrade |ServiceId=3b2bdfd2-9eb1-4a99-a181-356f2704bc02 |UpgradeStrategy=40f069a2-01ae-4027-9aef-13f54bc53613 |AddIncluded=No |OptionalServiceIntro={{JDNote|..."