5. Übersicht - OCT-Applikation

Icon “Zurück”

• Bei Auswahl dieses Icons gelangen Sie zurück zur Startseite des Konfigurators.

Icon “Beenden”

• Bei Auswahl dieses Icons öffnet sich ein Dialog, in welchem das Beenden des Dienstes bestätigt werden muss.

• Der Status der Applikation wird auf “Beendet” geändert.

• Die Applikation kann nachdem sie beendet wurde, in der Menüleiste wieder über das Icon “Dienst starten” oder das Icon “Neu starten” gestartet werden.

Icon “Dienst starten”

• Dieses Icon steht nur zur Verfügung, wenn zuvor ein Dienst bzw. Applikation beendet wurde. Anstelle der Option "Beenden" wird in der Menüleiste nun "Dienst starten" angezeigt.

• Bei Auswahl dieses Icons öffnet sich ein Dialog, in welchem das Starten des Dienstes bestätigt werden muss bzw. der angehaltene Dienst wieder gestartet werden kann.

Icon “Neu starten”

• Bei Auswahl dieses Icons öffnet sich ein Dialog, in welchem das “Neu starten” des Dienstes bestätigt werden muss.

Icon “Deinstallieren”

• Bei Auswahl dieses Icons öffnet sich ein Dialog, in welchem das Deinstallieren des Dienstes bestätigt werden muss.

• Die aktuell geöffnete Applikation bzw. der aktuell geöffnete Dienst wird deinstalliert.

• Die Übersicht mit der Liste der installierten Applikationen auf der Startseite des Konfigurators wird automatisch neu geladen und die Applikation deinstalliert.

Lizenzschlüssel

• Geben Sie einen gültigen Lizenzschlüssel ein.

• Ein Lizenzschlüssel hat die Form “XXXX-XXXX-XXXX” und wird beim Kauf der Applikation standardmäßig mitgeliefert.

Datei

• Alternativ kann manuell aus dem Dateisystem eine Lizenzdatei ausgewählt werden.

• Über den Button “Wählen” öffnet sich Ihr lokaler Speicherort, wo Sie die entsprechende Lizenzdatei auswählen und öffnen können.

• Es wird eine Datei mit der Dateiendung “.lic” benötigt.

• Der Dateipfad wird im Eingabefeld angezeigt.

Host / Domäne

• Dieses Feld zeigt den Host (lokaler Benutzer) / die Domäne (Active Directory) an, unter welchem/r die Applikation installiert wurde.

• Der Host / die Domäne kann im Eingabefeld bearbeitet werden.

Benutzername

• Dieses Feld zeigt den Benutzernamen an, unter welchem die Applikation installiert wurde.

• Der Benutzername kann im Eingabefeld bearbeitet werden.

Wählen Sie aus den verfügbaren Konten kein Administratorkonto aus! Administratoren besitzen für die Aufgaben des Dienstes in einer Produktionsumgebung zu viele Rechte.

Passwort

• Eingabefeld für das Passwort des Benutzerkontos

Checkbox “Überprüfung der Anmeldeinformationen überspringen”

• Bei deaktivierter Checkbox erfolgt eine Verifizierung der Anmeldeinformationen (Benutzername und Passwort).

• Bei aktivierter Checkbox kann die Verifizierung der Installation übersprungen werden.

Benutzername

• Der Benutzername kann im Eingabefeld bearbeitet werden und muss auf dem System einmalig sein.

Passwort

• Eingabefeld für das Passwort des Benutzerkontos

Das gewählte Passwort muss den ggf. existierenden Anforderungen der Kennwortrichtlinien der Umgebung entsprechen.

Passwort wiederholen

• Eingabefeld für die Bestätigung des Passworts

Domäne

• Eingabe einer existierenden Active-Directory-Domäne.

Die Active-Directory-Ansicht verfügt über eine Domäneneingabe, die nach Belieben frei bearbeitet werden kann.

Benutzername

• Namenseingabe eines Active-Directory-Benutzers

Button “Suchen”

• Über den Button kann man in einem Active Directory die Liste der Benutzernamen durchsuchen.

Passwort

• Passwort des Active-Directory-Benutzers

Checkbox “Überprüfung der Anmeldeinformationen überspringen”

• Bei deaktivierter Checkbox erfolgt eine Verifizierung der Anmeldeinformationen (Benutzername und Passwort).

• Bei aktivierter Checkbox kann die Verifizierung der Installation übersprungen werden.

Hostname/IP

• Der Installationsassistent scannt nach verfügbaren Auswahlen und stellt diese als Drop-down zur Verfügung.

• Bei einer manuellen Eingabe muss der FQDN (vollständig qualifizierter Domainname) angegeben werden.

Port

• Bei einer HTTP-Installation wird die Verwendung von Port 80 empfohlen, da ansonsten beim Aufruf der URL die Portangabe erfolgen muss.

• Sofern ein anderer Port gewählt wird, sollte dieser nicht mit der Applikationsversionsnummer assoziiert sein, sondern generisch (z.B. 5100) lauten - da bei einem späteren Update die URL beibehalten werden soll.

• Bei der Eingabe eines Ports muss die Zahl zwischen 1 bis 49151 liegen.

• Falls ein Port bereits verwendet wird, erscheint eine Meldung, dass ein anderer Port gewählt werden muss.

Hostname/IP

Als Hostname kann verwendet werden:

• die IP Adresse des Servers

Vorteile:

• Sie funktioniert mit geringen Rechten für das Dienstkonto.

• OCT kann immer über diese IP-Adresse aufgerufen werden (ggf. mit HTTPS-Wartung), auch wenn ein Zertifikat einen anderen Namen definiert. Das ist wichtig, um zwischen Test und Produktivsystem umschalten zu können.

• Mehrere HTTPS-Installationen mit verschiedenen Ports sind auf dem Rechner möglich.

• Es ist keine DNS-Konfiguration erforderlich.

Nachteil:

• Es muss ggf. ein Loopback-Registry-Key gesetzt werden.

• der Hostname des Servers in kurzer Schreibweise.

Vorteile:

• OCT kann immer über diese Namen aufgerufen werden (ggf. mit HTTPS-Wartung), auch wenn ein Zertifikat einen anderen Namen definiert. Das ist wichtig, um zwischen Test und Produktivsystem umschalten zu können.

• Mehrere HTTPS-Installationen mit verschiedenen Ports sind auf dem Rechner möglich.

• Es ist keine DNS-Konfiguration erforderlich.

Nachteil:

• Es sind ggf. höhere Rechte für das Dienstkonto erforderlich.

• der Hostname des Server in langer Schreibweise (primärer FQDN Name).

• der Hostname, auf welchen das SSL Zertifikat ausgestellt wurde. Dieser Name kann z.B. “oct.firma.de” und der Hostname des Servers “app1.meinefirma.local” lauten.

Vorteile:

• Es kann über das DNS zwischen zwei Servern mit gleichlautendem FQDN umgeschaltet werden. Das ist wichtig, um zwischen Test und Produktivsystem umschalten zu können.

• Es kann ein öffentliches Zertifikat verwendet werden, welches den Rechner auch im Internet erreichbar macht. Dies erfordert dann aber weitere Sicherheitsvorkehrungen.

• Für zwei parallele Installationen von OCT unter HTTPS können zwei FQDN Namen definiert werden, z.B. einer für den Aufruf unter Port 443 und einer für den Aufruf unter einem anderen Port.

Nachteil:

• Alle FQDN Namen müssen im DNS Server konfiguriert werden. Vorher kann die OCT-Oberfläche nicht aufgerufen werden, auch nicht lokal auf dem Server.

Besonderheiten:

• Das SSL Zertifikat kann ein Wildcard Zertifikat sein, welches den Hostnamen nicht definiert.

• Sofern der Servername vom Hostnamen laut Zertifikat abweicht, muss ggf. ein Deaktivierung der Loopback Protection erfolgen, um OCT auf dem Server selbst aufrufen zu können. Siehe: https://saxess-software.atlassian.net/wiki/spaces/OH/pages/74089308/FAQ+-+Probleme+mit+der+Einrichtung+von+OCT#9.1-Beim-Anmeldeversuch-erscheint-die-Anmeldemaske-immer-wieder-und-die-Anmeldung-wird-(scheinbar)-nicht-akzeptiert

