Kapitelübersicht

1. Programmstruktur und Kommunikation
2. Vorbemerkung
3. Entpacken der hfp auditSuite.zip
   1. Vorbereitung des MS SQL Servers
   2. Überprüfen / Aktivieren des TCP/IP-Protokolls des MS SQL-Servers
   3. Überprüfen / Aktivieren der MixedMode-Authentifizierung des MS SQL Servers
4. Server-Login und Datenbank anlegen
   1. Server-Login anlegen
   2. Datenbank anlegen
5. Vorbereitung der Installation / Bereitstellungen
6. Installation hfp auditService
   1. Funktionstest
   2. Firewall
   3. Windows-Ereignisanzeige
7. Bereitstellung der Client-Anwendungen
   1. hfp auditEditor
      1. Bereitstellung
      2. Funktionstest
   2. hfp auditManager
      1. Bereitstellung
      2. Funktionstest
8. Glossar

Vorbemerkung

Programmstruktur und Kommunikation

Installations- und Bereitstellungsanleitung für die hfp auditSuite

Vorbemerkung

Die hfp auditSuite besteht aus drei Programm-Komponenten sowie einer MS SQL-Server-Datenbank. Die drei Komponenten sind:

• der hfp auditEditor. Diese Windows-Anwendung dient der Prüfungsdurchführung.
• der hfp auditManager. Diese Windows-Anwendung dient der Verwaltung aller prüfungsrelevanter Daten und Dateien.
• der hfp auditService. Dieser Windows-Service stellt das Bindeglied zwischen der Datenbank und der Ablage prüfungsrelevanter Datendateien einerseits und den zwei Anwendungen andererseits dar.

Jede der drei Komponenten ist als sogenannte „portable Anwendung“ konzipiert, um sowohl größtmögliche Flexibilität hinsichtlich der Installation/Bereitstellung zu gewährleisten, als auch das Einspielen von Updates signifikant zu vereinfachen.

Die Installation der hfp auditSuite wird in folgenden Schritten beschrieben:

• Vorbereiten des MS SQL-Servers. 
• Bereitstellen der MS SQL-Server-Datenbank „hfpAuditDB“ .
• Vorbereitung der Installation / Breitstellungen.
• Installation hfp auditService.
• Bereitstellen hfp auditEditor.
• Bereitstellen hfp auditManager.

Entpacken der hfp auditSuite.zip

Entpacken Sie die Ihnen von hfp zur Verfügung gestellte Datei „hfp auditSuite_vX.X.zip“ (vX.X steht für die Versionsnummer) in ein Verzeichnis Ihrer Wahl. Dieses Verzeichnis wird im Weiteren als <Installationsquelle> bezeichnet.

Vorbereitung des MS SQL Servers

Sollten Sie auf dem MS SQL-Server bereits hfp-Datenbanken („pm_*“) in Betrieb haben, können Sie direkt zu Abschnitt 2.4 springen.

Es wird hier von einer englischen MS SQL-Server-Version ausgegangen.

Überprüfen / Aktivieren des TCP/IP-Protokolls des MS SQL-Servers

1. Öffnen Sie den „SQL Server Configuration Manager“.
2. Wählen Sie „SQL Server Network Configuration“ -> Wählen Sie „Protocols for {Servername}“
3. Setzen Sie TCP/IP auf „Enabled“.

Sollte TCP/IP nicht bereits aktiviert gewesen sein:

4. Machen Sie bitte einen Doppelklick auf „TCP/IP“, wechseln Sie danach auf den Reiter „IP-Adressen“, scrollen Sie nach unten bis zu dem Eintrag „IPALLl“ und:

• Entfernen Sie ggf. den Eintrag für „TCP Dynamic Ports“
• Geben Sie als Eintrag für „TCP Port“ den Wert „1433“ ein

5. Bestätigen Sie Ihre Eingaben mit „OK“.

6. Starten Sie im Anschluss den SQL Server neu.

Überprüfen / Aktivieren der MixedMode-Authentifizierung des MS SQL Servers

1. Öffnen Sie das MS SQL Management Studio.
2. Verbinden Sie sich mit dem Server auf dem die MS SQL-Datenbank der hfp auditSuite installiert werden soll. Sie benötigen Administrationsrechte.
3. Öffnen Sie die „Properties” auf Serverebene.
4. Wählen Sie „Security”.
5. Wählen Sie „SQL Server and Windows Authentication mode”.
6. Bestätigen Sie Ihre Eingaben mit „OK”.

Server-Login und Datenbank anlegen

Server-Login anlegen

