SAPControl ist die Web-Service-Schnittstelle der sapstartsrv-Services/Daemons und kann auf Befehlszeilenebene verwendet werden. Er ist Teil des SAP-Kernels und auf allen unterstützten uiBetriebssystemplattformen (UNIX, Linux, Windows) verfügbar. Der Aufruf von SAPControl ohne andere Option liefert die Syntaxbeschreibung. Bei dem Befehl wird zwischen Groß- und Kleinschreibung unterschieden, und das Programm selbst sollte auf der Betriebssystemplattform UNIX/Linux in Kleinbuchstaben verwendet werden, während die Webmethoden und -optionen auf allen Betriebssystemplattformen eine Mischung aus Klein- und Großbuchstaben verwenden. Einige Grundlagen der Syntax sind in der folgenden Abbildung zu sehen, einschließlich eines Auszugs der Funktionen, der sogenannten Webmethoden.
Beispiel 1:
sapcontrol -user <sid>adm <Kennwort> -nr <Instanznummer> -function StartSystem LEVEL 1
Die Webmethode StartSystem wird mit dem PrioritätsparameterLEVEL und dem Wert 1 aufgerufen. Wie bei der SAP MC werden die Instanzen eines AS-Java-basierten SAP-Systems über einen sapstartsrvDaemon / Service gestartet. „LEVEL 1" bedeutet, dass alle Instanzen (einschließlich) mit Priorität 1 gestartet werden (es sei denn, sie werden bereits ausgeführt). In einem AS-Java-basierten SAP-System ist dies in der Regel nur die Central-Services-Instanz (SCS), aber keine weiteren Instanzen.
Beispiel 2:
sapcontrol -user <sid>adm <Kennwort> -nr <Instanznummer> -function StartSystem LEVEL 3
Mit StartSystem LEVEL 3 (entspricht StartSystem ALL) werden alle Instanzen des AS-Java-basierten SAP-Systems gemäß ihrer PrioritätLEVEL gestartet, sofern sie nicht bereits laufen. Dies ist die gleiche Vorgehensweise wie beim Starten des Systems über die SAP MC. Insgesamt ist es nicht wichtig, ob die Instanzen auf demselben Host oder auf verschiedenen Hosts ausgeführt werden.
Beispiel 3:
sapcontrol -user <sid>adm <Kennwort> -nr <Instanznummer> -function StopSystem LEVEL 3
Dieser Befehl stoppt alle Instanzen mit der PrioritätLEVEL 3 (PAS/AAS-Instanzen), aber keine anderen Instanzen mit einer höheren PrioritätLEVEL (z.B. SCS-Instanz mit PrioritätLEVEL 1). StopSystem ALL ist gleichbedeutend mit StopSystem LEVEL 1.
Beispiel 4:
sapcontrol -prot NI_HTTP -nr <Instanznummer> -function Start
Hier wird eine vertrauenswürdige Verbindung verwendet, um nur eine Instanz zu starten. Es wird kein Benutzername oder Kennwort angegeben, da die Betriebssystemauthentifizierung als „<sid>adm" ausreicht. Es ist jedoch nur möglich, Web-Methoden für den lokalen Host aufzurufen. Die Funktion StartSystem LEVEL 3 ist nicht möglich, da StartSystem möglicherweise mit Elementen auf anderen Hosts kommunizieren muss, was unter Trusted Connections nicht zulässig ist. Das bedeutet, dass nur Funktionen möglich und zulässig sind, die auf Instanzen basieren.
Beispiel 5:
sapcontrol –nr <Instanznummer> –systempki /usr/sap/<SID>/SYS/profile/<SID>_J<Instanznummer>_<Hostname> –function StartSystem ALL
Mit der Option -systempki ist es möglich, geschützte Web-Methoden ohne Einschränkung der Funktionalität für lokale Instanzen zu verwenden. Im Vergleich zum vorherigen Beispiel aktiviert diese Option die Funktion StartSystem ALL, auch wenn die Instanzen eines AS-Java-basierten SAP-Systems über verschiedene Server verteilt sind. Auf diese Weise macht die Option -systempki die Verwendung der Option -user <user_name> <password> obsolet.
Achtung
Vertrauenswürdige Verbindung für UNIX: -prot NI_HTTP; dies ist der Standardwert.
Vertrauenswürdige Verbindung für Windows: -prot PIPE
Siehe auch SAP-Hinweis 927637: https://me.sap.com/notes/927637
SAPControl bietet viele weitere Funktionen, insbesondere Überwachungsfunktionen sind beim Starten oder Stoppen von AS-Java-basierten SAP-Systemen sehr nützlich.