4. Neue OCT-Applikation installieren

Typ

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

• Stabile Version: Dies ist eine stabile Applikationsversion, für die ein öffentliches Release besteht.

• Vorab-Version: Dies ist eine Vorversion für den endgültigen öffentlichen Release, bei dem alle geplanten Features implementiert, aber ggf. noch Fehler vorhanden sind.

• Entwicklungsversion: Dies ist eine Version, die noch in der Entwicklung ist und nicht für den produktiven Betrieb empfohlen wird.

Verfügbare Versionen

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

• Bei Auswahl des Typs “Stabile Version” werden im Drop-down-Menü für verfügbare Versionen nur bereits stabile Applikationsversionen angezeigt, die für den produktiven Einsatz empfohlen sind.

• Bei Auswahl des Typs “Vorab-Version” werden im Drop-down-Menü für verfügbare Versionen stabile Applikationsversionen sowie Vorab-Versionen angezeigt.

• Bei Auswahl des Typs “Entwicklungsversion” werden im Drop-down-Menü für verfügbare Versionen sämtliche öffentlich verfügbare Versionen angezeigt.

Dateipfad

• Das Feld zeigt den Dateipfad an, unter welchem die Installationsdatei abgelegt ist.

Button “Wählen”

• Bei Auswahl des Buttons öffnet sich ein Dialog, in welchem eine Installationsdatei von einem lokalen Speicherort ausgewählt werden kann.

• Die Installationsdatei können Sie von Ihrem Ansprechpartner bei Saxess beziehen.

• Die Installationsdatei kann auch über folgende URL manuell heruntergeladen werden:

  https://api.saxess-software.com/download/OCTMSI/<Version> also z.B. https://api.saxess-software.com/download/OCTMSI/5.11.17

Für CP Kunden kann “OCTMSI” durch “CPCEMSI” in der URL ersetzt werden, um die CPCE Variante herunterzuladen.

Dienstname

• Eingabefeld für den Windows-Dienst, welchen der Konfigurator einrichtet.

• Der Name muss:

  • 3-64 Zeichen lang sein,

  • mit einem Buchstaben beginnen und

  • darf nur Buchstaben, Ziffern, Binde- oder Unterstriche enthalten.

Bestehende OCT-Dienste

• Der Konfigurator scannt automatisch nach bereits installierten OCT-Diensten und zeigt deren Namen an.

Domäne

• Eingabefeld für eine existierende Active-Directory-Domäne

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

Benutzername

• Eingabefeld für den Namen eines Active-Directory-Benutzers

Passwort

• Eingabefeld für das Passwort des Active-Directory-Benutzers

Checkbox “Überprüfung der Anmeldeinformationen überspringen”

• Am Ende des Dialogs wird über den Button “Weiter” der Übergang zum nächsten Installationsschritt eingeleitet.

• Bei diesem Übergang erfolgt eine Verifizierung der Anmeldeinformationen (Benutzer + Passwort).

• Mit dieser Option kann die Verifizierung an diesem Punkt der Installation übersprungen werden.

Sind die Anmeldeoptionen falsch hinterlegt und die Verifizierung wurde an dieser Stelle übersprungen, wird die Installation am Ende scheitern.

Host/Domäne

• Eingabefeld für den Host (lokaler Benutzer) oder die jeweilige Domäne (Active Directory)

Benutzername

• Eingabefeld für einen Benutzernamen

• In diesem Drop-down-Feld sind alle verfügbaren Benutzerkonten sichtbar.

• Falls das gesuchte Konto nicht verfügbar ist, kann ein Kontoname manuell eingegeben werden. Unter Umständen kann die Installation auch problemlos erfolgen, obwohl der gewünschte Kontoname nicht gefunden wurde.

Wählen Sie aus den verfügbaren Konten kein Administratorenkonto 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”

• Am Ende des Dialogs wird über den Button “Weiter” der Übergang zum nächsten Installationsschritt eingeleitet.

• Bei diesem Übergang erfolgt eine Verifizierung der Anmeldeinformationen (Benutzer + Passwort).

• Mit dieser Option kann die Verifizierung an diesem Punkt der Installation übersprungen werden.

Sind die Anmeldeoptionen falsch hinterlegt und die Verifizierung wurde an dieser Stelle übersprungen, wird die Installation am Ende scheitern.

Benutzername

• Eingabefeld für den Benutzernamen

• Der Name des Benutzerkontos muss einmalig auf dem System sein.

• Es wird automatisch der Hostname bzw. die Domäne ausgewählt und vor dem einzugebenden Benutzernamen eingeblendet.

Passwort

• Eingabefeld für das Passwort des Benutzerkonto

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

Passwort wiederholen

• Wiederholen Sie das zuvor eingegebene Passwort.

Installationspfad

• Der Pfad wird vom Konfigurator automatisch vorgeschlagen.

• Der Standard-Vorschlag lautet: “C:\Program Files\Saxess Software\<Dienstname>”.

Es erfolgt eine automatische Prüfung der Verfügbarkeit des ausgewählten Pfades. Leere Ordner kann man auswählen und über den Konfigurator befüllen. Liegt auf dem Pfad ein Ordner mit auch nur einer Datei, so erscheint eine Warnung.

Datenpfad

• Der Pfad wird vom Konfigurator automatisch vorgeschlagen.

• Der Standard-Vorschlag lautet: “C:\ProgramData\Saxess Software\<Dienstname>”.

• In diesem Pfad werden temporäre Dateien oder Exporte von OCT abgelegt.

Hostname/IP

• Der Konfigurator 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. 5001) 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: 5. FAQ - Einrichtung von OCT

Der Installationsassistent 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”

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

aus.

Die ausgestellte Zertifikatsdomain sollte mit den Angaben im Installationsassistenten ü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.