Configurando o Gerenciador de Dispositivos do DataPower Utilizando o Script

Utilize o servidor de aplicativos e a ferramenta wsadmin para configurar, consultar e administrar os dispositivos configurados do DataPower no gerenciador de dispositivos do DataPower. Os dispositivos do DataPower são dispositivos de rede fáceis de implementar, criados com a finalidade de simplificar, ajudar a proteger e acelerar as implementações da Web e do XML.

Antes de Iniciar

Antes de começar, verifique se cada dispositivo que você deseja gerenciar tem um nível 3.6.0.4 ou superior de firmware. Além disso, verifique se o terminal AMP (Appliance Management Protocol) está ativado para cada dispositivo. Se o terminal AMP da interface Gerenciamento de XML for desativado durante a instalação, utilize a WebGUI do DataPower para ativar o terminal AMP.

[z/OS]O certificado raiz do DataPower, localizado em app_server_root/profiles/profile_name/etc/DataPower-root-ca-cert.pem, é fornecido como parte do armazenamento de chaves padrão. Durante a criação do perfil, esse certificado pode ser incluído apenas nos armazenamentos baseados em arquivos. Como os conjuntos de chaves SAF não são baseados em arquivo, o certificado deve ser incluído no armazenamento de chaves RACF manualmente.

Sobre Esta Tarefa

Utilize este tópico para incluir dispositivos do DataPower no gerenciador de dispositivos do DataPower, criar conjuntos gerenciados e dispositivos para conjuntos gerenciados em seu ambiente. Você pode incluir quantos dispositivos e conjuntos gerenciados necessitar.

Os exemplos deste tópico configuram o gerenciador de dispositivos do DataPower para administrar dois conjuntos gerenciados de dispositivos do DataPower, atualizar o firmware do dispositivo e configurar domínios. O primeiro conjunto gerenciado representa um ambiente de produção que utiliza três dispositivos do DataPower. O segundo conjunto gerenciado representa um ambiente de teste que utiliza um dispositivo do DataPower. Definindo essa configuração, você poderá utilizar o segundo conjunto gerenciado no ambiente de teste para modificar e testar as configurações de dispositivos do DataPower antes de importar o domínio do dispositivo de teste em seu ambiente de produção. Modifique os exemplos para configurar ainda melhor seu ambiente.

Para visualizar informações adicionais e exemplos dos comandos neste tópico, consulte a documentação do grupo de comandos dpManagerCommands para o objeto AdminTask.

Procedimento

  1. Inicie a ferramenta de script wsadmin.
  2. Inclua os dispositivos do DataPower na configuração do gerenciador de dispositivos do DataPower.
    Utilize o comando dpAddAppliance para incluir dispositivos no gerenciador de dispositivos do DataPower. Cada chamada de comando cria uma tarefa no gerenciador de dispositivos do DataPower e retorna o identificador de tarefas como saída de comando. Os comandos a seguir incluem dispositivos ProductionAppliance1, ProductionAppliance2, ProductionAppliance3 e TestAppliance1 em sua configuração e designam o identificador de tarefas para uma variável específica:
    app1Task=AdminTask.dpAddAppliance('[-hostname ProductionAppliance1.ibm.com -hlmPort 5550 –name ProductionAppliance1 -userId admin -password mypassword]') 
    app2Task=AdminTask.dpAddAppliance('[-hostname ProductionAppliance2.ibm.com -hlmPort 5550 –name ProductionAppliance2 -userId admin -password mypassword]')
    app3Task=AdminTask.dpAddAppliance('[-hostname ProductionAppliance3.ibm.com -hlmPort 5550 –name ProductionAppliance3 -userId admin -password mypassword]') 
    testAppTask=AdminTask.dpAddAppliance('[-hostname TestAppliance1.ibm.com -hlmPort 5550 –name TestAppliance1 -userId admin -password mypassword]') 
    O gerenciador de dispositivos do DataPower envia tarefas para incluir os dispositivos na configuração. Se a tarefa utilizar um recurso que outra tarefa está utilizando, o sistema colocará a nova tarefa na fila até que a outra tarefa seja concluída. Utilize os seguintes comandos de exemplo para monitorar o status das tarefas:
    param = '-taskId '+app1Task; print AdminTask.dpGetTask(param)
    O comando retorna as informações de tarefas e o ID do dispositivo como o valor do atributo result, conforme mostrado na seguinte saída de exemplo:
    [ [currentStep 0] [totalSteps 0] [taskDescription [Add appliance ProductionAppliance1 to 
     the DataPower appliance manager]] [currentStepTimestamp [Jan 18, 2008 2:32:25 PM]] 
     [creationDate [Jan 18, 2008 2:32:23 PM]] 
     [taskStatus 2] [taskId 1] [hasError false] [createdByUser defaultWIMFileBasedRealm/admin]
     [isComplete true] [result [00605  20356]] ]

    Depois que o sistema incluir cada dispositivo em sua configuração, os dispositivos serão dispositivos não gerenciados. Para gerenciar cada dispositivo, designe cada dispositivo a um conjunto gerenciado.

  3. Inclua a versão de firmware no gerenciador de dispositivos do DataPower.
    Utilize o comando dpAddFirmwareVersion para incluir a versão de firmware que o dispositivo ProductionAppliance2 utiliza no gerenciador de dispositivos do DataPower. O dispositivo ProductionAppliance2 é definido como o dispositivo principal posteriormente neste tópico. Portanto, cada dispositivo do mesmo conjunto gerenciado como o dispositivo ProductionAppliance2 utilizará a mesma versão de firmware.
    firmwareTask=AdminTask.dpAddFirmwareVersion('[-file 
       "C:\temp\dptestFW\dev-xs-143863-3_6_0_15.scrypt2" -userComment "my new firmware"]')
    Evitar Problemas Evitar Problemas: Não utilize o nível de firmware DataPower 3.6.0.28, 3.6.0.29 ou 3.6.0.30 para um conjunto gerenciado.gotcha
    Geralmente, ao criar um conjunto gerenciado de dispositivos DataPower, o gerenciador de dispositivos DataPower conclui o seguinte processo:
    • Cria uma versão de configurações de dispositivos compartilháveis a partir das configurações de dispositivos compartilháveis no dispositivo principal.
    • Sincroniza as configurações no conjunto gerenciado. Esse processo de sincronização é repetido sempre que as configurações de dispositivos compartilháveis mudam no dispositivo principal.
    Da mesma forma, quando um domínio é incluído em um conjunto gerenciado no gerenciador de dispositivos DataPower, normalmente o gerenciador de dispositivos DataPower conclui o seguinte processo:
    • Cria uma versão de domínio a partir do domínio no dispositivo principal.
    • Sincroniza a versão do domínio no conjunto gerenciado. Esse processo de sincronização é repetido cada vez que o domínio muda no dispositivo principal.

    Se você utilizar o nível de firmware DataPower 3.6.0.28, 3.6.0.29 ou 3.6.0.30 para um conjunto gerenciado, o nível de firmware pode fazer com que o gerenciador de dispositivos DataPower crie desnecessariamente novas versões de configurações de dispositivos compartilháveis ou versões de domínios, e sincronize essas novas versões no conjunto gerenciado.

    O comando envia uma tarefa para o sistema incluir o firmware e designa o identificador de tarefas para a variável firmwareTask.

  4. Inclua conjuntos gerenciados em sua configuração do gerenciador de dispositivos do DataPower.
    Utilize o comando dpAddManagedSet para incluir conjuntos gerenciados no gerenciador de dispositivos do DataPower. Cada chamada de comando cria uma tarefa no gerenciador de dispositivos do DataPower e retorna o identificador de tarefas como saída de comando. Os seguintes comandos criam os conjuntos gerenciados testSet e productionSet em sua configuração:
    AdminTask.dpAddManagedSet('-name testSet') 
    AdminTask.dpAddManagedSet('-name productionSet')

    O comando envia a tarefa para o gerenciador de dispositivos DataPower.

  5. Verifique se o sistema incluiu cada dispositivo e conjunto gerenciado em sua configuração.
    Os comandos dpAddAppliance e dpAddManagedSet podem não ser concluídos imediatamente. Antes de incluir os dispositivos nos conjuntos gerenciados, verifique se o sistema concluiu as tarefas dos comandos anteriores. Se você não definiu a saída do comando como variáveis nas etapas anteriores, utilize o seguinte comando para exibir cada identificador de tarefa a partir do gerenciador de dispositivos do DataPower:
    AdminTask.dpGetAllTaskIds()
    Caso contrário, utilize o comando dpGetTask para determinar se o sistema concluiu as tarefas. Execute o comando para cada tarefa, como demonstram os seguintes comandos:
    AdminTask.dpGetTask('-taskId '+app1Task) 
    AdminTask.dpGetTask('-taskId '+app2Task) 
    AdminTask.dpGetTask('-taskId '+app3Task) 
    AdminTask.dpGetTask('-taskId '+testAppTask) 
    AdminTask.dpGetTask('-taskId '+prodSetTask) 
    AdminTask.dpGetTask('-taskId '+firmwareTask) 
    AdminTask.dpGetTask('-taskId '+prodSetTask)

    Os comandos retornam informações sobre a tarefa assíncrona de interesse. O atributo isComplete exibirá um valor de true se a tarefa estiver concluída. Se não estiver concluída, anote o valor do atributo taskStatus. Se o valor retornado for 0, a tarefa estará em uma fila e o sistema não iniciou a tarefa. Se o valor retornado for 1, a tarefa estará em progresso. Se o valor retornado for 2, então a tarefa foi concluída com êxito. Se o valor retornado for 3, a tarefa encontrou uma exceção.

    Para obter descrições dos atributos adicionais que o comando retorna, consulte a documentação do grupo de comandos dpManagerCommands do objeto AdminTask.

  6. Designe os dispositivos de produção para o conjunto gerenciado de produção.
    Para designar dispositivos para o conjunto gerenciado, você deve saber os IDs dos dispositivos de interesse. Utilize o comando dpGetAllApplianceIds para exibir os IDs de cada dispositivo em sua configuração, como demonstra o seguinte exemplo:
    AdminTask.dpGetAllApplianceIds()
    Utilize o comando dpGetAppliance para exibir informações adicionais para um ID de dispositivo específico, como demonstra o seguinte exemplo:
    AdminTask.dpGetAppliance('[-applianceId "00605 20356"]')

    Utilize o comando dpManageAppliance para incluir cada dispositivo no conjunto gerenciado, especificando o ID de cada dispositivo para incluir o conjunto gerenciado.

    Evitar Problemas Evitar Problemas: Para designar vários dispositivos a um conjunto gerenciado, cada dispositivo deve ser o mesmo tipo de dispositivo, como XI50 ou XS40, e tipo de modelo. Além disso, os dispositivos devem ter os mesmos recursos necessários instalados. Verificando se cada dispositivo é exatamente o mesmo, certifique-se de que o gerenciador de dispositivos DataPower possa sincronizar o mesmo firmware, domínios e configurações para cada dispositivo no conjunto gerenciado.gotcha
    Os seguintes exemplos de comandos incluem os dispositivos ProductionAppliance1, ProductionAppliance2 e ProductionAppliance3 no conjunto gerenciado productionSet e especificam o dispositivo ProductionAppliance2 como o dispositivo principal. Se você não especificar um dispositivo como o dispositivo principal, o sistema designará automaticamente o primeiro dispositivo do conjunto gerenciado como o dispositivo principal.
    manageTask1=AdminTask.dpManageAppliance('[-managedSetId productionSet -applianceId "00605 20351"]') 
    manageTask2=AdminTask.dpManageAppliance('[-managedSetId productionSet -applianceId "00605 20352" -asMaster]') 
    manageTask3=AdminTask.dpManageAppliance('[-managedSetId productionSet -applianceId "00605 20353"]') 

    O comando envia uma tarefa para o sistema e define os identificadores de tarefas correspondentes como as variáveis manageTask1, manageTask2 e manageTask3.

  7. Designe o dispositivo de teste para o conjunto gerenciado de teste.
    O seguinte comando utiliza o comando dpManageAppliance para incluir o dispositivo TestAppliance1 no conjunto gerenciado testSet, especificando o ID do dispositivo TestAppliance1:
    manageTask4=AdminTask.dpManageAppliance('[-managedSetId testSet -applianceId "00605 20354"]')

    O comando envia uma tarefa para o sistema e configura o identificador de tarefa correspondente como a variável manageTask4.

  8. Verifique se o sistema incluiu os dispositivos nos conjuntos gerenciados.

    Utilize o comando dpGetTask para determinar o status das tarefas manageTask1, manageTask2, manageTask3 e manageTask4 antes de continuar a configurar o gerenciador de dispositivos do DataPower.

