Atualizar Apache Tomcat manualmente

Introdução

Este documento descreve como atualizar manualmente o Apache Tomcat no CCE.

Pré-requisitos

Requisitos

A Cisco recomenda que você tenha conhecimento destes tópicos:

• Contact Center Enterprise (CCE) 12.6
• Apache Tomcat

Componentes Utilizados

As informações neste documento são baseadas nestas versões de software e hardware:

• CCE 12.6
• Apache Tomcat 9.x

As informações neste documento foram criadas a partir de dispositivos em um ambiente de laboratório específico. Todos os dispositivos utilizados neste documento foram iniciados com uma configuração (padrão) inicial. Se a rede estiver ativa, certifique-se de que você entenda o impacto potencial de qualquer comando.

Atualização

Na maioria dos casos, atualizar o Tomcat usando o utilitário Cisco Upgrade Tomcat resolve vulnerabilidades. Há momentos em que a atualização do Tomcat falha, a configuração está corrompida ou uma nova pessoa atualiza o Tomcat usando os arquivos que encontra Online.

Caution: Tire um instantâneo da VM antes de iniciar este procedimento. Entre em contato com o TAC para obter assistência.

Antes da atualização

1. Baixe o instalador do Tomcat (apache-tomcat-version.exe) do site do Tomcat: http://archive.apache.org/dist/tomcat/tomcat-9/.

2. Copie o instalador nas VMs de componente do Unified CCE. Nesta atualização, usei a versão 9.0.89 do tomcat.

Neste laboratório, um servidor AW foi usado para atualizar o Tomcat.

Desinstalar o Tomcat atual

Etapa 1. Interrompa o serviço do distribuidor:

Etapa 2. Interrompa o Tomcat, o administrador do IIS e o serviço da Web do mundo a partir do windows services.msc.

Abra Services.msc:

Etapa 3. Desinstalar a versão Tomcat existente em Adicionar ou remover programas.

1. Abra Painel de Controle > Programa e Recursos > Selecionar Tomcat:

2. Clique em Desinstalar/Alterar:

Instalar Tomcat

Etapa 1. Copie o instalador do Apache Tomcat (o arquivo EXE) em c:\Temp:

Etapa 2. No CMD como administrador, execute o instalador usando este comando:

Note: Sua versão pode ser diferente: C:\temp\apache-tomcat-9.0.89.exe /s /D=C:\icm\tomcat.

Etapa 3. Continue com os avisos para instalar. Há apenas uma opção que você precisa modificar ou pesquisar, que é para a pasta JRE.

Fazer backup da pasta do Tomcat para excluir diretórios do Tomcat

Uma vez que a instalação esteja concluída, antes de começar a trabalhar, a pasta do Tomcat precisa ser copiada em backup, caso seja necessário recomeçar.

Etapa 1. Fazer backup da pasta do Tomcat criada:

c:\icm\tomcat

Etapa 2. Exclua o diretório, 'C:\icm\tomcat\webapps\docs'

Etapa 3. Exclua o diretório, 'C:\icm\tomcat\webapps\manager'

Etapa 4. Exclua o diretório,'C:\icm\tomcat\webapps\ROOT'

Copiar arquivos Tomcat

Etapa 1. Abra o CMD como administrador e execute 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

Etapa 2. No prompt de comando, execute estas etapas:

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

Etapa 3. No prompt de comando, execute estas etapas para copiar os arquivos jar do ICM para o diretório 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 (Criar diretório)
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

Adicionar Arquivos Ausentes

Etapa 1. Na próxima etapa, passe por dois arquivos: uriworkermap.properties e workers.properties a partir de um servidor em funcionamento, em que a instalação do Tomcat está funcionando corretamente. 

1. Observe que os dois arquivos estão ausentes.

2. Copie os arquivos ausentes de um servidor em funcionamento.

Etapa 2. Adicione as informações de registro ausentes para as opções na chave de registro Apache tomcat. 

Estas informações são Específicas do ICM e não são adicionadas por padrão:

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

Informações adicionadas às opções Chave após a última linha em Opções. A sequência subsequente deve ser adicionada, incluindo os hífens presentes:

-DICM_ROOT=C:\icm

-Dcom.sun.management.jmxremote.ssl.need.client.auth=false

-Dcom.sun.management.jmxremote.authenticate=falso

-Dcom.sun.management.jmxremote.port=1299

-Dcom.sun.management.jmxremote.ssl=false

-XX:MaxPermSize=128 m

-Dfile.encoding=UTF8

-Dclient.encoding.override=UTF-8

Habilitar herança e iniciar o serviço Tomcat

Etapa 1. A última etapa antes de iniciar o serviço tomcat e IIS é validar a herança para a pasta. Se você perder esta etapa, um erro de servidor interno 500 será retornado quando o IIS tentar usar o arquivo redirect isapi.dll. 

Como o IIS não tem mais permissões para a pasta Tomcat:

1. Navegue até c:\icm\
2. Localize a pasta Tomcat.
3. Clique com o botão direito do mouse e selecione propriedades.
4. Escolha Segurança > Avançado.
5. Clique em Enable Inheritance.
6. Clique em Apply.

Os direitos de usuário herdados são de c:\icm.

Etapa 2. Verifique se a versão atualizada está instalada executando o comando version:

Etapa 3. Inicie o serviço do distribuidor.

Etapa 4. Inicie o Apache Tomcat, o IIS e o serviço da Web em todo o mundo a partir de services.msc:

Verificar

Valide se a página cceadmin carregar sem problemas e conseguir fazer login: