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

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: 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 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. 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: Verifique se o servidor de administração IBM HTTP Server está em execução. 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. 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. 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. 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. 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.