Atualizar o Apache Tomcat em uma instalação existente do ThingWorx Navigate

Siga os passos deste tópico para atualizar o Apache Tomcat em uma instalação existente do ThingWorx Navigate.

◦ <Tomcat Home>\webapps\Thingworx.war

◦ <Tomcat Home>\conf\server.xml

◦ <Tomcat Home>\conf\web.xml

◦ <Tomcat Home>\bin\setenv.bat

◦ <Tomcat Home>\conf\sslkeystore.jks (if Tomcat is configured using SSL)

◦ (Opcional) pastas ThingworxPlatform e ThingworxStorage localizados no diretório de instalação do ThingWorx.

◦ Se você instalou o ThingWorx com um banco de dados MSSQL, faça backup do <Tomcat Home>\lib\mssql-jdbc-<version>.jre8.

◦ Se o seu ThingWorx estiver configurado para usar Windchill como o IDP, faça backup do <Tomcat Home>\webapps\Thingworx\WEB-INF\web.xml e <Tomcat-Home>\webapps\Thingworx\WEB-INF\lib\ptc-identity-provider-authentication-filter-<version>.jar

3. Execute uma das ações a seguir com base no tipo de instalação:

◦ Se você instalou o ThingWorx Navigate usando o instalador, apague o conteúdo da pasta do Tomcat <Navigate-Install>/tomcat/apache-tomcat-8.5.23/*.*. Além disso, observe o nome do serviço instalador (por exemplo, "ThingWorx-Foundation") e, em seguida, apague o serviço. Este nome será necessário mais tarde durante a instalação.

◦ Se você instalou o ThingWorx Navigate manualmente, desinstale o Apache Tomcat.

4. Faça download da versão requerida do Apache Tomcat usando o instalador de 32 bits/64 bits.

◦ Certifique-se de que a versão instalada da plataforma ThingWorx tenha suporte para a versão do Apache Tomcat que você deseja instalar. Para verificar as informações de compatibilidade, faça uma busca pelo documento de requisitos do sistema para a versão aplicável da plataforma ThingWorx nos documentos de referência da PTC.

◦ Se você instalou o ThingWorx Navigate usando o instalador:

▪ Instale o novo Tomcat na pasta tomcat do diretório de instalação. Caminho: <navigate-installation>/tomcat/apache-tomcat-{version}.

▪ Nomeie o serviço Tomcat como "ThingWorx-Foundation" (mesmo nome do serviço que você apagou no passo 3). Essa operação ajuda a garantir que a ferramenta ThingWorx Navigate Configuration funcione como esperado após a atualização do Tomcat.

◦ Consulte o arquivo setenv.bat para os locais de instalação do Tomcat e JAVA.

◦ As instruções para instalar o Apache Tomcat estão disponíveis na seção Instalando o ThingWorx do Help Center da plataforma ThingWorx 8. Para localizar o guia Instalando o ThingWorx para qualquer outra versão da plataforma ThingWorx, visite a página de documentos de referência da PTC.

▪ É possível ignorar as instruções de instalação do JAVA no documento, pois o JAVA já foi instalado dentro de uma instalação do ThingWorx Navigate.

▪ Certifique-se de atualizar as permissões de responsável da pasta tomcat com base no ThingWorx Navigate instalado antes da instalação manual do Apache Tomcat.

6. Depois de concluir a instalação e a configuração do Apache Tomcat, coloque o arquivo Thingworx.war copiado (conforme instruído no passo 2) na pasta <Tomcat Home>webapps.

7. Se um caminho não padrão for usado para a pasta ThingworxPlatform, atualize a variável de ambiente do sistema THINGWORX_PLATFORM_SETTINGS, se ela for afetada pela atualização do Apache Tomcat.

8. Atualize a variável PATH no <Tomcat Home>\webapps com o local do Tomcat.

9. Se você fez quaisquer mudanças nos arquivos de configuração (web.xml, server.xml), cole esses arquivos (copiados no passo 2) em seus respectivos locais da nova instalação.

10. Se o Tomcat existente foi configurado usando SSL e você copiou server.xml antes da atualização (conforme instruído no passo 2), realize uma das ações a seguir:

◦ Copie o arquivo sslkeystore.jks da pasta de configuração do Tomcat existente para a nova instalação.

◦ Atualize o caminho para o local sslkeystore.jks correto no server.xml.

11. Se o seu ThingWorx Navigate estiver configurado com autenticação Windchill, coloque os arquivos web.xml e ptc-identity-provider-authentication-filter-<version>.jar de volta em seus respectivos locais.

O ThingWorx Navigate foi atualizado com êxito. É hora de começar a usar a nova versão.

Se o ThingWorx Composer não estiver acessível e um erro 500 ocorrer após a atualização, consulte CS315394.