Das Benno MailArchiv Wiki

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Sie befinden sich hier: Benno MailArchiv » benno-archive-tool
Zuletzt angesehen:
benno-archive-tool

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Nächste Überarbeitung		Vorhergehende Überarbeitung
benno-archive-tool [2021/03/12 13:01] – angelegt 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.1615554061.txt.gz · Zuletzt geändert: 2021/03/12 13:01 von lwsystems

Seiten-Werkzeuge

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki