mirror of
https://github.com/gravitational/teleport.git
synced 2026-09-24 16:17:11 +08:00
Add AWS troubleshooting page and add into applicable pages (#15515)
This commit is contained in:
@@ -217,6 +217,10 @@ Finally, connect to the database:
|
||||
$ tsh db connect --db-user=alice --db-name postgres aurora
|
||||
```
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
(!docs/pages/includes/database-access/aws-troubleshooting.mdx!)
|
||||
|
||||
## Next Steps
|
||||
|
||||
For the next steps, dive deeper into the topics relevant to your Database
|
||||
|
||||
@@ -162,6 +162,10 @@ To log out of the database and remove credentials:
|
||||
$ tsh db logout my-redshift
|
||||
```
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
(!docs/pages/includes/database-access/aws-troubleshooting.mdx!)
|
||||
|
||||
## Next steps
|
||||
|
||||
- Learn more about [using IAM authentication to generate database user
|
||||
|
||||
@@ -211,6 +211,10 @@ To log out of the database and remove credentials:
|
||||
$ tsh db logout postgres-rds
|
||||
```
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
(!docs/pages/includes/database-access/aws-troubleshooting.mdx!)
|
||||
|
||||
## Next steps
|
||||
|
||||
(!docs/pages/includes/database-access/guides-next-steps.mdx!)
|
||||
|
||||
@@ -225,6 +225,10 @@ $ tsh db logout my-elasticache
|
||||
$ tsh db logout
|
||||
```
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
(!docs/pages/includes/database-access/aws-troubleshooting.mdx!)
|
||||
|
||||
## Next steps
|
||||
|
||||
(!docs/pages/includes/database-access/guides-next-steps.mdx!)
|
||||
|
||||
@@ -0,0 +1,26 @@
|
||||
### Certificate error
|
||||
|
||||
If your `tsh db connect` error includes the following text, you likely have an RDS database created before July 28, 2020, which presents an X.509 certificate that is incompatible with Teleport:
|
||||
|
||||
```code
|
||||
x509: certificate relies on legacy Common Name field, use SANs instead
|
||||
```
|
||||
|
||||
AWS provides instructions to rotate your [SSL/TLS certificate](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL-certificate-rotation.html).
|
||||
|
||||
### No credential providers error
|
||||
|
||||
If you see the error ` NoCredentialProviders: no valid providers in chain` in Database Service logs then Teleport
|
||||
is not detecting the required credentials to connect via AWS IAM permissions. Check whether
|
||||
the credentials or security role has been applied in the machine running the Teleport Database Service.
|
||||
|
||||
### Timeout errors
|
||||
|
||||
The Teleport Database Service needs connectivity to your database endpoints. That may require
|
||||
enabling inbound traffic on the database from the Database Service on the same VPC or routing rules from another VPC. Using the `nc`
|
||||
program you can verify connections to databases:
|
||||
|
||||
```code
|
||||
nc -zv postgres-instance-1.sadas.us-east-1.rds.amazonaws.com 5432
|
||||
# Connection to postgres-instance-1.sadas.us-east-1.rds.amazonaws.com (172.31.24.172) 5432 port [tcp/postgresql] succeeded!
|
||||
```
|
||||
Reference in New Issue
Block a user