Customer System Control Center

Das Customer System Control Center (CSCC) ist ein System dessen primäres Ziel es ist das Bearbeiten von IT-Support-Anfragen und -Aufträgen effektiver zu gestalten. Mit Hilfe des CSCC ist es dem IT-Support-Mitarbeiter möglich noch während des Telefonats einer neuen IT-Support-Anfrage wichtige Systemparameter des Geräts des Kunden zu prüfen ohne sich dafür über Fernzugriff aufschalten zu müssen.

Allgemeiner Aufbau

Die Software besteht aus drei Hauptkomponenten. Dem Autoit-Backend, welches für die Datenakquirierung zuständing ist, dem PHP-Skript, das die Daten entgegen nimmt und die Schnittstelle zur Datenbank darstellt und der Verwaltungs- / Übersichtswebseite.

Dem eigentlichen Autoit-Skript, welches jeweils in der aktuellsten Version auf einem Fileserver hinterlegt ist, ist ein kleineres Autoit-Skript vorangestellt, dessen einzige Aufgaben es sind die neuste Version des Hauptskripts herunterzuladen und auszuführen und eine temporäre Firewallausnahme für das Hauptskript einzurichten. Lediglich das vorangestellte, kleine Starterskript wird beim Kunden / zu überwachenden Gerät in den Autostart-Ordner gelegt. Durch diesen Aufbau wird gewährleistet, dass auf allen Geräten immer die neuste, gleiche Version der Software ausgeführt wird, was Kommunikationsprobleme mit dem Datenbankschnittstellen-Skript minimiert und zugleich das Erweitern und Einspielen von Patches extrem angenehm gestaltet.

Sowohl das Backend-Skript als auch das Starter-Skript laufen komplett headless, also ohne grafische Benutzeroberfläche, auf den Geräten und werden nach dem Start des Geräts ohne weiteres zutun des Anwenders ausgeführt. Im Idealfall bemerkt der Anwender nichts von der Ausführung der Software und wird in keinster Weise in der Nutzung seines Gerätes eingeschränkt.

Interaktion der Komponenten

Das Autoit-Backend sammelt mit Hilfe verschiedener Kommandozeilenbefehle diverse Systeminformationen und speichert diese teilweise lokal in Datei zwischen. Anschließend werden die Dateien via FTP temporär auf den Fileserver geladen und es wird ein POST-request an receiveCustomerData.php gesendet. Die POST-Parameter enthalten Informationen sowie die Dateinamen aller zuvor übertragenen Dateien. receiveCustomerData.php stellt die Verbindung zur Datenbank dar. Es nimmt die über POST-request gesendeten Informationen und schreibt diese, sowie den Inhalt der übermittelten Dateien in die Datenbank. Anschließend löscht das Autoit-Skript nochmal alle zuvor übermittelten Dateien vom FTP-Fileserver, da diese nun, wo ihr Inhalt in der Datenbank gespeichert ist, nichtmehr gebraucht werden. Wenn die Übersichtswebseite aufgerufen wird bezieht diese über PHP alle zuvor gespeicherten Informationen aus der Datenbank und erlaubt das übersichtliche Verwalten und Einsehen dieser.

Website

Die Webseite besitzt drei grundlegende Ansichten/Bereiche. Die Gruppenverwaltung, die Geräteübersicht und die Archivansicht.

Geräteübersicht

In der Geräteübersicht werden alle registrierten Geräte angezeigt die der ausgewählten Gruppe zugewiesen sind. Dazu kann oben im Filter-Dropdown-Menü eine Gruppe ausgewählt werden, nach welcher gefiltert werden soll. Ist keine Gruppe ausgewählt (default), so werden einfach alle registrierten Geräte angezeigt. Die Geräte werden in dieser Ansicht mit Nutzername@Rechnername kenntlich gemacht.

Durch das anklicken eines Buttons in einem Geräteeintrag wird ein Menü zur weiteren Inspektion des gewählten Punktes ausgeklappt, welches sich mit den Pfeiltasten am oberen Rand ausblenden und auch wieder einblenden lässt(s. Abb.2).

• 
  Abb.1: Geräteübersicht
• 
  Abb.2: Geräteübersicht ausgeklappt

Wurde in der Geräteübersicht ein Gruppenfilter gewählt werden alle dieser Gruppe zugewiesenen Geräte angezeigt. Diese lassen sich an dieser Stelle durch einen Klick auf das Kreuz in der oberen rechten Ecke des Geräteeintrags (s. Abb. 3) wieder aus der Gruppe entfernen, für den Fall, dass sie fälschlicherweise zugewiesen wurden oder man sieeiner anderen Gruppe zuordnen möchte.

Abb.3: Gruppenzuweisung entfernen

Archivansicht

Die Archivansicht stellt die Sammlung aller eingegangenen Informationen eines Geräts dar. Man gelangt zu ihr, indem man in einem Geräteeintrag der Geräteübersicht auf das Schraubenschlüsselsymbol hinter Archive klickt(s.Abb.4).

Abb.4: Archivansicht öffnen

Die Archivansicht für ein Gerät stellt jeden eingegangenen Eintrag für dieses Gerät, nach Datum sortiert, wie einen eigenen Geräteeintrag dar. Über die Filterfunktion am oberen Rand lässt sich hier nach Einträgen aus einer bestimmten Zeitspanne suchen. Wie auch schon bei der Geräteübersicht lässt sich durch das auswählen eines Buttons in einem Archiveintrag ein Inspektionsfenster einblenden, welches sich anschließend durch die Pfeiltasten am oberen Rand aus- und wieder einblenden lässt. Im Gegensatz zu den Geräteeinträgen der Geräteübersicht werden die Einträge in der Archivansicht mit ihrem Timestamp gekennzeichnet.

Abb.5: Archivansicht

Gruppenverwaltung

In der Gruppenverwaltung werden alle Geräte aufgelistet, welche noch keiner Gruppe zugeordnet wurden und können dort einfach über ein Dropdown-menü einer bestehenden Gruppe zugeordnet werden. Auf der rechten Seite lassen sich die Gruppen selbst bearbeiten. Mit dem Eingabefeld und dem Button "new" lassen sich einfach neue Gruppen erstellen. Das Klicken auf das "x" hinter einer Gruppe löscht diese und markiert alle mit ihr verbundenen Geräte wieder als nicht zugewiesen.

Abb.6: Gruppenverwaltung

Das Klicken des Schraubenschlüsselsymbols hinter einer Gruppe bringt eine zusätzliche Eingabemaske hervor, mit deren Hilfe man den Gruppennamen editieren kann (s. Abb. 6).

Abb.7: Gruppenname editieren

Das Entfernen einer Zuweisung funktioniert in der Geräteübersicht wenn der entsprechende Filter gewählt ist.

Schritt für Schritt: Neue Daten überwachen/loggen

Um neue Daten in das Program einzupflegen die überall nutzbar sein sollen muss es an mehreren Stellen erweitert werden.

Autoit

1. Zuerst muss eine neue Funktion in der Region "Data Collectors: Files" erstellt werden, welche die gewünschten Daten abfrägt und in einer Datei speichert. Dazu kann man sich an den anderen Funktionen in der Region orientieren. Ein Beispiel einer solchen Funktion wäre:

;get startup Programs and save it in a file
Func getStartup()
  RunWait(@ComSpec & ' /c wmic /OUTPUT:"' & @LocalAppDataDir & '\dataFiles\startup.html" startup list /format:hform',"", @SW_HIDE)
  trimDataFileHeader(@LocalAppDataDir & '\dataFiles\startup.html')
EndFunc

Wichtig ist hierbei, dass die erzeugte Datei im Ordner \dataFiles erstellt wird und dass, sofern wmic zum akquirieren der Daten zum Einsatz kommt, noch die Funktion "trimDataFileHeader" auf die neu erstellte Datei angewendet wird. "trimDataFilesHeader" bringt den von wmic erstellten Header in ein ansehnliches Format und (viel wichtiger) hat den Nebeneffekt, dass sich die erstellte Datei anschließend die benötigte Kodierung (UTF-8 ohne BOM) aufweist.

2. Nun muss ein Aufruf der neu erstellte Funktion in der Funktion "executeAllDataCollectors" ergänzt werden.

3. Anschließend gilt es die Funktion "createPOSTParamString" zu erweitern. Für die neu erstellte Datei muss zuerst eine Zeile mit dem folgenden Aufbau ergänzt werden:

$startup = $macAdd & "_" & "startup.html"

Die neue Variable (hier $startup) enthält den Namen der neu erstellten Datei unter dem sie auf dem Fileserver abgespeichert wurde.

Dann muss diese neue variable als zusätzlicher POST-Parameter an den POST-Parameter-String angehängt werden:

$postParams &= '&startup='& $startup

Datenbank/Datenbankschnittstelle

Hier müssen zuerst die Datenbanktabellen erweitert werden und anschließend die Datenbankschnittstelle (receiveCustomerData.php) ergänzt werden.

1. Die Tabelle MonitoringData muss um eine Spalte für die neuen Informationen erweitert werden. Beim Typ der Spalte sollte es sich um blob oder für besonders lange/große Dateien um longblob handeln.

2. Die Tabelle MonitoringDataArchive muss um die selbe Spalte (gleicher Typ, gleicher Spaltenname) erweitert werden.

3. Jetzt muss die Datei receiveCustomerData.php ergänzt werden. Das ist der kritischste Schritte beim Hinzufügen neuer Daten, da hier schnell Flüchtigkeitsfehler entstehen können. Zuerst muss eine neue Variable angelegt werden, welche für bind_param benötigt wird:

$startup = NULL;

Nun müssen an drei Stellen (Update, Insert, InsertArchive), jeweils mehrere Änderungen vorgenommen werden. - zuerst muss jeweils die SQL-query, analog zu den schon vorhandenen, um die neue Tabellenspalte erweitert werden. Eine solche Query sieht z.B. so aus:

$sqlUpdate = "UPDATE MonitoringData SET ComputerName = ?, UserName = ?, RamSize = ?, NameCPU = ?, Cores = ?,
LoadPercentage = ?, OSVersion = ?, SysArch = ?, Ping =  ?, IPConfig = ?, NetConfig = ?, SystemInfo = ?, Bios = ?,
SysDriver = ?, CPU = ?, OnboardDev = ?, Programs = ?, Startup = ?, MemoryChip = ?, PhysDrive = ?, LogDrive = ?,
Partition = ?, Volume = ?, SoundDev = ?, Printers = ?, PrinterConfig = ?, UserAcc = ?, Timestamp = Now()
WHERE MacAddress=?;";

oder so:

$sqlInsert = "INSERT INTO MonitoringData (MacAddress, ComputerName, UserName, RamSize, NameCPU, Cores, LoadPercentage,
OSVersion, SysArch, Ping, IPConfig, NetConfig, SystemInfo, Bios, SysDriver, CPU, OnboardDev, Programs, Startup, MemoryChip,
PhysDrive, LogDrive, Partition, Volume, SoundDev, Printers, PrinterConfig, UserAcc, Timestamp)
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, Now())";

Anschließend muss jeweils der Aufruf von "bind_param" angepasst werden. Dabei ist darauf zu achten, dass die neue zu bindende Variable für unsere neuen Daten an die richtige Stelle gesetzt wird (also, dass ihre relative Position zu den anderen Variablen mit der Position des Tabellenspaltennamens in der SQL-query übereinstimmt). Zudem muss ein, im ersten Parameter der bind_param übergeben wird definierter, Typ für die neue zu bindende Variable an der entsprechenden Stelle ergänzt werden. i steht in dem string für integer, s für string, d für decimal und b für blob (und auch alle Varianten davon, wie z.B. longblob). Ein solcher Aufruf von bind_param sieht z.B. so aus:

$stmtUpdate->bind_param('ssdsiisssbbbbbbbbbbbbbbbbbbs', $comName, $userName, $ramSize, $nameCPU, $cores, $loadPercentage,
$osVer, $sysArch, $ping, $ipConfig, $netConfig, $sysInfoOut, $bios, $sysDriver, $cpu, $onboardDev, $programs, $startup,
$memoryChip, $physDrive, $logDrive, $partition, $volume, $soundDev, $printers, $printerConfig, $userAcc, $mac);

Nun muss noch jeweils eine Zeile ergänzt werden um den Inhalt, der vom Autoit-Skript an den Server übermittelten Datei, in die Variable, die wir mit bind_param an unsere neue Tabellenspalte (des Typ blob) gebunden haben, zu laden. Eine solche Zeile sieht z.B. so aus:

$stmtUpdate->send_long_data(17, file_get_contents("TempFiles/".$_POST["startup"]));

Der String in $_POST[] entspricht dabei dem namen des gesendeten POST-Parameters (so wie wir ihn im Autoit-Skript festgelegt haben). Die Zahl vorne (hier: 17) entspricht dabei der Position der zu füllenden Variable im Aufruf von bind_param (WICHTIG: Die Zählung startet bei 0). Falls die Variable nicht am Ende hinzugefügt wurde muss natürlich in allen direkt folgenden Aufrufen von send_long_data der Index der zu füllenden Variable auch noch um 1 verschoben werden, da wir ja eine neue Variable dazwischen geschoben haben.

