[AIX Solaris HP-UX Linux Windows]

Configurando um plug-in do servidor da web usando a ferramenta pct

O comando WCT chama uma ferramenta de linha de comandos que é especificada pelo parâmetro -tool. É possível usar o comando WCT e especificar a ferramenta pct para configurar um servidor da web para usar um servidor de aplicativos como um servidor hosting.

Procedimento

Configure um servidor da Web para usar um servidor de aplicativos como um servidor de hospedagem.
Localização do comando WCT
O produto inclui o seguinte script que configura o ambiente e chama o comando WCT.
  • [Windows]WCT_install_root\WCT\wctcmd.bat
  • [Linux]WCT_install_root/WCT/wctcmd.sh
Sintaxe do comando WCT ao chamar a ferramenta pct
[Windows]
wctcmd.bat
      -tool pct
      -defLocPathname definition_location_pathname
      -defLocName definition_location_name
      -importDefinitionLocation
      -removeDefinitionLocation definition_location_name
      -listDefinitionLocations
      -createDefinition
      -deleteDefinition webserver_definition_name
      -listDefinitions
      -response response_file
[Linux]
./wctcmd.sh
      -tool pct
      -defLocPathname definition_location_pathname
      -defLocName definition_location_name
      -importDefinitionLocation
      -removeDefinitionLocation definition_location_name
      -listDefinitionLocations
      -createDefinition
      -deleteDefinition webserver_definition_name
      -listDefinitions
      -response response_file
Parâmetros do comando WCT ao chamar a ferramenta pct
-tool pct
Especifica o nome da ferramenta para ativar como se estivesse registrada com o comando WCT

Este parâmetro é requerido.

-defLocName definition_location_name
Especifia o nome lógico do local raiz de tempo de execução do plug-in

Este parâmetro é necessário quando você cria ou exclui uma definição.

-defLocPathname definition_location_pathname
Especifica o nome absoluto do caminho do local raiz de tempo de execução do plug-in existente

Este parâmetro é necessário quando você cria ou exclui uma definição.

-importDefinitionLocation
Especifica que você deseja importar um local de tempo de execução de plug-ins de servidor da web no registro da ferramenta

Uma nova definição é criada como parte dessa operação.

Exemplo de uso:

[Windows]
wctcmd.bat -tool pct -importDefinitionLocation -defLocPathname C:\data\IBM\WebSphere\Plugins -defLocName DefinitionLocationName -response C:\IBM\WebSphere\tools\WCT\responsefile.txt
[Linux]
./wctcmd.sh -tool pct -importDefinitionLocation -defLocPathname /opt/IBM/WebSphere/Plugins -defLocName DefinitionLocationName -response /opt/IBM/WebSphere/tools/WCT/responsefile.txt
-listDefinitionLocations
Especifica que você deseja gerar uma lista de todos os locais de definição

Exemplo de uso:

[Windows]
wctcmd.bat -tool pct -listDefinitionLocations
[Linux]
./wctcmd.sh -tool pct -listDefinitionLocations
-removeDefinitionLocation
Especifica que a ferramenta pct deve remover um local de definição

Este parâmetro é usado ao remover um local de definição.

Exemplo de uso:

[Windows]
wctcmd.bat -tool pct -removeDefinitionLocation -defLocPathname
C:\data\IBM\WebSphere\Plugins
[Linux]
./wctcmd.sh -tool pct -removeDefinitionLocation -defLocPathname /opt/IBM/WebSphere/Plugins
ou
[Windows]
wctcmd.bat -tool pct -removeDefinitionLocation -defLocName DefinitionLocationName
[Linux]
./wctcmd.sh -tool pct -removeDefinitionLocation -defLocName DefinitionLocationName
-createDefinition
Especifica que você está criando uma nova definição de servidor da web

Exemplo de uso:

[Windows]
wctcmd.bat -tool pct -createDefinition -defLocName DefinitionLocationName -response C:\IBM\WebSphere\tools\WCT\responsefile.txt
[Linux]
./wctcmd.sh -tool pct -createDefinition -defLocName DefinitionLocationName -response /opt/IBM/WebSphere/tools/WCT/responsefile.txt
-deleteDefinition webserver_definition_name
Especifica a definição de plug-in de servidor da web exclusiva a ser excluída

