Initial Oracle Deep Data Security lab kit

docs/troubleshooting.md

@@ -0,0 +1,38 @@
+# Troubleshooting
+
+## Terraform Plan Falha Por Autenticação
+
+Verifique:
+
+- OCIDs corretos.
+- Região correta.
+- Fingerprint da API key.
+- Caminho da chave privada.
+- Permissões IAM para criar recursos.
+
+## Autonomous Database Não Aceita Versão Informada
+
+Remova ou ajuste `adb_db_version` em `terraform.tfvars`. A disponibilidade de versão depende da região, tenancy e serviço. Para um lab real de Deep Data Security, use uma versão compatível com Oracle AI Database 26ai.
+
+## Banco Não É Acessível
+
+Verifique:
+
+- Cliente dentro da VCN ou conectado por VPN/FastConnect/bastion.
+- NSG permitindo porta `1522`.
+- Wallet e mTLS configurados.
+- DNS do private endpoint resolvendo corretamente.
+
+## Cenário SQL Falha
+
+Verifique:
+
+- Versão do banco compatível com Deep Data Security.
+- Usuário executor com privilégio para criar schema, end users, data roles e data grants.
+- Ordem dos scripts SQL.
+- Se o cenário anterior foi resetado.
+
+## Reset Não Remove Tudo
+
+Execute o `sql/99_reset.sql` do cenário e valide manualmente objetos remanescentes. Em ambiente compartilhado, confirme antes de dropar schemas.
+