Migration des Natural Web I/O Interface Client von IIS nach Apache Tomcat

Microsoft Internet Information Services (IIS) wird nicht mehr unterstützt. Wenn Sie derzeit den Natural Web I/O Interface Client auf IIS verwenden, müssen Sie auf Apache Tomcat umsteigen.

Anmerkung
JBoss Application Server und Oracle GlassFish Server werden ebenfalls nicht mehr unterstützt. Wenn Sie derzeit einen dieser Anwendungsserver verwenden, müssen Sie ebenfalls auf Apache Tomcat umsteigen. In diesem Fall können Sie jedoch Ihre bisherigen Einstellungen (d. h. die URL für die Anmeldeseite und die Konfigurationsdatei sessions.xml) wiederverwenden.

Die einfachste Lösung besteht darin, den Natural Web I/O Interface Client von IIS auf Apache Tomcat zu migrieren. Daher bietet dieses Kapitel IIS-Administratoren eine kurze Einführung in die Installation von Tomcat und beschreibt die Migrationsschritte.

Die folgenden Themen werden behandelt:


Bevor Sie den Natural Web I/O Interface Client installieren

Wenn Apache Tomcat noch nicht installiert ist, müssen Sie die folgenden Schritte ausführen:

Tomcat installieren

Gehen Sie zu http://tomcat.apache.org/ und laden Sie Tomcat als ZIP-Datei herunter.

Für Benutzer von Microsoft Windows: Laden Sie entweder die 32-Bit- oder die 64-Bit-Windows-ZIP-Datei herunter.

Entpacken Sie die heruntergeladene ZIP-Datei in ein Verzeichnis Ihrer Wahl.

Java installieren

Tomcat basiert auf Java. Daher müssen Sie sicherstellen, dass eine Java-Laufzeitumgebung (JRE) oder ein Java Development Kit (JDK) installiert ist. Die Version der Java-Laufzeitumgebung sollte mindestens Java 6 Update 24 sein. Dies ist die Mindestversion, die für den Natural Web I/O Interface Client auf Tomcat erforderlich ist.

Sie können die Java JRE oder das JDK von der Oracle-Website unter http://www.oracle.com/technetwork/java/javase/downloads/index.html.

Wenn Java auf Ihrem System installiert ist, stellen Sie sicher, dass die Umgebungsvariable JAVA_HOME auf das Java-Home-Verzeichnis gesetzt ist.

Tomcat-Server starten

Wenn Tomcat und die entsprechende Java-Version installiert sind, können Sie Tomcat starten.

Um Tomcat zu starten, führen Sie die Datei startup.bat aus dem Verzeichnis bin Ihrer Tomcat-Installation aus. Um zu überprüfen, ob Tomcat ausgeführt wird, geben Sie die folgende URL ein:

http://localhost:8080

Daraufhin sollte die Standard-Startseite von Tomcat angezeigt werden.

Installieren des Natural Web I/O Interface Client auf Apache Tomcat

Wenn Apache Tomcat installiert wurde, installieren Sie den Natural Web I/O Interface Client wie unter Installieren des Natural Web I/O Interface Clients auf Apache Tomcat beschrieben.

Konfigurieren des Natural Web I/O Interface Client auf Apache Tomcat

Wenn der Natural Web I/O Interface Client installiert wurde, fahren Sie wie in den folgenden Abschnitten beschrieben fort:

Aufrufen der Anmeldeseite

Geben Sie die folgende URL ein, um die Anmeldeseite aufzurufen (diese unterscheidet sich von der URL, die mit IIS verwendet wurde):

http://localhost:8080/natuniweb/natural.jsp

Ändern des Tomcat-HTTP-Ports

IIS läuft normalerweise auf dem Standardport 80. Wenn Sie möchten, dass Tomcat mit demselben Port arbeitet, bearbeiten Sie die Datei server.xml, die sich im Unterverzeichnis conf von Tomcat befindet, und suchen Sie dann nach dem folgenden Text:

<Connector port="8080" protocol="HTTP/1.1"

Ändern Sie die Portnummer so, dass sie wie folgt aussieht:

<Connector port="80" protocol="HTTP/1.1"

Using the Settings from Your IIS Configuration File

Mit Tomcat können Sie die Konfigurationsdatei settings.xml von IIS wiederverwenden, müssen die Datei jedoch in sessions.xml umbenennen. Gehen Sie wie folgt vor:

  1. Kopieren Sie die Datei settings.xml aus Ihrer IIS-Installation in das folgende Verzeichnis Ihrer Tomcat-Installation:

    webapps/natuniweb/WEB-INF

  2. Benennen Sie entweder die Datei sessions.xml, die mit der Installation des Natural Web I/O Interface Clients auf Tomcat geliefert wird, um (z. B. in sessions-original.xml) oder löschen Sie sie.

  3. Benennen Sie die Datei settings.xmlin sessions.xml um.

Verwendung des Konfigurationstools

Wenn der Natural Web I/O Interface Client auf Tomcat ausgeführt wird, ist es nicht mehr erforderlich, die Konfigurationsdatei manuell zu bearbeiten. Stattdessen können Sie das Konfigurationstool verwenden. Die Verwendung dieses Tools hat den Vorteil, dass Sie keinen ungültigen XML-Code erstellen und somit die XML-Datei beschädigen können. Weitere Informationen finden Sie unter Verwendung des Konfigurationstools.

Die IIS-spezifischen Einträge in der umbenannten Konfigurationsdatei werden ignoriert. Dies sind:

natural_parameter visible
theme
screen top
screen left
screen size
screen pfkeypos

Sie können die Konfigurationsdatei weiterhin manuell bearbeiten. Dies wird jedoch nicht mehr empfohlen.

Schutz des Konfigurationstools vor unbefugtem Zugriff

Es ist möglich, das Konfigurationstool vor unbefugtem Zugriff zu schützen. Ausführliche Informationen finden Sie unter Konfigurieren der containerverwalteten Security.

Ausführliche Informationen zur erforderlichen Realm-Konfiguration für Tomcat finden Sie unter http://tomcat.apache.org/tomcat-6.0-doc/realm-howto.html.

Anmeldeseite standardmäßig anzeigen

Wenn Sie die URL http://localhost:8080/natuniweb eingeben, zeigt Tomcat die Standardseite des Natural Web I/O Interface Client an, über die Sie entweder auf die Anmeldeseite oder das Konfigurationstool des Natural Web I/O Interface Client zugreifen können.

Anmerkung
Wenn Sie einen anderen Port definiert haben (z. B. 80), stellen Sie sicher, dass Sie diese Portnummer in der URL verwenden.

Dieses Verhalten unterscheidet sich von IIS, das standardmäßig die Anmeldeseite anzeigt. Wenn Sie möchten, dass Tomcat ebenfalls standardmäßig die Anmeldeseite anzeigt, bearbeiten Sie die Datei web.xml, die sich im Verzeichnis webapps\natuniweb\WEB-INF von Tomcat befindet, und suchen Sie nach dem folgenden Eintrag:

<welcome-file-list>
  <welcome-file>
         index.html
  </welcome-file>
</welcome-file-list>

Ändern Sie den Namen der Welcome-Datei wie im folgenden Beispiel gezeigt in natural.jsp:

<welcome-file-list>
  <welcome-file>
         natural.jsp           
  </welcome-file>
</welcome-file-list>