Implementando o aplicativo da web no Apache Tomcat

É possível implementar os aplicativos da web Rational Publishing Engine web apps (rpeng.war e dgaas.war) em um servidor Apache Tomcat com Derby.

Antes de Iniciar

Você deve instalar o Apache Tomcat V7.0.x ou V8.0.x e Rational Publishing Engine com o recurso RPE Remote Services antes de implementar o aplicativo da web.
Você deve ter acesso aos seguintes aplicativos da web disponíveis no diretório RPE_HOME\remote-services:
  • rpeng.war
  • dgaas.war

Procedimento

  1. Prepare o servidor de aplicativos Apache Tomcat:
    1. No servidor de aplicativos Tomcat, configure a variável do sistema TELELOGIC_LICENSE_FILE para port_number@hostname, por exemplo, 19353@licserver1. Para obter mais detalhes, consulte o tópico Verificar a variável de ambiente TELELOGIC_LICENSE_FILE.
    2. Aumente os tamanhos máximos do arquivo e da solicitação:

      Para o Tomcat 7:

      1. Abra o arquivo web.xml do aplicativo gerenciador Tomcat, por exemplo, TomcatInstallDir/webapps/manager/WEB-INF/web.xml.
      2. Localize a seção a seguir:
        <multipart-config>
        <!-- 50 MB max -->
        <max-file-size>52428800</max-file-size>
        <max-request-size>52428800</max-request-size>
        <file-size-threshold>0</file-size-threshold>
        </multipart-config>
      3. Edite esta seção para aumentar a capacidade:
        <multipart-config>
        <!-- 70 MB max -->
        <max-file-size>73400320</max-file-size>
        <max-request-size>73400320</max-request-size>
        <file-size-threshold>0</file-size-threshold>
        </multipart-config>
      4. Salve e feche o arquivo web.xml.
      Para o Tomcat 8:
      1. Pare o servidor de aplicativos Apache Tomcat.
      2. Exclua o diretório dgaas e dgaas.war do diretório TOMCAT_HOME\webapps, se eles já existirem.
      3. Copie o arquivo dgaas.war para o diretório TOMCAT_HOME\webapps.
  2. Inicie o servidor de aplicativos Apache Tomcat:
    Este é um ícone do sistema operacional Windows.
    Se você estiver executando o Apache Tomcat como um serviço do Windows, para iniciar o servidor, a partir do diretório TomcatInstallDir/bin, execute este comando (para o Apache Tomcat V7.0.x, substitua pelo Tomcat7.exe):
    Tomcat8.exe start
    Para parar o servidor, a partir do diretório TomcatInstallDir/bin, execute este comando (para Apache Tomcat V7.0.x, substitua pelo Tomcat7.exe):
    Tomcat8.exe stop
    Se você não estiver executando o Apache Tomcat como um serviço do Windows, para iniciar o servidor, a partir do diretório TomcatInstallDir/bin, execute este comando:
    startup.bat
    Dica: Uma janela separada do console do Apache Tomcat é aberta. Não feche essa janela ou o servidor parará de funcionar. É necessário esperar um momento para que o servidor Tomcat seja iniciado. Após o servidor ser iniciado, o horário de inicialização, em milissegundos, será exibido na janela do Tomcat. Por exemplo, Inicialização do servidor em 25731 ms.
    Para parar o servidor, a partir do diretório TomcatInstallDir/bin, execute este comando:
    shutdown.bat
    Este é um ícone do sistema operacional Linux.
    Para iniciar o servidor, a partir do diretório TomcatInstallDir/bin, execute este comando:
    startup.sh
    Para parar o servidor, a partir do diretório TomcatInstallDir/bin, execute este comando:
    shutdown.sh
  3. Selecione uma das opções a seguir para implementar o aplicativo da web:
    • Se desejar implementar o aplicativo da web usando uma interface gráfica com o usuário, continue com a próxima etapa para obter detalhes sobre como implementar usando a interface do Apache Tomcat Manager.
    • Se desejar implementar o aplicativo da web usando o sistema de arquivos, copie os arquivos rpeng.war e dgaas.war do diretório RPE_HOME\remote-services para o diretório webapps do Tomcat, por exemplo, Tomcat_InstallDir\webapps. E, em seguida, continue com a seção Resultados e O que fazer a seguir deste tópico.
  4. Abra o Gerenciador do Apache Tomcat em um navegador em http://server:port/manager/html
    Exemplo: http://localhost:8080/manager/html
    Dica: Uma janela solicitando um nome do usuário e a senha para autenticar o Aplicativo Tomcat Manager. Você deve incluir uma função manager-gui no arquivo Tomcat_install_dir/conf/tomcat-user.xml, em que Tomcat_install_dir é o diretório de instalação do Apache Tomcat. O seguinte exemplo inclui uma função manager-gui com my_username como o nome de usuário e my_password para a senha:
    <user username="my_username" password="my_password" roles="manager-gui"/>
  5. Implemente os aplicativos rpeng.war e dgaas.war no Apache Tomcat.
    1. Na seção Implementar, insira os detalhes para o arquivo rpeng.war e, em seguida, clique em Implementar:
      • Se o arquivo WAR estiver em um servidor diferente do Apache Tomcat, insira as seguintes informações na seção Implementar diretório ou arquivo WAR localizado no servidor:
        1. Caminho de Contexto: Insira /rpeng como o nome para o aplicativo da web do Rational Publishing Engine. Esta entrada é uma parte da URL usada para configurar o cliente.
        2. URL do arquivo de configuração XML: Não é necessário.
        3. WAR ou URL do Diretório: O caminho para o arquivo rpeng.war. Exemplo: RPE_HOME\remote-services\rpeng.war
      • Se o arquivo .war estiver no mesmo servidor que o Apache Tomcat, insira as seguintes informações na seção Arquivo WAR a Ser Implementado:
        1. Selecione WAR para upload: O caminho para o arquivo rpeng.war. Exemplo: RPE_HOME\remote-services\rpeng.war
    2. Na seção Implementar, insira os detalhes para o arquivo dgaas.war e, em seguida, clique em Implementar:
      • Se o arquivo .war estiver em um servidor diferente do Apache Tomcat, insira as seguintes informações na seção Implementar diretório ou arquivo WAR localizado no servidor:
        1. Caminho de Contexto: Insira /dgaas como o nome para o aplicativo da web do Rational Publishing Engine. Esta entrada é uma parte da URL usada para configurar o cliente.
        2. URL do arquivo de configuração XML: Não é necessário.
        3. WAR ou URL do Diretório: O caminho para o arquivo dgaas.war. Exemplo: RPE_HOME\remote-services\dgaas.war
      • Se o arquivo .war estiver no mesmo servidor que o Apache Tomcat, insira as seguintes informações na seção Arquivo WAR a Ser Implementado:
        1. Selecione WAR para upload: O caminho para dgaas.war. Exemplo: RPE_HOME\remote-services\dgaas.war

