![[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.
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]
[-portblock portnumber] [-transport -oldport oldvalue
-newport newvalue ] [ -endpoint endpointname -port newvalue ]
[-inthttp inthttpport]
[ -inthttpssl inthttpsslport ] [ -admin adminport ]
[-adminssl adminsslport]
[ -soap soapport ] [ -nameservice nameserviceport ]
[-sas sasserverport]
[-csiv2server csiv2serverauthport]
[-csiv2client csiv2clientauthport] [-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.
- -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.
- -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.
Tópico de Referência