AE-Scripts erstellen

Im Folgenden finden Sie Informationen zu AE-Scripts.

Scripts

Sie können angepasste Vorlagen und zugehörige Scripts erstellen. Wenn Sie Ihre Vorlagen erstellen, müssen Sie natürlich auch angepasste Scripts für diese Vorlagen haben, damit die neuen Regeln, die Sie in Ihren Vorlagen erstellt haben, ausgeführt werden. Mit dem Element scriptsDirectory in den Vorlageneinstellungen definieren Sie die Position, an der Ihre Scripts gespeichert werden. Wenn Sie einen bestimmten Abschnitt mit einem Script verlinken möchten, das die AE in Ihrem Abschnitt ausführen muss, müssen Sie das Script an der mit scriptsDirectory definierten Position speichern.

Es wird erwartet, dass alle erstellten Scripts, die von der Activation Engine ausgeführt werden sollen, bestimmten Kriterien entsprechen. Von wesentlicher Bedeutung ist es, dass die erstellten Scripts die von der Activation Engine an sie übergebenen Argumente, die im Abschnitt "ruleSet" der mit diesen Scripts verlinkten Vorlagendateien definiert sind, akzeptieren. Angenommen, der Abschnitt "network" der Vorlagendatei enthält Folgendes:

<section name="network" script="ae_network.sh">
        <ruleset>
          <address>9.3.148.163</address>
          <mask>255.255.254.0</mask>
          <gateway>9.3.148.0</gateway>
          <routes>default:0:9.3.149.1</routes>
        </ruleset>
</section>

In diesem Fall wird erwartet, dass das Script ae_network.sh alle drei Argumente, die im eingeschlossenen RuleSet-Abschnitt definiert sind, akzeptiert: address, mask und gateway. Außerdem muss das Script einen gültigen Rückgabecode an die Activation Engine zurückgeben: 0 für ERFOLG oder 1 für FEHLER.

Der Rückgabecode 2 ist für SUCCESS_WITH_WARNINGS reserviert und informiert die AE darüber, dass das Script zwar erfolgreich ausgeführt wurde, aber geringfügige Warnungen ausgegeben wurden und dies in den Ausführungsprotokollen protokolliert werden muss. Außerdem wird erwartet, dass die Scripts ihre Ausgabe nicht über eine Pipe in eine externe Datei leiten. Alle ausführlichen Nachrichten und Fehlernachrichten müssen an die Standardausgabe (STDOUT) oder Standardfehlerausgabe (STDERR) gesendet werden, von wo aus sie von der AE über eine Pipe in die entsprechenden Zielprotokolldateien geleitet werden, die im Abschnitt mit den Vorlageneinstellungen definiert sind. Weitere Informationen finden Sie unter Vorlageneinstellungen.

Die Scripts stellen auch gewisse Erwartungen an die von Ihnen erstellten Vorlagen. Zunächst müssen alle angepassten Vorlagendateien der im Schema definierten Struktur entsprechen. Weitere Informationen finden Sie unter AE-Vorlagendatei erstellen . Die Vorlage muss einen Abschnitt "Settings" und einen Abschnitt "Rules" enthalten. Das Ausfüllen des Abschnitts "Settings" ist optional. Wenn einige oder gar keine Regeln im Abschnitt "settings" der Vorlage nicht ausgefüllt sind, werden die Regeln der übergeordneten Vorlage verwendet. (Die übergeordnete Vorlage ist die Vorlagendatei ae_template.xml.) Wenn die scriptsDirectory-Einstellungen nicht in der angepassten Vorlagendatei enthalten sind, kann die AE keine Scripts aufrufen, die in der übergeordneten Vorlage nicht definiert sind.

Der Abschnitt "rules" der XML-Datei muss ausgefüllt werden und der strengen Regelstruktur entsprechen:

<rules>
      <section name="SECTION_NAME" script="SCRIPT">
          <ruleset>
              <argument1>value1</argument1>
              <argument2>value2</argument2>
          </ruleset>
      </section>
</rules>

Im vorherigen Beispiel ist SCRIPT ein Platzhalter für eine angepasste Zeichenfolge, die das untergeordnete Script benennt. Für SCRIPT kann der Dateiname jedes vom System ausführbaren Scripts angegeben werden, sofern dessen Position im Element scriptsDirectory definiert ist. Das vorherige Script wird wie folgt ausgeführt:

PATH/SCRIPT argument1=value1 argument2=value2

Alle Argument-Wert-Paare werden in der zuvor beschriebenen Weise verarbeitet und an das Script übergeben. PFAD steht für den im Abschnitt "settings" definierten scriptsDirectory-Pfad. Weitere Informationen finden Sie unter Vorlageneinstellungen .