1. Führen Sie die hfp auditDB-MsSql_Vx.x.x.exe aus. Diese befindet sich im Unterverzeichnis „hfp auditDatabase“ Ihrer <Installationsquelle>.
2. Wählen Sie „Login“.
3. Tragen Sie den Namen Ihres MS SQL-Servers und bei Datenbank „master“ ein.
4. Setzen Sie den Haken „Windows-Authentifizierung“:

   Wenn Sie das Programm auf Ihrem MS SQL-Datenbankserver gestartet haben, funktioniert die Windows Authentifizierung in den meisten Fällen. Ist dies nicht der Fall oder die Anmeldung ist nicht möglich, entfernen Sie den Haken und melden sich mit Ihrem MS SQL-Server-Administrator (i.d.R. „sa“) und dem dazugehörigen Passwort an.

5. Wählen Sie nach erfolgreicher Anmeldung „Server Login erstellen [hfp_audituser]“.

6. Bestätigen Sie die Abfrage mit „Ja“ und die anschließende Erfolgsmeldung mit „Ok“.

Datenbank anlegen

Sollten Sie nicht am MS SQL-Server angemeldet sein, führen Sie die Schritte 1 - 4 aus, die unter „2.4.1 Server-Login“ beschrieben sind.

1. Wählen Sie „Datenbank erstellen“.
2.  Bestätigen Sie die Voreinstellungen mit „OK“
3. Wählen Sie „Erstellungsskripte ausführen bzw. die DB aktualisieren“.
4. Stellen Sie sicher, dass beide Haken gesetzt sind und wählen Sie „Ausführen“.
5. Bestätigen Sie die folgende Erfolgsmeldung und verlassen Sie das Programm über „Beenden“.

Vorbereitung der Installation / Bereitstellungen

Stellen Sie sicher, dass Ihnen Ihre drei Lizenzdateien (*.asal, *.aeal, *.amal) sowie Ihr 16-stelliger Lizenzschlüssel vorliegen.

Installation hfp auditService

Obwohl es sich bei dem hfp auditService um eine portable Anwendung handelt, gilt für diesen eine Einschränkung:

• Soll der hfp auditService nach erfolgter Installation in einem anderen als dem bisherigen Verzeichnis ausgeführt werden, muss er deinstalliert und danach in dem neuen Verzeichnis erneut installiert werden.

Zunächst ist zu entscheiden, auf welchem Rechner die Installation des hfp auditService erfolgen soll. Da die einzige Voraussetzung die Erreichbarkeit über TCP darstellt, kommen theoretisch alle im Netzwerk erreichbaren Rechner als Installationsziel in Frage.

Aufgrund von Microsoft Lizenzvorgabgen muss dieser aber auf einem Windows Server installiert werden.

Unsere Empfehlungen zur Auswahl des Installationsrechners für den hfp auditService lauten:

• Ist ein Terminal-Server im Einsatz, werden die Anwendungs­programme höchstwahr­scheinlich auf diesem bereitgestellt. Damit bietet es sich an, auch den hfp auditService auf diesem zu installieren.
• Alternativ kann die Installation auf dem MS SQL-Server erfolgen.

Weiterhin ist zu entscheiden, wo die Installation des hfp auditService erfolgen soll.
Obwohl frei wählbar, schlagen wir aus Standardisierungsgründen die folgenden Installations­verzeichnisse vor. Denkbare Szenarien sind:

• Bereitstellung auf einem Terminal Server oder dem MS SQL-Server:

C:\Programme(x86)\hfp\auditSuite\Server\auditService

• Bereitstellung in einer Netzwerkfreigabe oder einem verbundenen Netzlaufwerk:

\\Netzwerkfreigabe\hfp\auditSuite\Server\auditService
bzw. z.B. W:\hfp\auditSuite\Server\auditService

Sobald Sie sich für ein Szenario entschieden haben, führen Sie bitte die folgenden Schritte durch:

1. Legen Sie das Verzeichnis für den hfp auditService an, dieses wird im Weiteren als <Installationsziel> bezeichnet.
2. Kopieren Sie den Inhalt des Unterverzeichnisses „hfp auditService“ aus Ihrer <Installationsquelle> in das <Installationsziel>.
3. Legen Sie Ihre Lizenzdatei mit der Endung „.asal“ im <Installationsziel> ab.
4. Führen Sie die Datei „auditService.exe“ im <Installationsziel> aus. (Es werden erforderliche Voreinstellungen generiert.)
5. Überprüfen und korrigieren Sie ggf. den Namen Ihres MS SQL Servers und belassen Sie die übrigen Voreinstellungen.
   Einstellung „Dateiablage-Basisverzeichnis“:In dem hier anzugebenden Verzeichnis werden Prüfungsrelevante Dateien abgelegt. Daher ist es naheliegend ein Verzeichnis einzutragen, dass in Ihrer Datensicherung enthalten ist. Dies kann, außer einem lokalen Verzeichnis, auch eine Netzwerkfreigabe sein. Im Falle einer Netzwerkfreigabe ist zu beachten, dass der UNC-Pfad zu der Freigabe eingetragen werden muss; die Eingabe eines LW-Buchstabens funktioniert hier nicht.
