1                     Themenübersicht

Diese Dokumentation beschreibt die Anwendung „Automatische Reorganisation“. Es gibt zwei Möglichkeiten ein neues Semiramis-System aufzusetzen: durch Installation von der Semiramis-Installations-DVD oder durch Kopie von einem vorhandenen Semiramis-System. Damit ein System durch Kopie aufgesetzt werden kann, müssen in der Regel mehrere Tools zu Reorganisationszwecken auf dem Quellsystem zur Vorbereitung der Kopie ausgeführt werden. Nach dem Kopieren müssen mehrere Tools auf dem kopierten System ausgeführt werden. Die Anwendung „Automatische Reorganisation“ unterstützt den Anwender bei diesen Reorganisationen.

2                     Zielgruppe

• Entwickler
• Technische Berater
• Administratoren

3                     Anwendungsbeschreibung

Die Anwendung kann Reorganisationsschritte, die zuvor in einer XML-Datei im Knowledgestore definiert wurden, ausführen. Ein Reorganisationschritt ist die Ausführung eines Tools mit bestimmten Parametern. Beim Laden der Datei werden die Schritte  in einer Liste angezeigt. Neben der sequentiellen Ausführung aller Schritte der Datei können die Schritte bei Bedarf auch einzeln aufgerufen werden. Eine erfolgreiche Ausführung wird durch eine grüne Ampel in der Liste angezeigt.

Ein Eintrag im XML steuert, ob die erfolgreiche Ausführung eines Schritts in Semiramis gespeichert werden soll. Die Reorganisationen zur Vorbereitung der Kopie sind in der Regel von kurzer Laufzeit und werden nur unmittelbar vor der Kopie vorgenommen. In diesem Fall ist eine Speicherung der erfolgreichen Ausführung nicht nötig und die Informationen sind in der Regel auch sofort veraltet, sobald mit dem Quellsystem wieder gearbeitet wird. Die Anwendung zeigt daher den erfolgreichen Lauf eines Kommandos solange an bis eine Datei geladen oder die Anwendung geschlossen wird. Beim Laden derselben oder einer anderen Datei bzw. beim Beenden der Anwendung gehen die Informationen über eine erfolgreiche Ausführung verloren.

Die Reorganisation des neuen aus der Kopie entstandenen Systems kann eine Laufzeit von mehreren Stunden haben. Aus diesem Grund bietet die Anwendung die Möglichkeit die Tools über eine Hintergrundanwendung ausführen zu lassen. Diese Aktion ist erst dann auswählbar wenn die Speicherung der Ausführung im XML vermerkt wurde. Ein erneutes Laden der Datei zeigt an welche Tools erfolgreich ausgeführt wurden.

Semiramis liefert als Entwicklungsobjekt Datei zwei Reorganisationsdateien mit:

com.cisag.sys.tools.automaticreorganization.AutomaticReorganizationSourceScript als Reorganisationsdatei für die Vorbereitung zur Kopie.

com.cisag.sys.tools.automaticreorganization.AutomaticReorganizationTargetScript als Reorganisationsdatei für die Reorganisation des als Kopie entstandenen Systems.

Diese Dateien sind vom Format XML und dienen als Vorlage und enthalten die für die jeweiligen Anwendungsfälle benötigten Semiramis-Tools. Vor jeder Reorganisation muss vom Benutzer geprüft werden, ob die Reorganisations-Datei an das jeweilige System angepasst werden muss. Die Anpassung betrifft zumeist die Parameter der Tools, es muss aber auch überprüft werden ob alle Tools ausgeführt werden sollen, oder ob Tools hinzugenommen werden sollen.

Die Tools werden auf dem Semiramis-Application-Server ausgeführt, an dem der Benutzer sich angemeldet hat. Die Ausgabe der Tools wird somit auch in den Log-Dateien des Semiramis-Application-Servers gespeichert. Wenn die Tools nicht im Hintergrund ausgeführt werden, werden die Ausgaben zusätzlich im Feld Ausgabe im Arbeitsbereich angezeigt.

Die Anwendung „Automatische Reorganisation“ besteht aus einem Identifi­kations- und einem Arbeitsbereich.

3.1               Identifikationsbereich

Der Identifikationsbereich enthält ein Feld zum Laden einer Reorganisationsdatei, sowie ein  Feld zur Anzeige der Beschreibung der geladenen Reorganisationsonsdatei.

Die Inhalte der Felder und der Karteireiter werden im Folgen­den beschrieben.

Die Felder im Einzelnen:

3.2               Arbeitsbereich

Der Arbeitsbereich besteht aus einer Liste mit den Kommandos der geladenen Reorganisationsdatei und dem Feld „Ausgabe“.

3.2.1          Liste der Kommandos

Die Liste zeigt die Kommandos der geladenen Reorganisationsdatei an.

3.2.2          Das Feld „Ausgabe“

3.3               Anwendungsbezogene Aktionen

Die folgenden anwendungsbezogenen Aktionen stehen in der Anwendung „Automatische Reorganisation“ zur Verfügung:

• Alle Kommandos ausführen
• Automatische Reorganisation im Hintergrund

3.3.1          Alle Kommandos ausführen

Alle Tools der geladenen Datei werden sequentiell ausgeführt. Bei erfolgreicher Ausführung wird der Status der betreffenden Zeile auf grün geschaltet. Die Ausgaben der Tools werden im Feld „Ausgabe“ angezeigt. Während der Abarbeitung der Datei ist das Aktualisierungsintervall des Browsers auf zwei Sekunden verkürzt. Nach der Abarbeitung der Datei wird das Aktualisierungsintervall wieder auf den Standardwert zurückgesetzt.

3.3.2          Automatische Reorganisation im Hintergrund

Eine Hintergrundanwendung führt alle Tools der geladenen Datei sequentiell aus. Diese Aktion ist nur dann auswählbar, wenn die geladene Datei die Speicherung der Ausführung vermerkt hat.

4                     Beschreibung des XML-Formats

Das XML-Format der Reorganisationsscripte bietet neben den Befehlszeilen der Tools noch die Möglichkeit Beschreibungen der Tools anzugeben, welche in der Liste der Befehle in der Spalte „Beschreibung“ angezeigt werden. Diese Beschreibungen können sowohl aus einer Stringtable gezogen werden, oder direkt im XML eingetragen werden.

4.1               Das Element  „script“

Das XML-Element bildet die Klammer um die Aufrufe der Tools. Mit dem Attribut „logging“ wird festgelegt, ob die Ausführung der Tools gespeichert werden soll oder nicht:

<?xml version=”1.0″ encoding=”UTF-8″ standalone=”yes”?>

<!-—logging=”true” für Speicherung in der Datenbank –>

<script logging=”false”>

</script>

Damit eine Beschreibung des Scripts in der Anwendung „Automatische Reorganisation“ angezeigt wird, verwendet man das Attribut „description“:

<?xml version=”1.0″ encoding=”UTF-8″ standalone=”yes”?>

<script description=”Reorganisation des Quellsystems” logging=”false”>

</script>

Die Beschreibung kann auch aus einer Stringtable ermittelt werden. Im Attribut „stringtable“ muss der vollqualifizierte Name des Entwicklungsobjektes angegeben werden. Das Attribut „tableid“ muss die entsprechende Textkonstante aus der Stringtable erhalten, zu dem der Beschreibungstext gehört:

<?xml version=”1.0″ encoding=”UTF-8″ standalone=”yes”?>

<script tableid=”SCRIPT_DESCRIPTION” stringtable=”com.cisag.sys.tools.automaticreorganization.AutomaticReorganizationSourceScript” logging=”false”>

</script>

4.2               Das Element  „action“

Das XML-Element „action“ dient zur Angabe eines Tools, welches ausgeführt werden soll. Das Attribut „command“ enthält die eigentliche Befehlszeile:

<?xml version=”1.0″ encoding=”UTF-8″ standalone=”yes”?>

<script logging=”false”>

<action command=”dltdbt -oltp -olap -table:%”/>

</script>

Damit in der Anwendung „Automatische Reorganisation“ eine Beschreibung für das Tool angezeigt wird muss das Element „action“ noch das Attribut „description“ erhalten:

<?xml version=”1.0″ encoding=”UTF-8″ standalone=”yes”?>

<script logging=”false”>

<action description=”Löschen von nicht benötigten Tabellen” command=”dltdbt -oltp -olap -table:%”/>

</script>

