Allgemeine Verwaltungsaufgaben
Ein praktisches Handbuch für die Aufgaben, die Administratoren am häufigsten ausführen. Jeder Befehl
wird auf dem grommunio-Server als root (oder mit sudo) ausgeführt. Identifizieren Sie einen Benutzer anhand seiner
E-Mail-Adresse ([email protected]); fügen Sie --help an einen beliebigen grommunio-admin-Befehl
an, um alle dessen Optionen anzuzeigen.
Benutzer und Passwörter
Abschnitt betitelt „Benutzer und Passwörter“Einen Benutzer anlegen und ein Passwort festlegen
Abschnitt betitelt „Einen Benutzer anlegen und ein Passwort festlegen“# Create the mailbox (a maildir/store is provisioned automatically)
# Set an initial password (you'll be prompted), or generate a strong one:Die Domäne (example.com) muss bereits vorhanden sein – siehe
Domäne erstellen weiter unten.
Benutzer anzeigen, auflisten und suchen
Abschnitt betitelt „Benutzer anzeigen, auflisten und suchen“grommunio-admin user list # all usersgrommunio-admin user list -f status=0 jdoe@* # filter + wildcardEinen Benutzer bearbeiten
Abschnitt betitelt „Einen Benutzer bearbeiten“# Add an alias address
# Change the interface language
# Toggle a feature (e.g. disable ActiveSync for this user)grommunio-admin user modify --help listet alle Felder auf, einschließlich der benutzerspezifischen
Funktionsschalter (--privChat, --privVideo, --privFiles, --privDav,
--privEas, …), Aliase und gespeicherte Eigenschaften.
Mobile Geräte verwalten
Abschnitt betitelt „Mobile Geräte verwalten“Delegierung und „Als… senden“
Abschnitt betitelt „Delegierung und „Als… senden““Einen Benutzer löschen
Abschnitt betitelt „Einen Benutzer löschen“Domains und Organisationen
Abschnitt betitelt „Domains und Organisationen“Eine Domain erstellen
Abschnitt betitelt „Eine Domain erstellen“# -u sets the maximum number of users for the domaingrommunio-admin domain create -u 100 example.comDomains auflisten, bearbeiten und entfernen
Abschnitt betitelt „Domains auflisten, bearbeiten und entfernen“grommunio-admin domain listgrommunio-admin domain modify example.com # see --help for fieldsgrommunio-admin domain delete example.com # soft-delete (recoverable)grommunio-admin domain purge --files example.com # permanent + remove filesLDAP / Active Directory
Abschnitt betitelt „LDAP / Active Directory“Verbinden Sie grommunio mit einem externen Verzeichnis, importieren Sie anschließend die Benutzer und halten Sie sie synchron.
grommunio-admin ldap configure # interactive: server, bind, search basegrommunio-admin ldap check # verify connectivity and the configurationgrommunio-admin ldap search jdoe # find matching directory objectsBenutzer importieren (ein „Down-Sync“ aus dem Verzeichnis in grommunio):
grommunio-admin ldap downsync -c # complete sync of all mapped usersFetchmail – E-Mails aus einem Remote-Postfach abrufen
Abschnitt betitelt „Fetchmail – E-Mails aus einem Remote-Postfach abrufen“Nützlich bei Migrationen, um E-Mails vom alten Provider eines Benutzers abzurufen:
grommunio-admin fetchmail create \ --srcServer mail.old-provider.example \ --srcUser old-account \ --srcPassword 'secret' \
Wartung der Mailbox
Abschnitt betitelt „Wartung der Mailbox“Diese Aufgaben verwenden gromox-mbop („Postfach-
Operationen“), die immer auf ein Postfach mit der Nummer -u abzielen. Ordner können durch
symbolischen Namen (INBOX, SENT, DRAFT, JUNK, DELETED, …) oder über den Pfad
(/Top of Information Store/…) angegeben werden.
Einen Ordner leeren
Abschnitt betitelt „Einen Ordner leeren“# Empty the Junk folder (soft-delete, like a client would)
# Empty Deleted Items recursively, including subfolders (-R), hard deleteBestimmte Nachrichten löschen
Abschnitt betitelt „Bestimmte Nachrichten löschen“Speicherplatz freigeben
Abschnitt betitelt „Speicherplatz freigeben“Weichgelöschte („wiederherstellbare“) Elemente belegen weiterhin Speicherplatz, bis sie endgültig gelöscht werden. Eine typische Bereinigung, gefolgt von einer Komprimierung, schafft den meisten Speicherplatz frei:
# Hard-delete items soft-deleted more than 30 days ago, across the whole store
# Drop attachment/content files no longer referenced by any message
# Compact the SQLite storeDie angegebene Filialgröße neu berechnen
Abschnitt betitelt „Die angegebene Filialgröße neu berechnen“Eine Aktion für alle Postfächer ausführen
Abschnitt betitelt „Eine Aktion für alle Postfächer ausführen“Der Pseudo-Befehl foreach.* wendet eine Aktion gleichzeitig auf mehrere Postfächer an —
ideal für flottenweite Wartungsarbeiten:
# Purge old soft-deleted items in every mailbox hosted on this servergromox-mbop foreach.mb.here purge-softdelete -r -t 30d /Backups und Snapshots
Abschnitt betitelt „Backups und Snapshots“grommunio appliances erstellen regelmäßig platzsparende Snapshots des Postfachspeichers (auf einem Copy-on-Write-Dateisystem wie Btrfs):
/usr/libexec/gromox/gromox-snapshot # create a snapshot nowPlanen Sie dies über einen systemd-Timer, um regelmäßige, ressourcenschonende
Zeitpunkt-Backups durchzuführen. Einzelheiten zur Aufbewahrungsdauer finden Sie unter gromox-snapshot].
Diagnose und Fehlerbehebung
Abschnitt betitelt „Diagnose und Fehlerbehebung“# Open (touch) a mailbox to confirm the store responds
# Check a mailbox for inconsistencies (and repair with care)
# Report a mailbox's size breakdown
# Inspect the local delivery queuegromox-mailq
# Drop into an interactive admin shell (REST API context)grommunio-admin shell