Roteiros de instalação de plug-in de servidor da web para o WebSphere Application Server Network Deployment Versão 8.5

Introdução
Roteiros de instalação de plug-in:

  1. Instalação de plug-in de servidor da web para servidores de aplicativos independentes
  2. Instalação de plug-in de servidor da web para ambientes distribuídos

Instalação de plug-in de servidor da web para servidores de aplicativos independentes

Cenário de instalação remota Cenário de instalação local

Ambiente típico


Produção (recomendado)


Desenvolvimento

Instalação e configuração

Instalação do servidor de aplicativos:
(Máquina A)
1. Instale o IBM Installation Manager.
2. Use o Installation Manager para instalar o produto WebSphere Application Server Network Deployment.
3. Crie um servidor de aplicativos independente.

Instalação de um servidor da web e dos Plug-ins do Servidor da Web:
(Máquina B)
4. Instale o IBM Installation Manager.
5. Use o Installation Manager para instalar o IBM HTTP Server ou instale outro servidor da web suportado.
6. Use o Installation Manager para instalar os Plug-ins de Servidor da Web para WebSphere Application Server.

Configuração do plug-in de servidor da web:
(Máquina B)
7. Use o Installation Manager para instalar o WebSphere Customization Tools.
8. Abra o WebSphere Customization Tools e ative o Web Server Plug-ins Configuration Tool para configurar o plug-in de servidor da web.

O script para criar e configurar o servidor da web é criado no diretório plugins_root/bin.

9. Copie o script configureWeb_server_name para colar na Máquina A.

Consulte Seção de considerações de diversas plataformas deste documento para obter mais informações sobre como executar scripts de configuração ao:

  • Uma máquina está executando o Windows e a outra está executando Linux ou UNIX.
  • Uma máquina está executando uma codificação de arquivo diferente.
Criação da definição de servidor da web:
(Máquina A)
10. Cole o script configureWeb_server_name da Máquina B no diretório app_server_root/bin na Máquina A
11.

Inicie o servidor de aplicativos na Máquina A.

12.

Execute o script na Máquina A.


Verificação:
(Máquina A)
13.

Verifique se o servidor de aplicativos está em execução.

(Máquina B)
14. Inicie o IBM HTTP Server ou inicie outro servidor da web suportado.
15.

Execute o snoop servlet.

Para verificar com seu próprio aplicativo, gere novamente e propague o arquivo plugin-cfg.xml após configurar (instalar) o aplicativo.

Instalação do servidor de aplicativos:
(Máquina A)
1. Instale o IBM Installation Manager.
2. Use o Installation Manager para instalar o produto WebSphere Application Server Network Deployment.
3. Crie um servidor de aplicativos independente.

Instalação de um servidor da web e dos Plug-ins do Servidor da Web:
(Máquina A)
4. Use o Installation Manager para instalar o IBM HTTP Server ou instale outro servidor da web suportado.
5. Use o Installation Manager para instalar os Plug-ins de Servidor da Web para WebSphere Application Server.

Configuração do plug-in de servidor da web e criação da definição de servidor da web:
(Máquina A)
6. Use o Installation Manager para instalar o WebSphere Customization Tools.
7. Abra o WebSphere Customization Tools e ative o Server Plug-ins Configuration Tool para configurar o plug-in de servidor da web e criar a definição de servidor da web.
8.

Inicie o servidor de aplicativos.


Verificação:
(Máquina A)
9.

Verifique se o servidor de aplicativos está em execução.

10. Inicie o IBM HTTP Server ou inicie outro servidor da web suportado.
11.

Execute o snoop servlet.


Regeneração do arquivo plugin-cfg.xml

Durante a configuração, o arquivo temporário plugin-cfg.xml é instalado na Máquina B no diretório plugins_root/config/Web_server_name.

O serviço de configuração de plug-in de servidor da web gera novamente o arquivo plugin-cfg.xml automaticamente.

Para usar o arquivo real plugin-cfg.xml do servidor de aplicativos, propague o arquivo plugin-cfg.xml conforme descrito na próxima seção.

O serviço de configuração de plug-in de servidor da web gera novamente o arquivo plugin-cfg.xml automaticamente.

O arquivo plugin-cfg.xml é gerado no diretório local profile_root/config/cells/cell_name/nodes/node_name/servers/Web_server_name quando a definição de servidor da web é criada.


Propagação do arquivo plugin-cfg.xml

O serviço de configuração de plug-in de servidor da web propaga o arquivo plugin-cfg.xml automaticamente apenas para o IBM HTTP Server. Para ativar a propagação automática, execute a configuração única.

Para todos os outros servidores da web, propague o arquivo de configuração de plug-in ao copiar manualmente o arquivo plugin-cfg.xml no diretório profile_root /config/cells/cell_name/nodes/node_name/servers/ web_server_name na Máquina A para o diretório plugins_root/config/web_server_name na Máquina B.

Use a opção de propagação para mover o arquivo plugin-cfg.xml do diretório profile_root/config/cells/cell_name/nodes/node_name/servers/Web_server_name para o diretório plugins_root/config/web_server_name.


Topologia remota






Topologia Local







Instalação de plug-in de servidor da web para ambientes distribuídos (células)




Cenário de instalação distribuída remota Cenário de instalação distribuída local

Ambiente típico


Produção (recomendado)


Desenvolvimento

Instalação e configuração

Instalação do Deployment Manager:
(Máquina A)
1. Instale o IBM Installation Manager.
2. Use o Installation Manager para instalar o produto WebSphere Application Server Network Deployment.
3. Crie um perfil do Deployment Manager.
4.

Verifique se o Deployment Manager está executando para permitir a sincronização de nós de arquivos de configuração alterados.


Instalação do servidor de aplicativos:
(Máquina B)
5. Instale o IBM Installation Manager.
6. Use o Installation Manager para instalar o produto WebSphere Application Server Network Deployment.
7. Crie um servidor de aplicativos independente.
8. Inclua o nó na célula do gerenciador de implementação para iniciar o processo do agente do nó. Inicie o agente do nó em um nó gerenciado existente. O Deployment Manager e o agente do nó devem estar em execução para permitir a sincronização de nós de arquivos de configuração alterados.

Instalação de um servidor da web e dos Plug-ins do Servidor da Web:
(Máquina C)
9. Instale o IBM Installation Manager.
10. Use o Installation Manager para instalar o IBM HTTP Server ou instale outro servidor da web suportado.
11. Use o Installation Manager para instalar os Plug-ins de Servidor da Web para WebSphere Application Server.

Configuração do plug-in de servidor da web:
(Máquina C)
12. Use o Installation Manager para instalar o WebSphere Customization Tools.
13. Abra o WebSphere Customization Tools e ative o Web Server Plug-ins Configuration Tool para configurar o plug-in de servidor da web.

O script para criar e configurar o servidor da web é criado no diretório plugins_root/bin.

14. Copie o script configureWeb_server_name para colar na Máquina A.

Consulte Seção de considerações de diversas plataformas deste documento para obter mais informações sobre como executar scripts de configuração ao:

  • Uma máquina está executando o Windows e a outra está executando Linux ou UNIX.
  • Uma máquina está executando uma codificação de arquivo diferente.

Criação da definição de servidor da web:
(Máquina A)
15. Cole o script configureWeb_server_name da Máquina C para o diretório app_server_root/bin na Máquina A.

16.

Execute o script a partir de uma linha de comandos.

Esta etapa requer que o Deployment Manager e o agente do nó estejam em execução.

Se tiver ativado a segurança ou alterado o tipo de conector JMX padrão, edite o script e inclua os parâmetros apropriados.


Verificação:
(Máquinas A e B)
17.

Use o console administrativo do Deployment Manager na Máquina A para iniciar o servidor de aplicativos na Máquina B.

(Máquina C)
18. Inicie o IBM HTTP Server ou inicie outro servidor da web suportado.
19.

Execute o snoop servlet.

Nota: O procedimento a seguir descreve a instalação dos plug-ins em duas máquinas. Entretanto, é possível executar esse procedimento em uma única máquina.

Instalação do Deployment Manager:
(Máquina A)
1. Instale o IBM Installation Manager.
2. Use o Installation Manager para instalar o produto WebSphere Application Server Network Deployment.
3. Crie um perfil do Deployment Manager.
4.

Verifique se o Deployment Manager está executando para permitir a sincronização de nós de arquivos de configuração alterados.


Instalação do servidor de aplicativos:
(Máquina B)
5. Instale o IBM Installation Manager.
6. Use o Installation Manager para instalar o produto WebSphere Application Server Network Deployment.
7. Crie um servidor de aplicativos independente.
8. Inclua o nó na célula do gerenciador de implementação para iniciar o processo do agente do nó. Inicie o agente do nó em um nó gerenciado existente. O Deployment Manager e o agente do nó devem estar em execução para permitir a sincronização de nós de arquivos de configuração alterados.

Instalação de um servidor da web e dos Plug-ins do Servidor da Web:
(Máquina B)
9. Use o Installation Manager para instalar o IBM HTTP Server ou instale outro servidor da web suportado.
10. Use o Installation Manager para instalar os Plug-ins de Servidor da Web para WebSphere Application Server.

