From 24f24e11f992a2a819ae677a84dd2195e7864886 Mon Sep 17 00:00:00 2001 From: chjmil Date: Fri, 9 Aug 2024 17:07:39 -0400 Subject: [PATCH 1/3] docs: Adding section about 2024.06 db changes --- docs/CONFIG-VARS.md | 6 ++++++ docs/Troubleshooting.md | 15 +++++++++++++++ docs/user/PostgreSQL.md | 9 +++++++++ 3 files changed, 30 insertions(+) diff --git a/docs/CONFIG-VARS.md b/docs/CONFIG-VARS.md index 32374f66..7ff6d287 100644 --- a/docs/CONFIG-VARS.md +++ b/docs/CONFIG-VARS.md @@ -248,6 +248,12 @@ V4_CFG_POSTGRES_SERVERS: ``` Several SAS Viya platform offerings require a second internal Postgres instance referred to as SAS Common Data Store or CDS PostgreSQL. See details [here](https://documentation.sas.com/?cdcId=itopscdc&cdcVersion=default&docsetId=dplyml0phy0dkr&docsetTarget=n08u2yg8tdkb4jn18u8zsi6yfv3d.htm#p0wkxxi9s38zbzn19ukjjaxsc0kl). The list of software offerings that include CDS PostgreSQL is located at [SAS Common Data Store Requirements (for SAS Planning and Retail Offerings)](https://documentation.sas.com/?cdcId=sasadmincdc&cdcVersion=default&docsetId=itopssr&docsetTarget=p05lfgkwib3zxbn1t6nyihexp12n.htm#n03wzanutmc6gon1val5fykas9aa) in System Requirements for the SAS Viya platform. To deploy and configure a CDS PostgreSQL instance in addition to the default internal platform Postgres instance, specify "cds-postgres" for your second Postgres instance as shown in the example below: +**Note**: Starting with 2024.06, the SharedServices database is not created automatically during the initial deployment of the SAS Viya platform. Instead, you must manually create it before you start the SAS Viya platform deployment. +Please refer to [this section](https://github.com/sassoftware/viya4-deployment/blob/main/docs/user/PostgreSQL.md##202406-sharedservices-database-updated-behavior +) in the PostgreSQL.md documentation + + + ```bash V4_CFG_POSTGRES_SERVERS: default: diff --git a/docs/Troubleshooting.md b/docs/Troubleshooting.md index e03995cf..f7ea7e8d 100644 --- a/docs/Troubleshooting.md +++ b/docs/Troubleshooting.md @@ -400,3 +400,18 @@ Based on this [Network Load Balancing documentation](https://docs.aws.amazon.com terminationGracePeriodSeconds: 600 ``` 3. When the `baseline,install` ansible tasks are run and `ingress-nginx` is installed, the EC2 Load Balancer that gets provisioned by AWS will have those tags you specified. + + +## sas-data-server-operator failure + +### Symptom + +```yaml +pod logs go here + +``` + +### Solution + +Please refer to [this section](https://github.com/sassoftware/viya4-deployment/blob/main/docs/user/PostgreSQL.md##202406-sharedservices-database-updated-behavior +) in the PostgreSQL.md documentation diff --git a/docs/user/PostgreSQL.md b/docs/user/PostgreSQL.md index 9c2f1279..f91f6ce5 100644 --- a/docs/user/PostgreSQL.md +++ b/docs/user/PostgreSQL.md @@ -5,6 +5,7 @@ * [Post Data Transfer Steps for viya4-deployment](#post-data-transfer-steps-for-viya4-deployment) * [Crunchy Data 5](#crunchy-data-5) * [Crunchy Data 4](#crunchy-data-4) + * [2024.06 SharedServices Database Updated Behavior](#202406-sharedservices-database-updated-behavior) ## Use IAC To Create an External PostgreSQL Database Cluster @@ -55,3 +56,11 @@ The final step in the [PostgreSQL Data Transfer Guide](https://documentation.sas 4. Going back to the [PostgreSQL Data Transfer Guide](https://documentation.sas.com/?cdcId=itopscdc&cdcVersion=default&docsetId=pgdatamig&docsetTarget=titlepage.htm) under "Post-transfer Steps for Crunchy Data 4" perform Step 8 and start the operator if your deployment is managed by the SAS Deployment Operator (if `V4_DEPLOYMENT_OPERATOR_ENABLED` was set to true in your `ansible-vars.yaml` file). Otherwise, skip this step. 5. Run the ansible-playbook again with the `viya,install` tags. This updates the `kustomization.yaml` by removing entries related to Crunchy Data 4 and adding entries for your external PostgreSQL cluster. The manifest will be rebuilt and reapplied to the cluster. This replaces step 9 from the "Post-transfer Steps for Crunchy Data 4" documentation. 6. Return to the [PostgreSQL Data Transfer Guide](https://documentation.sas.com/?cdcId=itopscdc&cdcVersion=default&docsetId=pgdatamig&docsetTarget=titlepage.htm) under "Post-transfer Steps for Crunchy Data 4". Perform Steps 10 and the remainder of the steps to complete the data transfer. + + +## 2024.06 SharedServices Database Updated Behavior +Due to changes in the sas-data-server-operator, the SharedServices database is not created automatically during the initial deployment of the SAS Viya platform. Instead, you must manually create it before you start the SAS Viya platform deployment + +Deployments performed on cadence versions before 2024.06 will not be impacted. + +For more information, please refer to the [External Postgres Requirements](https://documentation.sas.com/?cdcId=itopscdc&cdcVersion=default&docsetId=itopssr&docsetTarget=p05lfgkwib3zxbn1t6nyihexp12n.htm#p1wq8ouke3c6ixn1la636df9oa1u) documentation. \ No newline at end of file From d22da9f26f58ec82e25df7f5d994e546aa53e4c2 Mon Sep 17 00:00:00 2001 From: chjmil Date: Mon, 12 Aug 2024 17:19:07 -0400 Subject: [PATCH 2/3] docs: Adding troubleshooting section --- docs/Troubleshooting.md | 43 ++++++++++++++++++++++++++++++++++++----- 1 file changed, 38 insertions(+), 5 deletions(-) diff --git a/docs/Troubleshooting.md b/docs/Troubleshooting.md index f7ea7e8d..41e812ad 100644 --- a/docs/Troubleshooting.md +++ b/docs/Troubleshooting.md @@ -402,16 +402,49 @@ Based on this [Network Load Balancing documentation](https://docs.aws.amazon.com 3. When the `baseline,install` ansible tasks are run and `ingress-nginx` is installed, the EC2 Load Balancer that gets provisioned by AWS will have those tags you specified. -## sas-data-server-operator failure +## Deploying with cadence versions > 2024.06 without creating the external PostgreSQL SharedServices database ### Symptom -```yaml -pod logs go here +While deploying with a cadence version >= 2024.06 AND: + +* you are targeting an IaC-provisioned cluster with an External PostgreSQL Database Server +* you didn't create the SharedServices database prior to running viya4-deployment + +most pods will fail to initialize. The following error message can be found in the sas-data-server-operator pod: + +```bash +$ kubectl logs deployment/sas-data-server-operator +{ + "level":"error", + "source":"sas-data-server-operator-65c874585-xwzgr", + "messageParameters":{ + "p1":"failed to connect to `host=example-default-flexpsql.postgres.database.azure.com user=pgadmin database=SharedServices`: server error (FATAL: database \"SharedServices\" does not exist (SQLSTATE 3D000))" + }, + "messageKey":"failed to initialize database, got error %v", + "message":"failed to initialize database, got error %v" +} +{ + "level":"error", + "source":"sas-data-server-operator-65c874585-xwzgr", + "messageKey":"Reconciler error", + "properties":{ + "error":"database server is external and cannot connect to the SAS database", + "caller":"logr/logr.go:49" + }, + "attributes":{ + "DataServer":{ + "name":"sas-platform-postgres", + "namespace":"deploy" + }, + }, + "message":"Reconciler error" +} ``` ### Solution -Please refer to [this section](https://github.com/sassoftware/viya4-deployment/blob/main/docs/user/PostgreSQL.md##202406-sharedservices-database-updated-behavior -) in the PostgreSQL.md documentation +Due to changes in the sas-data-server-operator, the SharedServices database is not created automatically during the initial deployment of the SAS Viya platform. Instead, you must manually create it before you start the SAS Viya platform deployment + +For more information, please refer to the [External Postgres Requirements](https://documentation.sas.com/?cdcId=itopscdc&cdcVersion=default&docsetId=itopssr&docsetTarget=p05lfgkwib3zxbn1t6nyihexp12n.htm#p1wq8ouke3c6ixn1la636df9oa1u) documentation. From a6bd30f4d292bb1f82568381e633220ea0000416 Mon Sep 17 00:00:00 2001 From: chjmil Date: Mon, 12 Aug 2024 17:21:09 -0400 Subject: [PATCH 3/3] docs: Adding ToC link --- docs/Troubleshooting.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/Troubleshooting.md b/docs/Troubleshooting.md index 41e812ad..49584062 100644 --- a/docs/Troubleshooting.md +++ b/docs/Troubleshooting.md @@ -12,6 +12,7 @@ - [Deploying with the SAS Orchestration Tool using a Provider Based Kubernetes Configuration File](#deploying-with-the-sas-orchestration-tool-using-a-provider-based-kubernetes-configuration-file) - [Applying a New License for your SAS Viya Platform Deployment](#applying-a-new-license-for-your-sas-viya-platform-deployment) - [Tagging the AWS EC2 Load Balancers](#tagging-the-aws-ec2-load-balancers) + - [Deploying with cadence versions > 2024.06 without creating the external PostgreSQL SharedServices database](#deploying-with-cadence-versions--202406-without-creating-the-external-postgresql-sharedservices-database) ## Debug Mode Debug mode can be enabled by adding "-vvv" to the end of the docker or ansible commands