Wenn all diese Änderungen an allen drei Stellen (Update, Insert, InsertArchive) richtig durchgeführt wurden, sollte das Autoit-Skript nun erfolgreich durchlaufen und alle gewünschten Datenbanktabelleneinträge sauber anlegen.

Webseite

Damit die Daten aus der Webseite ordentlich angezeigt werden können müssen zuerst die neuen Buttons erstellt werden und anschließend das Inspektorfensters mit dem entsprechenden Inhalt gefüllt werden.

1. Zuerst muss in den Dateien displayStatusEntries.php und displayArchiveData.php jeweils mit dem folgenden Code ein neuer Button angelegt werden.

 //Startup
 echo "<div class=\"col-xs-6 entryValues\"><div class=\"row inspectLinkEntry\">".'<a class="chooseInspectButton"
 href="'.$_SERVER['PHP_SELF'].'?inspect=true&groupFilter='.$groupFilterID.'&mac='.$row["MacAddress"].'&startup=1">Startup</a>'."</div></div>";	

An der Stelle "&startup=1" muss natürlich statt "startup" der Name des gewählten POST-Parameters sein und "Startup" entspricht dem Anzeigenamen der auf der Webseite auf dem Button steht.

2. Anschließend müssen noch die eigentlichen Daten ins Inspektorfenster geladen werden. Dafür muss in der inspectEntryDetail.php erst zweimal der folgende Code ergänzt werden um den Titel des Inspektorfensters zu setzen.

 if(isset($_GET['startup'])){
 echo '<p>Startup programs:</p>';
 }

Der String in $_GET[] muss dabei dem entsprechen was vorher als POST-Parameter gewählt wurde. "Startup Programs" entspricht in diesem Fall dem Anzeigetext / Titel des Inspektorfensters.

Damit nun tatsächlich der Inhalt angezeigt wird muss für die normale Ansicht der folgende Code ergänzt werden:

 //display startup
 if (($row["MacAddress"] == $_GET['mac'])and isset($_GET['startup'])) {
 echo '<pre>'.$row['Startup'], 'UTF-8', 'UCS-2LE'.'</pre>';
 }

Der String in $_GET[] muss dabei wieder dem entsprechen was vorher als POST-Parameter gewählt wurde und der String in $row[] muss dem Spaltennamen aus der Tabelle entsprechen.

Für die Archivansicht muss der folgende Code ergänzt werden:

 //display startup
 if (($row["Timestamp"] == $_GET['timestamp'])and isset($_GET['startup'])) {
 echo "<pre>".$row['Startup']."</pre>";
 }

Der String in $_GET[] muss dabei wieder dem entsprechen was vorher als POST-Parameter gewählt wurde und der String in $row[] muss dem Spaltennamen aus der Tabelle entsprechen.

Datenbank

Das System arbeitet auf der Datenbank adriensql2 mit vier Tabellen. Die Tabellen Groups und DeviceAssignments beinhalten alle vom Nutzer erstellten Gruppen und die Zuweisung der Geräte zu den Gruppen. Die Tabelle MonitoringData ist die Haupttabelle und beinhaltet alle aktuellen Daten der Geräte. Dabei wird die MacAdresse der Geräte als PrimaryKey für die Tabelle verwendet. Jede Information zu dem Gerät belegt eine eigene Spalte der Tabelle. Die Tabelle MonitoringDataArchive speichert alle jemals eingegangenen Geräteeinträge jedes Geräts. Logischerweise ist der PrimaryKey hier ine fortlaufende ID statt der MacAdresse, da für jedes Gerät mehrere Einträge gespeichert werden sollen.

Webserver: http://s1.agilos-webhosting.de
DB: adriensql2
Pw: AgiStatus

Sonstiges

Zusatzfunktionalität in Google Chrome

Die Webseite nutzt ein paar HTML5 Komponenten wie z.B. das details-Tag, welche noch nicht vollständig von allen Browsern unterstützt werden. Obwohl die Webseite primär für Firefox gebaut wurde, werden HTML5-Tags verwendet, welche Firefox noch nicht unterstützt, da es für Firefox-Nutzer keinen direkten Nachteil bedeutet. Wird die Webseite über Chrome aufgerufen werden lediglich manche Bereiche der Einträge der Übersichtlichkeit halber ausklappbar dargestellt. Das erleichtert die Navigation durch die großen Datenmengen geringfügig.