TDI 7.1.1 für HCL Connections 6.0 und 6.5 unter Linux installieren

Installationsdateien herunterladen

Im Flexnet müssen wir hierzu den Download von HCL Connections v6.5 öffnen. Dies hat zunächst weniger mit der tatsächlich installierten Version zutun als vielmehr mit der Flexnet-Struktur. In der 6.5 Gruppe wird der TDI in der benötigten Version 7.1.1 angeboten:

Anschließend das Archiv entpacken. Ich empfehle hierzu einen seperaten Ordner:

mkdir tdi-install
tar -xvf CZUF3ML.tar -C tdi-install
cd tdi-install

Installation des TDI starten

./linux_x86_64/install_tdiv711_linux_x86_64.bin -console

Nun startet der Installer. Zunächst wird man nach der Sprache gefragt. Hier kann man prinzipiell die bevorzugte Sprache wählen. Englisch ist allerdings empfehlenswert. Sowohl zur einheitlichen Automatisierung, als auch der Fehlersuche. Die weiteren Schritte, einschließlich dem Standard-Installationpfad von /opt/IBM/TDI/V7.1.1 können übernommen werden. Hierzu genügt das Drücken der ENTER-Taste. Als Installationsart ist im Regelfall (1) Typical ausreichend.

Als Solutions Directory 4 wählen:

Bei den Ports empfiehlt es sich wieder, den Standard mit ENTER zu übernehmen. Die Registrierung als Dienst mit ENTER deaktivieren. Er wird für die reine Benutzer-Synchronisierung ohne Web-Funktionalität nicht benötigt. Auch die darauffolgenden Konsolen-Ports kann man wieder standardmäßig übernehmen.

TDI_JAVA_HOME anpassen

Der Pfad zu TDI_JAVA_HOME ist standardmäßig nicht korrekt. Er muss händisch auf den Zielpfad korrigiert werden.

vim /opt/IBM/TDI/V7.1.1/bin/javaHome.sh

Der Standardpfad lautet /opt/IBM/TDI/V7.1.1/jvm, sofern diese während der Installation nicht angepasst wurde. Somut muss javaHome.sh folgende Variable enthalten:

TDI_JAVA_HOME=/opt/IBM/TDI/V7.1.1/jvm

Updates herunterladen

Die aktuellsten Fixpacks aus dem Fix Central (IBM) herunterladen. Man sollte mindestens 7.1.1-TIV-TDI-FP0006 herunterladen, optional das neuste 8.

Updates installieren

Das Fixpack entpacken, z.B. mit

unzip 7.1.1-TIV-TDI-FP0006.zip

Mehrere JAR-Dateien werden entpackt. Hier muss man UpdateInstaller.jar in /opt/IBM/TDI/V7.1.1/maintenance/ verschieben. Um das Update zu installieren applyUpdates.sh im Bin-Zielordner starten. Als Argument muss man den Namen des ZIP-Archives angeben, den man aus dem Fix-Central herunterlagenden hat:

/opt/IBM/TDI/V7.1.1/bin/applyUpdates.sh -update TDI-7.1.1-FP0006.zip

Der schalter -queryreg zeigt an, welches Fixpack derzeit installiert ist:

/opt/IBM/TDI/V7.1.1/bin/applyUpdates.sh -queryreg
...
Fixes Applied
=-=-=-=-=-=-=
TDI-7.1.1-FP0006(7.1.1.0)

Components Installed
=-=-=-=-=-=-=-=-=-=
BASE
   -TDI-7.1.1-FP0006
SERVER
   -TDI-7.1.1-FP0006
CE
   -TDI-7.1.1-FP0006
JAVADOCS
   -TDI-7.1.1-FP0006
EXAMPLES
   -TDI-7.1.1-FP0006
EMBEDDED WEB PLATFORM
AMC
   Deferred: false

TDI Konfigurieren

Die Konfiguration selbst erfolgt im tdisol Verzeichnis und variiert stark nach der Umgebung, da die Software viele Möglichkeiten bietet. Nicht alle werden für CNX benötigt, können in Einzelfällen aber durchaus sinnvoll sein: Beispielsweise die Nutzer ein eigenes Profilfeld pflegen lassen, das man per TDI zurück in ein LDAP-Verzeichnis schreibt, damit diese Daten von dort auch anderen Systemen zur Verfügung stehen. Dieser Abschnitt geht daher nicht auf die komplette Konfiguration ein, sondern fasst lediglich das Wichtigste als Einstieg zusammen.

Das Meiste wird in der Datei profiles_tdi.properties definiert: Von welcher Ziel-Datenquelle soll er sich die Daten holen? Alle Variablen mit dem source_ldap_ Präfix legen dies fest. In der Regel wird man dort ein LDAP-Verzeichnis angeben, das evt. noch über einen LDAP-Filter den Zugriff beschränkt, etwa auf eine bestimmte OU.

Wichtig ist sync_updates_hash_field: Es legt fest, anhand welches LDAP-Feldes der TDI seinen Hash bildet. Damit erkennt er Änderungen: Hat sich der Hash verändert, muss ein vorhandener Nutzer aktualisiert werden. Setzt man diese Eigenschaft auf uid (LDAP) oder guid (AD), lassen sich E-Mail Adressen ändern, ohne dass ein neuer Nutzer angelegt wird. Bei Domino lässt sich das Problem elegant mit der Dokument-ID lösen. Somit werden selbst Änderungen von E-Mail & Anmeldename (z.B. bei einer Heirat/Scheidung) erkannt, weil das Dokument ja trotzdem Gleich bleibt und somit seine Id behält.

Alle dbrepos_* Variablen beziehen sich auf das Ziel. Dies ist die CNX-Datenbank: Hier braucht der TDI Hostname/Port und einen Benutzer, damit er neue/geänderte Benutzer entsprechend in die DB schreiben bzw. diese dort aktualisieren kann.