Verbindung zwischen dem in Apache Tomcat installierten MobileFirst Server und dem Rational License Key Server herstellen

Sie müssen die nativen und Java-Bibliotheken von Rational Common Licensing im Anwendungsserver Apache Tomcat installieren, bevor Sie eine Verbindung vom MobileFirst Server zum Rational License Key Server herstellen.

Vorbereitende Schritte

Rational License Key Server ab Version 8.1.4.8 muss installiert und konfiguriert sein. Über das Netz müssen Übertragungen zum und vom MobileFirst Server möglich sein. Dazu werden die Ports für wechselseitige Übertragung (lmrgd und ibmratl) geöffnet. Weitere Informationen finden Sie im Portal für Rational License Key Server und unter How to serve a license key to client machines through a firewall.
Vergewissern Sie sich, dass die Lizenzschlüssel für die IBM MobileFirst Platform Foundation generiert wurden. Weitere Informationen zum Generieren und Verwalten Ihrer Lizenzschlüssel mit dem IBM® Rational License Key Center finden Sie unter IBM Support - Licensing und Obtaining license keys with IBM Rational License Key Center.
MobileFirst Server muss in Ihrem Apache Tomcat installiert und mit der Option Activate token licensing with the Rational License Key Server konfiguriert sein (siehe Installationsübersicht für die Tokenlizenzierung).

Bibliotheken von Rational Common Licensing installieren

Vorgehensweise

Wählen Sie die native Bibliothek von Rational Common Licensing aus. Wählen Sie abhängig von Ihrem Betriebssystem und von der Bitversion der Java™ Runtime Environment (JRE), in der Ihr Apache Tomcat ausgeführt wird, unter Produktinstallationsverzeichnis/MobileFirstServer/tokenLibs/bin/Ihre_Plattform/native_Bibliotheksdatei die richtige native Bibliothek aus. Für Linux x86 mit einer 64-Bit-JRE finden Sie die Bibliothek beispielsweise in Produktinstallationsverzeichnis/MobileFirstServer/tokensLibs/bin/Linux_x86_64/librcl_ibmratl.so.
Kopieren Sie die native Bibliothek auf den Computer, auf dem der Verwaltungsservice von MobileFirst Server ausgeführt wird. Das Verzeichnis könnte ${CATALINA_HOME}/bin sein.
Anmerkung: ${CATALINA_HOME} ist das Installationsverzeichnis für Ihren Apache Tomcat.
Kopieren Sie die Datei rcl_ibmratl.jar in den Ordner ${CATALINA_HOME}/lib. Die Datei rcl_ibmratl.jar ist eine Java-Bibliothek von Rational Common Licensing, die sich im Verzeichnis Produktinstallationsverzeichnis/MobileFirstServer/tokenLibs befindet. Die Bibliothek verwendet die native Bibliothek, die Sie in Schritt 2 kopiert haben. Sie kann nur einmal von Apache Tomcat geladen werden. Diese Datei muss sich im Verzeichnis ${CATALINA_HOME}/lib befinden oder in einem Verzeichnis, das im Pfad des allgemeinen Klassenladers von Apache Tomcat enthalten ist.
Wichtig: Für die Java Virtual Machine (JVM) von Apache Tomcat sind Lese- und Ausführungsrechte für die kopierte native Bibliothek und die Java-Bibliothek erforderlich. Für die beiden kopierten Dateien muss es auch in Ihrem Betriebssystem (zumindest für den Anwendungsserverprozess) eine Lese- und Ausführungsberechtigung geben.
Konfigurieren Sie für die JVM Ihres Anwendungsservers den Zugriff auf die Bibliothek von Rational Common Licensing. Konfigurieren für alle Betriebssysteme die Datei ${CATALINA_HOME}/bin/setenv.bat (oder setenv.sh unter UNIX), indem Sie die folgende Zeile hinzufügen:

Windows:

set CATALINA_OPTS=%CATALINA_OPTS% -Djava.library.path=absoluter_Pfad_zum_obigen_Verzeichnis_bin

UNIX:

CATALINA_OPTS="$CATALINA_OPTS -Djava.library.path=absoluter_Pfad_zum_obigen_Verzeichnis_bin"

Anmerkung: Wenn Sie den Konfigurationsordner des Servers, auf dem der Verwaltungsservice ausgeführt wird, verschieben, müssen Sie java.library.path aktualisieren und den neuen absoluten Pfad angeben.
Konfigurieren Sie MobileFirst Server für den Zugriff auf Rational License Key Server. Suchen Sie in der Datei ${CATALINA_HOME}/conf/server.xml nach dem Element <Context> der Anwendung für die Verwaltungservices und fügen Sie die folgenden JNDI-Konfigurationszeilen hinzu:
```
<Environment name="mfp.admin.license.key.server.host" value="RLKS-Hostname" type="java.lang.String" override="false"/>
<Environment name="mfp.admin.license.key.server.port" value="RLKS-Port" type="java.lang.String" override="false"/>
```
- RLKS-Hostname ist der Hostname von Rational License Key Server.
- RLKS-Port ist der Port von Rational License Key Server. Der Standardwert lautet 27000.
Weitere Informationen finden Sie unter JNDI-Eigenschaften für Verwaltungsservices: Lizenzierung.

Installation in einer Apache-Tomcat-Server-Farm

Informationen zu diesem Vorgang

Wenn Sie die Verbindung von MobileFirst Server in einer Apache-Tomcat-Server-Farm konfigurieren möchten, müssen Sie für jeden Knoten Ihrer Server-Farm, auf dem der MobileFirst-Server-Verwaltungsservice ausgeführt wird, alle Schritte ausführen, die im Abschnitt Bibliotheken von Rational Common Licensing installieren beschrieben sind. Weitere Informationen zu Server-Farmen finden Sie unter Server-Farmtopologie und Server-Farm installieren.