Configurando os Sinalizadores Remotos para o Aplicativo de Serviços Remotos no WebSphere Application Server

É possível incluir parâmetros chamados sinalizadores nos arquivos de configuração do servidor de aplicativos para especificar determinados parâmetros para seu aplicativo de Serviços Remotos.

Antes de Iniciar

Revise a lista de sinalizadores remotos disponíveis para uso para o aplicativo de Serviços Remotos e selecione um a ser usado para concluir esta tarefa.
Tabela 1. Sinalizadores remotos
Sinalizador Valor Descrição
-Dcom.ibm.rational.rpe.docgen.concurrentlimit Um número

Exemplo: -Dcom.ibm.rational.rpe.docgen.concurrentlimit=5

Configure o número máximo de solicitações simultâneas de geração de documento do Rational Publishing Engine que podem ser executadas ao mesmo tempo. Se o limite for atingido, as solicitações de tarefa subsequentes serão colocadas em uma fila para iniciar depois que as tarefas atuais forem concluídas.
Importante: Conforme estiver selecionando um número de solicitações de geração de documento simultâneas, considere o número de licenças disponíveis para sua organização. Se uma licença não estiver disponível quando a geração de documento iniciar, independentemente de você configurar o limite simultâneo para um número maior que o número de licenças que você tem ou de todas as licenças que estão atualmente em uso, ocorrerá um dos comportamentos a seguir:
  • Se os sinalizadores com.ibm.rational.rpe.license.attempts.count e com.ibm.rational.rpe.license.retry.timeout forem especificados, a geração de documento será incluída na fila e tentada novamente nos intervalos especificados.
  • Se os sinalizadores com.ibm.rational.rpe.license.attempts.count e com.ibm.rational.rpe.license.retry.timeout não forem especificados, a geração de documento não poderá ser concluída. A geração de documento terminará.
-Dcom.ibm.rational.rpe.license.attempts.count Um número

Valor padrão: 1

Exemplo: -Dcom.ibm.rational.rpe.license.attempts.count=2

O número de vezes para verificar se há uma licença disponível. Se o valor inserido for inferior a 1, ele será ignorado.
-Dcom.ibm.rational.rpe.license.retry.timeout Um número em segundos

Valor padrão: 5 segundos

Exemplo: -Dcom.ibm.rational.rpe.license.retry.timeout=6

O número de segundos a esperar entre as tentativas de verificação de uma licença disponível.
-Dcom.ibm.rational.rpe.remote.debug true, false

Exemplo: -Dcom.ibm.rational.rpe.remote.debug=true

Você pode revisar informações de log mais detalhadas para depurar problemas de geração de documento.
-Dcom.ibm.rational.rpe.remote.filestore Um caminho de arquivo que inicia com \\

Exemplo: -Dcom.ibm.rational.rpe.remote.filestore=\\storage\rpe\files

Se estiver configurando um balanceamento de carga de carga, poderá designar o local do diretório de armazenamento compartilhado.
-Dcom.ibm.rational.rpe.remote.ignorelanguage true, false

Valor padrão: false

Exemplo: -Dcom.ibm.rational.rpe.remote.ignorelanguage=true

Quando configurado como true, o aplicativo Serviços remotos ignora os sinalizadores -Duser.country e -Duser.language configurados pelo usuário e configura o idioma padrão especificado para o servidor pelo administrador.
-Dcom.ibm.rational.rpe.remote.javaopts Tamanho de heap

Valor padrão: -Xmx1024m

Exemplo: -Dcom.ibm.rational.rpe.remote.javaopts=-Xmx1280m

É possível aumentar a quantidade de memória alocada para a geração de documentos pelo aplicativo de Serviços Remotos.

Se estiver usando um Java™ Runtime Environment (JRE) de 32 bits para o aplicativo de Serviços Remotos, será possível ajustar o tamanho de heap de 1 para 1,5 GB. Se você estiver usando um JRE de 64 bits para o aplicativo de Serviços Remotos, será possível ajustar o tamanho de heap para mais de 1,5 GB.

-Dcom.ibm.rational.rpe.remote.jre Um caminho absoluto para os arquivos de aplicativoJava Runtime Environment.

Exemplo: -Dcom.ibm.rational.rpe.remote.jre=C:\Program Files\Java\jre7

É possível especificar um caminho para o Java Runtime Environment diferente do contido nos arquivos de aplicativo do Rational Publishing Engine, que está localizado no RPE_HOME\jre.
-Dcom.ibm.rational.rpe.remote.jrearch 32 ou 64 bits.

Exemplo: -Dcom.ibm.rational.rpe.remote.jrearch=32

Se o Rational Publishing Engine não detectar a versão correta do Java Runtime Environment para executar gerações de documento, você poderá especificar qual versão deve ser usada.
-Dcom.ibm.rational.rpe.remote.rpecommandjar Um caminho absoluto para o arquivo rpecommand.jar.

Exemplo: -Dcom.ibm.rational.rpe.remote.rpecommandjar=C:\Program Files\Rational\Publishing Engine

Se o Rational Publishing Engine não detectar o caminho correto para o rpecommand.jar, você poderá especificar o caminho que deve ser usado.
-Dcom.ibm.rational.rpe.remote.showconsole true, false.

-Dcom.ibm.rational.rpe.remote.debug também deve ser configurado como true.

Exemplo:

-Dcom.ibm.rational.rpe.remote.showconsole=true
-Dcom.ibm.rational.rpe.remote.debug=true

Ícone do Windows: É possível abrir as informações de log detalhadas de com.ibm.rational.rpe.remote.debug em um console separado em sistemas Windows. Não use esta propriedade se o servidor de aplicativos estiver executando como um serviço do Windows NT.
-Dcom.ibm.rational.rpe.remote.workarea Um caminho absoluto ao qual o usuário tem acesso de gravação.

Exemplo: -Dcom.ibm.rational.rpe.remote.workarea=C:\temp

O local em que os arquivos temporários são criados durante a geração do documento. Se nenhum caminho for especificado, o diretório temporário para o sistema será utilizado.
-Dcom.ibm.rational.rpe.ssl Um tipo de segurança:
  • SSL
  • SSLv2
  • SSLv3
  • TLS
  • TLSv1
  • TLSv1.1

Exemplo: -Dcom.ibm.rational.rpe.ssl=TLSv1

Quando configurado para um tipo de segurança específico, o Rational Publishing Engine se comunica apenas nesse tipo de segurança.

Para o TLS v1.2, configure o sinalizador -Dcom.ibm.rational.rpe.tls12only em seu lugar. Se -Dcom.ibm.rational.rpe.tls12only e -Dcom.ibm.rational.rpe.ssl forem ambos configurados, -Dcom.ibm.rational.rpe.tls12only terá precedência.

-Dcom.ibm.rational.rpe.tls12only true, false

Exemplo: -Dcom.ibm.rational.rpe.tls12only=true

Quando configurado como true, o Rational Publishing Engine comunica-se somente no modo Transport Layer Security (TLS) 1.2. O Rational Publishing Engine não verifica outras configurações de propriedades da Java Virtual Machine para identificar qual protocolo Secure Sockets Layer (SSL) está em uso.

Se -Dcom.ibm.rational.rpe.tls12only e -Dcom.ibm.rational.rpe.ssl forem ambos configurados, -Dcom.ibm.rational.rpe.tls12only terá precedência.

-Dcom.ibm.ws.classloader.encodeResourceURLs true, false

-Dcom.ibm.rational.rpe.remote.debug também deve ser configurado como true.

Exemplo:

-Dcom.ibm.ws.classloader.encodeResourceURLs=false
-Dcom.ibm.rational.rpe.remote.debug=true

Obrigatório apenas para o WebSphere Application Server 8. Este sinalizador impede que as URLs sejam codificadas. Quando as URLs são codificadas pelo WebSphere Application Server 8, elas não podem ser lidas pelo Rational Publishing Engine.

Procedimento

  1. Abra o console administrativo em um navegador. Exemplo: http://server:port/ibm/console/logon.jsp
  2. Expanda Servidores > Tipos de Servidores.
  3. Clique em WebSphere Application Servers.
  4. Abra as propriedades do servidor clicando em server_name.
  5. Na seção Infraestrutura do Servidor, expanda Gerenciamento de Java e Processos.
  6. Clique em Definição de Processo.
  7. Na seção Propriedades Adicionais, clique em Java Virtual Machine.
  8. Na seção Propriedades Adicionais, clique em Propriedades Customizadas.
  9. Clique em Novo para incluir o sinalizador.
  10. No campo Nome, insira o nome do sinalizador selecionado.
  11. Do nome do sinalizador copiado, exclua -D do início. Por exemplo, -Dcom.ibm.rational.rpe.flag, se torna com.ibm.rational.rpe.flag.
  12. No campo Valor, insira o parâmetro para o sinalizador.
  13. Opcional: Insira uma descrição indicando o propósito de usar o sinalizador.
  14. Clique em OK.
  15. Reinicie o servidor.

Feedback