![[IBM i]](../images/iseries.gif)
Comando chgwassvr
O comando chgwassvr permite alterar as portas de um servidor de aplicativos em um perfil.
Para obter instruções e exemplos de uso, consulte o tópico Alterar Propriedades de Servidor de Aplicativos. Para executar este script, seu perfil do usuário deve possuir a autoridade *ALLOBJ.
Use o comando chgwassvr a partir de dentro de um perfil do Network Deployment para modificar valores de porta para os servidores gerenciados pelo gerenciador de implementação para a célula. Use o parâmetro -profileName para especificar o perfil de gerenciador de implementação afetado. Ao modificar uma porta de um servidor gerenciado, você deve utilizar o parâmetro -node para especificar o nome do nó gerenciado que contém o servidor que você deseja modificar. Os documentos de configuração dos servidores são atualizados quando a próxima sincronização entre o gerenciador de implementação e os nós ocorre. Também é possível sincronizar a configuração com o comando syncNode. Para obter mais informações, consulte o tópico Comando syncNode. É possível executar o comando syncNode a partir do WebSphere Application Server (base) para o nó.
Também é possível utilizar o console administrativo para criar e gerenciar servidores de aplicativos. Consulte o tópico Administrando servidores de aplicativos para obter informações adicionais.
Sintaxe
A sintaxe de comandos é a seguinte:
chgwassvr -server servername
[instance instancename] [-profileName instancename]
[-node nodename] [-portblock portnumber]
[ -transport -oldport oldvalue -newport newvalue ]
[ -endpoint endpointname -port newvalue ]
[-inthttp inthttpport]
[ -inthttpssl inthttpsslport ] [ -admin adminport ]
[-adminssl adminsslport] [-soap soapport]
[-nameservice nameserviceport]
[-celldiscovery celldiscoveryport]
[ -sas sasserverport ] [ -csiv2server csiv2serverauthport ]
[ -csiv2client csiv2clientauthport ] [ -nodediscovery nodediscport ]
[-nodemulti nodemultdiscport] [-verbose] [-help | -?]
Parâmetros
As seguintes opções estão disponíveis para o comando chgwassvr:
- -server
- Este é um parâmetro obrigatório. O valor servername especifica o nome do servidor a ser alterado. Para o perfil do WebSphere Application Server padrão, o nome do servidor padrão é server1. Para o perfil padrão do Network Deployment, o nome do servidor padrão é dmgr. O valor desse parâmetro faz distinção entre maiúsculas e minúsculas e deve corresponder ao nome do servidor exatamente. É possível utilizar o comando dspwasinst para visualizar os servidores associados a um perfil. Para obter informações adicionais, consulte o tópico dspwasinst command.
- -profileName
- Este é um parâmetro opcional. O valor profile especifica o nome do perfil que contém o servidor de aplicativos que você deseja alterar. O valor padrão é default.
- -node
- Este é um parâmetro opcional. O valor nodename especifica o nó que hospeda o servidor de aplicativos que deseja alterar. O valor padrão é o perfil de gerenciamento do Network Deployment.
- -portblock
- Este é um parâmetro opcional. O valor portblock especifica o primeiro número de um bloco de números de portas utilizado por seu perfil. Se você especificar esse parâmetro, o script alterará todos os números de portas de seu servidor de aplicativos. Se
você não especificar esse parâmetro, os números de portas de seu servidor de aplicativos não serão alterados,
a menos que especifique um parâmetro de porta a ser alterado (consulte os parâmetros de porta a seguir). É possível utilizar o comando NETSTAT *CNN (Trabalhar com Status de Rede
TCP/IP) para exibir uma lista de números de portas que estão sendo utilizados atualmente.
- Um perfil WebSphere Application Server utiliza diversas portas
para diversas funções. Ao alterar propriedades de um servidor de aplicativos, as portas são designadas com base nas seguintes condições ordenadas:
- Parâmetros de porta específicos
- Se especificar valores para parâmetros de porta específicos, o script usará esses valores. Parâmetros de porta específicos são -inthttp (Servidor de aplicativos base), -admin, -jmsqueued (Servidor de aplicativos base), -jmsdirect (Servidor de aplicativos base), -jmssecure (Servidor de aplicativos base), -soap, -orblistener (Network Deployment), -nameservice, -drsclient e -celldiscovery (Network Deployment).
- O parâmetro -portblock
- Os serviços para os quais você não especificou um número da porta têm portas designadas iniciando sequencialmente com o valor do parâmetro -portblock. Se um script encontrar uma porta que está em utilização, ele ignorará esse número de porta e continuará com a próxima porta não utilizada.
- Valores atuais
- Se -portblock não for especificado, quaisquer serviços para os quais você não especificou um parâmetro de porta reterão seus valores atuais.
- Para o parâmetro -portblock, o script verifica apenas um índice mestre de todos os perfis do WebSphere Application Server. O script não pode detectar a utilização da porta por outros aplicativos, incluindo as versões anteriores do WebSphere Application Server.
- Um perfil WebSphere Application Server utiliza diversas portas
para diversas funções. Ao alterar propriedades de um servidor de aplicativos, as portas são designadas com base nas seguintes condições ordenadas:
- -transport
- Esse é um parâmetro opcional definido. O valor oldvalue especifica o número da porta do contêiner da Web que você deseja mudar.
O valor newvalue especifica o novo número da porta que deseja designar ao transporte do contêiner da Web. Se o transporte do contêiner da Web também for especificado no alias de host para um host virtual, a porta para o alias de host também será atualizada.
Utilize o conjunto de parâmetros -transport no lugar dos parâmetros -admin, -adminssl, -inthttp ou -inthttpssl. Esses parâmetros estão obsoletos.
- -endpoint
- Este é um parâmetro opcional. O valor endpointname especifica o nome da porta do nó de extremidade a ser modificada. O valor newvalue específica o número da porta para o qual definir a porta do nó de extremidade.
- -inthttp
- Este é um parâmetro opcional. O valor inthttpport especifica o número da porta no qual o contêiner da Web atende pelas solicitações a partir do servidor da Web. Se nem o parâmetro -portblock nem o parâmetro -inthttp forem especificados, essa porta não será alterada. Consulte o parâmetro -portblock para obter informações adicionais.
- -inthttpssl
- Este é um parâmetro opcional. O valor inthttpsslport especifica o número da porta que o servidor de aplicativos utiliza para comunicações seguras com o servidor HTTP interno. Se nem o parâmetro -portblock nem o parâmetro -inthttpssl forem especificados, essa porta não será alterada. Consulte o parâmetro -portblock para obter informações adicionais.
- -admin
- Este é um parâmetro opcional. O valor adminport especifica o número da porta a ser utilizado para o console administrativo. Se nem o parâmetro -portblock nem o parâmetro -admin forem especificados, essa porta não será alterada. Consulte o parâmetro -portblock para obter informações adicionais
- -adminssl
- Este é um parâmetro opcional. O valor adminportssl especifica o número da porta a ser utilizado para comunicações seguras com o console administrativo. Se nem o parâmetro -portblock nem o parâmetro -adminssl forem especificados, essa porta não será alterada. Consulte o parâmetro -portblock para obter informações adicionais.
- -soap
- Este é um parâmetro opcional. O valor soapport especifica o número da porta a ser utilizado para SOAP. Se nem o parâmetro -portblock nem o parâmetro -soap forem especificados, essa porta não será alterada. Consulte o parâmetro -portblock para obter informações adicionais.
- -nameservice
- Este é um parâmetro opcional. O valor nameserviceport especifica o número da porta a ser utilizado para a porta do serviço de nomes (ou conector RMI). Se nem o parâmetro -portblock nem o parâmetro -nameservice forem especificados, essa porta não será alterada. Consulte o parâmetro -portblock para obter informações adicionais.
- -celldiscovery
- Este é um parâmetro opcional. O valor celldiscoveryport especifica a porta na qual o perfil do Network Deployment atende um nó que está tentando localizar a célula à qual o nó pertence. Se nem o parâmetro -portblock nem o parâmetro -celldiscovery forem especificados, essa porta não será alterada. Consulte o parâmetro -portblock para obter informações adicionais.
- -sas
- Este é um parâmetro opcional. O valor sasserverport especifica a porta na qual o SAS (Secure Association Services) atende pedidos de autenticação de entrada. Se o parâmetro -sas não for especificado, essa porta não será alterada. Essa porta é especificada pela propriedade SAS_SSL_SERVERAUTH_LISTENER_ADDRESS em serverindex.xml.
- -csiv2server
- Este é um parâmetro opcional. O valor csiv2serverauthport especifica a porta na qual o Common Secure Interoperability Version 2 (CSIV2) Service atende a solicitações de autenticação de servidor de entrada. Se o parâmetro -csiv2server não for especificado, essa porta não será alterada. Essa porta é especificada pela propriedade CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS em serverindex.xml.
- -csiv2client
- Este é um parâmetro opcional. O valor csiv2clientauthport especifica a porta na qual o Common Secure Interoperability Version 2 (CSIV2) Service atende a solicitações de cliente de entrada. Se o parâmetro -csiv2client não for especificado, essa porta não será alterada. Essa porta é especificada pela propriedade CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS em serverindex.xml.
- -nodediscovery
- Este é um parâmetro opcional. O valor nodediscport especifica a porta na qual o nó do serviço de descoberta do agente do nó atende.
- -nodemulti
- Este é um parâmetro opcional. O valor nodemultidiscport especifica a porta na qual o serviço de descoberta multicast do agente do nó atende.
- -verbose
- Este parâmetro opcional ativa mensagens verbosas, que podem ser úteis se você precisar depurar o script.
- -help
- Este parâmetro opcional exibe a mensagem de ajuda. Se você especificar este parâmetro, o script ignorará todos os outros parâmetros.