WebSphere Virtual Enterprise, Version 6.1.1
             Sistemas Operacionais: AIX,, HP-UX, Linux, Solaris, Windows


Tarefas Administrativas de Gerenciamento da Edição de Aplicativos

Você pode utilizar as linguagens de script Jacl ou Jython para gerenciar as edições de aplicativos. Também é possível usar o objeto AdminApp para gerenciar aplicativos com edições específicas.

Use os seguintes comandos para ativar, desativar, executar uma implementação, validar, listar e verificar uma edição do aplicativo. Também é possível clonar um cluster dinâmico existente para usar um grupo de nós diferentes e é possível cancelar o modo de validação em uma edição do aplicativo:
É possível executar as seguintes operações usando o objeto AdminApp no wsadmin para gerenciar aplicativos com edições: Para obter uma lista completa de operações que podem ser executadas usando o objeto AdminApp, consulte Comandos para o Objeto AdminApp.

activateEdition

O comando activateEdition ativa uma edição.

Objeto de destino

Nenhum.

Parâmetros

-appName
Especifica o nome do aplicativo. (String)
-edition
Especifica o nome da edição do aplicativo. (String)

Valor de Retorno

O comando retorna:
  • true: êxito
  • false: falha

Exemplo de uso do modo em lote

Uso de exemplo do modo interativo

deactivateEdition

O comando deactivateEdition desativa uma edição.

Objeto de destino

Nenhum.

Parâmetros

-appName
Especifica o nome do aplicativo. (String)
-edition
Especifica o nome da edição do aplicativo. (String)

Valor de Retorno

O comando retorna:
  • true: êxito
  • false: falha

Exemplo de uso do modo em lote

Uso de exemplo do modo interativo

rolloutEdition

O comando rolloutEdition transfere uma edição e especifica o tamanho do grupo.

Objeto de destino

Nenhum.

Parâmetros

-appName
Especifica o nome do aplicativo. (String)
-edition
Especifica o valor da propriedade customizada. (String)
-params
Especifica valores de configuração para a transferência. (Cadeia)
rollout strategy
  • grouped: Ativa o aplicativo especificado no lugar da edição atual do mesmo aplicativo no cluster no qual o cluster do aplicativo está implementado, N servidores ao mesmo instante, conforme especificado pela palavra-chave groupSize. O tamanho do grupo padrão é 1. Durante a transferência, as duas edições do aplicativo podem atender pedidos. Sempre defina o número de grupos com no mínimo um a menos que o tamanho do cluster, para que pelo menos um membro do cluster atenda à edição antiga enquanto a transferência da nova edição é iniciada.
  • atomic: Ativa o aplicativo especificado no lugar da edição atual do mesmo aplicativo no cluster no qual o cluster de aplicativo é implementado, metade do cluster por vez, de forma que apenas uma edição do aplicativo atende pedidos a qualquer momento.
reset strategy
Especifica como iniciar uma instância de edição de aplicativo durante a operação de transferência.
  • hard: Pára ou reinicia o servidor de aplicativos.
  • soft: Pára ou reinicia a instância do aplicativo, enquanto deixa o servidor de aplicativos em execução.
tamanho do grupo da transferência em grupo
Especifica o número de servidores a serem atualizados quando rolloutStrategy é agrupado.
  • Integer
intervalo de drenagem
Especifica o número de segundos de espera antes de parar uma instância de edição de aplicativo durante a transferência, para que as sessões possam ser concluídas. O padrão é 30 segundos.
  • Integer
Especifique as propriedades a seguir para transferência de aplicativo SIP (Session Initiation Protocol):
estratégia de quiesce
Especifica se os membros e servidores de cluster serão pausados depois que todos os diálogos e sessões ativos forem concluídos ou se serão pausados depois de um intervalo especificado.

DEFAULT: Os membros de cluster e servidores pausam quando diálogos e sessões ativos são concluídos.

INTERVAL: Os membros de cluster e servidores pausam após um intervalo especificado. Você também deve especificar o quiesceInterval como um valor inteiro em número de segundos.

Valor de Retorno

O comando retorna:
  • true: êxito
  • false: falha

Exemplo de uso do modo em lote

Uso de exemplo do modo interativo

validateEdition

O comando validateEdition valida uma edição.

Objeto de destino

Nenhum.

Parâmetros

