Den OneConnexx gibt es in einer 32-Bit und einer 64-Bit Version. Auf einem 64-Bit Betriebssystem wird empfohlen die 64-Bit Version des OneConnexx zu verwenden, ausser ein Add-In erfordert zwingend den 32-Bit Modus. Die Add-Ins laufen automatisch als 32-Bit oder 64-Bit Prozesse, je nach Version des OneConnexx.
Installationspakete werden von Sevitec in Form von 7-zip Archiven zur Verfügung gestellt. Folgende Pakete werden benötigt:
Alle benötigten Installationspakete auf den Server ins Verzeichnis <Laufwerk>:\OneConnexx\Install kopieren.
Falls nur eine OneConnexx Instanz installiert wird, den Inhalt von ocx-service.7z nach <Laufwerk>:\OneConnexx\OneConnexxService entpacken, und den Inhalt von ocx-addins.7z in ein Unterverzeichnis AddIns.
Wenn mehrere Instanze geplant sind (z.B. Test und Produktiv), dann wird empfohlen die Installationspakete in einen Unterordner <Laufwerk>:\OneConnexx\<Instanzname> zu entpacken.
Danach sollte folgende Verzeichnisstruktur vorhanden sein:
\OneConnexx
|-<Instanzname>
|-AddIns
|-Config
|-Pipeline
Der OneConnexx Windows-Dienst wird pro Installation über die Eingabeaufforderung (Windows Konsole) installiert. Die Eingabeaufforderung muss als Administrator geöffnet werden. Der Name unter dem der Dienst installiert wird muss auf der Kommandozeile angegeben werden. Sollen verschiedene Instanzen (z.B. Test und Produktiv) auf demselben Server installiert werden, muss für jede Instanz ein eindeutiger Name verwendet werden.
Ins Stammverzeichnis des OneConnexx wechseln und den Service installieren:
cd \OneConnexx\OneConnexxService
OneConnexx.exe –install –servicename=OneConnexx
Zum Deinstallieren:
OneConnexx.exe –uninstall –servicename=OneConnexx
-servicename=OneConnexx wird dabei durch den gewählten eindeutigen Namen der Instanz ersetzt.
In einem Unternehmensnetzwerk wird empfohlen, für den OneConnexx einen eigenen Benutzer anzulegen unter dem der Service installiert wird. Um den Service unter diesem Benutzer auszuführen muss folgendermassen vorgegangen werden:
sc config OneConnexx obj= "<Benutzername>" password= "<Passwort>"
obj=
bzw. password=
Falls der OneConnexx Service nicht unter dem lokalen Systemkonto (Lokales System/Local System) installiert wird, muss dem <OneConnexx-User> für das Verzeichnis <Laufwerk>:\OneConnexx und alle Unterordner volle Berechtigung erteilt werden. In diesem Beispiel wurde OneConnexx unter C:\OneConnexx installiert und läuft unter einem Benutzer mit Namen ocxservice:
icacls C:\OneConnexx /grant ocxservice:(OI)(CI)RW
Da verschiedene Dateien im Verzeichnis %ProgramData%\Sevitec\OneConnexx gespeichert werden, muss bei der ersten Installation sichergestellt werden, dass normale Benutzer Schreibzugriff auf dieses Verzeichnis haben. Die folgenden Befehle erstellen dieses Verzeichnis und erteilen die benötigte Berechtigung:
mkdir "%ProgramData%\Sevitec\OneConnexx"
icacls %ProgramData%\Sevitec\OneConnexx /grant Users:(OI)(CI)RW
In der Konfigurationsdatei <Laufwerk>:\OneConnexx\OneConnexxService\OneConnexx.exe.config sind folgende Parameter zu konfigurieren:
Alle anderen Konfigurationsparameter sollten nicht verändert werden!
In der Konfigurationsdatei <Laufwerk>:\OneConnexx\OneConnexxService\Config\nlog.config kann die Protokollierung des OneConnexx-Services und der Add-Ins konfiguriert werden. Normalerweise muss an der Protokollierung nichts geändert werden. Die Standardkonfiguration lautet: