Actualizar Apache Tomcat manualmente

Introducción

Este documento describe cómo actualizar manualmente Apache Tomcat en CCE.

Prerequisites

Requirements

Cisco recomienda que tenga conocimiento sobre estos temas:

• Contact Center Enterprise (CCE) 12.6
• Apache Tomcat

Componentes Utilizados

La información que contiene este documento se basa en las siguientes versiones de software y hardware.

• CCE 12.6
• Apache Tomcat 9.x

La información que contiene este documento se creó a partir de los dispositivos en un ambiente de laboratorio específico. Todos los dispositivos que se utilizan en este documento se pusieron en funcionamiento con una configuración verificada (predeterminada). Si tiene una red en vivo, asegúrese de entender el posible impacto de cualquier comando.

Actualizar

En la mayoría de los casos, la actualización de Tomcat mediante la utilidad Tomcat de actualización de Cisco resuelve las vulnerabilidades. Hay ocasiones en las que la actualización de Tomcat falla, la configuración está dañada o una persona nueva actualiza Tomcat usando los archivos que encuentra en línea.

Precaución: Realice una instantánea de VM antes de iniciar este procedimiento. Póngase en contacto con el TAC para obtener ayuda.

Antes de actualizar

1. Descargue el instalador de Tomcat (apache-tomcat-version.exe) desde el sitio web de Tomcat: http://archive.apache.org/dist/tomcat/tomcat-9/.

2. Copie el instalador en las VM de los componentes de Unified CCE. En esta actualización, utilicé tomcat versión 9.0.89.

En este laboratorio, se utilizó un servidor AW para actualizar Tomcat.

Desinstalación del Tomcat actual

Paso 1. Detenga el servicio de distribuidor:

Paso 2. Detenga Tomcat, el administrador de IIS y el servicio web de World Wide desde windows services.msc.

Abra Services.msc:

Paso 3. Desinstale la versión existente de Tomcat de Agregar o quitar programas.

1. Abra Panel de control > Programa y características > Seleccionar Tomcat:

2. Haga clic en Desinstalar/Cambiar:

Instalar Tomcat

Paso 1. Copie el instalador de Apache Tomcat (el archivo EXE) en c:\Temp:

Paso 2. Desde CMD como administrador, ejecute el instalador con este comando:

Nota: Su versión puede ser diferente: C:\temp\apache-tomcat-9.0.89.exe /s /D=C:\icm\tomcat.

Paso 3. Continúe con las indicaciones para instalar. Sólo hay una opción que debe modificar o buscar, que es la carpeta JRE.

Copia de seguridad de la carpeta Tomcat para eliminar directorios Tomcat

Una vez finalizada la instalación, antes de comenzar el trabajo, es necesario realizar una copia de seguridad de la carpeta Tomcat por si fuera necesario volver a empezar.

Paso 1. Realice una copia de seguridad de la carpeta Tomcat creada:

c:\icm\tomcat

Paso 2. Elimine el directorio 'C:\icm\tomcat\webapps\docs'

Paso 3. Elimine el directorio 'C:\icm\tomcat\webapps\manager'

Paso 4. Elimine el directorio 'C:\icm\tomcat\webapps\ROOT'

Copiar archivos Tomcat

Paso 1. Abra CMD como administrador y ejecute estas 4 consultas:

• 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

Paso 2. Desde el símbolo del sistema, ejecute estos pasos:

1. "%CCE_JAVA_HOME%\bin\java" -cp C:\icm\bin Unzip C:\icm\install\unifiedconfig-realm-assembly.zip C:\icm\tomcat\lib
2. "%CCE_JAVA_HOME%\bin\java" -cp C:\icm\bin Unzip C:\icm\install\shindig-cache-assembly.zip C:\icm\tomcat\lib

Paso 3. Desde el símbolo del sistema, ejecute estos pasos para copiar los archivos jar de ICM al directorio tomcat:

1. copy /Y C:\icm\bin\catalina.properties C:\icm\tomcat\conf\catalina.properties
2. copy /Y C:\icm\bin\icm-websetup-shared.jar C:\icm\tomcat\lib\icm-websetup-shared.jar
3. copy /Y C:\icm\bin\registry.jar C:\icm\tomcat\lib\registry.jar
4. copy /Y C:\icm\bin\jntservices.jar C:\icm\tomcat\lib\jntservices.jar
5. md C:\icm\tomcat\bin\i386 (Crear directorio)
6. copy /Y C:\icm\bin\isapi_redirect.dll C:\icm\tomcat\bin\i386\isapi_redirect.dll
7. copy /Y C:\icm\bin\web.xml C:\icm\tomcat\conf\web.xml
8. copy /Y C:\icm\bin\catalina-jmx-remote.jar C:\icm\tomcat\lib\catalina-jmx-remote.jar
9. copy /Y C:\icm\install\web.config C:\icm\tomcat\bin\i386\web.config
10. copy /Y C:\icm\bin\server.xml.IIS.custom C:\icm\tomcat\conf\server.xml

Agregar archivos que faltan

Paso 1. En el siguiente paso, mueva sobre dos archivos: uriworkermap.properties y workers.properties desde un servidor en funcionamiento, donde la instalación de Tomcat funciona correctamente. 

1. Observe que faltan los dos archivos.

2. Copie los archivos que faltan de un servidor en funcionamiento.

Paso 2. Agregue la información de registro que falta para las opciones de la clave del Registro Apache tomcat. 

Esta información es específica para ICM y no se agrega de forma predeterminada:

Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Apache Software Foundation\Procrun 2.0\Tomcat9\Parameters\Java

Información añadida a la clave de opciones después de la última línea de Opciones. Se debe agregar la cadena siguiente, incluidos los guiones presentes:

-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

Activar la herencia e iniciar el servicio Tomcat

Paso 1. El último paso antes de iniciar tomcat y el servicio IIS es validar la herencia de la carpeta. Si no realiza este paso, se devuelve un error de servidor interno 500 cuando IIS intenta utilizar el archivo isapi.dll de redirección. 

Como IIS ya no tiene permisos para la carpeta Tomcat:

1. Vaya a c:\icm\.
2. Busque la carpeta Tomcat.
3. Haga clic con el botón derecho y seleccione propiedades.
4. Elija Security > Advanced.
5. Haga clic en Habilitar herencia.
6. Haga clic en Apply (Aplicar).

Los derechos de usuario heredados son de c:\icm.

Paso 2. Verifique que la versión actualizada esté instalada ejecutando el comando version:

Paso 3. Inicie el servicio de distribuidor.

Paso 4. Inicie Apache Tomcat, IIS y el servicio World wide web desde services.msc:

Verificación

Validar si la página cceadmin se carga sin problemas y puede iniciar sesión: