Ridge Dépannage
Diagnostiquez depuis la frontière la plus externe vers l'intérieur : service, transport, session, catalogue, SQL, transaction, puis stockage. Conservez la première erreur structurée et SQLSTATE.
Le service n'est pas disponible
systemctl status ridged.service
pg_isready -h 127.0.0.1 -p 7898 -d ridge
Confirmez le port configuré, le préfixe de données, les autorisations, les bibliothèques d'exécution, les fichiers TLS et que l'écouteur reste en bouclage. Exécutez ridged --check avant de démarrer un binaire packagé.
Le démarrage ou la négociation TLS échoue
Vérifiez que le certificat et la clé sont configurés, lisibles uniquement par l'identité du service et correspondent. Ridge l'authentification par mot de passe n'est acceptée que dans sa configuration TLS chemin. Vérifier le client TLS mode et évitez de supposer PostgreSQL Mappage SCRAM ou certificat-utilisateur.
SQL est rejeté
Utilisez le message structuré et SQLSTATE. Vérifiez :
- une instruction limitée ou un mode d'exécution pris en charge ;
- identifiants minuscules sans guillemets ;
- l'exact SQL des formes dans
grove/libs/ridge_sql/README.md; - Ridge
SHOWintrospection au lieu de PostgreSQL catalogues; - types de paramètres et limites de résultats ;
- état de la transaction après une erreur antérieure.
Une réponse explicite non prise en charge ne constitue pas une preuve de corruption du stockage.
Une écriture déconnectée
Ne le rejouez pas. Le serveur a peut-être validé avant la perte de la réponse. Reconnectez-vous, inspectez la cible par sa clé primaire ou d'idempotence et décidez de la prochaine action à partir de l'état observé. Ridge Admin étiquette ce résultat uncertain.
Conflit de verrouillage ou de sérialisation
SQLSTATE 55P03 indique un conflit de verrou limité. Des conflits de transactions peuvent également survenir en raison d'une validation de tête attendue ou de clé unique. Annulez la transaction ayant échoué, actualisez l'état et réessayez uniquement lorsque le fonctionnement de l'application est sûr et limité.
Ridge Admin n'a pas de local Ridge
Confirmez que le binaire contract-3 actuel est en cours d'exécution, que son magasin de profils est accessible en écriture avec le mode 0600 et que ridged accepte les connexions sur 127.0.0.1:7898. Redémarrez Ridge Admin après avoir remplacé le binaire ; les jetons de lancement et les sessions sont intentionnellement invalidés au redémarrage.
Dommages possibles lors du stockage
Arrêtez les mutations, conservez les journaux et les chemins exacts, vérifiez l'espace disque disponible et exécutez la vérification integrity/backup prise en charge. Restaurez vers une nouvelle cible et validez-la avant le basculement. Ne réparez jamais les fichiers B+Tree, WAL, de catalogue, d'index ou de version avec un éditeur de fichiers général.