Een Zimbra CE-mailbox back-uppen en herstellen met behulp van TGZ-exports.

Om een ​​back-up te maken van een Zimbra Community Edition (CE)-mailbox, exporteert u deze als een TGZ-bestand met zmmailbox getRestURL, valideert u het archief en herstelt u het met postRestURL. Wanneer u importeert in een account dat al e-mail bevat, begint u met resolve=skip; het gebruik van resolve=resetin de hoofdmap van de mailbox kan bestaande items verwijderen.

Begrijp welke bescherming een export per mailbox biedt.

Zimbra documenteert de export en import van TGZ-bestanden via de REST-interface en bijbehorende zmmailboxhulpprogramma's. Het archief is bedoeld om de inhoud en mapstructuur van mailboxen te bewaren, inclusief e-mailberichten verpakt als EML-bestanden en relevante agenda-, contact-, taak- of Briefcase-gegevens. Welke inhoud en metadata behouden blijven na een import, hangt af van de bron- en bestemmingsversies en de items die worden overgedragen.

Verwar dit niet met een volledige back-up van een account of server. Een TGZ-contentexport voorziet niet in een ontbrekend account en bewaart niet zelfstandig alle LDAP-attributen, wachtwoorden, aliassen, klasse-van-service-toewijzingen, routeringsinstellingen, filters, machtigingen of serverconfiguratie. Leg alle benodigde accountinstellingen afzonderlijk vast met behulp van beheerprocedures. Het zmbackuphulpprogramma dat in oudere Zimbra-documentatie wordt beschreven, behoort tot Network Edition en niet tot de standaard CE-workflow.

De commandovoorbeelden volgen de gedocumenteerde interfaces van Zimbra, maar ze vormen geen live test van elke onafhankelijk gebouwde CE-release. Raadpleeg de zmcontrol -vbeschikbare zmmailboxhelp en de release-opmerkingen van uw build voordat u een herstel naar een productieomgeving plant. Ga er ook niet van uit dat een live REST-export een perfect consistent moment vastlegt als de gebruiker items wijzigt terwijl deze wordt uitgevoerd. Plan een periode met weinig activiteit in wanneer consistentie belangrijk is.

Exporteer de individuele mailbox

1. Identificeer het account en de bijbehorende e-mailhost.

Maak verbinding met de Zimbra-server met een besturingssysteemaccount met beheerdersrechten. Schakel over naar de Zimbra-servicegebruiker en controleer of het doelaccount bestaat. Zorg er bij een implementatie met meerdere servers voor dat u verbinding maakt met de juiste mailboxservice.

sudo -iu zimbra
zmcontrol -v
zmprov ga user@example.com zimbraMailHost zimbraAccountStatus
zmmailbox -z -m user@example.com getAllFolders

Vervang dit user@example.comdoor het daadwerkelijke account. De -zswitch gebruikt de lokale Zimbra-beheerdersgegevens; dit is niet het wachtwoord van de eindgebruiker. Als u niet over de benodigde beheerdersrechten beschikt, gebruik dan een goedgekeurde workflow voor accounttoegang in plaats van wachtwoorden in een shell-opdracht op te nemen.

2. Maak een privé-archieflocatie aan.

Maak als gebruiker met beheerdersrechten een locatie aan waartoe de Zimbra-servicegebruiker schrijfrechten heeft. Doe dit buiten de openbaar toegankelijke mappen en controleer eerst de beschikbare schijfruimte. Voer de installatieopdracht uit voordat u overschakelt naar zimbrauw beheerdersaccount of terugkeert naar uw account met beheerdersrechten.

sudo install -d -o zimbra -g zimbra -m 0700 /srv/zimbra-mailbox-backups
df -h /srv/zimbra-mailbox-backups
ls -ld /srv/zimbra-mailbox-backups

E-mailarchieven kunnen vertrouwelijke berichten en bijlagen bevatten. Beperk de toegang tot het bestandssysteem, bescherm eventuele kopieën buiten de server en hanteer een passend bewaarbeleid.

3. Exporteer de mailbox als TGZ-bestand.

zimbraGebruik vanuit een shell de onderstaande REST-exporter. Deze -t 0optie schakelt de CLI-time-out voor grote bewerkingen uit; het garandeert echter niet dat proxies, schijf-I/O of serverlimieten de export niet kunnen onderbreken.

umask 077
zmmailbox -z -m user@example.com -t 0 getRestURL '//?fmt=tgz' > /srv/zimbra-mailbox-backups/user-20261010.tgz

Voer per account één export uit en kies een unieke bestandsnaam met datum. Gebruik geen eerder archiefpad opnieuw, omdat shell-omleiding dit pad zal inkorten. Als de opdracht een foutmelding geeft, beschouw het resulterende bestand dan als onvolledig totdat het de onderstaande controles doorstaat.

4. Valideer het archief en noteer de checksum.

Een niet-leeg TGZ-bestand is geen bewijs van een herstelbare back-up. Test de volledige tar-stream, inspecteer representatieve mapvermeldingen en bereken een hash. Een mislukte tar-controle betekent dat u de export moet onderzoeken in plaats van het bestand te importeren.

