Java & Tomcat Update

Mit Hilfe von diesem Dokument soll der Umstieg von einer bisherigen Java Version (< Java 1.8) erleichtert und die notwendige Konfiguration erläutert werden.

Verwandte Themen in der Dokumentation:

• IT Systemvoraussetzungen

Tomcat Update

Ermitteln Sie zunächst welche Tomcat-Version auf Ihrem System installiert ist. Unter Windows muss dazu die Windows-Batchdatei version.bat ausgeführt werden. Entspricht die installierte Tomcat-Version bereits der neusten Tomcat-Version von http://tomcat.apache.org/download-70.cgi ist keine Aktualisierung notwendig.
Falls die installierte Version < 8.5 ist, können Tomcat und die B2B nicht zusammen mit Java 8 verwendet werden. Eine Aktualisierung ist notwendig.

Installation von Tomcat 8.5.x

Um ihre Tomcat-Installation zu aktualisieren, muss das passende Archiv von der Tomcat-Website http://tomcat.apache.org/download-80.cgi oder http://tomcat.apache.org/download-90.cgi heruntergeladen werden.
Extrahieren Sie nun den Inhalt des Archivs auf Ihr Dateisystem. Zur Aktualisierung wird nur der Inhalt der Ordner bin und lib benötigt.

Kopieren Sie den Inhalt des Ordners bin in das bin-Verzeichnis Ihres zu aktualisierenden Tomcat-Knotens. Ersetzen Sie alle Dateien. Falls die Dateien tomcatX.exe und tomcatXw.exe umbenannt wurden, müssen die nun kopierten Dateien tomcatX.exe und tomcatXw.exe auch entsprechend angepasst werden und die alten Dateien gelöscht werden.

Kopieren Sie nun den Inhalt des Ordners conf in das conf-Verzeichnis Ihres zu aktualisierenden Tomcat-Knotens. Ersetzen Sie bis auf die server.xml-Datei alle Dateien mit der neueren Version.

Diese Vorgehensweise muss für alle Tomcat Knoten separat durchgeführt werden.

Anpassung an server.xml

Um eine für Tomcat 8 oder 9 gültige server.xml Datei zu erstellen, müssen zwei Änderungen an der bisher verwendeten server.xml Datei vorgenommen werden. Die Datei server.xml finden sie im conf-Verzeichnis des jeweiligen Tomcat-Knotens. Entfernen sie folgenden Eintrag aus der Datei:

<Listener className="org.apache.catalina.core.JasperListener"/>

Und fügen Sie folgenden Eintrag hinzu:

<Listener className="org.apache.catalina.startup.VersionLoggerListener" />

Speichern Sie die Datei ab und verfahren Sie so bei allen anderen Tomcat-Knoten.

Zusätzlich muss digest=”MD5” durch CredentialHandler ersetzt werden

Damit wird der Eintrag:

<Realm className="org.apache.catalina.realm.DataSourceRealm" debug="99" digest="MD5" dataSourceName="jdbc/b2bbp" localDataSource="true" userTable="B2BBP_ADM_ACCOUNT" userNameCol="userid" userCredCol="password" userRoleTable="B2BBP_ADM_USER" roleNameCol="roleid" />

zu:

<Realm className="org.apache.catalina.realm.DataSourceRealm" debug="99" dataSourceName="jdbc/b2bbp" localDataSource="true" userTable="B2BBP_ADM_ACCOUNT" userNameCol="userid" userCredCol="password" userRoleTable="B2BBP_ADM_USER" roleNameCol="roleid" >
	<CredentialHandler className="org.apache.catalina.realm.NestedCredentialHandler">
		<CredentialHandler className="org.apache.catalina.realm.MessageDigestCredentialHandler"
		algorithm="md5" />
		<CredentialHandler className="org.apache.catalina.realm.MessageDigestCredentialHandler"
		algorithm="sha-512" />
	</CredentialHandler>
</Realm>

Siehe dazu auch: B2B-Login über Tomcat

Anpassung an der b2bbp-engine.xml

In der b2bbp-engine.xml müssen zwei Paarameter ersetzt werden: maxActive=”40” wird mit Tomcat 8 zu maxTotal=”40” und maxWait=”-1” wird mit Tomcat 8 zu maxWaitMillis=”30000”.

Beispiel der server.xml Datei für Tomcat 8

Ein vollständiges Beispiel einer server.xml-Datei finden sie hier.

BIRT-Update

Das Erstellen von BIRT-Reports ist mit Java 1.8 nur dann möglich, wenn die passende BIRT-Version eingesetzt wird. Dazu muss sowohl die BIRT-Komponente innerhalb der B2B als auch die auf den Kundensystemen installierte BIRT-Engine aktualisiert werden. Andernfalls ist die Report-Erzeugung nicht mehr möglich.

Siehe hierfür auch: CCM Birt-Installation und IT Systemvoraussetzungen