Der Konfigurator sucht nach möglichen Hostnamen/IPs und stellt diese als Drop-down zur Verfügung. Dazu liest er auch den Hostnamen aus dem ausgewählten Zertifikat aus und schlägt diesen vor.

Stellen Sie das Zertifikat

• auf den primären FQDN des Servers z.B. “app1.meinefirma.local” aus.

• auf einen beliebigen Alias FQDN Namen z.B. “oct.firma.de” aus

Die ausgestellte Zertifikatsdomain sollte mit den Angaben im Konfigurator übereinstimmen.

Port

• Bei einer HTTPS-Installation wird die Verwendung von Port 443 dringend empfohlen,

  • da ansonsten beim Aufruf der URL die Portangabe erfolgen muss.

  • da bei Konfiguration der Namensauflösung im DNS nur eine Ziel IP Adresse, aber kein Port, angegeben werden kann.

Zertifikat

• Zeigt alle Zertifikate des “lokalen Computers” und des “aktuellen Benutzers” an.

OCT erkennt ggf. gültige Zertifikate als ungültig an. Ein solches “ungültiges” Zertifikat kann trotzdem ausgewählt und die Installation fortgesetzt werden.

Experten können ggf. auch den Artikel “4.3. Austausch eines SSL-Zertifikats” verwenden.

Icon “Datenbankserver hinzufügen”

Icon “Datenbankserver bearbeiten”

Icon “Datenbankserver importieren”

Icon “Datenbankserver löschen”

Datenbankserver-ID

• Die ID muss eindeutig sein und ist auf bestimmte Zeichen beschränkt, da diese ID ein Teil der URL für den Datenbankaufruf wird.

• Erlaubte Zeichen:

• Nur wenn eine ID vergeben ist, kann der Button “Anwenden” ausgewählt werden

• Die ID sollte kurz gehalten werden und einen logischen Namen für den Datenbankserver definieren. Es sollte nicht der tatsächliche Servername sein, damit die URL bei einem Serverwechsel konstant bleibt.

Beschreibung

• Die Beschreibung ist kein Pflichtfeld.

• Im Eingabefeld kann z.B. eingetragen werden, welchen Zweck der Server erfüllt.

Server

• Definiert den zu verbindenden Server.

• Dieser Server muss existieren und mit der später eingestellten Authentifizierungsmethode zugänglich sein.

Instanz

• Name der SQL Instanz auf diesem Server, sofern eine benannte Instanz verwendet werden soll.

Windows-Authentifizierung

• Anmeldung am SQL Server über Windows-Authentifizierung mit dem OCT Service-Benutzer.

• Diese Authentifizierung sollte aus Sicherheitsgründen bevorzugt werden. Es wird dann das Windows Konto, unter welchem der OCT Dienst läuft, zur Anmeldung verwendet.

SQL Server-Authentifizierung

• Anmeldung mit Benutzernamen und Passwort (SQL Server Login)

Checkbox “Verschlüsseln”

• Bei aktivierter Checkbox wird die Datenübertragung vom und zum SQL Server verschlüsselt.

Checkbox “Serverzertifikat vertrauen”

• Bei aktivierter Checkbox wird die Überprüfung der Zertifikatskette bei einer verschlüsselten Verbindung übersprungen, so dass eine Verbindung trotz unvollständig konfigurierten Zertifikaten möglich ist.

• Es wird die Transportebene SSL verwendet, um den Kanal zu verschlüsseln.

Sind “Verschlüsseln” und “Trust-Server-Zertifikat” aktiviert, so wird die auf dem Server angegebene Verschlüsselungsstufe verwendet.
Das trifft auch zu, wenn Encrypt in der Verbindungszeichenfolge deaktiviert ist; andernfalls schlägt die Verbindung fehl.

Anzeigefeld für die Verbindungszeichenfolge

• Es zeigt basierend auf den oberhalb getätigten Eingaben und Auswahlen die resultierende Verbindungszeichenfolge an.

Button “Verbindung testen”

• Bei Auswahl des Buttons wird die Verbindung zum Server auf dessen Funktionalität getestet.

• Ist der Test erfolgreich, erscheint neben dem Button “Verbindung testen” ein kleiner grüner Haken ().

• Ist der Test nicht erfolgreich, erscheint neben dem Button “Verbindung testen” ein Icon (). Schwebt man mit dem Mauszeiger über dem Icon, wird eine Fehlerbeschreibung angezeigt.

• Die Verbindung zum Datenbankserver muss nicht zwingend erfolgreich sein. Sofern der verwendete Benutzer nur Rechte in der Datenbank, aber nicht auf Serverebene besitzt, ist es normal, dass der Verbindungstest zum Datenbankserver fehlschlägt, zur Datenbank im nächsten Schritt aber erfolgreich ist.

Eingabefeld für die Verbindungszeichenfolge

• Ermöglicht die freie Eingabe einer individuell erstellten Verbindungszeichenfolge.

• Mehr zum Aufbau einer Verbindungszeichenfolge findet man auf: https://www.connectionstrings.com/sql-server/

Button “Verbindung testen”

• Bei Auswahl des Buttons wird die Verbindung zum Server auf dessen Funktionalität getestet.

• Ist der Test erfolgreich, erscheint neben dem Button “Verbindung testen” ein kleiner grüner Haken “”.

• Ist der Test nicht erfolgreich, erscheint neben dem Button “Verbindung testen” ein Icon “”. Schwebt man mit dem Mauszeiger über dem Icon, wird eine Fehlerbeschreibung angezeigt.

Service

• Hier kann in einem Drop-down-Menü ein Dienst bzw. eine Applikation ausgewählt werden, von welcher ein Datenbankserver importiert werden soll.

Datenbankserver

• Die Auswahl des Drop-down-Menüs ist durch die ausgewählte Applikation bedingt, d.h. dass nur Datenbankserver angezeigt werden, die in der ausgewählten Applikation verfügbar sind.

Icon “Liste aller Datenbanken laden”

• Dieses Icon ist immer aktiviert.

• Bei Auswahl des Icons werden die Datenbanken in der Datenbankenübersicht aktualisiert und somit neu geladen.

Icon “Ausgewählte Datenbank registrieren”

• Dieses Icon ist nur aktiviert, wenn davor eine nicht-registrierte OCT-Datenbank (grauer Kreis) ausgewählt wurde.

• Eine detaillierte Beschreibung finden Sie hier: 5. Übersicht - OCT-Applikation | 5.5.2.-Ausgewählte-Datenbank-registrieren

Icon “Datenbank aus der Liste löschen”

• Dieses Icon ist nur aktiviert, wenn davor eine registrierte OCT-Datenbank (grüner Kreis) ausgewählt wurde.

• Die Datenbank wird aus der Liste der registrierten OCT Datenbanken entfernt, aber nicht vom SQL Server gelöscht.

Icon “Neue Datenbank erstellen”

• Dieses Icon ist immer aktiviert.

• Eine detaillierte Beschreibung finden Sie hier: 5. Übersicht - OCT-Applikation | 5.5.3.-Neue-Datenbank-erstellen

Icon “Datenbank einrichten”

• Dieses Icon ist nur für Datenbanken aktiviert, die keine OCT-Datenbanken sind.

• Bei Auswahl des Icons öffnet sich ein Dialog, in welchem die Datenbank eingerichtet werden kann.

• Eine detaillierte Beschreibung zur Einrichtung finden Sie hier: 5. Übersicht - OCT-Applikation | 5.5.3.-Neue-Datenbank-erstellen

Icon “Datenbank-Administrator hinzufügen”

• Dieses Icon ist nur aktiviert, wenn davor eine registrierte OCT-Datenbank (grüner Kreis) ausgewählt wurde.

• Bei Auswahl des Icons öffnet sich ein Dialog, in welchem ein weiterer OCT-Datenbank-Administrator hinzugefügt werden kann.

