Das Benno MailArchiv Wiki

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Sie befinden sich hier: Benno MailArchiv » benno-archive-tool
Zuletzt angesehen: • Journaling Mailbox • Begriffsbestimmungen • Vorgehensweise • benno-archive-tool
benno-archive-tool

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung		Vorhergehende Überarbeitung
benno-archive-tool [2021/05/18 14:00] – [benno-archive-tool] lwsystemsbenno-archive-tool [2026/04/22 13:55] (aktuell) – [Ausschließlich Index-Einträge löschen] lwsystems
Zeile 1: Zeile 1:
 ====== benno-archive-tool ====== ====== benno-archive-tool ======
  
-Das Programmpaket //benno-archive-tool// stellt Werkzeuge zum direkten Bearbeiten des Indexes oder Repositories zur Verfügung.+Das Programmpaket //benno-archive-tool// stellt Werkzeuge zum direkten Bearbeiten des Indexes oder Repositories zur Verfügung. Mit dem Kommando
  
-//Der Index ist durch den Benno Archive Daemon gelockt und muss vor der Arbeit mit diesem Tool gestoppt werden.// Wir empfehlen vor Arbeiten am Index oder dem Repo, ein aktuelles Backup oder ein Snapshot des Systems zu erstellen.+  apt install benno-archive-tool 
 + 
 +wird das Programm installiert. 
 + 
 +//**Der Index ist durch den Benno Archive Daemon gelockt und muss vor der Arbeit mit diesem Tool gestoppt werden.**// Wir empfehlen vor Arbeiten am Index oder dem Repo, ein aktuelles Backup oder ein Snapshot des Systems zu erstellen.
  
 ====== Vorgehensweise ====== ====== Vorgehensweise ======
  
   * Benno-Id der E-Mail(s) ermitteln   * Benno-Id der E-Mail(s) ermitteln
-  * Benno Archive Daemon stoppen+  * Benno Archive Daemon stoppen: ''systemctl stop benno-archive''
   * benno-archive-tool mit der ID-Liste und entsprechenden Parametern aufrufen   * benno-archive-tool mit der ID-Liste und entsprechenden Parametern aufrufen
-  * Benno Archive Daemon starten+  * Benno Archive Daemon starten: ''systemctl start benno-archive''
  
 ====== ID der E-Mails ermitteln ====== ====== ID der E-Mails ermitteln ======
Zeile 22: Zeile 26:
 ===== E-Mail Liste ===== ===== E-Mail Liste =====
  
-Eine größere Liste von E-Mails kann über das Logfile oder per Konsole mit dem Kommando ''[[benno-client]]'' mittels Suchanfrage erstellt werden. +Eine größere Liste von E-Mails kann über das Logfile oder per Konsole mit dem Kommando ''[[benno-client]]'' mittels Suchanfrage erstellt werden. Die Liste aller E-Mails aus dem Jahr 2011 erstellen Sie wie folgt: 
 + 
 +<file> 
 +benno-client --limit 10000000 -q '(Date:[20110010000 TO 201131122359])' > /tmp/2011.list 
 +</file> 
 + 
 +**Achtung:** Der Parameter ''--limit'' gibt an, wieviele E-Mail IDs maximal ausgegeben werden sollen. Daher muss er größer als die Anzahl der E-Mails im fraglichen Zeitraum. 
 + 
 +Falls die E-Mails eines anderen Containers als dem Standard-Container //BennoContainer// ermittelt werden sollen, wird dieser mittels ''-C $CONTAINERNAME'' übergeben.
  
 ====== Funktionsbeschreibung ====== ====== Funktionsbeschreibung ======
Zeile 37: Zeile 49:
   * Lösche Mails aus dem Index anhand einer Liste   * Lösche Mails aus dem Index anhand einer Liste
   * Lösche doppelte Mails aus dem Index   * Lösche doppelte Mails aus dem Index
-  * Mail wird aus dem REPO Ordner gelöscht+  * Mail wird aus dem REPO Ordner gelöscht (Mail in S3-Repos müssen zusätzlich manuell gelöscht werden)
   * Leere Ordner oberhalb des Pfades der Mail werden ebenfalls gelöscht   * Leere Ordner oberhalb des Pfades der Mail werden ebenfalls gelöscht
  
-==== Beispiele ====+====== Beispiele ======
  
-=== Mail löschen === 
  
-Mail löschen, wenn Aufbewahrungsfrist vorbei ist (10 Jahre)+Mit dem Parameter //-m// wird die [[rest_interface#e-mail_mittels_bennoid_laden|BennoID]] der zu löschenden E-Mail übergeben.
  
-    benno-archive-tool -D -m 2020:12345678...+===== Mail nach Aufbewahrungsfrist löschen =====
  
-Mail löschen, ohne die Aufbewahrungsfrist zu überprüfen 
  
-    benno-archive-tool -D -f -m 2020:12345678...+Mail löschen, wenn Aufbewahrungsfrist vorbei ist (10 Jahre).
  
-Löschen einer Liste von E-Mails+    benno-archive-tool -D -m 2020:12345678...
  
-    benno-archive-tool -D --maillist mails.txt 
-    benno-archive-tool -D -f --maillist mails.txt 
  
