Atualizando Versões de Firmware para Dispositivos do DataPower Utilizando o Script

Utilize a ferramenta wsadmin para atualizar o firmware para dispositivos dentro de um conjunto gerenciado. Os arquivos de versão de firmware provenientes do fabricante são específicos para tipos de dispositivos, tipos de modelos e bibliotecas de recursos.

Antes de Iniciar

Antes de começar, configure o gerenciador de dispositivos do DataPower incluindo e configurando dispositivos e conjuntos gerenciados.

Sobre Esta Tarefa

Este tópico fornece um exemplo para atualizar o firmware de vários dispositivos que o gerenciador de dispositivos do DataPower administra dentro de um conjunto gerenciado. Os dispositivos de interesse são membros do conjunto gerenciado testSet. Ao atualizar o firmware em um conjunto gerenciado que gerencia vários dispositivos, o sistema implementa a versão de firmware para o dispositivo principal e, então, na sequência, cada dispositivo do conjunto gerenciado.

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. Determine os IDs dos conjuntos gerenciados.
    Utilize o comando dpGetAllManagedSetIDs para exibir os IDs de cada conjunto gerenciado da configuração do gerenciador de dispositivos do DataPower, como demonstra o seguinte comando:
    AdminTask.dpGetAllManagedSetIds()
    Você pode, opcionalmente, utilizar o comando dpGetManagedSet para exibir atributos para um dado ID de conjunto gerenciado específico, como demonstra o seguinte exemplo:
    AdminTask.dpGetManagedSet('-managedSetId testSet')
  3. Determine a versão de firmware para implementar em cada conjunto gerenciado.

    É possível utilizar o gerenciador de dispositivos do DataPower para implementar uma nova versão de firmware em sua configuração ou reverter para uma versão de firmware anterior que exista em sua configuração.

    • Para implementar novas versões do firmware em sua configuração, faça download das versões de firmware desejadas a partir do Web site DataPower. Você não precisará fazer download de novas versões de firmware se estiver revertendo para uma versão de firmware anterior existente em sua configuração. Depois de fazer download das novas versões de firmware, utilize o comando dpAddFirmwareVersion e inclua a versão de firmware local no gerenciador de dispositivos do DataPower. A versão de firmware é associada a um firmware específico, que atua como um contêiner em cada versão de firmware que tenha o mesmo tipo de dispositivo, tipo de modelo e recursos compatíveis. O seguinte exemplo de comando inclui uma versão de firmware no gerenciador de dispositivos do DataPower:
      addFirmwareTask=AdminTask.dpAddFirmwareVersion('[-file "C:\temp\dptestFW\dev-xs-143863-3_6_0_16.scrypt2"
       -userComment "my new firmware for test"]')
      O comando envia as tarefas para o gerenciador de dispositivos do DataPower e define os IDs de tarefas como as variáveis correspondentes. Utilize os seguintes comandos de exemplo para monitorar o status das tarefas:
      param = '-taskId '+addFirmwareTask 
      print AdminTask.dpGetTask(param) 
      O comando retorna as informações de tarefas e o ID da versão de firmware como o valor do atributo result, conforme mostrado na seguinte saída de amostra:
      [ [currentStep 0] [totalSteps 0] [taskDescription
       [Add new firmware version 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 [XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.15]] ] 
      É possível utilizar o comando dpGetAllFirmwareIds para exibir o ID de cada firmware disponível. Em seguida, utilize o comando dpGetAllFirmwareVersionIDs para obter os IDs de cada versão de firmware disponível do firmware de interesse. Quando você encontrar o ID da versão de firmware a ser utilizado, defina o valor do atributo result como uma variável a ser utilizada no comando que implementa a versão de firmware no conjunto gerenciado, como demonstra o seguinte exemplo:
      testFirmwareVersionID = 'XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.15'
    • Para implementar uma versão de firmware existente para o conjunto gerenciado, utilize os seguintes comandos para determinar as versões de firmware de interesse:
      • Utilize o comando dpGetAllFirmwareVersionIds para exibir os IDs da versão de cada versão de firmware de um firmware específico, como demonstra o seguinte exemplo:
        AdminTask.dpGetAllFirmwareVersionIds('-firmwareId "XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;"')
      • Neste exemplo, existem as duas seguintes versões de firmware:
        XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.15
        XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.16
      • Você pode, opcionalmente, utilizar o comando dpGetFirmware para exibir o tipo de dispositivo, tipo de modelo, recursos exatos e recursos não exatos do firmware, como demonstra o seguinte exemplo:
        AdminTask.dpGetFirmware('-firmwareId "XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;"')
      • Se você não tiver certeza de qual firmware utilizar, poderá utilizar o comando dpGetBestFirmware para consultar o firmware que corresponde ao seu tipo de dispositivo, tipo de modelo e recursos do dispositivo. O comando não recomenda um firmware específico. O comando determina o firmware que corresponde à sua configuração. No seguinte exemplo, o comando consulta um firmware que contém a versão de firmware 3.6.0.4:
        AdminTask.dpGetBestFirmware('-applianceType "XS40" -modelType "9002" -applianceFeatures "JAXP-API" -level "3.6.0.4"')
  4. Verifique se o sistema incluiu a nova versão de firmware no gerenciador de dispositivos do DataPower.
    Utilize o comando getTask para determinar se a tarefa está concluída, como demonstra o seguinte exemplo:
    AdminTask.dpGetTask('-taskId '+addFirmwareTask)

    O comando retorna informações sobre a tarefa de interesse assíncrona. 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.

  5. Implemente a versão de firmware.
    Depois que o sistema incluir a versão de firmware no gerenciador de dispositivos do DataPower, utilize o comando dpSetManagedSet para designar a versão de firmware para o conjunto gerenciado. O exemplo a seguir designa a versão de firmware mais recente transferida por download para o conjunto gerenciado do ambiente de teste:
    FVTask=AdminTask.dpSetManagedSet('-managedSetId testSet -desiredFirmwareVersionId '+testFirmwareVersionID)

    O comando envia as tarefas para o gerenciador de dispositivos do DataPower e designa os identificadores de tarefas para as variáveis correspondentes. A implementação de um firmware pode levar vários minutos e resultará no dispositivo sendo reiniciado para executar a nova versão de firmware.

  6. Verifique se o sistema designou com êxito as novas versões de firmware para os conjuntos gerenciados.
    Utilize o comando getTask para determinar se a tarefa está concluída, como demonstra o seguinte exemplo:
    AdminTask.dpGetTask('-taskId '+FVTask)

    O comando retorna informações sobre a tarefa de interesse assíncrona. 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.

  7. Opcional: Remova a versão de firmware que o sistema substituiu do gerenciador de dispositivos do DataPower.

    Se você não desejar manter uma cópia da versão de firmware anterior no gerenciador de dispositivos do DataPower, remova a versão de firmware de sua configuração. Você pode desejar manter as duas versões de firmware anteriores no caso de precisar reverter para a versão anterior.

    Utilize o comando dpRemoveFirmwareVersion para remover a versão de firmware que o conjunto gerenciado não utiliza mais. Você não pode remover versões de firmware que estejam designadas a conjuntos gerenciados. O seguinte exemplo remove a versão de firmware do gerenciador de dispositivos do DataPower:
    AdminTask.dpRemoveFirmwareVersion('-firmwareVersionId "XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.13"')

Resultados

O conjunto gerenciado utiliza a nova versão de firmware.

O que Fazer Depois

É possível utilizar 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_7dpfirmware
Nome do arquivo: txml_7dpfirmware.html