Einleitung
In diesem Dokument wird beschrieben, wie Sie Apache Tomcat auf CCE manuell aktualisieren.
Voraussetzungen
Anforderungen
Cisco empfiehlt, dass Sie über Kenntnisse in folgenden Bereichen verfügen:
- Contact Center Enterprise (CCE) 12,6
- Apache Tomcat
Verwendete Komponenten
Die Informationen in diesem Dokument basierend auf folgenden Software- und Hardware-Versionen:
- CCE 12,6
- Apache Tomcat 9.x
Die Informationen in diesem Dokument beziehen sich auf Geräte in einer speziell eingerichteten Testumgebung. Alle Geräte, die in diesem Dokument benutzt wurden, begannen mit einer gelöschten (Nichterfüllungs) Konfiguration. Wenn Ihr Netzwerk in Betrieb ist, stellen Sie sicher, dass Sie die möglichen Auswirkungen aller Befehle kennen.
Upgrade
In den meisten Fällen werden durch die Aktualisierung von Tomcat mit dem Cisco Upgrade Tomcat Utility Sicherheitslücken geschlossen. Manchmal schlägt das Upgrade von Tomcat fehl, die Konfiguration ist beschädigt oder eine neue Person aktualisiert Tomcat mithilfe der Dateien, die sie online finden.
Vorsicht: Machen Sie einen VM-Snapshot, bevor Sie diesen Vorgang starten. Wenden Sie sich bei Fragen an das TAC.
Vor dem Upgrade
-
Laden Sie das Tomcat-Installationsprogramm (apache-tomcat-version.exe) von der Tomcat-Website herunter: http://archive.apache.org/dist/tomcat/tomcat-9/
-
Kopieren Sie das Installationsprogramm auf die Unified CCE-Komponenten-VMs. Bei diesem Upgrade habe ich die Version 9.0.89 von Tomcat verwendet.

In dieser Übung wurde ein AW-Server verwendet, um Tomcat zu aktualisieren.
Aktuellen Tomcat deinstallieren
Schritt 1: Beenden Sie den Distributor-Service:

Schritt 2: Beenden Sie den Tomcat-, IIS-Admin- und World Wide Web-Dienst von windows services.msc.
Öffnen Sie Services.msc:




Schritt 3: Deinstallieren Sie die vorhandene Tomcat-Version von den Add/Remove-Programmen.
1. Öffnen Sie Systemsteuerung > Programm und Funktionen > Tomcat auswählen:


2. Klicken Sie auf Deinstallieren/Ändern:




Tomcat installieren
Schritt 1. Kopieren Sie den Apache Tomcat Installer (die EXE-Datei) in c:\Temp:

Schritt 2: Führen Sie in CMD als Administrator das Installationsprogramm mit folgendem Befehl aus:
Anmerkung: Ihre Version kann unterschiedlich sein: C:\temp\apache-tomcat-9.0.89.exe /s /D=C:\icm\tomcat.

Schritt 3: Fahren Sie mit den Anweisungen zur Installation fort. Es gibt nur eine Option, die Sie ändern oder durchsuchen müssen, nämlich den JRE-Ordner.

Tomcat-Ordner sichern, um Tomcat-Verzeichnisse zu löschen
Wenn die Installation abgeschlossen ist, muss vor Beginn der Arbeit der Tomcat-Ordner gesichert werden, falls ein Neustart erforderlich ist.
Schritt 1: Sichern Sie den erstellten Tomcat-Ordner:
c:\icm\tomcat
Schritt 2: Löschen Sie das Verzeichnis "C:\icm\tomcat\webapps\docs".
Schritt 3: Löschen Sie das Verzeichnis "C:\icm\tomcat\webapps\manager".
Schritt 4: Löschen Sie das Verzeichnis "C:\icm\tomcat\webapps\ROOT".
Tomcat-Dateien kopieren
Schritt 1: Öffnen Sie CMD als Administrator und führen Sie die folgenden 4 Abfragen aus:
- copy /Y C:\icm\bin\setup.war C:\icm\tomcat\webapps\setup.war
- copy /Y C:\icm\install\unifiedconfig.war C:\icm\tomcat\webapps\unifiedconfig.war
- copy /Y C:\icm\install\cceadmin.war C:\icm\tomcat\webapps\cceadmin.war
- copy /Y C:\icm\install\ccbu-common-shindig-server.war C:\icm\tomcat\webapps\ROOT.war