Resultados

Um conjunto gerenciado do ambiente de teste e um conjunto gerenciado do ambiente de produção existem na configuração do gerenciador de dispositivos do DataPower deste exemplo. O conjunto gerenciado do ambiente de teste gerencia o dispositivo TestAppliance1. O conjunto gerenciado do ambiente de produção gerencia os dispositivos ProductionAppliance1, ProductionAppliance2 e ProductionAppliance3. Cada dispositivo nos conjuntos gerenciados utiliza o domínio padrão.

O que Fazer Depois

Você poderá utilizar a WebGUI do DataPower para configurar domínios do dispositivo testAppliance1 do ambiente de teste se os domínios ainda não existirem. Depois de configurar e testar os domínios, você poderá utilizar a ferramenta wsadmin para copiar a configuração do dispositivo do ambiente de teste para o conjunto gerenciado do ambiente de produção.

É possível utilizar também a ferramenta wsadmin para gerenciar dispositivos, firmware, domínios, conjuntos gerenciados e configurações específicas do dispositivo. Além disso, o sistema cria versões de domínios, firmware e configurações específicas do dispositivo. É possível utilizar a ferramenta wsadmin para modificar a versão atual ou para reverter para versões anteriores de domínios, firmware e configurações específicas do dispositivo.


Í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=txml_7datapowerep
Nome do arquivo: txml_7datapowerep.html