test -s /srv/zimbra-mailbox-backups/user-20261010.tgz
tar -tzf /srv/zimbra-mailbox-backups/user-20261010.tgz > /dev/null
tar -tzf /srv/zimbra-mailbox-backups/user-20261010.tgz | head -n 20
cd /srv/zimbra-mailbox-backups
sha256sum user-20261010.tgz > user-20261010.tgz.sha256

Bewaar de checksum naast het archiefbestand en verplaats beide naar een beveiligde locatie buiten de oorspronkelijke server. Voer na het kopiëren de opdracht uit sha256sum -c user-20261010.tgz.sha256in de map met de twee bestanden. Een succesvolle checksum bevestigt de integriteit van de bytes, maar niet dat alle mailboxfuncties correct zullen worden hersteld.

Het archief herstellen zonder de live mail te overschrijven.

5. Bereid de bestemmingsmailbox voor en controleer deze.

Maak het doelaccount aan via uw normale, goedgekeurde Zimbra-provisioneringsproces als het nog niet bestaat; de TGZ-import zal het niet aanmaken. Controleer het adres, het quotum, de servicetoegang en de bestaande mappen. Gebruik voor de eerste test een geïsoleerd, niet-productieaccount, met name voor overdrachten tussen verschillende versies.

sudo -iu zimbra
zmprov ga user@example.com zimbraMailHost zimbraAccountStatus
zmmailbox -z -m user@example.com getAllFolders

Kopieer het gevalideerde archief naar een map die leesbaar is voor de Zimbra-gebruiker op de bestemming, met behoud van beperkte machtigingen. Controleer bij een overdracht op afstand de checksum opnieuw op de bestemming. Ga er niet vanuit dat een account met hetzelfde adres leeg is.

6. Importeer met een conflictbeleid dat aansluit bij de bestemming.

Om ontbrekende items toe te voegen terwijl overeenkomende items behouden blijven, gebruikt u resolve=skip. Dit is het gedocumenteerde standaardgedrag voor het afhandelen van duplicaten, maar het is geen garantie voor een perfecte samenvoeging voor elk itemtype of elke versie.

zmmailbox -z -m user@example.com -t 0 postRestURL '//?fmt=tgz&resolve=skip' /srv/zimbra-mailbox-backups/user-20261010.tgz

Vermijd het kopiëren van een destructief voorbeeld naar een productieomgeving. Zimbra documenteert resolve=resetbestemmingsitems vóór import. Het replacebeleid modifywijzigt ook de manier waarop bestaande items worden verwerkt. Overweeg ze alleen voor een gecontroleerd herstel na testen en het verkrijgen van goedkeuring voor de exacte account- en mapomvang.

Verwerk exportfouten en controleer het herstel.

Als u een time-out tegenkomt, bewaar -t 0en controleer dan de time-out- en opslaglimieten van de server of proxy; een CLI-time-out van nul lost niet elk netwerkprobleem op. De ondersteuningswiki van Zimbra waarschuwt ook voor beschadigde archieven en I/O-fouten bij sommige grote mailboxexporten. Bij een te grote of onbetrouwbare export kunt u het werk opsplitsen per map of datum en vervolgens elk archief en de bijbehorende import testen op een reserveaccount.

De gedocumenteerde zoekopdracht selecteert bijvoorbeeld under:Inboxde inhoud van de inbox en de bijbehorende submappen. De aanhalingstekens rond de REST-URL zijn essentieel, omdat het ampersand-teken Zimbra moet bereiken en niet de shell.

zmmailbox -z -m user@example.com -t 0 getRestURL '//?fmt=tgz&query=under:Inbox' > /srv/zimbra-mailbox-backups/inbox-20261010.tgz

Een archief op mapniveau is geen vervanging voor een volledige export van de mailbox. Controleer de inhoud ervan onafhankelijk en documenteer welke mappen of datums zijn weggelaten. Als het account is uitgeschakeld of de aanvraag een autorisatiefout retourneert, controleer dan de accountstatus en de beheerdersauthenticatie in plaats van TLS-certificaatcontroles te omzeilen of inloggegevens openbaar te maken.

7. Controleer de herstelde items, niet alleen de opdrachtafsluiting.

Maak een lijst van de bestemmingsmappen en vergelijk deze met de geregistreerde bronmappen en de TGZ-inventaris:

zmmailbox -z -m user@example.com getAllFolders
zmmailbox -z -m user@example.com getMailboxSize

Meld u vervolgens aan bij het testaccount van de bestemming en open een voorbeeld van ontvangen en verzonden berichten, bijlagen, contactpersonen en agenda-items. Controleer de datums en mappaden en bekijk eventuele importfouten. Maak aliassen, deelrechten, regels en andere accountinstellingen indien nodig opnieuw aan of controleer ze afzonderlijk. Beschouw het herstel pas als geslaagd wanneer de verwachte gegevens toegankelijk zijn en de controles zijn vastgelegd.

Primaire referenties: Zimbra zmmailbox-opdrachtreferentie , Zimbra REST API-referentie , Zimbra zmprov-beheerreferentie en Zimbra-artikel over scoped exports en waarschuwingen voor grote archieven . Sommige Zimbra-wiki-voorbeelden zijn ouder of gemarkeerd als 'in ontwikkeling'; controleer hun gedrag op uw geïnstalleerde CE-build voordat u ze in productie gebruikt.