Difference between revisions of "PEC-REP/Current/GIMPEGuide/PlanningGCA"
From Genesys Documentation
m (Text replacement - "Genesys Engage" to "Genesys Multicloud CX") |
|||
| (5 intermediate revisions by 2 users not shown) | |||
| Line 2: | Line 2: | ||
|DisplayName=Before you begin GCA deployment | |DisplayName=Before you begin GCA deployment | ||
|Context=Find out what to do before deploying GIM Config Adapter (GCA). | |Context=Find out what to do before deploying GIM Config Adapter (GCA). | ||
| + | |IncludedServiceId=f05492f5-52ed-490a-b0d5-c318a4a7272b | ||
|LimitationsStatus=No | |LimitationsStatus=No | ||
| − | |LimitationsText= | + | |LimitationsText=Instructions are provided for a single-tenant deployment. |
| − | |||
<br /> | <br /> | ||
| Line 18: | Line 18: | ||
The following table lists the third-party prerequisites for GCA. | The following table lists the third-party prerequisites for GCA. | ||
|SectionThirdPartyItem={{SectionThirdPartyItem | |SectionThirdPartyItem={{SectionThirdPartyItem | ||
| − | |||
| − | |||
|ThirdPartyItem=2f69518e-33af-4c0f-adcc-a98e5427e5e0 | |ThirdPartyItem=2f69518e-33af-4c0f-adcc-a98e5427e5e0 | ||
| + | |Notes=GCA publishes configuration data to the <tt>gca-cfg</tt> topic, which GSP consumes. The topic must exist in your Kafka configuration. | ||
| + | <!--<br/>{{Editgrn_open}}<font color=red>'''Writer's note: Borys/Alexey,''' in GSP the topic name is customizable (in the values.yaml), but I don't see where customers could customize it in the GCA values.yaml. ??</font>{{Editgrn_close}}--> | ||
}}{{SectionThirdPartyItem | }}{{SectionThirdPartyItem | ||
| − | |ThirdPartyItem= | + | |ThirdPartyItem=9ae24d71-5263-4a2e-8d1b-f65660f1cdc0 |
| + | |Notes=Both GCA and GSP require object storage to store data during processing. You can use the same storage account for both services. | ||
}}{{SectionThirdPartyItem | }}{{SectionThirdPartyItem | ||
| − | |ThirdPartyItem= | + | |ThirdPartyItem=3e732261-b78e-4921-b6a6-08ee0a322ca1 |
}}{{SectionThirdPartyItem | }}{{SectionThirdPartyItem | ||
| − | |ThirdPartyItem= | + | |ThirdPartyItem=9196f7d6-6782-467f-a664-627a2c293000 |
| + | |Variation=No | ||
}} | }} | ||
|StorageStatus=No | |StorageStatus=No | ||
| + | |StorageText=GCA uses object storage to store the GCA snapshot during processing. Like GSP, GCA supports using S3-compatible storage provided by OpenShift and Google Cloud Platform (GCP),<!-- By default, GCA expects to use Azure Blob Storage, but you can also use S3-compatible bucket storage provided by other cloud platforms. <font color=red>'''Writer's note:''' Confirm the default setup. All the storage parameters in the values.yaml are empty.</font> If you use S3-compatible storage for GSP,--> and Genesys expects you to use the same storage account for GSP and GCA. If you want to use separate storage for GCA, follow the {{Link-SomewhereInThisVersion|manual=GIMPEGuide|topic=ConfigureGSP|anchor=Storage|display text=Configure S3-compatible storage}} instructions for GSP to create similar S3-compatible storage for GCA. | ||
|NetworkStatus=No | |NetworkStatus=No | ||
| − | |NetworkText= | + | |NetworkText=No special network requirements. |
|BrowserStatus=No | |BrowserStatus=No | ||
|DependenciesStatus=No | |DependenciesStatus=No | ||
| − | |DependenciesText= | + | |DependenciesText=*{{Link-AnywhereElse|product=PrivateEdition|version=Current|manual=TenantPEGuide|display text=Voice Tenant Service}}, which enables GCA to access the Configuration Server database. You must deploy the Voice Tenant Service before you deploy GCA. |
| − | + | **Ensure that an appropriate user account is available for GCA to use to access the Configuration Database. The GCA user account requires at least read permissions. | |
| − | *{{Link-AnywhereElse|product=PrivateEdition|version=Current|manual=TenantPEGuide|display text=Voice Tenant Service}}, which enables GCA to access the Configuration Server database | + | **You must also have your Tenant ID information available.<!--{{Editgrn_open}}<font color=red>'''Writer's note:''' Where can they find this info?</font>{{Editgrn_close}}--> |
| − | * | + | *There are no strict dependencies between the Genesys Info Mart services, but the logic of your particular pipeline might require Genesys Info Mart services to be deployed in a particular order. Depending on the order of deployment, there might be temporary data inconsistencies until all the Genesys Info Mart services are operational. For example, GSP looks for the GCA snapshot when it starts; if GCA has not yet been deployed, GSP will encounter unknown configuration objects and resources until the snapshot becomes available. |
For detailed information about the correct order of services deployment, see {{SuiteLevelLink|deployorder}}. | For detailed information about the correct order of services deployment, see {{SuiteLevelLink|deployorder}}. | ||
Latest revision as of 16:46, September 2, 2022
This topic is part of the manual Genesys Info Mart Private Edition Guide for version Current of Reporting.
Contents
Find out what to do before deploying GIM Config Adapter (GCA).
Related documentation:
RSS:
Limitations and assumptions
Instructions are provided for a single-tenant deployment.
Download the Helm charts
GIM Config Adapter (GCA) and GCA monitoring are the only services that run in the GCA Docker container. The Helm charts included with the GCA release provision GCA and any Kubernetes infrastructure necessary for GCA to run.
See Helm charts and containers for Genesys Info Mart for the Helm chart versions you must download for your release.
For information about how to download the Helm charts, see Downloading your Genesys Multicloud CX containers.
Third-party prerequisites
For information about setting up your Genesys Multicloud CX private edition platform, see Software requirements.
The following table lists the third-party prerequisites for GCA.
| Name | Version | Purpose | Notes |
|---|---|---|---|
| Kafka | 2.x | Message bus. | GCA publishes configuration data to the gca-cfg topic, which GSP consumes. The topic must exist in your Kafka configuration. |
| Object storage | Persistent or shared data storage, such as Amazon S3, Azure Blob Storage, or Google Cloud Storage. | Both GCA and GSP require object storage to store data during processing. You can use the same storage account for both services. | |
| A container image registry and Helm chart repository | Used for downloading Genesys containers and Helm charts into the customer's repository to support a CI/CD pipeline. You can use any Docker OCI compliant registry. | ||
| Command Line Interface | The command line interface tools to log in and work with the Kubernetes clusters. |
Storage requirements
GCA uses object storage to store the GCA snapshot during processing. Like GSP, GCA supports using S3-compatible storage provided by OpenShift and Google Cloud Platform (GCP), and Genesys expects you to use the same storage account for GSP and GCA. If you want to use separate storage for GCA, follow the Configure S3-compatible storage instructions for GSP to create similar S3-compatible storage for GCA.
Network requirements
No special network requirements.
Browser requirements
Not applicable
Genesys dependencies
- Voice Tenant Service, which enables GCA to access the Configuration Server database. You must deploy the Voice Tenant Service before you deploy GCA.
- Ensure that an appropriate user account is available for GCA to use to access the Configuration Database. The GCA user account requires at least read permissions.
- You must also have your Tenant ID information available.
- There are no strict dependencies between the Genesys Info Mart services, but the logic of your particular pipeline might require Genesys Info Mart services to be deployed in a particular order. Depending on the order of deployment, there might be temporary data inconsistencies until all the Genesys Info Mart services are operational. For example, GSP looks for the GCA snapshot when it starts; if GCA has not yet been deployed, GSP will encounter unknown configuration objects and resources until the snapshot becomes available.
For detailed information about the correct order of services deployment, see Order of services deployment.
GDPR support
Not applicable. GCA does not store information beyond an ephemeral snapshot.
Comments or questions about this documentation? Contact us for support!