Manage a Semarchy xDM instance on Azure Kubernetes Service (AKS)
Review the pre-upgrade instructions before upgrading your instance(s) of Semarchy xDM.
Stop all applications and user connections to Semarchy xDM during the upgrade:
No application should access the Semarchy xDM services and APIs.
No user should access the Semarchy user interfaces for design-time or data management operations.
No user or application should access the repository or data locations' database schemas.
Contact your database administrator and middleware administrator to ensure Semarchy xDM remains unavailable throughout the upgrade process.
To upgrade Semarchy xDM:
Navigate to the folder containing Kubernetes descriptor files for the active and passive deployments.
Update both the descriptor files to use the new Semarchy xDM image to upgrade to. Refer to the Semarchy xDM Docker Hub page for more information.
Run the following command to delete the active application server deployment:
$ kubectl delete deployment.apps/semarchy-appserver-active
Run the following command to delete the passive application server deployment:
$ kubectl delete deployment.apps/semarchy-appserver-passive
Refer to Upgrade an Azure Kubernetes Service Cluster for more information on upgrading the AKS cluster control plane.
Refer to Upgrade PostgreSQL database for more information on upgrading the Azure PostgreSQL instances.
The following is a non-exhaustive list of commands useful for monitoring and troubleshooting Semarchy xDM:
Get the pods running on the active application server.
$ kubectl get pods -l app=semarchy-appserver-active
Get the pods running on the passive application servers.
$ kubectl get pods -l app=semarchy-appserver-passive
Get details for a specific pod.
$ kubectl describe pod _<pod_name>_
Get logs for the active application server.
$ kubectl logs -l app=semarchy-appserver-active
Get logs for the passive application servers.
$ kubectl logs -l app=semarchy-appserver-passive
Get details for the active application server deployment.
$ kubectl get deployments -l app=semarchy-appserver-active
Get details for the passive application server deployment.
$ kubectl get deployments -l app=semarchy-appserver-passive
Additionally, the platform offers REST API readiness probes to monitor the application status.
Refer to Cluster Administration for more information on maintaining and managing Kubernetes deployment and pods.
Refer to Manage the License for more information.
Semarchy xDM supports Key Management Services and Secrets Manager to store the platform’s sensitive configuration items such as credentials, API keys, or passwords and to implement rotating system credentials.
Azure Monitor can be used to monitor the different resources of the architecture.
Refer to Monitoring Azure Kubernetes Service (AKS) with Azure Monitor for more information.
Refer to Monitor Azure SQL Database with Azure Monitor for more information.