Fehlerbehebung bei der Clustererstellung

Wählen Sie eine Dokumentationsversion aus:

Auf dieser Seite wird beschrieben, wie Sie Probleme mit AlloyDB Omni mithilfe des RPM-Orchestrators beheben.

Fehler bei der Clustererstellung

In diesem Abschnitt werden Fehler bei der Clustererstellung aufgeführt, die auftreten können, und es wird erklärt, wie Sie diese beheben.

Installation schlägt fehl, weil die Rechteausweitung nicht aktiviert ist

Das folgende Problem tritt auf, wenn die Variable ansible_user in Ihrem Installations-Playbook einen Nicht-Root-Nutzer angibt und die Ausführung keine Berechtigungserweiterung aktiviert:

This command has to be run under the root user.

Dieses Problem tritt auf, weil die Rolle google.alloydbomni_orchestrator.install Pakete mit dem Paketmanager dnf installiert, der Root-Berechtigungen erfordert.

So beheben Sie das Problem:

  1. Fügen Sie in Ihrem Playbook become: true auf Ausführungsebene hinzu, wie unter AlloyDB Omni-Komponenten mit Ansible installieren beschrieben.
  2. Prüfen Sie, ob der Nutzer in der Variablen ansible_user sudo auf jedem Knoten im Inventar ausführen kann.
  3. Führen Sie das Playbook noch einmal aus:

    ansible-playbook -i deployment_spec.yaml install.yaml

Prüfen Sie, ob das Problem behoben ist, indem Sie prüfen, ob für die Aufgabe Install SELinux python utilities der Status ok oder changed gemeldet wird und ob in der Zusammenfassung der Ausführung für jeden Host failed=0 angezeigt wird.

Bootstrap schlägt fehl, weil das Datenverzeichnis auf den Datenbankknoten nicht vorhanden ist

Das folgende Problem tritt auf, wenn für alle Datenbank knoten ein Timeout für das Bootstrap-Playbook mit der Meldung Timeout when waiting for DB_NODE_1:5432 auftritt und im Node Manager-Log ein Fehler im Zusammenhang mit einem fehlenden Datenverzeichnis angezeigt wird.

So ermitteln Sie das fehlende Verzeichnis:

  1. Prüfen Sie das Knotenmanager-Protokoll mit journalctl:

    sudo journalctl -u alloydbomni_node_manager
  2. Suchen Sie in der Ausgabe nach einer Meldung wie der folgenden:

    service "dbprocess": root data directory does not exist: PG_DATA_DIR
    

Diese Meldungen enthalten die folgenden Werte:

  • DB_NODE_1: die IP-Adresse oder der voll qualifizierte Domainname (FQDN) eines Datenbankknotens.
  • PG_DATA_DIR: der Hostpfad zum Verzeichnis, in dem die Datenbankdaten gespeichert sind.

Dieses Problem tritt auf, weil PG_DATA_DIR nicht auf jedem Datenbankknoten vorhanden ist. Der Orchestrator erwartet, dass das Verzeichnis vor dem Bootstrap vorhanden ist.

So beheben Sie das Problem:

  1. Erstellen Sie auf jedem Datenbankknoten PG_DATA_DIR und stellen Sie das externe Volume darin bereit. Weitere Informationen finden Sie unter Cluster erstellen.
  2. Konfigurieren Sie die Bereitstellung so, dass sie auch nach Neustarts bestehen bleibt.
  3. Führen Sie das Bootstrap-Playbook noch einmal aus.

Führen Sie den folgenden Befehl aus, um zu prüfen, ob das Problem behoben ist:

alloydbctl get -d deployment_spec.yaml -t DBCluster -n CLUSTER_NAME -o yaml

Ersetzen Sie CLUSTER_NAME durch den Namen Ihres Datenbankclusters.

In der Ausgabe wird die DatabaseReady Bedingung mit status: "True" angezeigt.

Bootstrap schlägt fehl, weil die Parameterwerte von DBCluster nicht in Anführungszeichen gesetzt sind

Das folgende Problem tritt auf, wenn der Abschnitt parameters Ihrer DBCluster-Spezifikation numerische Werte ohne Anführungszeichen enthält und Sie das Playbook ausführen, das die Rolle google.alloydbomni_orchestrator.bootstrap aufruft:

invalid parameters in DBCluster resource specification: json: cannot unmarshal number into Go struct field AlInstanceSpec.primarySpec.InstanceSpec.parameters of type string

Dieses Problem tritt auf, weil jeder Eintrag im Feld parameters ein Schlüssel-Wert String-Paar ist, wie unter DBCluster Custom Resource Definition beschrieben.

So beheben Sie das Problem:

  1. Setzen Sie jeden Wert im Feld spec.primarySpec.parameters in Anführungszeichen, wie unter Clusterspezifikationen vorbereiten beschrieben:

    DBCluster:
      spec:
        primarySpec:
          parameters:
            max_connections: "100"
            max_wal_size: "2GB"
    
  2. Führen Sie das Bootstrap-Playbook noch einmal aus.

Führen Sie den folgenden Befehl aus, um zu prüfen, ob das Problem behoben ist:

alloydbctl get -d deployment_spec.yaml -t DBCluster -n CLUSTER_NAME -o yaml

Ersetzen Sie CLUSTER_NAME durch den Namen Ihres Datenbankclusters.

In der Ausgabe wird die DatabaseReady Bedingung mit status: "True" angezeigt.