Manage a Semarchy xDM instance in GCP
Upgrade Semarchy xDM
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 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
-
Repeat the deployment steps 8 and 9 to apply the new deployments for the active and passive application servers.
GCP Ressources
GCP GKE
Refer to Best practices for upgrading clusters for more information on upgrading the GKE cluster control plane.
GCP Cloud SQL
Refer to Upgrade the database major version for more information on upgrading the Amazon Aurora cluster.
Backup
Semarchy xDM
Refer to Upgrade Procedure Steps for more information on backing up your installation of Semarchy xDM.
GCP GKE
Refer to Backup for GKE for more information on managing backups for GCP GKE.
GCP Cloud SQL
Refer to About Cloud SQL backups for more information on managing backups with Cloud SQL.
Maintenance & Troubleshooting
Semarchy xDM
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.
Kubernetes deployments and pods
Refer to Cluster Administration for more information on maintaining and managing Kubernetes deployment and pods.
GCP Ressources
GCP GKE
Refer to GKE troubleshooting for more information on troubleshooting Amazon EKS.
GCP Cloud SQL
Refer to GCP Storage troubleshooting for more information on troubleshooting the Amazon Aurora Instances.
License & Support
Refer to Semarchy xDM System Requirements for more information.
Additional services on GCP
Secrets
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.
GCP Cloud Key Management (KMS)
Refer to Configure a Key Management Service for more information on configuring GCP Cloud Key Management.
GCP Secrets Manager
Refer to Configure External Secrets Managers for more information on configuring GCP Secrets Manager.
Cloud Monitoring
Google Cloud Monitoring can be used to monitor the different resources of the architecture.
GCP GKS
Refer to Observing your GKE clusters for more information on monitoring the Google GKE.
GCP Cloud SQL
Refer to Monitor Cloud SQL instances for more information on monitoring Cloud SQL.