É 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:
Procedimento
- Prepare o servidor de aplicativos Apache Tomcat:
- 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.
- Aumente os tamanhos máximos do arquivo e da solicitação:
Para o Tomcat 7:
- Abra o arquivo web.xml do aplicativo gerenciador
Tomcat, por exemplo, TomcatInstallDir/webapps/manager/WEB-INF/web.xml.
- 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>
- 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>
- Salve e feche o arquivo web.xml.
Para o Tomcat 8:
- Pare o servidor de aplicativos Apache Tomcat.
- Exclua o diretório dgaas e dgaas.war do
diretório TOMCAT_HOME\webapps, se eles já existirem.
- Copie o arquivo dgaas.war para o
diretório TOMCAT_HOME\webapps.
- Inicie o servidor de aplicativos Apache Tomcat:

- 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

- 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
- 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.
- Abra o Gerenciador do Apache Tomcat em um navegador em
http://server:port/manager/html
Exemplo:
http://localhost:8080/manager/htmlDica: 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"/>
- Implemente os aplicativos rpeng.war e dgaas.war
no Apache Tomcat.
- 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:
- 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.
- URL do arquivo de configuração XML: Não é
necessário.
- 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:
- Selecione WAR para upload: O caminho para
o arquivo rpeng.war. Exemplo: RPE_HOME\remote-services\rpeng.war
- 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:
- 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.
- URL do arquivo de configuração XML: Não é
necessário.
- 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:
- 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:
- 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.
- 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.
- Selecione Variáveis de Tempo de Execução.
- 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.