• Standardmäßig wird der Windows-Benutzername (Domäne\Benutzername) übernommen, der den Konfigurator gestartet hat.

Icon “Datenbank löschen”

• Dieses Icon ist immer aktiviert.

• Die Datenbank wird aus der Konfiguration sowie von der SQL Server Instanz gelöscht.

• Bei Auswahl des Icons werden zuerst die Berechtigungen des Benutzers geprüft und danach öffnet sich ein Dialog, in welchem das Löschen der Datenbank vom SQL Server bestätigt werden muss.

• Wurde der Button “Ja” ausgewählt, erscheint ein zweiter Dialog, in welchem nochmal das Löschen bestätigt werden muss.

Beachten Sie, dass durch das Löschen der Datenbank auch alle Daten in der Datenbank unwiderruflich gelöscht werden.

Icon “Im Browser öffnen”

• Dieses Icon ist nur aktiviert, wenn davor eine registrierte OCT-Datenbank (grüner Kreis) ausgewählt wurde.

• Über dieses Icon wird die URL der ausgewählten Datenbank im Standardbrowser geöffnet.

Suchfeld “Datenbanken durchsuchen”

• Über das Suchfeld kann die Übersicht der Datenbanken nach Text oder nach Zahlen gefiltert werden.

Datenbankname

• Der Name der Datenbank darf noch nicht existieren bzw. es wird eine neue Datenbank erstellt.

• Eingabefeld für den Name der neuen Datenbank.

• Er darf noch nicht vergeben sein.

OCT Administrator-Benutzername

• Standardmäßig wird der Windows-Benutzername (Domäne\Benutzername) übernommen, der den Konfigurator gestartet hat.

• Im Eingabefeld kann ein Benutzername für den OCT-Datenbank-Administrator eingetragen werden.

Dieser ist deaktiviert, wenn eine Datei für die Einrichtung der Datenbank ausgewählt wird, da das Hinzufügen eines OCT Administrators abhängig von der Version ist und das entsprechende Skript aus der Saxess Cloud abgerufen wird.

Typ

• Mit einem Linksklick in das Feld öffnet sich ein Drop-down-Menü, in welchem zwischen drei Option gewählt werden kann: “Stabile Version”, “Vorab-Version” oder “Entwicklungsversion”.

• Stabile Version: Dies ist eine stabile Applikationsversion, für die ein öffentliches Release besteht. Bei Auswahl dieses Typs werden im Drop-down-Menü für verfügbare Versionen nur stabile Versionen angezeigt.

• Vorab-Version: Dies ist eine “Release-Candidate-Version” bzw. eine Vorversion für den endgültigen öffentlichen Release, bei dem alle geplanten Features implementiert, aber ggf. noch Fehler vorhanden sind. Bei Auswahl dieses Typs werden im Drop-down-Menü für verfügbare Versionen stabile Versionen sowie Vorab-Versionen angezeigt.

• Entwicklungsversion: Dies ist eine Version, die noch in der Entwicklung ist und nicht für den produktiven Betrieb empfohlen wird. Bei Auswahl dieses Typs werden im Drop-down-Menü für verfügbare Versionen stabile Versionen, Vorab-Versionen sowie Entwicklungsversionen angezeigt.

Verfügbare Versionen

• Mit einem Linksklick in das Feld öffnet sich ein Drop-down-Menü, in welchem eine Datenbankversion ausgewählt werden kann.

Dateipfad

• Das Feld zeigt den Dateipfad an, unter welchem das OCT Setup SQL-Skript abgelegt ist.

Button “Durchsuchen”

• Bei Auswahl des Buttons öffnet sich ein Dialog, in welchem ein OCT Setup SQL-Skript von einem lokalen Speicherort ausgewählt werden kann.

• Das Setup Skript können Sie von Ihrem Ansprechpartner bei Saxess beziehen oder unter https://api.saxess-software.com/download/OCTDB/<VersionsNummer> (z.B. https://api.saxess-software.com/download/OCTDB/5.11.16) selbst herunterladen.