de.bsvrz.ars.ars.mgmt
Class ArSRemoteControl

java.lang.Object
  extended by de.bsvrz.ars.ars.mgmt.ArSRemoteControl

public class ArSRemoteControl
extends Object

Klasse zur Fernsteuerung des Archivsystems (fuer Testzwecke).

Author:
beck et al. projects GmbH, Alexander Schmidt

Nested Class Summary
static class ArSRemoteControl.Datenspez
           
static class ArSRemoteControl.Einst
           
static class ArSRemoteControl.ParamSatz
           
static class ArSRemoteControl.RequestDataSpec
           
 
Field Summary
static String DAV_ADDRESS
           
static boolean DISABLE_RC_DEBUG
          Wenn wahr, gibt die RemoteControl keine eigenen Debugmeldungen aus
static String PASSWD
           
 
Constructor Summary
ArSRemoteControl()
           
 
Method Summary
static String getDebugLevelFile()
           
static ArchiveInfoQueryResult sendArchiveInfoRequestWait(String usr, String pw, String kvPid, ArchiveDataSpecification[] ads)
          Sendet eine Archivinformationsanfrage an das Archivsystem.
static void sendArsParams(String usr, String pw, String kvPid, ArSRemoteControl.ParamSatz[] ps)
          Parametriert das Archivsystem unter dem angegebenen Konfigurationsverantwortlichen anhand der uebergebenen Parameter.
static void sendArsParamsWait(String usr, String pw, ArSRemoteControl.ParamSatz[] ps, ArchiveManager aMgr)
          Sendet einen Parametersatz zum DAV und wartet bis das uebergebene Archivsystem darauf reagiert hat.
static void sendArSSettings(String usr, String pw, String kvPid, ArchiveSettings einst)
          Sendet Archiveinstellungen ueber den Datenverteiler.
static void sendArSSettingsWait(String usr, String pw, String kvPid, ArchiveSettings einst, ArchiveManager aMgr)
          Sendet Archiveinstellungen ueber den Datenverteiler und wartet bis das uebergeben Archivsystem darauf reagiert hat.
static void sendContainerSettings(String usr, String pw, String kvPid, ContainerSettings cs)
          Sendet Containereinstellungen ueber den Datenverteiler.
static void sendContainerSettingsWait(String usr, String pw, String kvPid, ContainerSettings cs, ArchiveManager aMgr)
          Sendet Containereinstellungen ueber den Datenverteiler und wartet bis das uebergeben Archivsystem darauf reagiert hat.
static String sendHeaderRestoreRequest(String usr, String pw, String kvPid, int requestIndex, int mediumID)
           
static void sendQuickContainerSettings(String usr, String pw, String kvPid, int maxDS, int maxSize, long maxTime)
          Setzt atg.archivContainer
static void sendQuickContainerSettingsWait(String usr, String pw, String kvPid, int maxDS, int maxSize, long maxTime, ArchiveManager aMgr)
           
static String sendRequestRequestWait(String usr, String pw, String kvPid, int requestIndex, ArSRemoteControl.RequestDataSpec[] rds)
          Sendet einen Nachforderungsauftrag, wartet und liefert den Antwortstring.
static String sendRequestRequestWait(String usr, String pw, String kvPid, int requestIndex, ArSRemoteControl.RequestDataSpec[] rds, SystemObject[] archives)
          Sendet einen Nachforderungsauftrag, wartet und liefert den Antwortstring.
static void setDebugLevelFile(String debugLevelFile)
          Setzt das beim Start des Archivsystem zu verwendendes Debuglevel für Ausgabe in Datei.
static ArchiveManager startArS(String persistenceDir, String debugLevel)
          Startet das Archivsystem ohne auf die Uebernahme der Parametrierung zu warten.
static ArchiveManager startArSRemoveOldData(String persistenceDir, String debugLevel)
           
static ArchiveManager startArSWaitForParams(String persistenceDir)
          Startet das Archivsystem.
static ArchiveManager startArSWaitForParams(String persistenceDir, String debugLevel)
          Startet das Archivsystem unter dem lokalen KV.
static ArchiveManager startArSWaitForParams(String persistenceDir, String debugLevel, String configAuth)
          Startet das Archivsystem.
static ArchiveManager startArSWaitForParams(String persistenceDir, String debugLevel, String configAuth, File backupPropertiesFile, boolean removeOldData)
          Startet das Archivsystem.
static ArchiveManager startArSWaitForParams(String persistenceDir, String debugLevel, String configAuth, String backupModule, boolean removeOldData)
          Startet das Archivsystem.
static ArchiveManager startArSWaitForParams(String persistenceDir, String debugLevel, String configAuth, String backupModule, String backupDir, boolean removeOldData)
          Startet das Archivsystem.
static ArchiveManager startArSWaitForParamsRemoveOldData(String persistenceDir)
          Loescht das uebergebene Persistenzverzeichnis und startet das Archivsystem.
static ArchiveManager startArSWaitForParamsRemoveOldData(String persistenceDir, String debugLevel)
          Loescht das uebergebene Persistenzverzeichnis und startet das Archivsystem.
static ArchiveManager startArSWaitForParamsRemoveOldData(String persistenceDir, String debugLevel, String configAuth)
          Loescht das uebergebene Persistenzverzeichnis und startet das Archivsystem.
static ArchiveManager startArsWaitForParamsWithArgs(String[] args)
          Startet das Archivsystem und wartet bis die Parametrierung übernommen wurde.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

DISABLE_RC_DEBUG

public static boolean DISABLE_RC_DEBUG
Wenn wahr, gibt die RemoteControl keine eigenen Debugmeldungen aus


PASSWD

public static String PASSWD

DAV_ADDRESS

public static String DAV_ADDRESS
Constructor Detail

ArSRemoteControl

public ArSRemoteControl()
Method Detail

getDebugLevelFile

public static String getDebugLevelFile()
Returns:
Liefert das beim Start des Archivsystem zu verwendendes Debuglevel für Ausgabe in Datei.

setDebugLevelFile

public static void setDebugLevelFile(String debugLevelFile)
Setzt das beim Start des Archivsystem zu verwendendes Debuglevel für Ausgabe in Datei.

Parameters:
debugLevelFile - Das beim Start des Archivsystem zu verwendendes Debuglevel für Ausgabe in Datei.

startArS

public static ArchiveManager startArS(String persistenceDir,
                                      String debugLevel)
                               throws Exception
Startet das Archivsystem ohne auf die Uebernahme der Parametrierung zu warten.

Parameters:
persistenceDir - Persistenzverzeichnis
Returns:
Archivsystem
Throws:
Exception

startArSRemoveOldData

public static ArchiveManager startArSRemoveOldData(String persistenceDir,
                                                   String debugLevel)
                                            throws Exception
Throws:
Exception

startArSWaitForParams

public static ArchiveManager startArSWaitForParams(String persistenceDir)
                                            throws Exception
Startet das Archivsystem. Es wird gewartet, bis die Parametrierung vollstaendig uebernommen wurde. Debug-Level fuer stdout ist "INFO".

Parameters:
persistenceDir - Persistenzverzeichnis
Returns:
Archivsystem
Throws:
Exception

startArSWaitForParams

public static ArchiveManager startArSWaitForParams(String persistenceDir,
                                                   String debugLevel)
                                            throws Exception
Startet das Archivsystem unter dem lokalen KV. Es wird gewartet, bis die Parametrierung vollstaendig uebernommen wurde.

Parameters:
persistenceDir - Persistenzverzeichnis
debugLevel - Debug-Level fuer stdout
configAuth - Konfigurationsverantwortlicher oder null (dann wird der lokale KV verwendet)
Returns:
Archivsystem
Throws:
Exception

startArSWaitForParams

public static ArchiveManager startArSWaitForParams(String persistenceDir,
                                                   String debugLevel,
                                                   String configAuth)
                                            throws Exception
Startet das Archivsystem. Es wird gewartet, bis die Parametrierung vollstaendig uebernommen wurde.

Parameters:
persistenceDir - Persistenzverzeichnis
debugLevel - Debug-Level fuer stdout
configAuth - Konfigurationsverantwortlicher oder null (dann wird der lokale KV verwendet)
Returns:
Archivsystem
Throws:
Exception

startArSWaitForParams

public static ArchiveManager startArSWaitForParams(String persistenceDir,
                                                   String debugLevel,
                                                   String configAuth,
                                                   String backupModule,
                                                   boolean removeOldData)
                                            throws Exception
Startet das Archivsystem. Es wird gewartet, bis die Parametrierung vollstaendig uebernommen wurde.
Falls im Parameter backupModule "filesystem" spezifiziert wurde, sollte die Methode startArSWaitForParams(String,String,String,String,String,boolean) verwendet werden und ein Verzeichnis fuer die Sicherung angegeben werden (ansonsten Fehler!).

Parameters:
persistenceDir - Persistenzverzeichnis
debugLevel - Debug-Level fuer stdout
configAuth - Konfigurationsverantwortlicher oder null (dann wird der lokale KV verwendet)
backupModule - Sicherungsmodul ["keydox"|"filesystem"|"dvd"]
removeOldData - gibt an, ob das uebergebene Persistenzverzeichnis geloescht werden soll
Returns:
Archivsystem
Throws:
Exception

startArSWaitForParams

public static ArchiveManager startArSWaitForParams(String persistenceDir,
                                                   String debugLevel,
                                                   String configAuth,
                                                   String backupModule,
                                                   String backupDir,
                                                   boolean removeOldData)
                                            throws Exception
Startet das Archivsystem. Es wird gewartet, bis die Parametrierung vollstaendig uebernommen wurde.
Falls im Parameter backupModule "filesystem" spezifiziert wurde, sollte ein Verzeichnis fuer die Sicherung angegeben werden.

Parameters:
persistenceDir - Persistenzverzeichnis
debugLevel - Debug-Level fuer stdout
configAuth - Konfigurationsverantwortlicher oder null (dann wird der lokale KV verwendet)
backupModule - Sicherungsmodul ["keydox"|"filesystem"|"dvd"]
backupDir - Sicherungsverzeichnis (kann null sein, wenn backupModule nicht "filesystem" ist)
removeOldData - gibt an, ob das uebergebene Persistenzverzeichnis geloescht werden soll
Returns:
Archivsystem
Throws:
Exception

startArSWaitForParams

public static ArchiveManager startArSWaitForParams(String persistenceDir,
                                                   String debugLevel,
                                                   String configAuth,
                                                   File backupPropertiesFile,
                                                   boolean removeOldData)
                                            throws Exception
Startet das Archivsystem. Es wird gewartet, bis die Parametrierung vollstaendig uebernommen wurde.
Falls im Parameter backupModule "filesystem" spezifiziert wurde, sollte ein Verzeichnis fuer die Sicherung angegeben werden.

Parameters:
persistenceDir - Persistenzverzeichnis
debugLevel - Debug-Level fuer stdout
configAuth - Konfigurationsverantwortlicher oder null (dann wird der lokale KV verwendet)
backupPropertiesFile - Datei mit Backup-Einstellungen
removeOldData - gibt an, ob das uebergebene Persistenzverzeichnis geloescht werden soll
Returns:
Archivsystem
Throws:
Exception

startArsWaitForParamsWithArgs

public static ArchiveManager startArsWaitForParamsWithArgs(String[] args)
                                                    throws Exception
Startet das Archivsystem und wartet bis die Parametrierung übernommen wurde.

Parameters:
args - Kommandozeilenparameter für das Archivsystem
Returns:
Archivmanager
Throws:
Exception

startArSWaitForParamsRemoveOldData

public static ArchiveManager startArSWaitForParamsRemoveOldData(String persistenceDir)
                                                         throws Exception
Loescht das uebergebene Persistenzverzeichnis und startet das Archivsystem. Es wird gewartet, bis die Parametrierung vollstaendig uebernommen wurde.

Parameters:
persistenceDir - Persistenzverzeichnis
Returns:
Archivsystem
Throws:
Exception

startArSWaitForParamsRemoveOldData

public static ArchiveManager startArSWaitForParamsRemoveOldData(String persistenceDir,
                                                                String debugLevel)
                                                         throws Exception
Loescht das uebergebene Persistenzverzeichnis und startet das Archivsystem. Es wird gewartet, bis die Parametrierung vollstaendig uebernommen wurde.

Parameters:
persistenceDir - Persistenzverzeichnis
debugLevel - Debug-Level fuer stdout
Returns:
Archivsystem
Throws:
Exception

startArSWaitForParamsRemoveOldData

public static ArchiveManager startArSWaitForParamsRemoveOldData(String persistenceDir,
                                                                String debugLevel,
                                                                String configAuth)
                                                         throws Exception
Loescht das uebergebene Persistenzverzeichnis und startet das Archivsystem. Es wird gewartet, bis die Parametrierung vollstaendig uebernommen wurde.

Parameters:
persistenceDir - Persistenzverzeichnis
debugLevel - Debug-Level fuer stdout
configAuth - Konfigurationsverantwortlicher oder null (dann wird der lokale KV verwendet)
Returns:
Archivsystem
Throws:
Exception

sendContainerSettings

public static void sendContainerSettings(String usr,
                                         String pw,
                                         String kvPid,
                                         ContainerSettings cs)
                                  throws Exception
Sendet Containereinstellungen ueber den Datenverteiler.

Throws:
Exception

sendRequestRequestWait

public static String sendRequestRequestWait(String usr,
                                            String pw,
                                            String kvPid,
                                            int requestIndex,
                                            ArSRemoteControl.RequestDataSpec[] rds)
                                     throws Exception
Sendet einen Nachforderungsauftrag, wartet und liefert den Antwortstring.

Throws:
Exception

sendHeaderRestoreRequest

public static String sendHeaderRestoreRequest(String usr,
                                              String pw,
                                              String kvPid,
                                              int requestIndex,
                                              int mediumID)
                                       throws Exception
Throws:
Exception

sendRequestRequestWait

public static String sendRequestRequestWait(String usr,
                                            String pw,
                                            String kvPid,
                                            int requestIndex,
                                            ArSRemoteControl.RequestDataSpec[] rds,
                                            SystemObject[] archives)
                                     throws Exception
Sendet einen Nachforderungsauftrag, wartet und liefert den Antwortstring. Bei dieser Methode koennen die zu verwendenden Archivsysteme angegeben werden. Diese werden anstelle der parametrierten Nachforderungs-Archivsysteme verwendet.

Throws:
Exception

sendArchiveInfoRequestWait

public static ArchiveInfoQueryResult sendArchiveInfoRequestWait(String usr,
                                                                String pw,
                                                                String kvPid,
                                                                ArchiveDataSpecification[] ads)
                                                         throws Exception
Sendet eine Archivinformationsanfrage an das Archivsystem. Stellt dazu eine eigene Verbindung zum Datenverteiler her.

Parameters:
usr - Dav-Benutzer, z.B. "Tester".
pw - Dav-Passwort, z.B. "geheim".
kvPid - Pid des Konfigurationsverantwortlichen, z.B. "kv.testKonfiguration".
ads - Parameter der Anfrage.
Returns:
Ergebnis der Anfrage
Throws:
Exception - Fehler ist aufgetreten.

sendContainerSettingsWait

public static void sendContainerSettingsWait(String usr,
                                             String pw,
                                             String kvPid,
                                             ContainerSettings cs,
                                             ArchiveManager aMgr)
                                      throws Exception
Sendet Containereinstellungen ueber den Datenverteiler und wartet bis das uebergeben Archivsystem darauf reagiert hat.

Throws:
InterruptedException
Exception

sendQuickContainerSettingsWait

public static void sendQuickContainerSettingsWait(String usr,
                                                  String pw,
                                                  String kvPid,
                                                  int maxDS,
                                                  int maxSize,
                                                  long maxTime,
                                                  ArchiveManager aMgr)
                                           throws Exception
Throws:
Exception

sendQuickContainerSettings

public static void sendQuickContainerSettings(String usr,
                                              String pw,
                                              String kvPid,
                                              int maxDS,
                                              int maxSize,
                                              long maxTime)
                                       throws Exception
Setzt atg.archivContainer

Parameters:
usr - Benutzer
pw - Passwort
kvPid - Konfigurationsverantwortlicher
maxDS - max. Anzahl Datensaetze pro Container
maxSize - max. Groesse eines Containers in Bytes
maxTime - max. Zeitspanne eines Containers in Sekunden
Throws:
Exception

sendArSSettings

public static void sendArSSettings(String usr,
                                   String pw,
                                   String kvPid,
                                   ArchiveSettings einst)
                            throws Exception
Sendet Archiveinstellungen ueber den Datenverteiler.

Throws:
Exception

sendArSSettingsWait

public static void sendArSSettingsWait(String usr,
                                       String pw,
                                       String kvPid,
                                       ArchiveSettings einst,
                                       ArchiveManager aMgr)
                                throws Exception
Sendet Archiveinstellungen ueber den Datenverteiler und wartet bis das uebergeben Archivsystem darauf reagiert hat.

Throws:
Exception

sendArsParams

public static void sendArsParams(String usr,
                                 String pw,
                                 String kvPid,
                                 ArSRemoteControl.ParamSatz[] ps)
                          throws Exception
Parametriert das Archivsystem unter dem angegebenen Konfigurationsverantwortlichen anhand der uebergebenen Parameter.

Parameters:
kvPid - Konfigurationsverantwortlicher
ps - Parametersatz
Throws:
ConfigurationException
MissingParameterException
CommunicationError
ConnectionException
InconsistentLoginException
SenderException
Exception

sendArsParamsWait

public static void sendArsParamsWait(String usr,
                                     String pw,
                                     ArSRemoteControl.ParamSatz[] ps,
                                     ArchiveManager aMgr)
                              throws Exception
Sendet einen Parametersatz zum DAV und wartet bis das uebergebene Archivsystem darauf reagiert hat.

Throws:
Exception