6. Wählen Sie „Test“ und bestätigen Sie die Meldung bei Erfolg mit „OK“.
7. Speichern Sie die Einstellungen in der Datei „SystemConfig.xml“ mit einem Klick auf „Ja“.
8. Wählen Sie „Installieren“ und bestätigen Sie die Erfolgsmeldung mit „OK“.

Wurde bei Punkt 1 ein Netzwerk- als Installationslaufwerk gewählt oder bei Punkt 5 ein UNC-Pfad eingetragen, wird noch folgender Hinweis angezeigt:

Bitte folgen Sie im „Nachgang“ dieser Anweisung.
Hintergrund ist, dass das Konto „Local System“, unter dem Dienste in der Regel laufen, keinen Zugriff auf Netzwerk-Ressourcen besitzt. Dies können Sie in der Ereignisanzeige überprüfen.

Funktionstest

1. Starten Sie im <Installationsziel> das Programm ‚auditService-Test.exe‘.
2. Bei Erfolg wird Ihnen eine Meldung ähnlich der folgenden angezeigt: Der Verbindungstest zum hfp auditService auf <Rechnername> am 20.09.2019 um 21:20:24 Uhr war erfolgreich

Firewall

Wird nach dem Abschluss der Client-Bereitstellungen wenigstens eine der Client­anwendungen auf einem anderen als dem hfp auditService-Rechner ausgeführt, so ist auf dem hfp auditService-Rechner eine Firewall-Regel einzurichten, welche eingehende Verbindungen auf dem Port „7771“ zulässt:

1. Öffnen Sie „Windows Defender Firewall mit erweiterter Sicherheit“.
2. Wählen Sie „Eingehende Regeln“.
3. Wählen Sie „Neue Regel“.
4. Wählen Sie im Bereich „Regeltyp” „Port” aus.
5. Bestätigen Sie Ihre Eingaben mit „Weiter”. 
6. Im Bereich „Protokolle und Ports” wählen Sie „TCP“.
7. Tragen Sie „7771” im Feld „Bestimmte lokale Ports” ein.
8. Bestätigen Sie Ihre Eingaben mit „Weiter”.
9. Im Bereich „Aktion” wählen Sie „Verbindungen zulassen”.
10. Bestätigen Sie Ihre Auswahl mit „Weiter”, um in den Bereich „Profil” zu gelangen.
11. Entfernen Sie den Haken bei „Öffentlich”.
12. Bestätigen Sie Ihre Eingaben mit „Weiter”, um in den Bereich „Name” zu gelangen.
13. Vergeben Sie den Namen „hfp auditService”.

14. Bestätigen Sie alle Ihre Eingaben mit einem Klick auf „Fertigstellen”.

Windows-Ereignisanzeige

• Der hfp auditService schreibt Meldungen in das Windows-Protokoll „Anwendung“.
• Um bei Bedarf zu einer gefilterten Protokoll-Ansicht zu gelangen, befindet sich die Datei „hfp auditService_CustomEventViewer.xml“ im Unterverzeichnis „Eventviewer“ im <Installationsziel>. Diese Datei kann in die Ereignisanzeige importiert und damit in diese integriert werden:[1]

[1] Zum Erstellungszeitpunkt dieser Anleitung kam es zu Pro­­blemen bei der Anzeige be­nutzer­­­­­­definierter Ansichten: https://www.heise.de/newsticker/meldung/Juni-Sicherheitsupdates-sabotieren-Ereignisanzeige-in-allen-Windows-Versionen-4446733.html

Bereitstellung der Client-Anwendungen

hfp auditEditor

Bereitstellung

Zunächst ist zu entscheiden, wo die Bereitstellung des hfp auditEditor erfolgen soll.
Obwohl frei wählbar, schlagen wir aus Standardisierungsgründen die folgenden Bereitstellungs­verzeichnisse vor. Denkbare Szenarien sind:

• Bereitstellung auf einem Terminal Server:

C:\Programme(x86)\hfp\auditSuite\Clients\auditEditor

• Bereitstellung in einer Netzwerkfreigabe:

\\Netzwerkfreigabe\hfp\auditSuite\Clients\auditEditor

• Bereitstellung auf einem Netzwerk-Client (z.B. einem Laptop):

C:\Programme(x86)\hfp\auditSuite\Clients\auditEditor

Sobald Sie sich für ein Szenario entschieden haben, führen Sie bitte die folgenden Schritte durch:

1. Legen Sie das Verzeichnis für den hfp auditEditor an, dieses wird im Weiteren als <Bereitstellungsziel> bezeichnet.
2. Kopieren Sie den Inhalt des Unterverzeichnisses „hfp auditClients\hfp auditEditor“ aus der <Installationsquelle> in das <Bereitstellungsziel>.
3. Legen Sie Ihre Lizenzdatei mit der Endung „.aeal“ im <Bereitstellungsziel> ab.
4. Legen Sie eine Verknüpfung auf dem Terminal-Server- oder Clientdesktop an. Ziel der Verknüpfung ist die Datei „AEFramework.exe“ im <Bereitstellungsziel>.
5. Fügen Sie der Verknüpfung das Icon ‚‚application.ico“ aus dem <Bereitstellungsziel> hinzu.
6. Nennen Sie im <Bereitstellungsziel> die Datei „SystemConfig.xml_template“ um in „SystemConfig.xml“.
7. Wird der hfp auditEditor nicht auf dem gleichen Rechner wie der hfp auditService ausgeführt, ist folgendes auszuführen:

• • Ermitteln Sie den Namen und/oder die IP-Adresse des Rechners, auf welchem der hfp auditService ausgeführt wird.
  • Öffnen Sie im <Bereitstellungsziel> die Datei „SystemConfig.xml“ mit einem Texteditor.
  • Scrollen Sie bis zu der folgenden Zeile:<ServerListenerPrefix>http://localhost:7771/AuditServer</ServerListenerPrefix>. Ersetzen Sie in dieser „localhost“ durch „<ermittelter Rechnername oder IP-Adresse>“ (ohne die spitzen Klammern).
  • Speichern Sie die Datei.

Funktionstest

1. Starten Sie im <Bereitstellungsziel> das Programm ‚auditService-Test.exe‘.
2. Bei Erfolg wird Ihnen eine Meldung ähnlich der folgenden angezeigt: Der Verbindungstest zum hfp auditService auf <Rechnername> am 20.09.2019 um 21:20:24 Uhr war erfolgreich!

hfp auditManager

Bereitstellung

Zunächst ist zu entscheiden, wo die Bereitstellung des hfp auditManager erfolgen soll.
Obwohl frei wählbar, schlagen wir aus Standardisierungsgründen die folgenden Bereitstellungs­verzeichnisse vor.

Denkbare Szenarien sind:

• Bereitstellung auf einem Terminal Server:

 C:\Programme(x86)\hfp\auditSuite\Clients\auditManager

• Bereitstellung in einer Netzwerkfreigabe:

\\Netzwerkfreigabe\hfp\auditSuite\Clients\auditManager

• Bereitstellung auf einem Netzwerk-Client (z.B. einem Laptop):

C:\Programme(x86)\hfp\auditSuite\Clients\auditManager

Sobald Sie sich für ein Szenario entschieden haben, führen Sie bitte die folgenden Schritte durch:

1. Legen Sie das Verzeichnis für den hfp auditManager an, dieses wird im Weiteren als <Bereitstellungsziel> bezeichnet.
2. Kopieren Sie den Inhalt des Unterverzeichnisses „hfp auditClients\hfp auditManager“ aus der <Installationsquelle> in das <Bereitstellungsziel>.
3. Legen Sie Ihre Lizenzdatei mit der Endung „.amal“ im  <Bereitstellungsziel> ab.
4. Legen Sie eine Verknüpfung auf dem Terminal-Server oder Clientdesktop an. Ziel der Verknüpfung ist die Datei „AMFramework.exe“ im <Bereitstellungsziel>.
5. Fügen Sie der Verknüpfung das Icon ‚‚application.ico“ aus dem <Bereitstellungsziel> hinzu.
6. Nennen Sie im <Bereitstellungsziel> die Datei „SystemConfig.xml_template“ um in „SystemConfig.xml“.
7. Wird der hfp auditManager nicht auf dem gleichen Rechner wie der hfp auditService ausgeführt:

• • Ermitteln Sie den Namen und/oder die IP-Adresse des Rechners, auf welchem der hfp auditService ausgeführt wird
  • Öffnen Sie im <Bereitstellungsziel> die Datei „SystemConfig.xml“ mit einem Texteditor.
  • Blättern Sie bis zu der folgenden Zeile:<ServerListenerPrefix>http://localhost:7771/AuditServer/</ServerListenerPrefix>. Ersetzen Sie in dieser „localhost“ durch „<ermittelter Rechnername oder IP-Adresse>“ (ohne die spitzen Klammern).
  • Speichern Sie die Datei.

Funktionstest

1. Starten Sie im <Bereitstellungsziel> das Programm ‚auditService-Test.exe‘.
2. Bei Erfolg wird Ihnen eine Meldung ähnlich der folgenden angezeigt: Der Verbindungstest zum hfp auditService auf <Rechnername> am 20.09.2019 um 21:20:24 Uhr war erfolgreich!

Glossar