Este parâmetro é usado ao excluir uma definição existente.

O definition_name é obrigatório. Um dos seguintes parâmetros também são obrigatórios:
  • -defLocName definition_location_name
  • -defLocPathname definition_location_pathname
Se os dois valores de parâmetros forem fornecidos, o primeiro será usado. Se o primeiro valor fornecido não passar pela verificação de validação, o comando falhará com uma mensagem de erro.

Exemplo de uso:

[Windows]
wctcmd.bat -tool pct -defLocPathname C:\data\IBM\WebSphere\Plugins -defLocName DefinitionLocationName -deleteDefinition WebServerDefinitionName
[Linux]
./wctcmd.sh -tool pct -defLocPathname /opt/IBM/WebSphere/Plugins -defLocName DefinitionLocationName -deleteDefinition WebServerDefinitionName
-listDefinitions
Especifica que você deseja gerar uma lista de todas as definições

Exemplo de uso:

[Windows]
wctcmd.bat -tool pct -listDefinitions -defLocName DefinitionLocationName
[Linux]
./wctcmd.sh -tool pct -listDefinitions -defLocName DefinitionLocationName
-response response_file
Especifica o arquivo de resposta contendo argumentos da ferramenta

Este parâmetro é necessário ao criar uma definição.

Notes:
  • Os argumentos de linha de comandos fazem distinção de maiúsculas e minúsculas.
  • Se um argumento aceitar um valor que contenha espaços, o valor deverá ser colocado entre aspas duplas (" ").
-logLevel integer_value
Indica a granularidade da saída do log. O valor do argumento pode ser um número inteiro de 1 a 7, onde 7 é o melhor nível de log.
Parâmetros da ferramenta pct
Parâmetros Gerais
Parâmetro Valores
configType
Especifica o tipo de configuração
local_standalone
WebSphere Application Server e servidor da web na mesma máquina
remoto
WebSphere Application Server e servidor da web em máquinas separadas
local_distributed
O perfil no WebSphere Application Server é federado para um gerenciador de implementação
wasExistingLocation
Especifica o local do diretório inicial de instalação do WebSphere Application Server

Essa opção é válida apenas para um tipo de configuração local.

Local do diretório inicial de instalação do WebSphere Application Server

webServerSelected
Especifica o servidor da web a ser configurado

Especifique apenas um servidor da web a ser configurado.

apache22
Servidor da Web Apache Versão 2.2
domino7
Lotus Domino Web Server Versão 7.0

Não suportado no HP-UX ou Solaris x64 (x86_64)

domino8
Lotus Domino Web Server Versão 8.0

Não suportado no HP-UX ou Solaris x64 (x86_64)

ihs
IBM® HTTP Server Versão 7.0
iis6
Microsoft Internet Information Services Versão 6

Suportado no Windows

iis7
Microsoft Internet Information Services Versão 7

Suportado no Windows

iis8
Microsoft Internet Information Services Versão 8

Suportado no Windows

sunone
Sun Java™ System Web Server Versão 6.1 ou Sun Java System Web Server Versão 7.0
ihsAdminPort
Especifica o número da porta de administração HTTP

Especifique esse valor apenas ao configurar o IHS.

Número da porta de administração HTTP

ihsAdminUserID
Especifica o ID do usuário administrador do IHS para o servidor de administração IHS

Especifique esse valor apenas ao configurar o IHS.

ID do usuário administrador do IHS do servidor de administração IHS

ihsAdminUserGroup
Especifica o grupo de usuários para o servidor de administração IHS

Especifique esse valor apenas ao configurar o IHS.

Grupo de usuários do servidor de administração IHS

webServerConfigFile1
Especifica o primeiro arquivo de configuração do servidor da web

O arquivo especificado deve existir.

apache
httpd.conf
Restrição: Para se configurar o servidor com sucesso, o nome do arquivo de configuração deve ser retido como httpd.conf.
domino7
notes.jar
domino8
notes.jar
ihs
httpd.conf
Restrição: Para se configurar o servidor com sucesso, o nome do arquivo de configuração deve ser retido como httpd.conf.
sunone
magnus.conf
webServerConfigFile2
Especifica o segundo arquivo de configuração do servidor da web

O arquivo especificado deve existir.

domino7
names.jar
domino8
names.jar
sunone
obj.conf
webServerPortNumber
Especifica a porta do servidor da web para o servidor da web a ser configurado

Porta do servidor da web a ser configurado

dominoUserID
Especifica o ID do usuário do Domino Versão 7.0 ou 8.0

ID do usuário do Domino Versão 7.0 ou 8.0

webServerDefinition
Especifica o nome de definição do servidor da web

Nenhum espaço é permitido no nome de definição do servidor da web.

Nome de definição de servidor da web sem espaços

wasMachineHostName
Especifica o nome do host da máquina do WebSphere Application Server

Essa especificação pode ser omitida para um tipo de instalação local_standalone.

Para um tipo de instalação remota:
"hostname"

A instalação usará o nome do host hostname na máquina.

Para um tipo de instalação local:
""

O nome do host da máquina de instalação de destino será usado.

Atenção: Se você usar o comando WCT para criar vários servidores da web e executar o WCT nas máquinas de servidor da web conforme o necessário, o nome do host de cada servidor da web será um nome do host derivado - com base no mesmo tipo para o qual o sistema operacional é consultado quanto ao nome do host.

Executar o WCT dessa forma resulta na criação de dois arquivos de script com o mesmo nome do host que será usado para criar o nó e o arquivo serverIndex.xml.

Com os dois servidores da web na mesma máquina, haverá dois endereços IP de rede, para os quais deverá haver nomes do host exclusivos.

Como o nome do host foi derivado e não foi solicitado o nome do host do servidor da web, a ferramenta WCT e o script configurewebserverx.bat/sh associado criarão um nó e um arquivo serverIndex.xml com o mesmo nome do host.

Para assegurar-se de que os dois Servidores da web criados na mesma máquina tenham dois endereços IP de rede diferentes, acesse o console administrativo e execute o seguinte:
  1. Servidores > Servidores da web > webserverName
  2. Clique em portas
  3. Se o nó for gerenciado, clique em WEBSERVER_ADDRESS. Se o nó não for gerenciado, clique em WEBSERVER_ADMIN_ADDRESS
  4. Altere os endereços IP (nome do host).
  5. Clique em OK e em Salvar.
Parâmetros avançados (disponíveis apenas em instalações silenciosas)
Parâmetro Valores
mapWebserverToApplications
Especifica se todos os aplicativos implementados existentes devem ser mapeados ou não para o servidor da web

Se essa não for configurada como uma opção válida, o instalador a configurará como true e continuará a instalação.

true
A definição de servidor da web é mapeada como um destino para os aplicativos implementados existentes, como contagem de rastreamentos e ocorrências. (Recomendado)
falso
Nenhum aplicativo é mapeado para a definição de servidor da web.
webServerHostName
Em cenários avançados em que um usuário possui diversos nomes do host do servidor da web em uma máquina, especifica o nome do host do servidor da web usado a ser configurado
""
A instalação será resolvida para o nome do host detectado na máquina. (Recomendado)
"hostname"
A instalação usará o nome do host hostname na máquina.
webServerInstallArch
Especifica a arquitetura de instalação do servidor da web
"32"
Válido para instalações do servidor da web de 32 bits
"64"
Válido para instalações do servidor da web de 64 bits
""
A arquitetura da máquina do servidor da web será usada
profileName
Especifica o nome do perfil do WebSphere Application Server a ser configurado
"profile_name"
Você deve inserir o nome de um perfil existente do WebSphere Application Server.

Deixar a sequência vazia resultará no uso do perfil padrão pelo instalador.

Essa opção é válida apenas nos cenários de instalação local.

ihsAdminPassword
Especifica a senha do usuário para o servidor administrativo IHS a ser configurado