-Als Aufbewahrungsfristdatum soll das Datum des Date-Headers genommen werden+Der Zeitraum der Aufbewahrungsfrist berechnet sich aus der Differenz zum Index-Timestamp der E-Mail und dem aktuellen Zeitpunkt. Der Index-Timestamp wird mit Archivieren oder mit Re-Indexieren der E-Mail neu gesetzt.
  
-    benno-archive-tool -md -D -m 2020:12345678...+==== Date-Header für Aufbewahrungsfrist ====
  
 +Mit dem Schalter //%%-md%%//, bzw. //%%--maildate%%// wird der Zeitraum anhand des Date-Headers der E-Mail berechnet.
  
-Current Journal Datei liegt in einem anderen Ordner (seltener Fall. Standard ist das aktuelle Jahr vom Server)+    benno-archive-tool -md -D -m 2020:12345678...
  
-  benno-archive-tool -md -D -m 2020:12345678 -jy 2021 
  
-Mail Duplikate löschen+===== Mail löschen, ohne die Aufbewahrungsfrist zu überprüfen =====
  
-Löschen von Mailduplikaten nach der Aufbewahrungsfrist+    benno-archive-tool -D -f -m 2020:12345678...
  
-    benno-archive-tool -DD 
  
-====== Kommandozeilenparameter ======+===== Löschen einer Liste von E-Mails =====
  
-<code> 
-    -D,--delete                           Delete mails from index 
  
-    -DD,--deleteduplicate                 Delete duplicate mails from index+  * ''%%benno-archive-tool --delete --maillist mails.txt%%'' 
 +  * ''%%benno-archive-tool --delete --maildate --maillist mails.txt%%'' 
 +  * ''%%benno-archive-tool --delete --force --maillist mails.txt%%''
  
-    -f,--force                            Delete mails without checking retention period+==== Ausschließlich Index-Einträge löschen ====
  
-    -fe,--fileextension <FILEEXTENSION>   File extension of the mail+Hiermit werden die E-Mails ausgeblendet und können nicht mehr gefunden werden. Die jeweilige E-Mail ist noch im Repo vorhanden und kann durch einen Re-Index wieder gefunden werden. 
 +Dieser Aufruf ist erheblich schneller und bietet sich bei einer großen Anzahl von E-Mails an.
  
-    -h,--help                             print this description+  * '''%%benno-archive-tool --INDEX-DELETE --maillist mails.txt%%'' 
 +===== Journal nicht in Standard-Verzeichnis =====
  
-    -i,--indexpath <INDEXPATH>            Path of Index directory (default: /srv/benno/archive/index)+Current Journal Datei liegt in einem anderen Ordner (seltener Fall. Standard ist das aktuelle Jahr vom Server)
  
-    -j,--journalpath <JOURNALPATH>        Path of Journal directory (default: /srv/benno/archive/repo)+  benno-archive-tool -md -D -m 2020:12345678 -jy 2021
  
-    -jy,--journalyear <JOURNALYEAR>       Current year to determine the current.journal 
  
-    -m,--mailid <MAIL>                    Select mailid+====== Kommandozeilenparameter ======
  
-    --maillist <MAILLIST>                 Select maillist file with mailids +<code> 
- + -D,--delete                           Delete mails from index and repo 
-    -md,--maildate                        Take as retention period parameter the mail date header (instead + -Do,--deleteorphans                   Delete orphan entries from index 
-                                          of IndexTS from index) + -f,--force                            Delete mails without checking 
- +                                       retention period 
-    -r,--repopath <REPOPATH>              Path of Repo directory (default: /srv/benno/archive/repo) + -fe,--fileextension <FILEEXTENSION>   File extension of the mail 
- + -h,--help                             print this description 
-    -s,--subdirs <SUBDIRS>                Set the total amount of Subdirectories + -i,--indexpath <INDEXPATH>            Path of Index directory (default: 
- +                                       /srv/benno/archive/index) 
-    -sl,--subdirlen <SUBDIRLEN>           Subdirlength + -id,--INDEX-DELETE                    Delete only index entry without 
- +                                       checking repo 
-    -tk,--tagkey <TAGKEY>                 Set Tagkey name here (Currently only invisible possible) + -j,--journalpath <JOURNALPATH>        Path of Journal directory (default: 
- +                                       /srv/benno/archive/repo) 
-    -tv,--tagvalue <TAGVALUE>             Set Tagvalue name here (Currently only 1 or 0 possible)+ -jy,--journalyear <JOURNALYEAR>       Current year to determine the 
 +                                       current.journal 
 + -m,--mailid <MAIL>                    Select mailid 
 +    --maillist <MAILLIST>              Select maillist file with mailids 
 + -md,--maildate                        Take as retention period parameter 
 +                                       the mail date 
 + -r,--repopath <REPOPATH>              Path of Repo directory (default: 
 +                                       /srv/benno/archive/repo) 
 + -s,--subdirs <SUBDIRS>                Set the total amount of 
 +                                       Subdirectories 
 + -sl,--subdirlen <SUBDIRLEN>           Subdirlength 
 + -tk,--tagkey <TAGKEY>                 Set Tagkey name here (Currently 
 +                                       only invisible possible) 
 + -tv,--tagvalue <TAGVALUE>             Set Tagvalue name here (Currently 
 +                                       only 1 or 0 possible)
 </code> </code>
benno-archive-tool.1621346404.txt.gz · Zuletzt geändert: 2021/05/18 14:00 von lwsystems

Seiten-Werkzeuge

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki