Configurando o Proxy

Depois de instalar o proxy e os componentes de execução de serviço no computador proxy, você deve configurar o proxy para executar os serviços.

Local do Arquivo de Opções do Produto Proxy

Use o arquivo de opções do produto proxy para configurar as propriedades de configuração do proxy. O arquivo de opções do produto proxy está localizado em proxy_folder/eclipse.ini, em que proxy_folder é a pasta na qual o proxy foi instalado. A pasta de proxy padrão depende do sistema operacional e do usuário que instalou o proxy.
  • Pasta do proxy padrão em computadores Microsoft Windows:
    • 32 bits: C:\Program Files\IBM Optim\proxy\
    • 64 bits: C:\Program Files (x86)\IBM Optim\proxy\
  • Pasta padrão do proxy em computadores Linux ou UNIX:
    • Proxy instalado pelo superusuário: /opt/IBM/Optim/proxy/
    • Proxy instalado pelo usuário que não é o superusuário: /home/username/IBM/Optim/proxy/, em que username é o nome do usuário que instalou o proxy

Configurando o Proxy para Usar o Executor

Se você desejar usar o proxy para executar serviços com o executor, instale o executor no mesmo computador proxy.

Depois de instalar o executor, abra o arquivo executor_folder/eclipse.ini e procure a seguinte linha, em que executor_folder é a pasta do executor. Se esta linha existir, configure a linha para a pasta correta do executor. Você sempre deverá alterar esta linha se instalar o executor em um computador com uma versão de 64 bits do Windows. Se esta linha não existir, inclua o arquivo com a pasta correta do executor.
-Dcom.ibm.nex.executor.location=executor_folder
A pasta de execução padrão depende do sistema operacional e do usuário que instalou o executor.
  • Pasta padrão do executor em computadores Windows:
    • 32 bits: C:\Program Files\IBM Optim\executor
    • 64 bits: C:\Program Files (x86)\IBM Optim\executor
  • Pasta padrão do executor em computadores Linux ou UNIX:
    • Executor instalado pelo superusuário: /opt/IBM/Optim/executor
    • Executor instalado por um usuário diferente do superusuário: /home/username/IBM/Optim/executor, em que username é o nome do usuário que instalou o executor

Configurando o proxy para usar o programa Optim pr0cmnd

É possível usar o proxy para executar serviços com o programa Optim pr0cmnd como seu componente de execução de serviço. Primeiro, você deve instalar e configurar o Optim no mesmo computador proxy para que o programa pr0cmnd fique no computador proxy. Você também deve instalar no computador proxy as bibliotecas do cliente de banco de dados para qualquer sistema de gerenciamento de banco de dados relacional que os serviços usarem. O computador proxy deve poder acessar um banco de dados que possa ser usado para armazenar o diretório do Optim. Use o Optim para executar pelo menos um serviço sozinho para verificar se o programa pr0cmnd está configurado adequadamente e pronto para executar serviços.

Ao executar um serviço que usa o comando pr0cmnd, o proxy usa a versão do pr0cmnd na seguinte pasta por padrão:
  • Pasta padrão do programa em computadores Windows:
    • 32 bits: C:\Program Files\IBM Optim\RT\BIN
    • 64 bits: C:\Program Files (x86)\IBM Optim\RT\BIN
  • Pasta padrão do programa em computadores Linux ou UNIX: /opt/IBM/Optim/rt/bin
Se o programa pr0cmnd estiver em uma pasta diferente da pasta padrão, inclua o seguinte argumento no final do arquivo proxy_folder/eclipse.ini. Você sempre deverá incluir esse argumento se instalar o Optim em um computador com uma versão de 64 bits do Windows.
-Dcom.ibm.nex.pr0cmnd.location=pr0cmnd_folder
  • pr0cmnd_folder é a pasta do programa para o programa pr0cmnd.
Por exemplo, a seguinte linha especifica /opt/IBM/Optim/dist/bin como o nome da pasta de programa para o programa pr0cmnd.
-Dcom.ibm.nex.pr0cmnd.location=/opt/IBM/Optim/dist/bin

Configurando o Proxy para Enviar Serviços para o Optim para z/OS

Se for possível executar com êxito um serviço do Optim para z/OS a partir do designer, você poderá executar o mesmo serviço sem qualquer configuração adicional do proxy. Entretanto, pode ser necessário configurar a rede, os firewalls e o computador IBM® z/OS para que o proxy possa enviar com êxito o serviço para o computador z/OS.

Configurando os Locais de Registro e Repositório

Por padrão, o proxy é configurado para usar o registro e repositório em http://localhost:8080/server/registry e http://localhost:8080/server/repository. Esses locais serão válidos se o registro e o repositório estiverem em um servidor de gerenciamento que esteja instalado no computador proxy e que use a porta 8080. Por padrão, o WebSphere Application Server Community Edition usa a porta 8080 para o servidor de gerenciamento. Se o proxy e o registro e repositório estiverem em computadores diferentes, você deverá configurar os locais de registro e repositório para o proxy. Você também deverá configurar os locais de registro e repositório se implementar o servidor de gerenciamento para um servidor de aplicativos que não seja o WebSphere Application Server Community Edition.

Abra o arquivo proxy_folder/eclipse.ini e procure as seguintes linhas, em que registry_URL é o local do registro e repository_URL é o local do repositório. Se essas linhas existirem, configure-as nos locais de registro e repositório corretos. Se essas linhas não existirem, inclua-as no arquivo com os locais do registro e do repositório corretos.
-Dcom.ibm.optim.registry.url=registry_URL
-Dcom.ibm.optim.repository.url=repository_URL
Por exemplo, as seguintes linhas especificam http://mgmtserver1:8080/server/registry como local do registro e http://mgmtserver1:8080/server/repository como local do repositório.
-Dcom.ibm.optim.registry.url=http://mgmtserver1:8080/server/registry
-Dcom.ibm.optim.repository.url=http://mgmtserver1:8080/server/repository

Configurando o Nome do Host e a Porta para um Proxy

Se o computador proxy estiver designado a endereços IP dinamicamente, configure o nome do host e a porta que devem ser usados pelo proxy. Para configurar o nome do host e a porta para o proxy, inclua os seguintes argumentos no final do arquivo proxy_folder/eclipse.ini.
-Dcom.ibm.optim.host.name=host_name
-Dcom.ibm.optim.host.port=host_port
  • host_name é o nome do host ou o endereço IP do proxy.
  • host_port é a porta usada pelo proxy.
Por exemplo, as seguinte linhas especificam proxy_computer como o nome do host do proxy e 12000 como o número de porta usado pelo proxy.
-Dcom.ibm.optim.host.name=proxy_computer
-Dcom.ibm.optim.host.port=12000

Configurando a Variável de Ambiente da Biblioteca Compartilhada

Ao instalar o proxy no Linux ou UNIX, configure a variável de ambiente da biblioteca compartilhada para incluir o diretório que contém as bibliotecas de proxy (proxy_folder/shared/bin). Configure a variável de ambiente compartilhada para cada conta usada para executar o proxy. Para configurar a variável de ambiente de biblioteca compartilhada para uma conta, inclua as seguintes linhas no perfil de login da conta.
  • AIX:
    LIBPATH=$LIBPATH:proxy_folder/shared/bin
    export LIBPATH
  • Linux ou Solaris:
    LD_LIBRARY_PATH=$LD_LIBRARY_PATH:proxy_folder/shared/bin
    export LD_LIBRARY_PATH

Configurando o Proxy para Usar o Protocolo https

É possível estabelecer um relacionamento confiável entre um servidor de gerenciamento e um proxy. Entre outras coisas, você deve configurar o proxy para usar o protocolo https para comunicar-se com outros componentes. O proxy usa o protocolo http, a menos que você configure o proxy para usar o protocolo https. Para configurar o proxy para usar o protocolo https, inclua o seguinte argumento no final do arquivo proxy_folder/eclipse.ini.
-Dcom.ibm.optim.url.protocol=https
Por exemplo, as seguintes linhas especificam https://mgmtserver1:8080/server/registry como local do registro e https://mgmtserver1:8080/server/repository como local do repositório.
-Dcom.ibm.optim.registry.url=https://mgmtserver1:8080/server/registry
-Dcom.ibm.optim.repository.url=https://mgmtserver1:8080/server/repository
-Dcom.ibm.optim.url.protocol=https

Configurando os Recursos de Armazenamento de Dados (NDS) Nativos em um Proxy

Para configurar um proxy para executar serviços que usam armazenamentos de dados nativos, instale o software do cliente de banco de dados relacional no computador proxy. Em seguida, use uma propriedade de local de armazenamento de dados nativo para especificar o local das bibliotecas compartilhadas nativas que são instaladas com o cliente de banco de dados. Inclua a propriedade de local de armazenamento de dados nativo para o sistema de banco de dados relacional no fim do comando proxy_folder/eclipse.ini.

A seguinte lista contém o nome da propriedade do local de armazenamento de dados nativo para cada sistema de banco de dados relacional suportado.
  • DB2 para Linux, UNIX e Windows: com.ibm.nex.nds.rdbms.udb.location
  • DB2 para z/OS: com.ibm.nex.nds.rdbms.db2.location
  • Oracle: com.ibm.nex.nds.rdbms.oracle.location
  • Informix: com.ibm.nex.nds.rdbms.informix.location
Por exemplo, o proxy é instalado em um computador Linux, enquanto as bibliotecas compartilhadas nativas do DB2 para Linux, UNIX e Windows são instaladas em /opt/IBM/db2/V9.7/sqllib/lib32. Para configurar o recurso NDS para DB2 para Linux, UNIX e Windows no proxy, inclua a seguinte linha no final do arquivo proxy_folder/eclipse.ini.
-Dcom.ibm.nex.nds.rdbms.udb.location=/opt/IBM/db2/V9.7/sqllib/lib32

Configurando o Proxy para Usar a Versão Exata do Driver Especificada em Todas as Solicitações

Por padrão, o proxy usa o driver JDBC que está especificado na solicitação de serviço ou em qualquer versão mais recente do mesmo driver. O proxy usa o primeiro driver que ele localiza no repositório. É possível configurar o proxy para que use somente a versão do driver JDBC que está especificada na solicitação de serviço. Se o repositório não contiver a versão que está especificada na solicitação de serviço, o proxy retornará um erro. Para configurar o proxy para que use somente a versão exata do driver especificada, inclua a seguinte linha no final do arquivo proxy_folder/eclipse.ini:
-Dcom.ibm.nex.capability.driver.compatility.level=enforceExactVersionMatch

Configurando o Proxy para Usar Codificação UTF-8 em Logs

Se você instalar o proxy em um computador configurado com um idioma que exige o uso de caracteres de byte duplo, configure o proxy para usar a codificação UTF-8 nos arquivos de log. Para configurar o proxy para usar a codificação UTF-8, inclua a seguinte linha no final do arquivo proxy_folder/eclipse.ini.
-Dfile.encoding=UTF-8
Nos computadores Windows, você também deve incluir a seguinte linha, em que encoding é a codificação de caractere usada pelo computador Windows. Por exemplo, use MS932 para a codificação Shift JIS.
-Dconsole.encoding=encoding

Configurando Permissões de Arquivo

Se você instalar o executor em um computador Linux ou UNIX como um usuário que não seja o superusuário, as permissões de arquivo em seu diretório inicial poderão restringir o uso do executor pelos usuários. Para corrigir esse problema, execute qualquer uma das tarefas a seguir.
  • Peça ao administrador para instalar o executor em /opt/IBM/Optim/executor.
  • Configure as permissões de arquivo para a pasta na qual o executor é instalado para que os usuários possam executar o executor.