Especifique esse valor apenas ao configurar o IHS.

"IHS_admin_password"
Você deve inserir a senha do usuário, que será usada para configurar o servidor administrativo IHS.
enableAdminServerSupport
Especifica se o servidor administrativo IHS deve ser configurado ou não

Especifique esse valor apenas ao configurar o IHS.

true
O suporte será ativado e o servidor administrativo IHS será configurado.
falso
O suporte não será ativado e o servidor administrativo IHS não será configurado.
enableUserAndPass
Especifica se o suporte para configurar o servidor administrativo IHS deve ser ativado ou não com um ID do usuário e senha como credenciais

Especifique esse valor apenas ao configurar o IHS.

true
O suporte para configurar o servidor administrativo IHS com um determinado ID do usuário e senha será ativado.

As credenciais adicionais relevantes devem ser fornecidas.

falso
O suporte para configurar o servidor administrativo IHS com um determinado ID do usuário e senha não será ativado.

Nenhum valor adicional é necessário.

webServerType
Especifica o tipo de servidor da web a ser configurado

Especifique apenas um servidor da web a ser configurado.

APACHE
Servidor da Web Apache Versão 2.2
DOMINO
Lotus Domino Web Server Versão 7.0 ou Versão 8.0

Não suportado no HP-UX ou Solaris x64 (x86_64)

IHS
IBM HTTP Server Versão 7.0
IIS
Microsoft Internet Information Services Versão 6, Versão 7 ou Versão 8

Suportado no Windows

SUNJAVASYSTEM
Sun Java System Web Server Versão 6.1 ou Versão 7.0
ihsWindowsStartupType
Especifica o tipo de inicialização do serviço administrativo do IHS que deve ser criado no Windows

Especifique esse valor apenas ao configurar o IHS.

Para utilização com o sistema operacional Windows.

auto
O serviço será iniciado automaticamente quando o sistema foi inicializado.
demanda
O serviço será iniciado apenas quando solicitado.
ihsAdminWinUserID
Especifica o ID do usuário que será usado para configurar o servidor administrativo IHS no Windows

Especifique esse valor apenas ao configurar o IHS.

Para utilização com o sistema operacional Windows.

"IHS_admin_user_ID"
Você deve inserir o nome que será usado para configurar o servidor administrativo IHS.
ihsAdminWinPassword
Especifica a senha do usuário, que será usada para configurar o servidor administrativo IHS no Windows

Especifique esse valor apenas ao configurar o IHS.

Para utilização com o sistema operacional Windows.

"IHS_admin_password"
Você deve inserir a senha do usuário, que será usada para configurar o servidor administrativo IHS.
enableWinService
Especifica se o servidor administrativo IHS deve ser configurado ou não para ser executado como um serviço do Windows

Especifique esse valor apenas ao configurar o IHS.

Para utilização com o sistema operacional Windows.

true
O suporte para configurar o servidor administrativo IHS como um serviço do Windows será ativado
falso
O suporte para configurar o servidor administrativo IHS como um serviço do Windows não será ativado.
Nota: Após executar o comando WCT, o servidor da web será configurado para usar um servidor de aplicativos como o servidor de hospedagem. O comando WCT também criará um novo arquivo de resposta no diretório que contiver os arquivos de configuração. Este arquivo de resposta pode conter duas entradas não documentadas, defLocPathname e profilePath, que não são funcionalmente suportados pelo produto. O novo arquivo de resposta contém as informações usadas para criar a configuração do servidor da web.
Exemplo de uso da ferramenta pct para configurar um IHS Web Server para usar um servidor de aplicativos como um servidor host:
  • [Windows]wctcmd.bat -tool pct -defLocPathname C:\data\IBM\WebSphere\Plugins -defLocName someDefinitionLocationName -createDefinition -response C:\IBM\WebSphere\tools\WCT\responsefile.txt
  • [Linux]./wctcmd.sh -tool pct -defLocPathname /opt/IBM/WebSphere/Plugins -defLocName someDefinitionLocationName -createDefinition -response /opt/IBM/WebSphere/tools/WCT/responsefile.txt

O seguinte é um exemplo do conteúdo de um arquivo de resposta para uma configuração do plug-in local do IHS. Os valores válidos para o parametro webServerOS, usado para especificar o sistema operacional do servidor da web, são Windows, Linux, Solaris, AIX, HPUX, OS390 e OS400.

[AIX][HP-UX][Linux][Solaris]
configType=local_standalone
enableAdminServerSupport=true
enableUserAndPass=true
enableWinService=false
ihsAdminCreateUserAndGroup=true
ihsAdminPassword=******
ihsAdminPort=8008
ihsAdminUnixUserGroup=grp101
ihsAdminUnixUserID=user1
mapWebServerToApplications=true
profileName=AppSrv01
wasExistingLocation=/opt/IBM/WebSphere/AppServer85
webServerConfigFile1=/opt/IBM/HTTPServer/conf/httpd.conf
webServerDefinition=webserver1
webServerHostName=local.ibm.com
webServerOS=operating_system_value
webServerPortNumber=80
webServerSelected=ihs
[Windows]
configType=local_standalone
enableAdminServerSupport=true
enableUserAndPass=true
enableWinService=true
ihsAdminPassword=******
ihsAdminPort=8008
ihsAdminUserID=admin1
ihsWindowsPassword=******
ihsWindowsStartupType=auto
ihsWindowsUserID=user1
mapWebServerToApplications=true
profileName=AppSrv01
wasExistingLocation=D:\\IBM\\WebSphere\\AppServer85
webServerConfigFile1=D:\\IBM\\HTTPServer\\conf\\httpd.conf
webServerDefinition=webserver1
webServerHostName=local.ibm.com
webServerInstallArch=32
webServerPortNumber=80
webServerSelected=ihs

O exemplo a seguir é do conteúdo de um arquivo de resposta para uma configuração de plug-in remoto de IHS. Os valores válidos para o parametro webServerOS, usado para especificar o sistema operacional do servidor da web, são Windows, Linux, Solaris, AIX, HPUX, OS390 e OS400.

[AIX][HP-UX][Linux][Solaris]
configType=remote
enableAdminServerSupport=true
enableUserAndPass=true
enableWinService=false
ihsAdminCreateUserAndGroup=true
ihsAdminPassword=******
ihsAdminPort=8008
ihsAdminUnixUserGroup=grp101
ihsAdminUnixUserID=user1
mapWebServerToApplications=true
wasMachineHostname=192.168.1.2
webServerConfigFile1=/opt/IBM/HTTPServer/conf/httpd.conf
webServerDefinition=webserver1
webServerHostName=remote.ibm.com
webServerOS=operating_system_value
webServerPortNumber=80
webServerSelected=ihs
[Windows]
configType=remote
enableAdminServerSupport=true
enableUserAndPass=true
enableWinService=true
ihsAdminPassword=******
ihsAdminPort=8008
ihsAdminUserID=admin1
ihsWindowsPassword=******
ihsWindowsStartupType=auto
ihsWindowsUserID=user1
mapWebServerToApplications=true
wasMachineHostname=192.168.1.2
webServerConfigFile1=D:\IBM\HTTPServer\conf\httpd.conf
webServerDefinition=webserver1
webServerHostName=remote.ibm.com
webServerInstallArch=32
webServerOS=windows
webServerPortNumber=80
webServerSelected=ihs

O que Fazer Depois

Boas Práticas Boas Práticas: Será possível usar a ferramenta pct se a máquina tiver vários nomes do host e endereços IP. No entanto, o nome do host deverá ser definido após a configuração do servidor da web por meio da interface gráfica com o usuário PCT usando o processo a seguir:
  1. Clique em Portas.
  2. Clique em WEBSERVER_ADDRESS. Se este for um modo não gerenciado, clique em WEBSERVER_ADMIN_ADDRESS.
  3. Altere o nome do host.
  4. Clique em OK para salvar.
best-practices

Ícone que indica o tipo de tópico Tópico de Tarefa



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tins_pctcl_using
Nome do arquivo: tins_pctcl_using.html