Schritt 2: Führen Sie an der Eingabeaufforderung folgende Schritte aus:
- "%CCE_JAVA_HOME%\bin\java" -cp C:\icm\bin Entpacken Sie C:\icm\install\unifiedconfig-realm-assembly.zip C:\icm\tomcat\lib
- "%CCE_JAVA_HOME%\bin\java" -cp C:\icm\bin Entpacken Sie C:\icm\install\shindig-cache-assembly.zip C:\icm\tomcat\lib

Schritt 3. Von der Eingabeaufforderung führen Sie diese Schritte aus, um die jar-Dateien von ICM in das Verzeichnis tomcat zu kopieren:
- copy /Y C:\icm\bin\catalina.properties C:\icm\tomcat\conf\catalina.properties
- copy /Y C:\icm\bin\icm-websetup-shared.jar C:\icm\tomcat\lib\icm-websetup-shared.jar
- copy /Y C:\icm\bin\registry.jar C:\icm\tomcat\lib\registry.jar
- copy /Y C:\icm\bin\jntservices.jar C:\icm\tomcat\lib\jntservices.jar
- md C:\icm\tomcat\bin\i386 (Verzeichnis erstellen)
- copy /Y C:\icm\bin\isapi_redirect.dll C:\icm\tomcat\bin\i386\isapi_redirect.dll
- copy /Y C:\icm\bin\web.xml C:\icm\tomcat\conf\web.xml
- copy /Y C:\icm\bin\catalina-jmx-remote.jar C:\icm\tomcat\lib\catalina-jmx-remote.jar
- copy /Y C:\icm\install\web.config C:\icm\tomcat\bin\i386\web.config
- copy /Y C:\icm\bin\server.xml.IIS.custom C:\icm\tomcat\conf\server.xml

Fehlende Dateien hinzufügen
Schritt 1. Bewegen Sie sich im nächsten Schritt über zwei Dateien: uriworkermap.properties und workers.properties von einem funktionierenden Server, auf dem die Tomcat-Installation ordnungsgemäß funktioniert.
1. Beachten Sie, dass die beiden Dateien fehlen.
2. Kopieren Sie die fehlenden Dateien von einem funktionierenden Server.

Schritt 2. Fügen Sie fehlende Registrierungsinformationen für Optionen in Apache tomcat Registrierungsschlüssel hinzu.
Diese Informationen sind spezifisch für ICM und werden standardmäßig nicht hinzugefügt:
Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Apache Software Foundation\Procrun 2.0\Tomcat9\Parameters\Java
Informationen, die den Optionen hinzugefügt wurden Schlüssel nach der letzten Zeile in Optionen. Die folgende Zeichenfolge muss mit den vorhandenen Bindestrichen hinzugefügt werden:
-DICM_ROOT=C:\icm
-Dcom.sun.management.jmxremote.ssl.need.client.auth=false
-Dcom.sun.management.jmxremote.authentication=false
-Dcom.sun.management.jmxremote.port=1299
-Dcom.sun.management.jmxremote.ssl=false
-XX:MaxPermSize=128 m
-Dfile.encoding=UTF8
-Dclient.encoding.override=UTF-8

Vererbung aktivieren und Tomcat-Dienst starten
Schritt 1: Der letzte Schritt vor dem Starten von Tomcat und IIS-Dienst besteht darin, die Vererbung für den Ordner zu überprüfen. Wenn Sie diesen Schritt verpassen, wird ein 500 interner Serverfehler zurückgegeben, wenn IIS versucht, die Datei "redirect isapi.dll" zu verwenden.
Da IIS nicht mehr über Berechtigungen für den Tomcat-Ordner verfügt:
- Navigieren Sie zu c:\icm\.
- Finde den Ordner Tomcat.
- Klicken Sie mit der rechten Maustaste, und wählen Sie Eigenschaften aus.
- Wählen Sie Security > Advanced (Sicherheit > Erweitert).
- Klicken Sie auf Vererbung aktivieren.
- Klicken Sie auf Apply (Anwenden).
Die geerbten Benutzerrechte stammen von c:\icm.


Schritt 2. Überprüfen Sie, ob die aktualisierte Version installiert ist, indem Sie den Befehl version ausführen:

Schritt 3: Starten Sie den Distributor-Service.

Schritt 4: Starten Sie Apache Tomcat, IIS und World Wide Web Service von services.msc:



Überprüfung
Überprüfen Sie, ob die cceadmin-Seite problemlos geladen wird und sich anmelden kann:
