Cancelando Registro de Nós do Agente Administrativo

É possível cancelar registro de nós do servidor de aplicativos para que não sejam mais registrados em um agente administrativo. Cancele registro dos nós se não precisar mais do nó no ambiente do agente administrativo ou se pretender excluir o perfil do nó do servidor de aplicativos. Depois de cancelar registro de um nó de um agente administrativo, é possível usar o nó independente, registrar o nó com outro agente administrativo ou excluir o perfil do nó do servidor de aplicativos.

Antes de Iniciar

O nó do servidor de aplicativos que você deseja remover do ambiente do agente administrativo deve ser registrado com o agente administrativo. Inicie o agente administrativo se ele ainda não estiver em execução.

Sobre Esta Tarefa

Para cancelar registro de um nó, execute o comando deregisterNode no diretório bin do agente administrativo. A Etapa 1 descreve como executar o comando deregisterNode.

Ao remover o registro de um nó, a configuração do nó é mantida, mas marcada como não registrada no agente administrativo. Se o nó cujo registro foi cancelado tinha o console administrativo ou os aplicativos Enterprise JavaBeans (EJB) instalados antes de registrar o nó, eles serão reativados.

Executar o comando deregisterNode poderá resultar em uma exceção de ponteiro nulo se o perfil do nó do servidor de aplicativos estiver corrompido ou se não for aproveitável. Se você receber a exceção de ponteiro nulo, o processo para cancelar registro do servidor de aplicativos do agente administrativo falhou. Você recebe mensagens ADMU0116I, ADMU0128I, ADMU0211I, ADMU0113E e ADMU1211I no log de erros. A Etapa 2 descreve como remover um nó e pontos de extremidade relacionados se houver uma exceção de ponteiro nulo.

Se o perfil do nó do servidor de aplicativos for excluído antes do cancelamento do registro do nó, executar o comando deregisterNode será ineficaz. Como o perfil não existe mais, o agente administrativo não reconhece o perfil. Conclua a Etapa 2 para remover o nó e pontos de extremidade relacionados do ambiente de agente administrativo.

Procedimento

  1. Cancele registro de um nó usando o comando deregisterNode.

    Se o nó do qual você deseja cancelar registro existir, execute o comando deregisterNode especificando o caminho do perfil do nó cujo registro será cancelado:

    deregisterNode -profilePath profile_root/profile_name

    Por exemplo, para cancelar registro do perfil AppSrv02 do ambiente de agente administrativo, execute o seguinte comando:

    deregisterNode -profilePath profile_root/AppSrv02

    Consulte o tópico sobre o comando deregisterNode para obter informações sobre os parâmetros de comando.

  2. Se resultar uma exceção de ponteiro nulo da execução do comando deregisterNode ou se o perfil do nó tiver sido excluído, execute comandos wsadmin que removam o nó registrado e os pontos de extremidade relacionados.
    1. Em uma linha de comandos, execute um comando para iniciar a ferramenta de script wsadmin a partir do diretório bin do agente administrativo.
      Para usar a linguagem de script Jython, digite:
      wsadmin -lang jython
      Para usar a linguagem de script Jacl, digite:
      wsadmin
    2. Se você não souber o nome do nó que será removido, execute o comando list de AdminConfig para listar os nós que estão registrados no agente administrativo e localize o nó a ser removido na lista.
      Para Jython:
      print AdminConfig.list('ManagedNode')
      Para Jacl:
      $AdminConfig list ManagedNode

      A lista de nós registrados exibida assemelha-se ao seguinte:

      nodeA(cells/myAACell01/managednodes/nodeA|managednode.xml#ManagedNode_1239121412703)
      nodeB(cells/myAACell01/managednodes/nodeB|managednode.xml#ManagedNode_1239121498500)

      Essa lista mostra que nodeA e nodeB são nós registrados do agente administrativo myAACell01.

    3. Emita comandos wsadmin que removam o nó.

      Para remover nodeA e salvar as mudanças, execute os comandos a seguir sucessivamente.

      Para Jython:
      mn = AdminConfig.getid('/ManagedNode:nodeA/')
      
      AdminConfig.remove(mn)
      
      AdminConfig.save()
      Para Jacl:
      set mn [$AdminConfig getid /ManagedNode:nodeA/]
      
      $AdminConfig remove $mn
      
      $AdminConfig save
    4. Execute comandos wsadmin que removam pontos de extremidade que foram gerados para o subsistema quando o perfil do nó foi registrado.

      Execute os comandos a seguir em sequência para remover pontos de extremidade de nodeA. O comando for no Jython e o comando foreach no Jacl são comandos de uma linha mostrados em múltiplas linhas para fins de publicação.

      Para Jython:
      import java.lang.System as System
      
      lineSeparator = System.getProperty("line.separator")
      
      neps = AdminConfig.list("NamedEndPoint").split(lineSeparator)
      
      for nep in neps:
        set name = AdminConfig.showAttribute(nep, "endPointName")
        if (name.endswith("nodeA") == 1):
           AdminConfig.remove(nep)
      
      AdminConfig.save()
      
      quit
      Para Jacl:
      set neps [$AdminConfig list NamedEndPoint]
      
      foreach nep $neps {set name [$AdminConfig showAttribute $nep endPointName]; 
      if {[string last "nodeA" $name] != -1} {$AdminConfig remove $nep}}
      
      $AdminConfig save
      
      quit
    5. Reinicie o agente administrativo.

      Para reiniciar um agente administrativo denominado adminagent, execute os seguintes comandos em um prompt de comandos no diretório bin do perfil do agente administrativo:

      stopServer adminagent
      
      startServer adminagent
    6. Verifique se o nó não está mais registrado no agente administrativo.

Resultados

O nó do servidor de aplicativos não está mais registrado no agente administrativo.

O que Fazer Depois

É possível usar o nó cujo registro foi cancelado independentemente ou registrar o nó com outro agente administrativo. Opcionalmente, use o comando manageprofiles para excluir o perfil do servidor de aplicativos.


Í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-base-dist&topic=tagt_adminagent_deregister_node
Nome do arquivo: tagt_adminagent_deregister_node.html