Introduction
Ce document décrit comment mettre à niveau manuellement Apache Tomcat sur CCE.
Conditions préalables
Exigences
Cisco vous recommande de prendre connaissance des rubriques suivantes :
- Contact Center Enterprise (CCE) 12.6
- Apache Tomcat
Composants utilisés
Les informations contenues dans ce document sont basées sur les versions de matériel et de logiciel suivantes :
- CCE 12.6
- Apache Tomcat 9.x
The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. Si votre réseau est en ligne, assurez-vous de bien comprendre l’incidence possible des commandes.
Mise à niveau
Dans la plupart des cas, la mise à jour de Tomcat à l'aide de Cisco Upgrade Tomcat Utility résout les vulnérabilités. Parfois, la mise à niveau de Tomcat échoue, la configuration est endommagée ou une nouvelle personne met à jour Tomcat à l'aide des fichiers qu'elle trouve en ligne.
Mise en garde : Prenez un instantané de machine virtuelle avant de commencer cette procédure. Contactez le TAC pour obtenir de l'aide.
Avant la mise à niveau
-
Téléchargez le programme d'installation de Tomcat (apache-tomcat-version.exe) à partir du site Web de Tomcat : http://archive.apache.org/dist/tomcat/tomcat-9/.
-
Copiez le programme d'installation sur les machines virtuelles du composant Unified CCE. Dans cette mise à niveau, j'ai utilisé tomcat version 9.0.89.

Au cours de ces travaux pratiques, un serveur AW a été utilisé pour mettre à niveau Tomcat.
Désinstaller le Tomcat actuel
Étape 1. Arrêtez le service de distribution :

Étape 2. Arrêtez Tomcat, l'administrateur IIS et le service World Wide Web à partir de windows services.msc.
Open Services.msc :




Étape 3. Désinstaller la version existante de Tomcat à partir de Ajout/Suppression de programmes.
1. Ouvrez Panneau de configuration > Programmes et fonctionnalités > Sélectionner Tomcat :


2. Cliquez sur Désinstaller/Modifier :




Installer Tomcat
Étape 1. Copiez le programme d'installation d'Apache Tomcat (le fichier EXE) dans c:\Temp:

Étape 2. À partir de CMD en tant qu’administrateur, exécutez le programme d’installation en utilisant cette commande :
Remarque : Votre version peut être différente : C:\temp\apache-tomcat-9.0.89.exe /s /D=C:\icm\tomcat.

Étape 3. Suivez les instructions d'installation. Il n'y a qu'une seule option que vous devez modifier ou rechercher, et c'est pour le dossier JRE.

Sauvegarder le dossier Tomcat pour supprimer les répertoires Tomcat
Une fois l'installation terminée, avant de commencer à travailler, le dossier Tomcat doit être sauvegardé au cas où le besoin de recommencer.
Étape 1. Sauvegardez le dossier Tomcat créé :
c:\icm\tomcat
Étape 2 : suppression du répertoire « C:\icm\tomcat\webapps\docs »
Étape 3 : suppression du répertoire « C:\icm\tomcat\webapps\manager »
Étape 4. Supprimez le répertoire « C:\icm\tomcat\webapps\ROOT »
Copier les fichiers Tomcat
Étape 1. Ouvrez CMD en tant qu’administrateur et exécutez les 4 requêtes suivantes :
- 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

Étape 2. À partir de l’invite de commandes, exécutez les étapes suivantes :
- "%CCE_JAVA_HOME%\bin\java" -cp C:\icm\bin Décompressez C:\icm\install\unifiedconfig-realm-assembly.zip C:\icm\tomcat\lib
- "%CCE_JAVA_HOME%\bin\java" -cp C:\icm\bin Décompressez C:\icm\install\shindig-cache-assembly.zip C:\icm\tomcat\lib

Étape 3. À partir de l’invite de commandes, exécutez les étapes suivantes pour copier les fichiers jar d’ICM dans le répertoire tomcat :
- 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 (Créer un répertoire)
- 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

Ajouter les fichiers manquants
Étape 1. À l’étape suivante, déplacez-vous sur deux fichiers : uriworkermap.properties et workers.properties à partir d'un serveur opérationnel, où l'installation Tomcat fonctionne correctement.
1. Notez que les deux fichiers sont manquants.
2. Copiez les fichiers manquants à partir d'un serveur opérationnel.

Étape 2. Ajouter les informations manquantes pour les options dans la clé de Registre Apache Tomcat.
Ces informations sont spécifiques à ICM et ne sont pas ajoutées par défaut :
Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Apache Software Foundation\Procrun 2.0\Tomcat9\Parameters\Java
Informations ajoutées aux options Clé après la dernière ligne dans Options. La chaîne suivante doit être ajoutée avec les traits d'union présents :
-DICM_ROOT=C:\icm
-Dcom.sun.management.jmxremote.ssl.need.client.auth=false
-Dcom.sun.management.jmxremote.authenticate=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

Activer l'héritage et démarrer le service Tomcat
Étape 1. La dernière étape avant de démarrer tomcat et le service IIS consiste à valider l'héritage pour le dossier. Si vous manquez cette étape, une erreur de serveur interne de 500 est renvoyée lorsque IIS tente d'utiliser le fichier isapi.dll de redirection.
Comme IIS n'a plus d'autorisations pour le dossier Tomcat :
- Rendez-vous à la page suivante : c:\icm\.
- Trouvez le dossier Tomcat.
- Cliquez avec le bouton droit et sélectionnez Propriétés.
- Choisissez Security > Advanced.
- Cliquez sur Enable Inheritance.
- Cliquez sur Apply.
Les droits d'utilisateur hérités proviennent de c:\icm.


Étape 2. Vérifiez que la version mise à jour est installée en exécutant la commande version :

Étape 3. Démarrez le service de distribution.

Étape 4. Démarrez Apache Tomcat, IIS et le service World Wide Web à partir de services.msc :



Vérifier
Vérifiez si la page cceadmin se charge sans problème et si vous pouvez vous connecter :