-appName
Especifica o nome do aplicativo. (String)
-edition
Especifica o nome da edição do aplicativo. (String)
-params
Especifica os parâmetros para configuração do tamanho do cluster que está sendo clonado durante a validação. Por padrão, o tamanho do cluster original será usado, se os parâmetros não estiverem especificados.
  • Cluster dinâmico:
    dynClusterMaxSize
    Especifica o tamanho máximo do cluster dinâmico.
    dynClusterMinSize
    Especifica o tamanho mínimo do cluster dinâmico.
  • Cluster estático:
    staticClusterSize
    Especifica o tamanho do cluster estático. O valor de staticClusterSize não pode exceder o tamanho do cluster estático que está sendo clonado.

Valor de Retorno

O comando retorna:
  • true: êxito
  • false: falha

Exemplo de uso do modo em lote

Uso de exemplo do modo interativo

listEditions

O comando listEditions fornece uma lista de todas as edições instaladas do aplicativo.

Objeto de destino

Nenhum.

Parâmetros

-appName
Especifica o nome do aplicativo. (String)

Valor de Retorno

O comando retorna uma matriz de cadeia de todas as edições instaladas do aplicativo.

Exemplo de uso do modo em lote

Uso de exemplo do modo interativo

isEditionExists

O comando isEditionExists verifica se a edição especificada existe para o aplicativo específico.

Objeto de destino

Nenhum.

Parâmetros

-appName
Especifica o nome do aplicativo. (String)
-edition
Especifica o nome da edição do aplicativo. (String)

Valor de Retorno

O comando retorna:
  • true: êxito
  • false: falha

Exemplo de uso do modo em lote

Uso de exemplo do modo interativo

cloneDynamicCluster

O comando cloneDynamicCluster clona um cluster dinâmico para utilizar um grupo de nós diferente.

Objeto de destino

Nenhum.

Parâmetros

-clusterName
Especifica o nome do cluster dinâmico original. (String)
-newClusterName
Especifica o nome do cluster dinâmico clonado. (String)
-nodeGroupName
Especifica o nome do grupo de nós no qual o cluster dinâmico clonado está localizado. Por padrão, o nome será configurado no grupo de nós atual se esse parâmetro não estiver especificado. (String)
-opMode
Especifica o modo operacional do cluster dinâmico clonado. Por padrão, o modo do cluster dinâmico original será utilizado se esse parâmetro não for especificado. Configure o valor como Automático, Manual ou Supervisionado. (String)

Para obter informações adicionais sobre modos operacionais, consulte Clusters Dinâmicos .

-templateName
Especifica o nome de um modelo existente no formato de cell_name/node_name/server_name. O modelo é usado para criar as instâncias do servidor do cluster clonado.

Exemplo de uso do modo em lote

Uso de exemplo do modo interativo

cancelValidation

O comando cancelValidation cancela o modo de validação em uma edição do aplicativo.

O comando getEditionState retorna o estado da edição do aplicativo. O estado de uma edição existente pode ser ACTIVE, INACTIVE ou VALIDATE. Para um aplicativo ou edição não-existente, o método retorna nulo.

Objeto de destino

Nenhum.

Parâmetros

-appName
Especifica o nome do aplicativo. (String)
-edition
Especifica o nome da edição do aplicativo. (String)

Valor de Retorno

O comando retorna:
  • verdadeiro: O cancelamento da validação foi bem-sucedido.
  • falso: Falha no cancelamento da validação.

Exemplo de uso do modo em lote

Uso de exemplo do modo interativo

getEditionState [Version 6.1.1 and later]

O comando getEditionState retorna o estado da edição do aplicativo. O estado de uma edição existente pode ser ACTIVE, INACTIVE ou VALIDATE. Para um aplicativo ou edição não-existente, o método retorna nulo.

Objeto de destino

Nenhum.

Parâmetros

-appName
Especifica o nome do aplicativo. (String)
-edition
Especifica o nome da edição do aplicativo. (String)

Valor de Retorno

O comando retorna:
  • ACTIVE
  • INACTIVE
  • VALIDATE

Exemplo de uso do modo em lote

Uso de exemplo do modo interativo

Instalar um Aplicativo com uma Edição

Use o comando de instalação AdminApp para instalar um aplicativo com uma edição. Você deve transmitir o parâmetro -edition para especificar o identificador de edição.