Das Element „action“ kann ebenfalls Beschreibungen aus der Stringtable referenzieren. Es wird in der Stringtable nach den Textkonstanten gesucht, welche im Elementattribut von „script“ angegeben wurde. Es folgt die Vorlage für Reorganisation im Quellsystem als vollständiges Beispiel:

<?xml version=”1.0″ encoding=”UTF-8″ standalone=”yes”?>

<script tableid=”SCRIPT_DESCRIPTION” stringtable=”com.cisag.sys.tools.automaticreorganization.AutomaticReorganizationSourceScript” logging=”false”>

<!–instead of using the stringtable for the description of a command you can use the attribute description –>

<!– example: –>

<!– <action description=”Delete not used tables” command=”dltdbt -oltp -olap -table:%”/> –>

<action tableid=”DELETE_NOT_USED_TABLES” command=”dltdbt -oltp -olap -table:%”/>

<action tableid=”MAKE_TABLES_CONSISTENT” command=”rgzdbt -SBLOBs -configuration -repository -oltp -olap –modify”/>

<action tableid=”CHECK_IS_DELIVERABLE” command=”rgzrep –isdeliverable –verbose”/>

<action tableid=”CHECK_GENERATION_ERRORS” command=”chkdbt –analysetables –oltp –olap –repository –all”/>

</script>

5                     Customizing

Für die Anwendung „Automatische Reorganisation“ sind in der Anwendung „Custo­mizing“ keine Einstellungen fest­zulegen.

6                     Business Entitys

Für die Anwendung „Automatische Reorganisation“ ist das nachfolgende Business Entity relevant, das Sie beispielsweise verwenden, um

• Berechtigungen zu vergeben,
• Aktivitätsdefinitionen einzurichten oder
• Daten zu importieren oder zu exportieren.

Automatische Reorganisation

com.cisag.sys.tools.automaticreorganization.obj.AutomaticReorganization

7                     Berechtigungen

Berechtigungen können sowohl mithilfe der Berechtigungsrollen als auch durch die Zuordnung einer Organisation vergeben werden. Das Berechtigungskonzept können Sie in der Technischen Dokumen­tation Berechtigungen nachlesen.

7.1               Spezielle Fähigkeiten

Für die Anwendung „Automatische Reorganisation“ bestehen keine speziellen Fähigkeiten.

7.2               Organisations-Zuordnungen

Für die Anwendung „Automatische Reorganisation“ ist eine Organisations-Zuordnung nicht erforderlich.

7.3               Besonderheiten

Für die Anwendung „Automatische Reorganisation“ bestehen keine Besonderheiten.

7.4               Berechtigungen für Geschäftspartner

Die Anwendung „Automatische Reorganisation“ ist für Geschäftspartner nicht freigegeben.

8                     Vorgehensweisen

Lesen Sie nachfolgend, wie Sie mit der Anwendung „Automatische Reorganisation“ arbeiten:

• Reorganisation eines Systems als Vorbereitung zum Kopieren
• Reorganisation des als Kopie entstanden Systems

8.1               Reorganisation eines Systems als Vorbereitung zum Kopieren

1. Speichern Sie sich lokal die Datei des Datei-Entwicklungsobjektes com.cisag.sys.tools.automaticreorganization.AutomaticReorganizationSourceScript.
2. Überprüfen Sie ob die Datei angepasst werden muss: Parameter der Tools, fehlende Tools gegebenenfalls hinzufügen.
3. Speichern Sie die angepasste Datei im Knowledgestore des zu kopierenden Systems.
4. Öffnen Sie die Anwendung „Automatische Reorganisation“.
5. Laden Sie die zuvor im Knowledgestore gespeicherte Datei.
6. Wählen Sie „Alle Kommandos ausführen“.

8.2               Reorganisation des als Kopie entstanden Systems

1. Speichern Sie sich lokal die Datei des Datei-Entwicklungsobjektes com.cisag.sys.tools.automaticreorganization.AutomaticReorganizationTargetScript.
2. Überprüfen Sie ob die Datei angepasst werden muss: Parameter der Tools, fehlende Tools gegebenenfalls hinzufügen.
3. Speichern Sie die angepasste Datei im Knowledgestore des zu kopierenden Systems.
4. Öffnen Sie die Anwendung „Automatische Reorganisation“.
5. Laden Sie die zuvor im Knowledgestore gespeicherte Datei.
6. Wählen Sie „Automatische Reorganisation im Hintergrund“.