Installing Genesys CX Insights - Podman Compose

GCXI is agnostic to container environments. It can work on top of Docker, Podman, or Kubernetes with any valid container runtime (like containerd or cri-o). The Podman setup is similar to a GCXI installation with Docker with minor syntactic differences between both types.

Prerequisites

GCXI deployment on Podman shares the same requirements to the host system, as GCXI on Docker.

• requirements to IPC / shared memory sysctl settings, namely kernel.sem and vm.max_map_count
• selinux must be set to permissive mode or disabled

Install Podman

1. Install Podman version 4.5 or greater* using standard instructions depending on your Linux type. See Podman Installation for more information.
2. Verify if the installation was successful. podman version
3. Enable Podman socket and verify.
   

systemctl enable --now podman.socket
systemctl status podman.socket

Install Podman Plugins

1. Install Podman plugins package. For RedHat 8 /9, or CentOS Stream 8 / 9. the command will be: yum install -y podman-plugins.x86_64 Refer the Podman documentation for more information on installing plugins.

Install Docker Compose

1. Install the docker-compose standalone binary following the instructions in Install Compose standalone.
2. Verify if the installation was successful. podman compose version

Prepare File Volumes

Similar to GCXI docker-compose deployment, GCXI on Podman uses certain folders on the host machine to store persistent data.

Before running GCXI on Podman, review all host-path file volumes, mentioned in the compose file, and ensure that the corresponding folders on the host 1. exist and 2. are owned by the user under which GCXI container runs (by default, user 500).

CODE_BLOCK

Prepare GCXI Images

Newer versions of Podman client work similar to Docker. Podman supports all necessary commands for working with images, like podman pull , podman load, or podman tag.

In most cases, GCXI images are shipped as tar.gz archives. In this case you need to use podman import to create a usable OCI image, which may be consumed by Podman.

CODE_BLOCK

Review GCXI Compose File

GCXI IP ships a sample docker-compose.yaml file.

This file may be fully reused by Podman versions > 4.5, no changes needed. Configure GCXI variables in the compose file referring to the standard GCXI documentation. Ensure that the image references in your compose file are configured similar to how GCXI images are tagged on the host. General GCXI requirements about host IPC settings apply as usual.

Run GCXI on Podman Compose

1. Run GCXI on Podman Compose. podman compose --file docker-compose.yml up

Podman Compose almost fully mirrors behavior of Docker Compose, hence operating podman compose client shouldn’t comprise any difficulty.