Resultados

É possível confirmar que o aplicativo da web está implementado abrindo a página introdutória do aplicativo da web Rational Publishing Engine em um navegador em http://server:port/rpeng/
Importante:

Por padrão, o aplicativo rpeng.war procura o aplicativo dgaas.war no mesmo servidor, no caminho do contexto /dgaas. Se você implementar o aplicativo dgaas.war em um servidor diferente ou em um caminho do contexto diferente, você deverá configurar a variável de tempo de execução DGAAS_URL no aplicativo rpeng.war.

Para configurar a variável de ambiente de tempo de execução DGAAS_URL:
  1. Você deve efetuar logon no aplicativo da web, http://server:port/rpeng/, com um usuário que tenha acesso de administrador (rpe_admin). Para obter detalhes sobre como configurar um usuário com a função de usuário rpe_admin, consulte o tópico Configurando usuários para o aplicativo da web no Apache Tomcat.
  2. Na barra de ferramentas do usuário do aplicativo da web, selecione Administrar. Esta opção de menu Administrar está disponível para usuários com a função rpe_admin.
  3. Selecione Variáveis de Tempo de Execução.
  4. Configure o valor da variável de ambiente de tempo de execução DGAAS_URL para uma URL, como http://server:port/dgaas.

O que Fazer Depois

Opcionalmente, é possível implementar e executar o aplicativo de amostra Newskeeper que usa a tecnologia de serviço de geração de documento para gerar documentos e fornece uma interface de armazenamento para os documentos e ativos de serviço de geração de documento. Para obter mais detalhes, consulte Executando a amostra do Newskeeper.

Configure o aplicativo da web Rational Publishing Engine listado na página http://server:port/rpeng/. Consulte URLs do aplicativo da web para obter uma explicação de como cada URL é usada e as tarefas para configuração de cada um dos recursos.