Backup e ripristino (Pacchetto)

Zammad include script nelle installazioni tramite pacchetto per backup e ripristino che puoi usare.

WARNING

Questi script non sono coperti da alcuna garanzia e potrebbero non funzionare nel tuo specifico caso d'uso.

Ci sono alcune limitazioni che dovresti conoscere:

• Questi script non funzioneranno nelle installazioni basate su container.
• Funzionano solo per installazioni PostgreSQL.
• Il backup è sempre un dump completo (nessun backup incrementale).
• Il backup e ripristino parziale (ad esempio solo dati specifici come ticket, utenti) non è possibile.
• Cambiare sistema database non è possibile.
• Le impostazioni di sistema (come le variabili d'ambiente) non vengono salvate nel backup.
• Il ripristino su una versione Zammad precedente non è possibile.
• Non ripristinare file di backup da script personalizzati con gli script forniti da Zammad. Questo.

Nozioni di base

Gli script si trovano in /opt/zammad/contrib/backup. I seguenti file sono rilevanti:

• File di configurazione backup: config.dist
• Script per il backup dei tuoi dati: zammad_backup.sh
• Script per il ripristino dei tuoi dati: zammad_restore.sh

Per eseguire un backup basato sulla configurazione predefinita, segui i passaggi seguenti:

1. Copia il file config.dist in config.
2. Change default parameters in the config file if needed. See Backup Configuration for details.
3. Ferma Zammad systemctl stop zammad
4. Esegui /opt/zammad/contrib/backup/zammad_backup.sh (come utente root o zammad)

Configurazione backup

Puoi trovare dettagli sui parametri di configurazione con valori predefiniti di seguito.

BACKUP_DIR /var/tmp/zammad_backup

Posizione dove lo script.

HOLD_DAYS 10

Definisce per quanti giorni lo script di backup dovrebbe.

Esempi:

• 1 manterrà i backup delle ultime 25 ore
• -1 rimuoverà tutti i backup disponibili.

FULL_FS_DUMP yes

• yes: il backup include anche l'applicazione.

In ogni caso, include il database Zammad e gli allegati, se li hai memorizzati.

DEBUG no

Impostare questa opzione su yes produrrà output di debug utili.

WARNING

Questa opzione potrebbe restituire informazioni sensibili sull'output standard! Non usarla.

Ripristina backup

Informazioni Importanti

Leggi attentamente le seguenti informazioni prima di iniziare a ripristinare i tuoi dati.

• This section is not about migrating from one host to another. You can find instructions about this topic on the Migrate Zammad page.
• Questa guida si aspetta una versione di Zammad completamente installata
• Si aspetta anche che tu ripristini Zammad sullo stesso host e versione Zammad
• Il processo di ripristino ferma e riavvia Zammad. Pertanto devi eseguire lo script di ripristino.
• Le installazioni basate su PostgreSQL elimineranno e ricreeranno il database!
• È richiesto almeno il doppio della dimensione dell'istanza Zammad sottoposta a backup di spazio libero.

TIP

If your scenario is different as described above, please consult the Zammad Community or consider paid support options.

Copia i file di backup in una posizione adatta

Assicurati che l'utente che stai usando per il ripristino sia autorizzato a leggere i file di backup e.

Il backup di Zammad consiste in due file. Sono denominati così:

<timestamp>_zammad_db.psql.gz
<timestamp>_zammad_files.tar.gz

Ci sono anche due collegamenti simbolici nella tua cartella di backup che puntano al backup più recente creato.

latest_zammad_db.psql.gz
latest_zammad_files.tar.gz

Copiali in una posizione adatta accessibile per l'utente che esegue il ripristino.

Configura lo script di backup

For a new installation, this is required. At least you have to provide a directory where your backups are stored. See Backup Configuration for more information.

Pulisci la cartella di archiviazione

Nel caso tu ripristini su un ambiente di produzione con archiviazione filesystem attivata, dovresti.

Esegui il ripristino

Tieni presente che il ripristino dei backup può sovrascrivere il tuo database.yml. Puoi verificarlo.

Il ripristino funziona in due modi possibili, a seconda di quanto vuoi essere interattivo:

Esegui lo script:

/opt/zammad/contrib/backup/z

:::warning
Usa l'opzione seguente solo se sai cosa stai facendo! Il comando
seguente sovrascriverà.
:::
Se chiamato con un argomento timestamp (corrispondente al nome file del backup),
Zammad procederà.

Il risultato dovrebbe assomigliare a questo:

# Zammad restore started - Fri Jan 21 17:54:13 CET 2022!

Il ripristino eliminerà il tuo attuale.

Passaggi aggiuntivi

• Se hai impostato impostazioni ambientali, riapplicale ora.
• Se non già fatto, installa Elasticsearch ora.
• Connect Elasticsearch with Zammad and rebuild its search index. The rebuild can safely run during your work, but will cause a degraded search performance and may lead to temporarily not found data.

Risoluzione problemi backup e ripristino

You can find some common problems below. If your issue is not listed, feel free to consult the Zammad Community for technical assistance.

Codici di uscita

I nostri script di backup e ripristino includono codici di uscita per aiutarti a trovare una soluzione.

Oltre ai codici di uscita, ci sono anche messaggi di errore restituiti allo standard output.

| Codice | Descrizione / Situazione

Problemi comuni

Autenticazione password fallita / Autenticazione peer fallita

Questo indica che la password del tuo utente database Zammad è diversa dal tuo `dat

Se la tua istanza Zammad è in esecuzione, può essere causata da un fallback alla connessione socket.

Cosa fare?

Assicurati che le credenziali utente fornite siano corrette. Puoi anche considerare di usare `r

Autenticazione ident fallita per l'utente

Questo indica che il tuo server database richiede l'autenticazione ident. Quel tipo di autenticazione.

Cosa fare?

Controlla il pg_hba.conf del tuo server PostgreSQL e regolalo se necessario.

Solitamente, l'autenticazione può essere consentita così:

# QUESTO È UN ESEMPIO E POTREBBE NON ADATTARSI AL TUO AMBIENTE
host    all             all

Please consult the official PostgreSQL documentation for this, as this is out of our documentation scope.

AVVISO: Sembra che tu non abbia allegati nel filesystem

Questo indica che la tua istanza attualmente non salva gli allegati nel filesystem.

Questo avviso verrà mostrato una volta prima di creare una cartella vuota per permettere al processo di backup.

Check and adjust your storage settings via console or in Zammad's admin interface under Settings > System > Storage.

Script di aiuto

Avviso

Uno script può potenzialmente essere distruttivo! Non dovresti mai eseguire script di cui non conosci l'ambito.

Tieni presente che esegui questi script a tuo rischio.

Aiuto database: (Re)imposta password

Limitazioni

• Questo script funziona solo per installazioni PostgreSQL.
• Sono supportati solo server database locali (lo script cambia utente).
• Questo script richiede di essere eseguito come root o utente con privilegi simili.
• Tieni presente che lo script fermerà e avvierà automaticamente Zammad!

Ambiti

L'ambito di questo script sono principalmente le installazioni tramite pacchetto, specialmente CentOS e SUSE.

Funzionalità

Lo script eseguirà automaticamente le seguenti azioni per te, a seconda della situazione.

• Se database.yml contiene una riga password vuota, verrà generata e impostata una nuova password.
• Se database.yml contiene una password, verrà usata per impostare la password dell'utente database Zammad.

Utilizzo

Esegui lo script con il comando seguente e segui le istruzioni. Non è richiesta nessuna configurazione specifica.

/opt/zammad/contrib/backup/zammad_db_user_helper.sh

Se si verificano errori, lo script proverà a riportare Zammad online prima di uscire.