Risolvere i problemi relativi alla creazione del cluster

Seleziona una versione della documentazione:

Questa pagina mostra come risolvere i problemi relativi ad AlloyDB Omni che utilizza l'orchestratore RPM.

Errori di creazione del cluster

Questa sezione elenca gli errori di creazione del cluster che potresti riscontrare e spiega come risolverli.

L'installazione non riesce perché l'escalation dei privilegi non è abilitata

Il seguente problema si verifica quando la variabile ansible_user nel playbook di installazione specifica un utente non root e il play non abilita l'escalation dei privilegi:

This command has to be run under the root user.

Questo problema si verifica perché il ruolo google.alloydbomni_orchestrator.install installa i pacchetti con il gestore di pacchetti dnf, che richiede i privilegi di root.

Per risolvere il problema, segui questi passaggi:

  1. Nel playbook, aggiungi become: true a livello di play, come mostrato in Installare i componenti di AlloyDB Omni utilizzando Ansible.
  2. Verifica che l'utente nella variabile ansible_user possa eseguire sudo su ogni nodo dell'inventario.
  3. Esegui di nuovo il playbook:

    ansible-playbook -i deployment_spec.yaml install.yaml

Per verificare che il problema sia stato risolto, controlla che l'attività Install SELinux python utilities riporti ok o changed e che il riepilogo del play mostri failed=0 per ogni host.

Il bootstrap non riesce perché la directory dei dati non esiste sui nodi del database

Il seguente problema si verifica quando il playbook di bootstrap va in timeout su tutti i nodi del database con il messaggio Timeout when waiting for DB_NODE_1:5432, e il log di Node Manager mostra un errore relativo a una directory dei dati mancante.

Per identificare la directory mancante:

  1. Utilizza journalctl per controllare il log di Node Manager:

    sudo journalctl -u alloydbomni_node_manager
  2. Controlla l'output per un messaggio simile al seguente:

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

Questi messaggi includono i seguenti valori:

  • DB_NODE_1: l'indirizzo IP o il nome di dominio completo (FQDN) di un nodo del database.
  • PG_DATA_DIR: il percorso host della directory in cui sono archiviati i dati del database.

Questo problema si verifica perché PG_DATA_DIR non esiste su ogni nodo del database. L'orchestratore si aspetta che la directory esista prima del bootstrap.

Per risolvere il problema, segui questi passaggi:

  1. Su ogni nodo del database, crea PG_DATA_DIR e monta il volume esterno. Per saperne di più, consulta Creare un cluster.
  2. Configura il montaggio in modo che persista dopo i riavvii.
  3. Esegui di nuovo il playbook di bootstrap.

Per verificare che il problema sia stato risolto, esegui il seguente comando:

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

Sostituisci CLUSTER_NAME con il nome del cluster di database.

L'output mostra la condizione DatabaseReady con status: "True".

Il bootstrap non riesce perché i valori parametro DBCluster non sono tra virgolette

Il seguente problema si verifica quando la sezione parameters della specifica DBCluster contiene valori numerici senza virgolette ed esegui il playbook che richiama il ruolo google.alloydbomni_orchestrator.bootstrap:

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

Questo problema si verifica perché ogni voce nel campo parameters è una coppia di stringhe chiave-valore, come descritto in Definizione di risorse personalizzate DBCluster.

Per risolvere il problema, segui questi passaggi:

  1. Racchiudi tra virgolette ogni valore nel campo spec.primarySpec.parameters, come mostrato in Preparare le specifiche del cluster:

    DBCluster:
      spec:
        primarySpec:
          parameters:
            max_connections: "100"
            max_wal_size: "2GB"
    
  2. Esegui di nuovo il playbook di bootstrap.

Per verificare che il problema sia stato risolto, esegui il seguente comando:

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

Sostituisci CLUSTER_NAME con il nome del cluster di database.

L'output mostra la condizione DatabaseReady con status: "True".