Ü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: ServerName ServerVersion InstanceId InstanceToken StartDate UpTime HttpRequests CurrentWarnings CurrentErrors CurrentCriticals OverallWarnings OverallErrors OverallCriticals 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

Browser nicht unterstützt