Wartung und Reparatur: Unterschied zwischen den Versionen

[unmarkierte Version][geprüfte Version]
 
K
 
(14 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
Normalerweise werden Sie sich mit dem Inhalt nicht auseinandersetzen müssen; die MailStore-Produkte sind so entwickelt, dass sie im Regelfall absolut wartungsfrei arbeiten.
+
Die MailStore-Produkte sind so entwickelt, dass sie sehr wenig administrativen Aufwand benötigen. Es ist jedoch ratsam, zur Sicherstellung der Integrität des Archivs regelmäßige Wartungen durchzuführen.  
  
Wenn jedoch z.B. aufgrund von Systemabstürzen oder versehentlichem Eingriff in die Dateistruktur ein Fehler auftritt, und Sie z.B. auf den Inhalt des Archivs nicht mehr zugreifen können, versetzt Sie dieses Dokument in die Lage, auch ohne die Kontaktierung des MailStore-Supports bestimmte Wartungs- und Reparaturarbeiten durchführen zu können.
+
Andere Gründe für die Verwendung von Wartungs- oder Reparaturfunktionen können Systemabstürze oder versehentliche Eingriffe in die Dateistruktur sein, bei denen anschließend ein Fehler auftritt und Sie z.B. auf den Inhalt des Archivs nicht mehr zugreifen können. Dieses Dokument versetzt Sie in die Lage, auch ohne die Kontaktierung des MailStore-Supports bestimmte Wartungs- und Reparaturarbeiten durchführen zu können.
  
'''Hinweis:''' Die im Folgenden beschriebenen Befehle können von einem MailStore-Administrator über die Management Shell eingeben werden.
+
== Archivspeicher ==
 +
Die im Folgenden beschriebenen Befehle können von einem MailStore-Administrator über den MailStore Client unter ''Verwaltung > Storage > Speicherorte'', die [[MailStore Server Management Shell]] oder zeitgesteuert als [[Jobs|Job]] ausgeführt werden.
  
= Logische Prüfung =
+
Für diese Befehle ist häufig die Angabe der ID eines Archivspeichers als Parameter <tt>id</tt> notwendig. Diese finden Sie unter ''Verwaltung > Storage > Speicherorte'' in der Spalte ''ID'' der Tabelle ''Archivspeicher''.
 +
[[Datei:Maintenance_repair_01.png|500px|center]]
 +
Alternativ können Sie auch den Management API-Befehl <tt>GetStores</tt> z.B. in der [[MailStore Server Management Shell]] verwenden, um eine Liste der Archivspeicher anzeigen zu lassen.
  
Die logische Prüfung erlaubt eine Verifikation, ob alle E-Mails im MailStore noch vollständig und originalgetreu vorhanden sind. Wurde z.B. eine Contentdatei (.dat) von Hand verändert, wird dies von der logischen Prüfung moniert. Ersetzen Sie 1 durch die tatsächliche Nummer der zu prüfenden Dateigruppe.
+
=== Datenintegrität prüfen ===
 +
Die Prüfung der Datenintegrität erlaubt eine Verifikation, ob alle E-Mails im MailStore noch vollständig und originalgetreu vorhanden sind. Wurde z.B. eine Contentdatei (.dat) von Hand verändert, wird dies von der Datenintegritätsprüfung moniert.  
  
  filegroup-verify --gid=1
+
Verwenden Sie die Management API-Befehle <tt>VerifyStore</tt> zum Überprüfen einzelner Archivspeicher und <tt>VerifyStores</tt> zum Überprüfen aller Archivspeicher. Der Parameter <tt>includeIndexes</tt> gibt in beiden Fällen an, ob auch die Volltextindizes in die Überprüfung einbezogen werden sollen.
  
= Datenbanken =
+
  VerifyStore --id=1 --includeIndexes=true
 +
  VerifyStores --includeIndexes=false
  
Einfaches Bereinigen der Masterdatenbank (es wird nichts gelöscht!)
+
=== Alle FDB-Dateien warten ===
 +
Das Warten aller von MailStore Server verwendeten Firebird Embedded Datenbank-Dateien (FDB-Dateien) optimiert die internen Datenstrukturen und entfernt ggf. nicht länger benötigte Datenbankseiten und Transaktionsprotokolle.
  
  maintain-db --command=sweep
+
  MaintainFileSystemDatabases
  
Kompletter Neuaufbau der Masterdatenbank (z.B. bei Auftreten struktureller Probleme)
+
=== Bereinigen (Compact) ===
  
  maintain-db --command=backup-restore
+
Kompaktieren der Masterdatenbank.
  
Einfaches Bereinigen einer Dateigruppen-Datenbank. Auch hier wird nichts gelöscht. Ersetzen Sie 1 durch die Nummer der Dateigruppe.
+
  CompactMasterDatabase
  
  maintain-db --command=sweep --gid=1
+
Kompaktieren eines Archivspeichers inkl. Datenbank, Containerdateien und Index-Dateien.
  
Kompletter Neuaufbau einer Dateigruppen-Datenbank (z.B. bei Auftreten struktureller Probleme)
+
  CompactStore --id=1
  
  maintain-db --command=backup-restore --gid=1
+
== Suchindizes ==
 +
Können E-Mails weder über die Ordnerstruktur noch durch das Ausführen einer Suchanfrage gefunden werden, ist dies häufig ein Zeichen für defekte oder unvollständige Indizes. Ein defekter Index ist nicht kritisch - er kann jederzeit ohne Datenverlust neu aufgebaut werden.
  
= Indizes =
+
Um die dazu notwendigen Schritte mit dem MailStore Client durchzuführen, folgenden Sie bitte den Anweisungen [[Suchindizes#Suchindizes neu aufbauen|Suchindizes neu aufbauen]] im MailStore Server Handbuch.
Können E-Mails weder über die Ordnerstruktur noch durch das Ausführen einer Suchanfrage gefunden werden, ist dies häufig ein Zeichen für defekte oder unvollständige Indizes. Ein defekter Index ist nicht kritisch - er kann jederzeit ohne Datenverlust neu aufgebaut werden. Um einen Index neu aufzubauen, gehen Sie wie folgt vor:
 
  
* Benutzen Sie den MailStore Client um sich damit als Administrator am MailStore Server anzumelden.
+
Der entsprechende Management API-Befehl zum Reparieren aller als defekt markierten Suchindizes lautet:
* Klicken Sie auf Verwaltung und wählen Sie Suchindizes aus.
 
* Wählen Sie die Dateigruppen und die Benutzerindizes aus und klicken sie auf ''Neu aufbauen''.
 
* Wiederholen Sie diese Schritte für alle betroffenen Dateigruppen und Benutzer.
 
  
 +
  RebuildSelectedStoreIndexes
  
 +
Ebenso gibt es unter ''Verwaltung > Management API > Jobs'' eine Vorlage zum Erstellen eines entsprechenden Jobs, um in regelmäßigen Abständen evtl. defekte Suchindizes neu aufzubauen.
 +
 +
[[de:Wartung und Reparatur]]
 
[[en:Maintenance_and_Repair]]
 
[[en:Maintenance_and_Repair]]

Aktuelle Version vom 15. Juni 2015, 10:27 Uhr

Die MailStore-Produkte sind so entwickelt, dass sie sehr wenig administrativen Aufwand benötigen. Es ist jedoch ratsam, zur Sicherstellung der Integrität des Archivs regelmäßige Wartungen durchzuführen.

Andere Gründe für die Verwendung von Wartungs- oder Reparaturfunktionen können Systemabstürze oder versehentliche Eingriffe in die Dateistruktur sein, bei denen anschließend ein Fehler auftritt und Sie z.B. auf den Inhalt des Archivs nicht mehr zugreifen können. Dieses Dokument versetzt Sie in die Lage, auch ohne die Kontaktierung des MailStore-Supports bestimmte Wartungs- und Reparaturarbeiten durchführen zu können.

Archivspeicher

Die im Folgenden beschriebenen Befehle können von einem MailStore-Administrator über den MailStore Client unter Verwaltung > Storage > Speicherorte, die MailStore Server Management Shell oder zeitgesteuert als Job ausgeführt werden.

Für diese Befehle ist häufig die Angabe der ID eines Archivspeichers als Parameter id notwendig. Diese finden Sie unter Verwaltung > Storage > Speicherorte in der Spalte ID der Tabelle Archivspeicher.

Maintenance repair 01.png

Alternativ können Sie auch den Management API-Befehl GetStores z.B. in der MailStore Server Management Shell verwenden, um eine Liste der Archivspeicher anzeigen zu lassen.

Datenintegrität prüfen

Die Prüfung der Datenintegrität erlaubt eine Verifikation, ob alle E-Mails im MailStore noch vollständig und originalgetreu vorhanden sind. Wurde z.B. eine Contentdatei (.dat) von Hand verändert, wird dies von der Datenintegritätsprüfung moniert.

Verwenden Sie die Management API-Befehle VerifyStore zum Überprüfen einzelner Archivspeicher und VerifyStores zum Überprüfen aller Archivspeicher. Der Parameter includeIndexes gibt in beiden Fällen an, ob auch die Volltextindizes in die Überprüfung einbezogen werden sollen.

 VerifyStore --id=1 --includeIndexes=true
 VerifyStores --includeIndexes=false

Alle FDB-Dateien warten

Das Warten aller von MailStore Server verwendeten Firebird Embedded Datenbank-Dateien (FDB-Dateien) optimiert die internen Datenstrukturen und entfernt ggf. nicht länger benötigte Datenbankseiten und Transaktionsprotokolle.

  MaintainFileSystemDatabases

Bereinigen (Compact)

Kompaktieren der Masterdatenbank.

  CompactMasterDatabase

Kompaktieren eines Archivspeichers inkl. Datenbank, Containerdateien und Index-Dateien.

  CompactStore --id=1

Suchindizes

Können E-Mails weder über die Ordnerstruktur noch durch das Ausführen einer Suchanfrage gefunden werden, ist dies häufig ein Zeichen für defekte oder unvollständige Indizes. Ein defekter Index ist nicht kritisch - er kann jederzeit ohne Datenverlust neu aufgebaut werden.

Um die dazu notwendigen Schritte mit dem MailStore Client durchzuführen, folgenden Sie bitte den Anweisungen Suchindizes neu aufbauen im MailStore Server Handbuch.

Der entsprechende Management API-Befehl zum Reparieren aller als defekt markierten Suchindizes lautet:

  RebuildSelectedStoreIndexes

Ebenso gibt es unter Verwaltung > Management API > Jobs eine Vorlage zum Erstellen eines entsprechenden Jobs, um in regelmäßigen Abständen evtl. defekte Suchindizes neu aufzubauen.