From d22da9f26f58ec82e25df7f5d994e546aa53e4c2 Mon Sep 17 00:00:00 2001
From: chjmil <christopher.miller@sas.com>
Date: Mon, 12 Aug 2024 17:19:07 -0400
Subject: [PATCH] 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.