É possível usar o seguinte exemplo no wsadmin para instalar o aplicativo BeenThere com a edição 1.0.
  • Utilizando Jacl:
    $AdminApp install /tmp/BeenThere1.0.ear {-appname BeenThere -edition 1.0 -nopreCompileJSPs -distributeApp -nouseMetaDataFromBinary -nodeployejb -createMBeansForResources -noreloadEnabled -nodeployws -validateinstall warn -noprocessEmbeddedConfig -filepermission .*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755 -noallowDispatchRemoteInclude -noallowServiceRemoteInclude -MapModulesToServers {{"BeenThere WAR" BeenThere.war,WEB-INF/web.xml WebSphere:cell=TestCell,cluster=TestClusterB} {"BeenThere EJB" BeenThere.jar,META-INF/ejb-jar.xml WebSphere:cell=TestCell,cluster=TestClusterB}}}  
  • Utilizando Jython:
    AdminApp.install("/tmp/BeenThere1.0.ear", '[-appname BeenThere -edition 1.0 -nopreCompileJSPs -distributeApp -nouseMetaDataFromBinary -nodeployejb -createMBeansForResources -noreloadEnabled -nodeployws -validateinstall off -processEmbeddedConfig -filepermission .*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755 -buildVersion Unknown -noallowDispatchRemoteInclude -noallowServiceRemoteInclude -MapModulesToServers [["BeenThere WAR" BeenThere.war,WEB-INF/web.xml WebSphere:cell=TestCell,cluster=TestClusterB] ["BeenThere EJB" BeenThere.jar,META-INF/ejb-jar.xml WebSphere:cell=TestCell,cluster=TestClusterB]]]') 

Atualizar um Aplicativo com uma Edição

Use o comando de atualização AdminApp para atualizar um aplicativo com uma edição. Transmita o nome completo do aplicativo, que é o nome do aplicativo e a edição, para especificar a edição.

É possível usar o seguinte exemplo no wsadmin para atualizar a edição 1.0 do aplicativo BeenThere com o arquivo BeenThereE1-update.ear.
  • Utilizando Jacl:
    $AdminApp update BeenThere-edition1.0 app {-operation update -contents /tmp/BeenThereE1-update.ear -nopreCompileJSPs -distributeApp -nouseMetaDataFromBinary -nodeployejb -createMBeansForResources -noreloadEnabled -nodeployws -validateinstall warn -noprocessEmbeddedConfig -filepermission .*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755 -noallowDispatchRemoteInclude -noallowServiceRemoteInclude}  
  • Utilizando Jython:
    AdminApp.update('BeenThere-edition1.0', 'app', '[-operation update -contents /tmp/BeenThereE1-update.ear -nopreCompileJSPs -distributeApp -nouseMetaDataFromBinary -nodeployejb -createMBeansForResources -noreloadEnabled -nodeployws -validateinstall warn -noprocessEmbeddedConfig -filepermission .*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755 -noallowDispatchRemoteInclude -noallowServiceRemoteInclude]') 

Editar um Aplicativo com uma Edição

Use o comando de edição AdminApp para editar um aplicativo com uma edição. Transmita o nome completo do aplicativo, que é o nome do aplicativo e a edição, para especificar a edição.

É possível usar o seguinte exemplo no wsadmin para editar a edição 1.0 do aplicativo BeenThere alterando a raiz de contexto do módulo da Web para /beenthere.
  • Utilizando Jacl:
    $AdminApp edit BeenThere-edition1.0 {-CtxRootForWebMod {{"BeenThere WAR" BeenThere.war,WEB-INF/web.xml /beenthere}}} 
  • Utilizando Jython:
    AdminApp.edit('BeenThere-edition1.0', '[-CtxRootForWebMod [["BeenThere WAR" BeenThere.war,WEB-INF/web.xml /beenthere]]]')

Desinstalar um Aplicativo com uma Edição

Use o comando de desinstalação AdminApp para desinstalar um aplicativo com uma edição. Transmita o nome completo do aplicativo, que é o nome do aplicativo e a edição, para especificar a edição.

É possível usar o seguinte exemplo no wsadmin para desinstalar a edição 1.0 do aplicativo BeenThere.
  • Utilizando Jacl:
    $AdminApp uninstall BeenThere-edition1.0 
  • Utilizando Jython:
    AdminApp.uninstall('BeenThere-edition1.0')



Conceitos relacionados
Application Edition Manager
Tarefas relacionadas
Implementando e Gerenciando Edições de Aplicativos sem Perda de Serviço
Executando uma Implementação em uma Edição
Cancelando a Validação de um Aplicativo
Instalando uma Edição
Tópico de Referência    

Termos de Uso | Feedback

Última atualização: 24/09/2009 14h19min03s EDT
http://publib.boulder.ibm.com/infocenter/wxdinfo/v6r1m1/index.jsp?topic=/com.ibm.websphere.ops.doc/info/reference/radtaskapped.html