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.

Se o nó de servidor de aplicativos estiver registrado com um gerenciador de tarefa, cancele o registro do nó a partir do gerenciador de tarefa. É possível usar o console do agente administrativo ou os comandos wsadmin para cancelar registro do nó:
  • Use o console do agente administrativo para cancelar registro do nó do servidor de aplicativos independente de um gerenciador de tarefa.
    1. Efetue login no console do agente administrativo. O agente administrativo assemelha-se a host_nameAANode01.
    2. Clique em Administração do Sistema > Agente Administrativo.
    3. Na guia Configuração da página do Agente Administrativo, clique em Nós.
    4. Na página Nós, selecione o nó para cancelar registro do gerenciador de tarefa e clique em Cancelar Registro de um Gerenciador de Tarefa.
    5. Na página Cancelar Registro de um Gerenciador de Tarefa, especifique um nome de nó; especifique um número de porta do console administrativo do gerenciador de tarefa; especifique, opcionalmente, outros parâmetros, como o nome do usuário e a senha do gerenciador de tarefa e clique em OK.

      Para Porta, se a segurança não estiver ativada, especifique 9960 para uma porta não-segura do console administrativo do gerenciador de tarefa. Se nenhum número de porta for especificado, o número da porta segura padrão 9943 será usado.

  • Execute o comando unregisterWithJobManager wsadmin no grupo de comandos ManagedNodeAgent para cancelar o registro do nó do servidor de aplicativos independente a partir de um gerenciador de tarefa.

    Ao executar o comando unregisterWithJobManager, especifique o nome do nó do servidor de aplicativos independente que é gerenciado pelo gerenciador de tarefa do parâmetro -managedNodeName necessário. Outros parâmetros são opcionais.

    AdminTask.unregisterWithJobManager('[-host myJobMgrHostname -port 8989
     -managedNodeName myAppServerNodeName]') 

    O valor-padrão do parâmetro -host é localhost.

    O valor-padrão do parâmetro -port é 9943, o número da porta segura do console administrativo do gerenciador de tarefa. Se a segurança estiver desativada, especifique 9960, o número da porta não segura padrão.

    Para obter informações adicionais sobre o comando e os parâmetros de unregisterWithJobManager, consulte o tópico sobre o grupo de comandos ManagedNodeAgent do objeto AdminTask.

    Se o sistema falhar ao cancelar o registro de um servidor de aplicativos independente a partir de um gerenciador de tarefa, execute o comando cleanupTarget no grupo JobManagerNode para limpar as informações de registro do gerenciador de tarefa. Consulte o tópico sobre o grupo de comandos JobManagerNode para o objeto AdminTask.

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-nd-mp&topic=tagt_adminagent_deregister_node
Nome do arquivo: tagt_adminagent_deregister_node.html