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.
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
- Inicie a ferramenta de script wsadmin.
- 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.
- 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: 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.
- 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.
- 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.
- 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: 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.
- 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.
- 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.