Grupo de Comandos ClusterConfigCommands para o Objeto AdminTask
Você pode utilizar as linguagens de script Jython ou Jacl para armazenar em cluster servidores de aplicativos, servidores genéricos e servidores proxy utilizando script. Os comandos e parâmetros no grupo ClusterConfigCommands podem ser usados para criar e excluir clusters de servidores e servidores conhecidos como membros de cluster.
![[z/OS]](../images/ngzos.gif)
changeClusterShortName
O comando createCluster altera o nome abreviado que está associado ao cluster.
Objeto de destino
NenhumaEtapas
- -clusterName (necessário)
- Especifica o nome do cluster de servidores. (String)
- -shortName (opcional)
- Especifica o novo nome abreviado que você deseja associar ao cluster. Cada cluster deve ter um nome abreviado exclusivo. Se este parâmetro não for especificado, um nome abreviado exclusivo será automaticamente designado. O valor que você especifica para este parâmetro deve ter 8 caracteres de comprimento ou menos e todos os caracteres deve estar em maiúsculas.
Exemplos
Exemplo de uso do modo de lote:
- Utilizando Jacl:
$AdminTask changeClusterShortName {-clusterName cluster1 -shortName newshortname}
- Utilizando a cadeia Jython:
AdminTask.changeClusterShortName('[-clusterName mycluster -shortName newshortname]')
- Utilizando a lista Jython:
AdminTask.changeClusterShortName(['-clusterName', 'mycluster', '-shortName', 'newshortname'])
Exemplo de uso no modo interativo:
- Utilizando Jacl:
$AdminTask changeClusterShortName {-interactive}
- Utilizando Jython:
AdminTask.changeClusterShortName ('-interactive')
- Utilizando a lista Jython:
AdminTask.changeClusterShortName (['-interactive'])
createCluster
O comando createCluster cria um novo cluster de servidores. Um cluster de servidores consiste em um grupo de servidores referidos como membros de cluster. Opcionalmente, um domínio de replicação pode ser criado para o novo cluster, e um servidor existente pode ser incluído como o primeiro membro de cluster. Também é possível utilizar o comando createCluster para aplicar configurações do servidor proxy no cluster.
Objeto de destino
NenhumEtapas
- -clusterConfig (necessário)
- Especifica as seguintes informações de configuração para o novo cluster de servidores:
- -clusterName
- Especifica o nome do cluster de servidores. (String)
- -preferLocal
- Especifica, opcionalmente, se a otimização de roteamento com escopo definido no nó
deve ser ativada ou desativada no cluster. O valor padrão é false. Especifique true para
ativar a otimização de roteamento com escopo definido no nó. (Boolean)
Configurações suportadas: Se ativar a otimização de preferLocal, o gerenciador de implementação deve estar sendo executado para afetar a configuração. Se o gerenciador de implementação for encerrado, a otimização preferLocal não será executada e os pedidos podem ser dispersos por todos os membros do cluster.sptcfg
- -clusterType
- Especifica, opcionalmente, o tipo do cluster de servidores a ser criado. O tipo padrão é APPLICATION_SERVER. Os valores válidos para esse parâmetro incluem: APPLICATION_SERVER, PROXY_SERVER e ONDEMAND_ROUTER. (String)
-shortName
Especifica o nome abreviado específico do servidor. Cada servidor deve ter um nome abreviado específico. Esse parâmetro deve ter um valor de oito caracteres maiúsculos ou menos. Se você não especificar um valor para o parâmetro specificShortName, o sistema gerará um nome abreviado exclusivo. (String)
- -replicationDomain (opcional)
- O sistema utiliza as propriedades de domínio de replicação para a replicação de dados da sessão HTTP.
- -createDomain
- Especifica se um domínio de replicação será criado em sua configuração de cluster. O valor padrão é false. Especifique true para criar um domínio de replicação em sua configuração de cluster. (Boolean)
- -convertServer (opcional)
- Especifica informações sobre um servidor de aplicativos existente para ser convertido para o primeiro membro do cluster. Essa etapa do comando é opcional. Os parâmetros a seguir podem ser especificados para essa etapa:
- -serverNode
- O nome do nó com o servidor para ser convertido para o primeiro membro do cluster. Você também deve especificar o parâmetro serverName. (String)
- -serverName
- O nome do servidor de aplicativos a ser convertido para o primeiro membro do cluster. Você também deve especificar o parâmetro serverNode. (String)
- -memberWeight
- O peso do membro do cluster. O peso controla a quantidade de trabalho direcionado ao servidor de aplicativos. Se o peso for maior que o peso atribuído a outros membros de cluster, o servidor irá receber uma parcela maior da carga de trabalho. O valor é um número entre 0 e 100. Se nenhum for especificado, o padrão será 2. (Número inteiro)
- -nodeGroup
- O nome do grupo de nós ao qual esse nó do membro do cluster e todos os nós de membros do cluster futuros devem pertencer. Todos os membros do cluster devem estar localizados em nós no mesmo grupo de nós. Se especificado, deverá ser um dos grupos de nós aos quais esse nó do membro pertence. Se não especificado, o valor padrão será o primeiro grupo de nós listado para o nó desse membro. (String)
- -replicatorEntry
- Especifica se a replicação de dados de sessão HTTP deve ser ativada. O valor padrão é false. Especifique true para ativar a replicação de dados de sessão. Esse parâmetro precisará ser especificado se o parâmetro createDomain tiver sido configurado como true na etapa de comando replicationDomain. (String)
- -resourcesScope
- Especifica o que fazer com recursos de servidor após o servidor ser
movido para um cluster. Valores possíveis:
- server: Especifica que os recursos de servidor e os recurso de cluster permanecem onde estão, inalterados.
- cluster: Especifica que os recursos de servidor são mover paras para o nível do cluster. Os recursos de escopo de cluster são configurados a partir dos recursos no servidor. Os recursos de escopo do servidor são removidos.
- both: Especifica que os recursos de servidor são copiados para o escopo de cluster. Os recursos de escopo de cluster são configurados a partir dos recursos no servidor. Os recursos de escopo do servidor permanecem sem mudança.
O valor-padrão é cluster.
Para Usuários de Transição: O valor padrão para o parâmetro -resourcesScope foi mudado para cluster para a Versão 8.x. O valor padrão é both na Versão 7.trns
Exemplos
Exemplo de uso do modo de lote:
- Utilizando Jacl:
$AdminTask createCluster {-clusterConfig {-clusterName cluster1 -preferLocal true -clusterType APPLICATION_SERVER}}
$AdminTask createCluster {-clusterConfig {-clusterName cluster1 -preferLocal true -clusterType APPLICATION_SERVER} -replicationDomain {-createDomain true}}
$AdminTask createCluster {-clusterConfig {-clusterName cluster1 -preferLocal true -clusterType APPLICATION_SERVER} -convertServer {-serverNode node1 -serverName server1}}
- Utilizando a sequência Jython:
AdminTask.createCluster('[-clusterConfig [-clusterName cluster1 -preferLocal true -clusterType APPLICATION_SERVER]]')
AdminTask.createCluster('[-clusterConfig [-clusterName cluster1 -preferLocal true -clusterType APPLICATION_SERVER] -replicationDomain [-createDomain true]]')
AdminTask.createCluster('[-clusterConfig [-clusterName cluster1 -preferLocal true -clusterType APPLICATION_SERVER] -convertServer [-serverNode node1 -serverName server1]]')
- Utilizando a lista Jython:
AdminTask.createCluster(['-clusterConfig', '[-clusterName cluster1 -preferLocal true -clusterType APPLICATION_SERVER]'])
AdminTask.createCluster(['-clusterConfig', '[-clusterName cluster1 -preferLocal true -clusterType APPLICATION_SERVER]', '-replicationDomain', '[-createDomain true]'])
AdminTask.createCluster(['-clusterConfig', '[-clusterName cluster1 -preferLocal true -clusterType APPLICATION_SERVER]', '-convertServer', '[-serverNode node1 -serverName server1]'])
Exemplo de uso no modo interativo:
- Utilizando Jacl:
$AdminTask createCluster {-interactive}
- Utilizando Jython:
AdminTask.createCluster ('-interactive')
createClusterMember
O comando createClusterMember cria um membro de um cluster de servidores. Um membro de cluster é um servidor de aplicativos que pertence a um cluster. Se esse for o primeiro membro do cluster, você deve especificar um gabarito para ser utilizado como o modelo para o membro de cluster. O modelo pode ser um modelo de servidor padrão, ou um servidor de aplicativos existente.
O primeiro membro de cluster é utilizado como um modelo para criar os membros subseqüentes no cluster. Quando você cria um primeiro membro de cluster, o modelo do membro de cluster é armazenado sob o escopo do cluster.
- O sistema armazena um modelo de cada versão do nó que já está configurado como um membro de cluster.
- O modelo do membro do cluster não existirá para uma determinada versão de nó até que um primeiro membro seja criado em um nó da mesma versão. Por exemplo, se um cluster contiver alguns nós V6.1 e alguns nós V6.0.x, haverá um modelo de membro de cluster para o nó V6.1 e outro para o nó V6.0.x.
- O modelo a seguir será utilizado para membros que serão criados para um nó V6.1: $WAS_HOME/config/templates/clusters/clusterName/servers/V6.1MemberTemplate.
- O modelo a seguir será utilizado para membros que serão criados para um nó V6.0.x: $WAS_HOME/config/templates/clusters/clusterName/servers/V6MemberTemplate.
- Ao fazer uma alteração de configuração para os membros num cluster, faça a mesma alteração no modelo armazenado no escopo do cluster correspondente.
Objeto de destino
Especifica, opcionalmente, o ID de configuração do cluster ao qual o novo membro pertence. Se o ID de configuração não for especificado, é preciso especificar o parâmetro clusterName. Utilize o comando getid do objeto AdminConfig para obter o ID de configuração do cluster de interesse.Parâmetros necessários
- -clusterName
- O nome do cluster ao qual o novo membro pertencerá. Se este parâmetro não for especificado, será preciso especificar o ID do objeto de cluster no destino do comando. (String)
Etapas
- -memberConfig (necessário)
- Especifica a configuração de um novo membro do cluster.
- memberNode
- Especifica o nó no qual o sistema cria o membro de cluster. (String)
- memberName
- Especifica o nome do novo membro de cluster. (String)
- memberWeight
- Especifica, opcionalmente, o peso inicial do membro de cluster. (Número inteiro)
- memberUUID
- Especifica, opcionalmente, o UUID do membro de cluster. (String)
- genUniquePorts
- Especifica, opcionalmente, se o sistema gerará números de porta exclusivos para cada transporte HTTP definido no servidor. O novo servidor não terá transportes HTTP que entrem em conflito com qualquer outro servidor definido no mesmo nó. O valor padrão é true. Se não quiser gerar números de porta exclusivos, especifique o valor como false. (Boolean)
- replicatorEntry
- Especifica, opcionalmente, se o sistema criará uma entrada de replicador para o novo membro de cluster no domínio de replicação do cluster. Uma entrada do replicador é utilizada para fornecer replicação de dados de sessão HTTP. Esse parâmetro de comando é opcional. O valor é true ou false, o que indica se a entrada será criada. O valor padrão é false. Você pode especificar esse parâmetro somente se um domínio de replicação tiver sido criado para o cluster. (Boolean)
specificShortName
Especifica, opcionalmente, o nome abreviado específico do servidor. Cada servidor deve ter um nome abreviado específico. O valor desse parâmetro não pode exceder 8 caracteres, começar com um número ou utilizar caracteres minúsculos. Se você não especificar um valor para o parâmetro specificShortName, o sistema gerará um nome abreviado exclusivo. (String)
- -firstMember (opcional)
- Especifica informações adicionais necessárias para configurar o primeiro membro
do cluster.
- templateName
- Especifica, opcionalmente, o nome de um modelo de servidor de aplicativos a ser utilizado ao criar o novo membro de cluster. Se você especificar um modelo, não pode especificar os parâmetros templateServerNode e templateServerName para utilizar um servidor de aplicativos existente como um modelo. É necessário especificar o parâmetro templateName, ou os parâmetros templateServerNode e templateServerName nessa etapa. (String)
- templateServerNode
- Especifica, opcionalmente, o nome do nó com um servidor de aplicativos existente a ser utilizado como o modelo ao criar o novo membro de cluster. Se você especificar o parâmetro templateServerNode, deve também especificar o parâmetro templateServerName, e não pode especificar o parâmetro templateName. É necessário especificar o parâmetro templateName ou os parâmetros templateServerNode e templateServerName nessa etapa. (String)
- templateServerName
- Especifica, opcionalmente, o nome do servidor de aplicativos existente a ser utilizado como o modelo ao criar o novo membro de cluster. Se você especificar o parâmetro templateServerName, deve também especificar o parâmetro templateServerNode, e não pode especificar o parâmetro templateName. É necessário especificar o parâmetro templateName, ou os parâmetros templateServerNode e templateServerName nessa etapa de comando. (String)
- nodeGroup
- Especifica, opcionalmente, o nome do grupo de nós ao qual o novo membro de cluster e cada membro de cluster adicional pertence. Cada membro de cluster deve residir em nós do mesmo grupo de nós. Se especificado, ele deverá ser um dos grupos de nós aos quais o nó desse membro pertence. Se você não especificar esse parâmetro, o sistema designará o primeiro grupo de nós listado para o nó do membro. (String)
- coreGroup
- Especifica, opcionalmente, o nome do grupo principal ao qual o novo membro de cluster e cada membro de cluster adicional pertence. Cada membro de cluster deve pertencer ao mesmo grupo principal. Se você não especificar esse parâmetro, o sistema designará o grupo principal padrão na célula. (String)
- resourcesScope
- Especifica o que fazer com recursos de servidor após o servidor ser
movido para um cluster. Valores possíveis:
- server: Especifica que os recursos de servidor e os recurso de cluster permanecem onde estão, inalterados.
- cluster: Especifica que os recursos de servidor são mover paras para o nível do cluster. Os recursos de escopo de cluster são configurados a partir dos recursos no servidor. Os recursos de escopo do servidor são removidos.
- both: Especifica que os recursos de servidor são copiados para o escopo de cluster. Os recursos de escopo de cluster são configurados a partir dos recursos no servidor. Os recursos de escopo do servidor permanecem sem mudança.
O valor-padrão é cluster.
Para Usuários de Transição: O valor padrão para o parâmetro -resourcesScope foi mudado para cluster para a Versão 8.x. O valor padrão é both na Versão 7.trns
Exemplos
Exemplo de uso do modo de lote:
Utilizando Jacl:
Criação do primeiro membro utilizando o nome do modelo:$AdminTask createClusterMember {-clusterName cluster1 -memberConfig {-memberNode node1 -memberName member1 -genUniquePorts true -replicatorEntry false}} -firstmember {-templateName serverTemplateName}}
Criação do primeiro membro utilizando servidor e nó para gabarito:$AdminTask createClusterMember {-clusterName cluster1 -memberConfig {-memberNode node1 -memberName member1 -genUniquePorts true -replicatorEntry false} -firstmember {-templateServerNode node1 -templateServerName server1}}
Criação do segundo membro:$AdminTask createClusterMember {-clusterName cluster1 -memberConfig {-memberNode node1 -memberName member2 -genUniquePorts true -replicatorEntry false}}
Utilizando a cadeia Jython:
Criação do primeiro membro utilizando o nome do modelo:AdminTask.createClusterMember('[-clusterName cluster1 -memberConfig [-memberNode node1 -memberName member1 -genUniquePorts true -replicatorEntry false]] -firstMember [-templateName serverTemplateName]]')
AdminTask.createClusterMember('[-clusterName cluster1 -memberConfig [-memberNode node1 -memberName member1
-genUniquePorts true -replicatorEntry false]] -firstMember
[-templateServerNode node1 -templateServerName server1]]')
AdminTask.createClusterMember('[-clusterName cluster1 -memberConfig [-memberNode node1 -memberName member1
-genUniquePorts true -replicatorEntry false]]')
Utilizando a lista Jython:
Criação do primeiro membro utilizando o nome do modelo:AdminTask.createClusterMember(['-clusterName', 'cluster1', '-memberConfig', '[-memberNode node1 -memberName member1 -genUniquePorts true -replicatorEntry false]]', '-firstMember', '[-templateName serverTemplateName]'])
Criação do primeiro membro utilizando servidor e nó para gabarito:AdminTask.createClusterMember(['-clusterName', 'cluster1', '-memberConfig', '[-memberNode node1 -memberName member1 -genUniquePorts true -replicatorEntry false]', '-firstMember', '[-templateServerNode node1 -templateServerName server1]'])
Criação do segundo membro:AdminTask.createClusterMember(['-clusterName', 'cluster1', '-memberConfig', '[-memberNode node1 -memberName member1 -genUniquePorts true -replicatorEntry false]'])
Exemplo de uso no modo interativo:
- Utilizando Jacl:
$AdminTask createClusterMember {-interactive}
- Utilizando Jython:
AdminTask.createClusterMember ('-interactive')
deleteCluster
O comando deleteCluster exclui a configuração de um cluster de servidores. Um cluster de servidores consiste em um grupo de servidores referidos como membros de cluster. O sistema exclui cada membro de cluster do cluster de interesse.Utilize o comando deleteClusterMember para excluir a configuração de um membro de cluster individual.
Objeto de destino
Especifica, opcionalmente, o ID do objeto de configuração do cluster a ser excluído. Se o ID do objeto não for especificado para o cluster, será necessário especificar o parâmetro clusterName. Utilize o comando getid do objeto AdminConfig para obter o ID de configuração do cluster.Parâmetros necessários
- -clusterName
- Especifica o nome do cluster a ser excluído. Se você especificar o ID de configuração do cluster, não especifique um valor para o parâmetro clusterName. (String)
Etapas
- -replicationDomain (etapa opcional)
- -deleteRepDomain
- Especifica se deve excluir o domínio de replicação. O valor padrão é false. Especifique true para excluir o domínio de replicação. (Boolean)
Exemplos
Exemplo de uso do modo de lote:
- Utilizando Jacl:
$AdminTask deleteCluster {-clusterName cluster1 }
$AdminTask deleteCluster {-clusterName cluster1 -replicationDomain {-deleteRepDomain true}}
- Utilizando a sequência Jython:
AdminTask.deleteCluster('[-clusterName cluster1]')
AdminTask.deleteCluster('[-clusterName cluster1 -replicationDomain [-deleteRepDomain true]]')
- Utilizando a lista Jython:
AdminTask.deleteCluster(['-clusterName', 'cluster1'])
AdminTask.deleteCluster(['-clusterName', 'cluster1', '-replicationDomain', '[-deleteRepDomain true]'])
Exemplo de uso no modo interativo:
- Utilizando Jacl:
$AdminTask deleteCluster -interactive
- Utilizando Jython:
AdminTask.deleteCluster ('-interactive')
deleteClusterMember
O comando deleteClusterMember exclui a configuração de um membro de cluster. Um membro de cluster é um servidor de aplicativos que pertence a um cluster de servidores.Utilize o comando deleteCluster para excluir a configuração de um cluster.
Objeto de destino
Especifica, opcionalmente, o ID do objeto de configuração do membro de cluster a ser excluído. Se o ID de configuração não for especificado, será necessário especificar os parâmetros clusterName, memberNode e memberName. Utilize o comando getid do objeto AdminConfig para obter o ID de configuração do cluster.Parâmetros necessários
- -clusterName
- Especifica o nome do cluster ao qual o membro de interesse pertence. Se esse parâmetro for especificado, os parâmetros memberName e memberNode também devem ser especificados. Se esse parâmetro não for especificado, o ID do objeto do membro deve ser especificado no destino do comando. (String)
- -memberNode
- Especifica o nome do nó ao qual o membro de cluster pertence. Se esse parâmetro for especificado, os parâmetros memberName e clusterName também devem ser especificados. Se esse parâmetro não for especificado, o ID do objeto do membro de cluster deve ser especificado no destino do comando. (String)
- -memberName
- Especifica o nome do servidor do membro a ser excluído do cluster. Se esse parâmetro for especificado, os parâmetros clusterName e memberNode também devem ser especificados. Se esse parâmetro não for especificado, o ID do objeto do membro deve ser especificado no destino do comando. (String)
Etapas
- replicatorEntry (opcional)
- Especifica a remoção de uma entrada do replicador para esse membro do cluster. Essa etapa do comando é opcional. Os parâmetros a seguir podem ser especificados para essa etapa:
- -deleteEntry
- Exclui a entrada de replicador que tem o nome do membro de cluster do domínio de replicação do cluster. Especifique o valor como true para excluir a entrada de replicador. O valor padrão é false.
Exemplos
Exemplo de uso do modo de lote:
- Utilizando Jacl:
$AdminTask deleteClusterMember {-clusterName cluster1 -memberNode node1 -memberName member1}
$AdminTask deleteClusterMember {-clusterName cluster1 -memberNode node1 -memberName member2 -replicatorEntry {-deleteEntry true}}
- Utilizando a sequência Jython:
AdminTask.deleteClusterMember('[-clusterName cluster1 -memberNode node1 -memberName member1]')
AdminTask.deleteClusterMember('[-clusterName cluster1 -memberNode node1 -memberName member2 -replicatorEntry [-deleteEntry true]]')
- Utilizando a lista Jython:
AdminTask.deleteClusterMember(['-clusterName', 'cluster1', '-memberNode', 'node1', '-memberName', 'member1'])
AdminTask.deleteClusterMember(['-clusterName', 'cluster1', '-memberNode', 'node1', '-memberName', 'member2', '-replicatorEntry', '[-deleteEntry true]'])
Exemplo de uso no modo interativo:
- Utilizando Jacl:
$AdminTask deleteClusterMember -interactive
- Utilizando Jython:
AdminTask.deleteClusterMember ('-interactive')
updateClusterMemberWeights
O comando updateClusterMemberWeights atualiza os pesos dos membros de cluster especificados. Um membro de cluster é um servidor de aplicativos que pertence a um cluster de servidores.Use o comando updateClusterMemberWeights para atualizar os pesos dos membros de cluster especificados na configuração de um cluster.
Objeto de destino
Especifica o ID de objeto de configuração do cluster do servidor a ser atualizado.Parâmetros necessários
- -clusterName
- Especifica o nome do cluster ao qual o membro de interesse pertence. Se esse parâmetro for especificado, os parâmetros memberName e memberNode também devem ser especificados. Se esse parâmetro não for especificado, o ID do objeto do membro deve ser especificado no destino do comando. (String)
- -memberNode
- Especifica o nome do nó ao qual o membro de cluster pertence. Se esse parâmetro for especificado, os parâmetros memberName e clusterName também devem ser especificados. Se esse parâmetro não for especificado, o ID do objeto do membro de cluster deve ser especificado no destino do comando. (String)
- -memberName
- Especifica o nome do servidor do membro a ser excluído do cluster. Se esse parâmetro for especificado, os parâmetros clusterName e memberNode também devem ser especificados. Se esse parâmetro não for especificado, o ID do objeto do membro deve ser especificado no destino do comando. (String)
Etapas
- memberWeight
- O peso do membro do cluster. O peso controla a quantidade de trabalho direcionado ao servidor de aplicativos. Se o peso for maior que o peso atribuído a outros membros de cluster, o servidor irá receber uma parcela maior da carga de trabalho. O valor é um número entre 0 e 100. Se nenhum for especificado, o padrão será 2. (Número inteiro)
Exemplos
Exemplo de uso do modo de lote:
- Utilizando Jacl:
$AdminTask updateClusterMemberWeights {-clusterName cluster1 -memberNode node1 -memberName member1 -memberWeight integer}
- Utilizando a cadeia Jython:
AdminTask.updateClusterMemberWeights('[-clusterName cluster1 -memberNode node1 -memberName member1 -memberWeight integer]')
- Utilizando a lista Jython:
AdminTask.updateClusterMemberWeights(['-clusterName', 'cluster1', '-memberNode', 'node1', '-memberName', 'member1', '-memberWeight', 'integer'])
Exemplo de uso no modo interativo:
- Utilizando Jacl:
$AdminTask updateClusterMemberWeights -interactive
- Utilizando Jython:
AdminTask.updateClusterMemberWeights ('-interactive')