Skip to content

Commit

Permalink
docs: Adding troubleshooting section
Browse files Browse the repository at this point in the history
  • Loading branch information
saschjmil committed Aug 12, 2024
1 parent 24f24e1 commit d22da9f
Showing 1 changed file with 38 additions and 5 deletions.
43 changes: 38 additions & 5 deletions docs/Troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

0 comments on commit d22da9f

Please sign in to comment.