Application Server beenden (endsvr)

Mit dem Tool „endsvr“ (end semiramis application server) beenden Sie bzw. starten Sie den aktuellen oder einen anderen Semiramis Application Server bzw. ein ganzes Semiramis-System entweder mit der Verzögerung oder sofort durch. Ebenso können Sie ein bereits angefordertes verzögertes Herunterfahren bzw. Durchstarten rückgängig machen. Das Durchstarten ist immer nach Änderungen an bestimmten Konfigurations-Objekten, nach dem Austauschen von Klassen und nach Änderungen an den Property-Dateien notwenig, damit die Änderungen wirksam werden. In der Toolshell stehen zwei Aliases für diesen Befehl zur Verfügung, die ohne weitere Parameter ausgerufen werden können

  • „restart“ entspricht „endsvr –restart“
  • „stop“ entspricht „endsvr –stop“

1                  Zielgruppe

  • System-Administratoren
  • Technische Berater

2                  Begriffsbestimmung

Semiramis Application Server (SAS)

Ein Semiramis Application Server (SAS) verarbeitet über verschiedene Kommunikationskanäle gestellte Anfragen. Zur Laufzeit wird ein Semiramis Application Server durch einen Java-Virtual-Machine-Prozess realisiert, welcher die Semiramis-System-Engine ausführt. Die Definition der zum Start notwendigen Parameter (Name, Datenbankverbindungen, Basis-URL) erfolgt in der Systemkonfigurations-Datenbank.

3                  Beschreibung

Das Tool dient zu dem Beenden oder dem Durchstarten eines Semiramis Application Servers oder eines Semiramis Systems.

3.1             Befehl

Nachfolgend finden Sie den Befehl inklusive aller möglichen Parameter.

endsvr [-system:<id>] [-sas:<id>] [-start] [-restart]

[-svmParameters:<text>] [-stop]

[-clientAction:<vs>] [-when:<timeStamp>]

[-message:<text>]

3.2             Parameter

Die Parameter des Befehls werden in der folgenden Tabelle erläutert. Die in eckigen Klammern gesetzten Parameter sind optional, die anderen hingegen sind Pflichtparameter. Für einige Parameter kann ein Stern (*) als Platzhalter angegeben werden, um damit alle möglichen Werte ausgeben zu können. Nicht alle Parameter können mehrfach genannt werden; nur die, die folgenden Zusatz an den Parametervariablen aufweisen, sind für die Mehrfachnennung zugelassen: „<str-1> … <str–n>“.

Parameter Erläuterung
[-system:<id>] System, zu dem der ausgwählte Application-Server gehört. Standard ist das aktuelle System.
[-sas:<id>] Application-Server, der beendet oder durchgestartet werden soll. Standard ist der aktuelle Application-Server. Wenn nur der Parameter –system angegeben wird, ist wird der Message-Server des angegebenen Systems ausgewählt.
[-start] Ausgewählten Application-Server bzw. ausgewähltes System in Betrieb lassen.
[-restart] Ausgewählten Application-Server bzw. ausgewähltes System durchzustarten.
[-svmParameters:<text>] Beim Durchstartnen können mit diesem Parameter die Argumente für den Start des Application-Servers angegeben werden. Hiermit ist es beispielsweise möglich direkt nach dem Durchstarten eine Script-Datei auszuführen. Das Format für die Angabe ist identisch zu dem Format, beim Aufruf der Skript-Datei „semiramis.bat“ bzw. „semiramis.sh“. Es müssen optional die Parameter, der Namen des Application Servers und optional die auszuführenden Toolshell-Befehle angegeben werden. Beispiel:
-svmParameters:“-toolUser:USER SERVER call example.scl“ 
[-stop] Ausgewählten Application-Server bzw. ausgewähltes System beenden. Der erneute Start ist dann nur manuell auf dem jeweiligen Rechner möglich.
[-clientAction:<vs>] Aktion der übrigen Application-Server beim Herunterfahren des Message-Servers, d.h. des Systems, stattfinden soll. Dieser Parameter kann nur beim Herunterfahren eines Systems verwendet werden. Als Vorschlagswert ist „Undefiniert“. Die Mögliche Werte sind:

·       Undefiniert:1

·       Anhalten:2
Die übrigen Application-Server werden angehalten und warten auf den Erneuten Start des Message-Servers. Die Betriebsystem-Prozesse bleiben aktiv.

·       Herunterfahren:3
Die übrigen Application-Server werden ebenfalls heruntergefahren. Die Betriebsystem-Prozesse werden beendet und müssen manuell neu gestartet werden.
[-when:<timeStamp>] Zeitpunkt, zu dem das System bzw. der Application-Server des Systems verzögert durchgestartet oder heruntergefahren werden soll. Beispiel:

„07.09.2006 14:59:25″.
[-message:<text>] Nachricht, die allen angemeldeten Benutzer gesendet und im Meldungsprotokoll als Hinweis ausgegeben wird.

 

3.3             Berechtigungen

Das Berechtigungskonzept sowie die generellen anwendungsbezogenen und Entity-bezogenen Berechtigungen können Sie in der Technischen Dokumentation im Dokument Berechtigungen nachlesen.

Für dieses Tool existieren keine speziellen Berechtigungen.

3.4             Vorgehensweisen

3.4.1         Aktuellen Application-Server durchstarten bzw. herunterfahren

  • endsvr -restart
  • endsvr –stop

 

3.4.2         Aktuellen Application-Server vezögert durchstarten bzw. herunterfahren

  • endsvr –restart –when:< Zeitpunkt >
  • endsvr –stop –when:< Zeitpunkt >

3.4.3         Application-Server eines anderen Systems durchstarten

  • endsvr –restart –system:<System> -sas:<SAS>

3.4.4         Application-Server eines anderen Systems verzögert durchstarten

  • endsvr –restart –system:<System> -sas:<SAS> –when:< Zeitpunkt >

3.4.5         System herunterfahren

  • endsvr –stop –system:<System>

3.4.6         System herunterfahren und übrige Application-Server anhalten bzw. herunterfahren

  • endsvr –stop –system:<System> -clientAction:2
  • endsvr –stop –system:<System> -clientAction:3

Czy ten artykuł był pomocny?

Wyślij opnie