Actualización de versiones de firmware para dispositivos DataPower utilizando scripts

Utilice la herramienta wsadmin para actualizar firmware para los dispositivos de un conjunto gestionado. Los archivos de versión de firmware del fabricante son específicos de los tipos de dispositivo, tipos de modelo y bibliotecas de características.

Antes de empezar

Antes de empezar, configure el gestor de dispositivos DataPower añadiendo y configurando dispositivos y conjuntos gestionados.

Acerca de esta tarea

En este tema se incluye un ejemplo para actualizar el firmware de varios dispositivos que el gestor de dispositivos DataPower administra en un conjunto gestionado. Los dispositivos de interés son miembros del conjunto gestionado conjuntoPrueba. Cuando se actualiza el firmware en un conjunto gestionado que gestiona varios dispositivos, el sistema despliega la versión de firmware en el dispositivo maestro y, a continuación, secuencialmente en cada uno de los dispositivos del conjunto gestionado.

Para ver información adicional y ejemplos de los mandatos en este tema, consulte la documentación del grupo de mandatos dpManagerCommands del objeto AdminTask.

Procedimiento

  1. Inicie la herramienta de scripts wsadmin.
  2. Determine los ID de los conjuntos gestionados.
    Utilice el mandato dpGetAllManagedSetIDs para mostrar los ID de cada conjunto gestionado en la configuración del gestor de dispositivos DataPower, como se muestra en el mandato siguiente:
    AdminTask.dpGetAllManagedSetIds()
    De manera opcional, puede utilizar el mandato dpGetManagedSet para mostrar los atributos de un determinado ID de conjunto gestionado, tal como se muestra en el siguiente ejemplo:
    AdminTask.dpGetManagedSet('-managedSetId conjuntoPrueba')
  3. Determine la versión de firmware que se va a desplegar en cada conjunto gestionado.

    Puede utilizar el gestor de dispositivos DataPower para desplegar una nueva versión de firmware en la configuración o para revertir a una versión de firmware anterior existente en la configuración.

    • Para desplegar una nueva versión de firmware en la configuración, descargue las versiones de firmware que desee del sitio web de DataPower. No es necesario descargar nuevas versiones de firmware si está revirtiendo a una versión de firmware anterior existente en la configuración. Después de descargar las nuevas versiones de firmware, utilice el mandato dpAddFirmwareVersion para añadir la versión de firmware local al gestor de dispositivos DataPower. La versión de firmware está asociada con un determinado firmware, que actúa como contenedor para todas las versiones de firmware que tengan el mismo tipo de dispositivo, tipo de modelo y características compatibles. El siguiente ejemplo de mandato añade una versión de firmware al gestor de dispositivos DataPower:
      addFirmwareTask=AdminTask.dpAddFirmwareVersion('[-file
      "C:\temp\dptestFW\dev-xs-143863-3_6_0_16.scrypt2"
       -userComment "mi nuevo firmware para la prueba"]')
      El mandato somete las tareas al gestor de dispositivos DataPower y establece los ID de tarea en las variables correspondientes. Utilice los siguientes mandatos de ejemplo para supervisar el estado de las tareas:
      param = '-taskId '+addFirmwareTask 
      print AdminTask.dpGetTask(param) 
      El mandato devuelve la información de las tareas y el ID de versión de firmware como el valor del atributo result, tal como se muestra en la siguiente salida de ejemplo:
      [ [currentStep 0] [totalSteps 0] [taskDescription
       Añadir nueva versión de firmware al gestor de dispositivos DataPower]]
       [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]] ] 
      Puede utilizar el mandato dpGetAllFirmwareIds para mostrar el ID de cada firmware disponible. A continuación, utilice el mandato dpGetAllFirmwareVersionIDs para obtener los ID de cada versión de firmware disponible del firmware de interés. Cuando busque el ID de la versión de firmware que desea utilizar, establezca el valor del atributo result en una variable para utilizarla en el mandato que despliega la versión de firmware en el conjunto gestionado, tal como se muestra en el siguiente ejemplo:
      testFirmwareVersionID = 'XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.15'
    • Para desplegar una versión de firmware existente en el conjunto gestionado, utilice los siguientes mandatos para determinar las versiones de firmware de interés:
      • Utilice el mandato dpGetAllFirmwareVersionIds para mostrar los ID de versión de cada versión de firmware de un firmware específico, tal como se muestra en el ejemplo siguiente:
        AdminTask.dpGetAllFirmwareVersionIds('-firmwareId
        "XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;"')
      • Para este ejemplo, existen las dos versiones de firmware siguientes:
        XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.15
        XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.16
      • De manera opcional, puede utilizar el mandato dpGetFirmware para mostrar el tipo de dispositivo, el tipo de modelo, las características estrictas y las características no estrictas del firmware, tal como se muestra en el siguiente ejemplo:
        AdminTask.dpGetFirmware('-firmwareId "XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;"')
      • Si no está seguro de qué firmware desea utilizar, puede utilizar el mandato dpGetBestFirmware para consultar qué firmware coincide con el tipo de dispositivo, el tipo de modelo y las características del dispositivo. El mandato no recomienda un firmware específico. El mandato determina el firmware que coincide con la configuración. En el ejemplo siguiente, el mandato busca un firmware que contenga la versión de firmware 3.6.0.4.
        AdminTask.dpGetBestFirmware('-applianceType "XS40" -modelType
        "9002" -applianceFeatures "JAXP-API" -level
        "3.6.0.4"')
  4. Compruebe que el sistema ha añadido la nueva versión de firmware al gestor de dispositivos DataPower.
    Utilice el mandato getTask para determinar si la tarea ha finalizado, tal como se muestra en el siguiente ejemplo:
    AdminTask.dpGetTask('-taskId '+addFirmwareTask)

    El mandato devuelve información sobre la tarea asíncrona de interés. El atributo isComplete muestra un valor true si la tarea está completa. Si no está completa, anote el valor del atributo taskStatus. Si el valor devuelto es 0, la tarea está en una cola y el sistema no ha iniciado la tarea. Si el valor devuelto es 1, la tarea está en curso. Si el valor devuelto es 2, la tarea ha finalizado satisfactoriamente. Si el valor devuelto es 3, la tarea ha experimentado una excepción.

  5. Despliegue la versión de firmware.
    Cuando el sistema añada la versión de firmware al gestor de dispositivos DataPower, utilice el mandato dpSetManagedSet para asignar la versión de firmware al conjunto gestionado. El siguiente ejemplo asigna la versión de firmware que acaba de descargar al conjunto gestionado del entorno de prueba:
    FVTask=AdminTask.dpSetManagedSet('-managedSetId conjutoPrueba
    -desiredFirmwareVersionId '+testFirmwareVersionID)

    El mandato somete las tareas al gestor de dispositivos DataPower y asigna los identificadores de tarea a las variables correspondientes. El despliegue de un firmware puede tardar varios minutos y hace que el dispositivo que se está reiniciando ejecute la nueva versión de firmware.

  6. Verifique que el sistema ha asignado satisfactoriamente las nuevas versiones de firmware a los conjuntos gestionados.
    Utilice el mandato getTask para determinar si la tarea ha finalizado, tal como se muestra en el siguiente ejemplo:
    AdminTask.dpGetTask('-taskId '+FVTask)

    El mandato devuelve información sobre la tarea asíncrona de interés. El atributo isComplete muestra un valor true si la tarea está completa. Si no está completa, anote el valor del atributo taskStatus. Si el valor devuelto es 0, la tarea está en una cola y el sistema no ha iniciado la tarea. Si el valor devuelto es 1, la tarea está en curso. Si el valor devuelto es 2, la tarea ha finalizado satisfactoriamente. Si el valor devuelto es 3, la tarea ha experimentado una excepción.

  7. Opcional: Elimine la versión de firmware que el sistema ha sustituido del gestor de dispositivos DataPower.

    Si no desea conservar una copia de la versión de firmware anterior en el gestor de dispositivos DataPower, elimine la versión de firmware de la configuración. Si lo desea, puede conservar las dos versiones de firmware anteriores, en el caso de que necesite revertir a la versión anterior.

    Utilice el mandato dpRemoveFirmwareVersion para eliminar la versión de firmware que ya no utiliza el conjunto gestionado. No puede eliminar versiones de firmware asignadas a conjuntos gestionados. El siguiente ejemplo elimina la versión de firmware del gestor de dispositivos DataPower:
    AdminTask.dpRemoveFirmwareVersion('-firmwareVersionId
    "XS40:9002::DataGlue;JAXP-API;PKCS7-SMIME;HSM;:3.6.0.13"')

Resultados

El conjunto gestionado utiliza la nueva versión de firmware.

Qué hacer a continuación

Puede utilizar la herramienta wsadmin para gestionar dispositivos, firmware, dominios, conjuntos gestionados y valores específicos de los dispositivos. Asimismo, el sistema crea versiones de dominios, firmware y valores específicos del dispositivo. Puede utilizar la herramienta wsadmin para modificar la versión actual, o para revertir a versiones anteriores de los dominios, firmware y valores específicos de los dispositivos.


Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_7dpfirmware
File name: txml_7dpfirmware.html