Vai al contenuto principale

FAQ

Qui sono disponibili le risposte alle domande più comuni sull'esecuzione del server Sync-in e dell'applicazione desktop.

Server​

Perché Sync-in non si avvia in una VM Proxmox con un errore sharp o Unsupported CPU?​

Sintomo. Questo problema può interessare le installazioni Docker eseguite in una macchina virtuale AMD64 ospitata da Proxmox. Il container Sync-in continua a riavviarsi e i relativi log contengono il seguente errore:

Unsupported CPU: Prebuilt binaries for Linux x64 require v2 microarchitecture

Causa. A partire da Sync-in 2.4, i file binari Linux x64 precompilati utilizzati da sharp richiedono una CPU compatibile con x86-64-v2. Un modello di CPU generico configurato in Proxmox potrebbe non rendere disponibile alla macchina virtuale il set di istruzioni richiesto, anche se la CPU fisica lo supporta. Quando il log contiene l'errore riportato sopra, reinstallare sharp all'interno del container non è la soluzione corretta.

Risoluzione. Rendere disponibile alla macchina virtuale un modello di CPU compatibile:

  1. Arrestare la macchina virtuale.
  2. Nell'interfaccia di Proxmox, aprire VM → Hardware → Processori → Modifica.
  3. Impostare Tipo su uno dei seguenti valori:
    • host: consigliato quando la VM rimane sullo stesso host Proxmox. Rende direttamente disponibili le funzionalità della CPU dell'host.
    • x86-64-v2-AES: utilizzare questo profilo di base quando è richiesta la compatibilità con la migrazione in tempo reale. Tutti i possibili nodi di destinazione devono supportare questo modello di CPU.
  4. Riavviare la macchina virtuale. È necessario un riavvio completo della VM affinché il nuovo modello di CPU venga applicato.

Verifica. Dalla directory Docker Compose di Sync-in, avviare i servizi e consultarne i log:

docker compose up -d
docker compose logs

Il container dovrebbe ora avviarsi senza l'errore Unsupported CPU.

avvertenza

Il tipo di CPU host rende disponibili funzionalità specifiche dell'attuale nodo Proxmox e può limitare la migrazione in tempo reale verso nodi che utilizzano processori compatibili. Utilizzare x86-64-v2-AES quando è necessario un profilo CPU comune in tutto il cluster.

Se il problema persiste. Assicurarsi che la VM sia stata arrestata e riavviata completamente, verificare che la modifica della CPU non sia più contrassegnata come in sospeso in Proxmox e confermare che la CPU fisica supporti x86-64-v2.

Applicazione desktop​

Come si avvia l'applicazione desktop in modalità nascosta?​

Utilizzare uno dei seguenti metodi.

Opzione della riga di comando:

./Sync-in-Desktop.exe --hidden

Variabile d'ambiente:

SYNC_IN_HIDDEN=1 ./Sync-in-Desktop-1.2.9-arm64.AppImage

La modalità nascosta può essere abilitata anche nelle impostazioni dell'applicazione.

Come si risolve l'errore Using GTK 2/3 and GTK 4 in the same process is not supported?​

Sintomo. Questo errore può comparire all'avvio dell'applicazione desktop su Linux.

Risoluzione. Riavviare l'applicazione forzando l'uso di GTK 3:

./Sync-in-Desktop.AppImage --gtk-version=3