Configuração do plug-in de servidor da web:
(Máquina B)
11. Use o Installation Manager para instalar o WebSphere Customization Tools.
12. Abra o WebSphere Customization Tools e ative o Server Plug-ins Configuration Tool para configurar o plug-in de servidor da web e criar a definição de servidor da web.

O script para criar e configurar o servidor da web é criado no diretório plugins_root/bin.

13. Copie o script configureWeb_server_name para colar na Máquina A.

Consulte Seção de considerações de diversas plataformas deste documento para obter mais informações sobre como executar scripts de configuração ao:

  • Uma máquina está executando o Windows e a outra está executando Linux ou UNIX.
  • Uma máquina está executando uma codificação de arquivo diferente.

Criação da definição de servidor da web:
(Máquina A)
14. Cole o script configureWeb_server_name da Máquina B no diretório app_server_root/bin na Máquina A.

15.

Execute o script a partir de uma linha de comandos.

Esta etapa requer que o Deployment Manager e o agente do nó estejam em execução.

Se tiver ativado a segurança ou alterado o tipo de conector JMX padrão, edite o script e inclua os parâmetros apropriados.


Verificação:
(Máquinas A e B)
16.

Use o console administrativo do Deployment Manager na Máquina A para iniciar o servidor de aplicativos na Máquina B.

17. Inicie o IBM HTTP Server ou inicie outro servidor da web suportado.

Antes de iniciar o servidor Domino Web em um sistema Linux ou UNIX, origine o script plug-ins_root/setupPluginCfg.sh.

18. Execute o snoop servlet.

Regeneração do arquivo plugin-cfg.xml

Durante a configuração, um arquivo temporário plugin-cfg.xml é instalado na Máquina C no diretório plugins_root/config/Web_server_name.

O serviço de configuração de plug-in de servidor da web gera novamente o arquivo plugin-cfg.xml automaticamente.

Para usar o arquivo real plugin-cfg.xml a partir do servidor de aplicativos, propague o arquivo plugin-cfg.xml conforme descrito na próxima seção.

O arquivo plugin-cfg.xml é gerado no diretório profile_root/config/cells/cell_name /nodes/node_name/servers/Web_server_name quando a definição de servidor da web é criada.

Gere novamente o arquivo plugin-cfg.xml na definição de servidor da web no servidor de aplicativos sempre que a configuração for alterada. O servidor da web possui acesso imediato ao arquivo sempre que for gerado novamente.

Quando o serviço de configuração de plug-in de servidor da web (um serviço de administração) é ativado na Máquina A, o arquivo plugin-cfg.xml é gerado automaticamente para todos os servidores da web.


Propagação do arquivo plugin-cfg.xml

O serviço de configuração de plug-in de servidor da web propaga o arquivo plugin-cfg.xml automaticamente apenas para o IBM HTTP Server. Para ativar a propagação automática, execute a configuração única descrita na última seção deste roteiro.

Para todos os outros servidores da web, propague o arquivo de configuração de plug-in, copiando manualmente o arquivo plugin-cfg.xml do diretório profile_root/config/cells/cell_name/nodes/node_name/servers/ Web_server_name na Máquina A para o diretório plugins_root/config/Web_server_name na Máquina C.

Use a opção de propagação para mover o arquivo plugin-cfg.xml do diretório profile_root/config/cells/cell_name/nodes/node_name/servers/Web_server_name para o diretório plugins_root/config/web_server_name.


Topologia remota






Topologia Local







Procedimento de configuração e resolução de problemas para propagação automática

O serviço de configuração de plug-in de servidor da web propaga o arquivo plugin-cfg.xml automaticamente apenas para o IBM HTTP Server. Para ativar a propagação automática, execute a configuração única a seguir:

  1. Crie um user=adminUser, password=adminPassword no arquivo IHS_root /conf/admin.passwd. Por exemplo: c:\ws\ihs85\bin\htpasswd -cb c:\ws\ihs85\conf\admin.passwd adminUser adminPassword
  2. No console administrativo, clique em Servidores > Servidores da web > webserver1 > Gerenciamento de servidor da web remoto. Configure os valores a seguir: admin Port=8008, User Id=adminUser, Password=adminPassword.
  3. Configure as permissões de leitura/gravação corretas para o arquivo httpd.conf e o arquivo plugin-cfg.xml. Consulte o arquivo IHS_root/logs/admin_error.log para obter mais informações.

A propagação automática do arquivo de configuração de plug-in requer que o servidor administrativo IBM HTTP esteja operacional e em execução. Se estiver gerenciando um IBM HTTP Server usando o console administrativo do WebSphere Application Server, o erro a seguir pode ser exibido:

"Erro: Não foi possível se conectar ao servidor de administração IHS"

Execute o procedimento a seguir:

  1. Verifique se o servidor de administração IBM HTTP Server está em execução.
  2. Verifique se o nome do host e a porta do servidor da web que está definida no console administrativo do WebSphere Application Server corresponde ao nome do host e porta e administração do IBM HTTP Server.
  3. Verifique se o firewall não está impedindo o acesso ao servidor de administração do IBM HTTP Server a partir do console administrativo do WebSphere Application Server.
  4. Verifique se o ID do usuário e senha especificados no console administrativo do WebSphere Application Server, sob gerenciamento remoto, foram criados no arquivo admin.passwd usando o comando htpasswd.
  5. Se estiver tentando se conectar seguramente, verifique se o certificado pessoal keydb do servidor de administração do IBM HTTP Server foi exportado no banco de dados de chaves do WebSphere Application Server como um certificado de assinante. Este banco de dados de chaves é especificado pela diretiva com.ibm.ssl.trustStore no arquivo sas.client.props no perfil em que o console administrativo está em execução. Esta consideração é destinada principalmente para certificados autoassinados.
  6. Se ainda tiver problemas, verifique o arquivo do IBM HTTP Server admin_error.log e os logs do WebSphere Application Server (arquivo trace.log) para determinar a causa do problema.



Considerações de diversas plataformas para execução de script de configuração

Várias diferenças em sistemas operacionais e plataformas de máquinas podem ocorrer ao configurar um servidor da web remoto:

  • Uma máquina está executando o Windows e a outra está executando Linux ou UNIX.
  • Uma máquina está executando uma codificação padrão que é diferente da outra.

Uma máquina está executando o Windows e a outra está executando Linux ou UNIX

Se uma máquina estiver executando no Linux ou UNIX e a outra máquina estiver executando no Windows, use o script criado no diretório plugins_root/bin/crossPlatformScripts.

Uma máquina está executando uma codificação padrão que é diferente da outra

O conteúdo do script configureWeb_server_name.bat ou do script configureWeb_server_name.sh poderá se corromper se a codificação do arquivo padrão de duas máquinas for diferente. Este cenário é possível quando uma máquina está configurada para um código de idioma de conjunto de caracteres de byte duplo (DBCS) e a outra máquina não.

Determine a codificação do arquivo para cada máquina e use um dos procedimentos a seguir como uma solução alternativa. Para determinar a codificação de arquivo padrão, execute o comando apropriado:

  • Sistemas Windows:
    CHCP
  • Sistemas Linux e UNIX:
    locale

Use o resultado do comando em cada máquina como o valor da variável web_server_machine_encoding e da variável application_server_machine_encoding em um dos procedimentos a seguir.

Procedimentos para corrigir diferenças de codificação

Suponha que o servidor da web esteja em execução em uma máquina Linux e que o Network Deployment esteja em execução em uma máquina Windows.

Servidor da web em execução em uma máquina Linux

Execute o comando a seguir no sistema Linux e UNIX para codificar o arquivo de script que configura a definição de servidor da web, antes de transferir por FTP o arquivo para a máquina Windows em modo binário:

iconv -f web_server_machine_encoding \
      -t application_server_machine_encoding \
         configureWeb_server_name.bat

Omita os caracteres de continuação de Linux e UNIX (\) se inserir o comando em uma linha.

Importante: O nome do servidor da web (apelido) é usado no nome do arquivo de script. O nome não pode conter caracteres de um conjunto de caracteres de byte duplo (DBCS) se pretender configurar o IBM HTTP Server para propagação automática.

Agora, suponha que o servidor da web esteja em execução em uma máquina Windows e que o Network Deployment esteja em execução em uma máquina Linux ou UNIX.

Servidor da web em execução em uma máquina Windows

Execute o comando a seguir no sistema Linux ou UNIX para codificar o arquivo de script que configura a definição de servidor da web, após transferir por FTP o arquivo em modo binário:

iconv -f web_server_machine_encoding \
      -t application_server_machine_encoding \
         configureWeb_server_name.sh

Omita os caracteres de continuação de Linux e UNIX (\) se inserir o comando em uma linha.

Se o mapeamento da conversão não for suportado pelo comando iconv em seu sistema, copie o conteúdo do script de configuração do servidor da web em uma área de transferência e cole-o na máquina na qual o servidor de aplicativo estiver em execução.