Enterprise Services API
- Former user (Deleted)
Übersicht
CLARC Enterprise Services sind Dienste welche als managed Services im Kontext des CLARC ENTERPRISE daemons ausgeführt werden. Ein Beispiel wäre der CLARC ASE daemon.
Jeder Enterprise Service muss eine Reihe von Funktionen und Start-Parametern unterstützen um entsprechend eingebunden werden zu können.
Ein Enterprise Service ist eine Windows-Konsolen-Anwendung.
Start-Parameter
Folgende Start-Parameter müssen von jedem Enterprise Service unterstützt werden:
Parameter | Bedeutung |
---|---|
instanceid | Die fortlaufende Nummer der lokalen Instanz des Services, beginnend bei 0. Wobei 0 die Master-Instanz definiert. |
instancetoken | 32 stellige eindeutige ID welche u.a. intern im Service als Authentifizierungs-Code für Web-Requests verwendet wird. |
port | Port-Nummer des integrierten Web-Services. Siehe auch Services und Ports. |
Aufrufbeispiel:
<clarc>\sys\ccasesrv.exe --instanceid=0 --instancetoken=B87B03B8A2C94E5297F7D372D721B9A6 --port=4410
Web-Service
Jeder Enterprise Service muss einen integrierten Web-Service mitbringen welcher nachfolgende Kommandos unterstützt:
Parameter | Bedeutung |
---|---|
/CCGETSTATUSXML | Im Ergebnis wird ein XML im Format CLARC Fast XML Format erwartet. Folgende Parameter müssen zurückgeliefert werden:
Weitere Informationsattribute können optional übergeben werden. |
/CCGETLOGXML | Im Ergebnis wird ein XML im Format CLARC Fast XML Format erwartet. Jeder Eintrag steht für eine Logzeile im internen Log-Format (siehe Logfiles und Logausgaben). Der Name der Property ist jeweils "Log". Die Anzahl der Logeinträge ist beliebig, wobei eine Menge von 1000 nicht überschritten werden sollte. Standard ist 100. |
/CCSHUTDOWN | Beim Aufruf dieses Kommandos soll sich der Dienst bei der nächsten Möglichkeit beenden. |
/CCREFRESH | Der Refresh Aufruf zeigt an, dass Konfigurationsänderungen vorliegen und diese aktualisiert werden sollen. |
/CCTRIGGER | Optionale Funktion welche als Trigger für interne Prozesse verwendet werden kann. |
Alle aufgeführten Funktionen müssen auf einen gültigen Url Parameter "AuthCode" prüfen. Dieser muss mit dem instancetoken übereinstimmen. Ist dies nicht der Fall, muss die Anfrage abgelehnt werden.
Beispielaufruf:
http://localhost:4410/ccgetstatusxml?authcode=B87B03B8A2C94E5297F7D372D721B9A6