

Questa guida fornisce la documentazione per Wickr Enterprise. Se utilizzi AWS Wickr, consulta AWS Wickr Administration [Guide o [AWS](https://docs.aws.amazon.com/wickr/latest/userguide/what-is-wickr.html) Wickr User Guide](https://docs.aws.amazon.com/wickr/latest/adminguide/what-is-wickr.html).

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Risoluzione dei problemi relativi alle installazioni dei cluster integrati in Wickr
<a name="troubleshooting-installation"></a>

Tutte le istanze di queste procedure di risoluzione dei problemi presuppongono che tu abbia accesso tramite shell all'istanza che esegue l'installazione di Wickr Embedded Cluster e che tu abbia eseguito il `./wickr-enterprise-ha shell` comando per poter interagire direttamente con l'installazione di Kubernetes.

## Problemi generali
<a name="general-issues"></a>

**Il pulsante Aggiungi nodo non è presente nella schermata di gestione del cluster**

***Installazioni Airgapped***

Se stai utilizzando un'installazione airgap, contatta il supporto di Wickr per ricevere assistenza nella correzione di questo comportamento.

***Installazioni standard***

Se la licenza include l'autorizzazione Embedded Cluster Multi-Node, esegui una sincronizzazione della licenza per ottenere la versione più recente. Se non sei sicuro o non hai questo diritto, contatta Wickr Support.

Per eseguire una sincronizzazione della licenza, completa i seguenti passaggi.

1. Vai al pannello di controllo KOTS.

1. Nella pagina **Dashboard**, individua la sezione della licenza nell'area in alto a destra della pagina. 

1. All'interno di questa sezione, nell'angolo in alto a destra, dovresti vedere un collegamento ipertestuale **Sync License**. Seleziona il collegamento ipertestuale.

1. Una volta sincronizzata la licenza, viene visualizzata l'interfaccia utente aggiornata e viene visualizzata **l'ultima sincronizzazione di pochi secondi fa.**

1. Scegli **Redeploy** dalla sezione **Versione** della pagina del pannello di controllo di KOTS.

1. Al termine della ridistribuzione, torna alla **gestione del cluster** e puoi aggiungere nodi.

## Problemi di aggiornamento
<a name="upgrade-issues"></a>

**Aggiornamento bloccato durante l'aggiornamento del cluster**

Se l'aggiornamento si blocca su **Upgrading Cluster**, probabilmente significa che alcuni pod non vengono terminati correttamente. Accedi all'istanza e usa il `./wickr-enteprise-ha shell` comando per accedere all'ambiente shell per la gestione dell'installazione di Kubernetes.

1. Identifica i pod ancora in esecuzione:

   `kubectl -n kotsadm get pods | grep Running`

1. `kubectl -n kotsadm delete pod name-of-running-pod`
**Nota**  
Se uno dei running pod è `embedded-cluster-upgrade-XXXXXXXXXXXXXX-xxxxx` `kotsadm-xxxxxxx` o è simile, non eliminatelo perché questi pod sono necessari per eseguire l'aggiornamento.

1. Verifica che non ci siano running pod rimanenti.

   `kubectl -n kotsadm get pods | grep Running`

Questa procedura dovrebbe consentire all'aggiornamento del cluster di procedere con l'aggiornamento di Wickr.

**L'applicazione non è stata aggiornata durante l'aggiornamento del cluster e non può distribuire una nuova versione**

Se l'applicazione rimane sulla vecchia versione dopo l'aggiornamento, la nuova versione potrebbe trovarsi in uno stato incoerente.

Controlla i record di installazione di Kubernetes:

1. Apri la shell Kubernetes dal programma di installazione.

   `./wickr-enterprise-ha shell`

1. Esegui il seguente comando kubectl:

   `kubectl get installations`

1. L'output sarà simile a questo:

   ```
         [root@ip-172-31-6-72 ~]# kubectl get installations
   NAME             STATE      INSTALLERVERSION   CREATEDAT              AGE
   20251113170603   Obsolete   2.1.3+k8s-1.30     2025-11-13T17:06:05Z   22h
   20251113180133   Failed     2.6.0+k8s-1.31     2025-11-13T18:01:37Z   21h
   ```

1. Eliminare l'installazione non riuscita.

   `kubectl delete installation 20251113180133`

1. Tenta di eseguire nuovamente l'aggiornamento tramite il pannello di amministrazione di KOTS.

**Errore del pod RabbitMQ con righe di registro `Error while waiting for Mnesia tables: {timeout_waiting_for_tables}`**

Il segreto e lo spazio di archiviazione di RabbitMQ non sono sincronizzati. Questo di solito accade quando vengono eseguite più istanze di RabbitMQ e causano un errore di selezione del leader o del quorum. Per risolvere questo problema, elimina il servizio RabbitMQ e i relativi volumi di archiviazione, quindi ridistribuiscilo.

Per eliminare il RabbitMQ non funzionante, completa i seguenti passaggi.

1. Eliminare il set di stato di RabbitMQ.

   `kubectl -n kotsadm delete statefulset rabbitmq —cascade=orphan`

1. Elimina i pod RabbitMQ rimanenti. Se ci sono più pod RabbitMQ-X in esecuzione, esegui questo comando più volte aggiornando il valore di RabbitMQ-x in modo che corrisponda ai nomi dei pod aggiuntivi.

   `kubectl -n kotsadm delete pod rabbitmq-0`

1. Eliminare il corrispondente. PVCs Se ci sono più pod in esecuzione, esegui questo comando più volte aggiornando il file in data-RabbitMQ-X modo che corrisponda ai pod appropriati.

   `kubectl -n kotsadm delete pvc data-rabbitmq-0`

1. Controlla se ci sono dei pod rimanenti, in caso di successo non dovrebbe generare alcun risultato.

   `kubectl -n kotsadm get pods|grep -i rabbitmq`

1. Controlla se ce ne sono ancora PVCs, in caso di successo non dovrebbe produrre nulla.

   `kubectl -n kotsadm get pvc|grep -i rabbitmq`

1. Ridistribuisci tramite il pannello di amministrazione di KOTS.

[Per ulteriori informazioni sulla risoluzione dei problemi, vedi Risoluzione dei problemi.](https://docs.aws.amazon.com/wickr/latest/wickrenterpriseinstall/troubleshooting.html)