Salta ai contenuti
XIQUIL Wiki

Backup, licenza e processi pianificati

La pagina Amministrazione centralizza tre aree critiche per il funzionamento della tua istanza: backup del database, licenza attiva e processi pianificati (cron interni). Accessibile solo agli utenti admin.

A cosa serve

Sezione intitolata “A cosa serve”
  • Configurare backup automatici del database con retention GFS (giornaliera/settimanale/mensile/annuale)
  • Attivare/sostituire la licenza (community, starter, pro, business)
  • Monitorare i cron interni (backup, rinnovo certificato, pulizia import, validazione licenza)
  • Configurare SMTP per invio email (reset password, notifiche)
  • Rate limiting globale

Come si usa — Backup

Sezione intitolata “Come si usa — Backup”
  1. Apri Amministrazione → Backup
  2. Verifica lo stato del job (ultimo backup, durata, successo/errore)
  3. Configura la retention:
    • Giornalieri (default 7)
    • Settimanali (default 4)
    • Mensili (default 12)
    • Annuali (default 5)
  4. Opzionalmente abilita password (cifratura AES-256-GCM) e skip if unchanged
  5. Scarica un backup esistente o ripristinane uno (attenzione: sovrascrive il database corrente)
  6. “Importa da file esterno” consente di caricare un file .dump / .dump.enc da un backup precedente

Sezione Sessioni e Sicurezza nella pagina Impostazioni Avanzate Sezione Sessioni e Sicurezza: configurazione autenticazione, TOTP obbligatorio e pulizia notturna sessioni.

Come si usa — Licenza

Sezione intitolata “Come si usa — Licenza”
  1. Apri Amministrazione → Licenza
  2. Senza licenza sei in tier community: tutte le feature base funzionano, ma non puoi installare plugin o avere più utenti attivi
  3. Inserisci una activation key (formato XQ-TIER-XXXXXXXX-XXXXXXXX) ricevuta dall’Hub
  4. XIQUIL contatta l’Hub, scambia la key con un JWT firmato, lo salva localmente e lo refresha ogni giorno
  5. Con una licenza attiva hai tre azioni:
    • Aggiorna licenza: riscarica dall’Hub i valori aggiornati (utenti, scadenza, feature)
    • Cambia licenza: inserisci una nuova activation key. Verso un piano uguale o superiore la sostituzione è immediata. Verso un piano inferiore (downgrade) appare una finestra di conferma che elenca le conseguenze: confermando, il cambio è atomico (nessun passaggio intermedio da community)
    • Rimuovi licenza: torni al tier community. Appare una finestra di conferma con tutte le conseguenze

Limiti numerici dei piani

Sezione intitolata “Limiti numerici dei piani”
PianoUtenti extra attiviAdmin extraPlugin Pro
Community00No
Starter00No
Pro31Si
Business103Si

L’amministratore principale non conta nei limiti. Ad esempio, con Business puoi avere 10 utenti non primari attivi, di cui al massimo 3 amministratori extra; con Starter resti al solo amministratore principale.

Conseguenze di rimozione o downgrade

Sezione intitolata “Conseguenze di rimozione o downgrade”

Rimuovere o degradare la licenza è immediato e comporta:

  • Le funzioni e i plugin del piano superiore vengono disattivati (con la rimozione torni a community: Obiettivi limitati a 3, Patrimonio disattivato, Previsione a 3 mesi, ecc.)
  • Gli utenti non primari in eccesso vengono disattivati e gli amministratori aggiuntivi retrocessi per rientrare nei limiti del nuovo piano; l’amministratore principale resta sempre attivo. Gli utenti impattati ricevono una notifica
  • I tuoi dati non vengono eliminati: cambiano solo limiti e viste premium
  • La licenza non viene cancellata dal sistema, ma per riattivarla dovrai reinserire la activation key (serve connessione all’Hub)

Gli amministratori ricevono una notifica e l’evento è registrato nei log di sistema.

Come si usa — Processi pianificati

Sezione intitolata “Come si usa — Processi pianificati”

I cron interni vengono mostrati come card collassabili. Per ciascun job puoi:

  • Vedere lo stato (ultima esecuzione, prossima, successo/errore)
  • Cambiare la frequenza (cron expression)
  • Eseguire manualmente
  • Attivare/disattivare

I job principali: backup database, rinnovo certificato TLS, pulizia import vecchi, validazione licenza online, cleanup sessioni notturne, snapshot patrimonio.

Sezione Backup Database nella pagina Impostazioni Avanzate con i parametri di retention Configurazione backup database: retention GFS a quattro livelli con opzione cifratura AES-256-GCM.

Concetti chiave

Sezione intitolata “Concetti chiave”
  • Retention GFS: Grandfather-Father-Son — combina backup di diverse granularità (giornaliero-settimanale-mensile-annuale) minimizzando lo spazio
  • Restore atomico: durante il ripristino l’app è momentaneamente inaccessibile; al termine invita al reload
  • Licenza offline: una volta attivata, XIQUIL funziona anche senza connessione all’Hub per il periodo di grace (default 7 giorni)

Vedi anche

Sezione intitolata “Vedi anche”