Configuración del gestor de dispositivos DataPower mediante scripts

Utilice el servidor de aplicaciones y la herramienta wsadmin para configurar, consultar y administrar los dispositivos DataPower configurados en el gestor de dispositivos DataPower. Los dispositivos DataPower son dispositivos de red específicos, fáciles de desplegar, que permiten simplificar, proteger y acelerar los despliegues de servicios web y XML.

Antes de empezar

Antes de empezar, verifique que cada dispositivo que desee gestionar tiene el nivel de firmware 3.6.0.4 o posterior. Además, verifique que el punto final AMP (Appliance Management Protocol) esté habilitado para cada dispositivo. Si el punto final AMP de la interfaz de gestión XML se ha inhabilitado durante la instalación, utilice la GUI de Web de DataPower para habilitar el punto final de AMP.

[z/OS]El certificado raíz de DataPower, que se encuentra en raíz_serv_aplic/profiles/nombre_perfil/etc/DataPower-root-ca-cert.pem, se facilita como parte del almacén de claves predeterminado. Durante la creación del perfil, este certificado sólo puede añadirse a los almacenes de claves basados en archivos. Puesto que los conjuntos de claves SAF no están basados en archivos, el certificado debe añadirse manualmente al almacén de claves RACF.

Acerca de esta tarea

Utilice este tema para añadir dispositivos DataPower al gestor de dispositivos DataPower, crear conjuntos gestionados y asignar dispositivos a los conjuntos gestionados en el entorno. Puede añadir tantos o tan pocos dispositivos y conjuntos gestionados como sea necesario.

Los ejemplos de este tema configuran el gestor de dispositivos DataPower para administrar dos conjuntos gestionados de dispositivos DataPower, actualizar el firmware de dispositivos y configurar dominios. El primer conjunto gestionado representa un entorno de producción que utiliza tres dispositivos DataPower. El segundo conjunto gestionado representa un entorno de prueba que utiliza un dispositivo DataPower. Al establecer esta configuración, puede utilizar el segundo conjunto gestionado del entorno de prueba para modificar y probar los valores de dispositivos DataPower antes de importar el dominio del dispositivo de prueba al entorno de producción. Modifique los ejemplos para configurar mejor el entorno.

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. Añada los dispositivos DataPower a la configuración del gestor de dispositivos DataPower.
    Utilice el mandato dpAddAppliance para añadir dispositivos al gestor de dispositivos DataPower. Cada invocación de mandato crea una tarea en el gestor de dispositivos DataPower y devuelve el identificador de tarea como salida de mandato. Los siguientes mandatos añaden los dispositivos DispositivoProducción1, DispositivoProducción2, DispositivoProducción3 y DispositivoPrueba1 en la configuración y asignan el identificador de tareas a una variable específica:
    app1Task=AdminTask.dpAddAppliance('[-hostname DispositivoProducción1.ibm.com -hlmPort
     5550 –name ProductionAppliance1 -userId admin -password micontraseña]')
    app2Task=AdminTask.dpAddAppliance('[-hostname ProductionAppliance2.ibm.com -hlmPort 5550 –name
     DispositivoProducción2 -userId admin -password micontraseña]')
    app3Task=AdminTask.dpAddAppliance('[-hostname DispositivoProducción3.ibm.com -hlmPort
     5550 –name ProductionAppliance3 -userId admin -password micontraseña]')
    testAppTask=AdminTask.dpAddAppliance('[-hostname TestAppliance1.ibm.com -hlmPort 5550 –name
     DispositivoProducción1 -userId admin -password micontraseña]') 
    El gestor de dispositivos DataPower somete tareas para añadir los dispositivos a la configuración. Si la tarea utiliza un recurso que está utilizando otra tarea, el sistema pone en cola la nueva tarea hasta que finaliza la otra. Utilice los siguientes mandatos de ejemplo para supervisar el estado de las tareas:
    param = '-taskId '+app1Task; print AdminTask.dpGetTask(param)
    El mandato devuelve la información de las tareas y el ID del dispositivo como el valor del atributo result, tal como aparece en la siguiente salida de ejemplo:
    [ [currentStep 0] [totalSteps 0] [taskDescription [Add appliance DispositivoProducción1 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]] ]

    Cuando el sistema añade cada dispositivo a la configuración, los dispositivos son dispositivos no gestionados. Para gestionar cada dispositivo, asigne cada dispositivo a un conjunto gestionado.

  3. Añada la versión de firmware al gestor de dispositivos DataPower.
    Utilice el mandato dpAddFirmwareVersion para añadir la versión de firmware que utiliza el dispositivo DipositivoProducción2 al gestor de dispositivos DataPower. El dispositivo DipositivoProducción2 se establece como el dispositivo maestro más adelante en este tema. Por lo tanto, cada uno de los dispositivos del mismo conjunto gestionado que el dispositivo DipositivoProducción2 utilizará la misma versión de firmware.
    firmwareTask=AdminTask.dpAddFirmwareVersion('[-file 
       "C:\temp\dptestFW\dev-xs-143863-3_6_0_15.scrypt2" -userComment "mi nuevo firmware"]')
    Avoid trouble Avoid trouble: No use el nivel DataPower de firmware 3.6.0.28, 3.6.0.29, o 3.6.0.30 para un conjunto gestionado.gotcha
    En general, cuando crea un conjunto gestionado de dispositivos DataPower, el gestor de dispositivos DataPower completa el proceso siguiente:
    • Crea una versión de los valores de dispositivos compartibles a partir de los valores de dispositivos compartibles del dispositivo maestro.
    • Sincroniza los valores en todo el conjunto gestionado. Este proceso de sincronización se repite siempre que se modifican los valores de dispositivos compartibles en el dispositivo maestro.
    Asimismo, cuando se añade un dominio al conjunto gestionado en el gestor de dispositivos DataPower, el gestor de dispositivos DataPower suele realizar el proceso siguiente:
    • Crea un versión de dominio a partir del dominio en el dispositivo maestro.
    • Sincroniza la versión del domino en el conjunto gestionado. Este proceso de sincronización se repite cada vez que se modifica el dominio en el dispositivo maestro.

    Si utiliza el nivel de firmware de DataPower 3.6.0.28, 3.6.0.2 o 3.6.0.30 para un conjunto gestionado, es posible que el nivel de firmware tenga como efecto que el gestor de dispositivos DataPower cree innecesariamente versiones nuevas de valores de dispositivos compartibles o versiones de dominio y, a continuación, sincronice estas versiones nuevas en el conjunto gestionado.

    El mandato somete una tarea al sistema para añadir el firmware y asigna el identificador de tarea a la variable firmwareTask.

  4. Añada conjuntos gestionados en la configuración del gestor de dispositivos DataPower.
    Utilice el mandato dpAddManagedSet para añadir conjuntos gestionados al gestor de dispositivos DataPower. Cada invocación de mandato crea una tarea en el gestor de dispositivos DataPower y devuelve el identificador de tarea como salida de mandato. Los siguientes mandatos crean los conjuntos gestionados conjuntoPrueba y conjuntoProducción en la configuración:
    AdminTask.dpAddManagedSet('-name
    conjuntoPrueba') 
    AdminTask.dpAddManagedSet('-name conjuntoProducción')

    El madnato envía la tarea al gestor de dispositivos DataPower.

  5. Compruebe que el sistema ha añadido cada dispositivo y conjunto gestionado a la configuración.
    Puede que los mandatos dpAddAppliance y dpAddManagedSet no finalicen inmediatamente. Antes de añadir los dispositivos a los conjuntos gestionados, compruebe que el sistema haya completado las tareas de los mandatos anteriores. Si no ha establecido la salida de mandatos en variables en los pasos anteriores, utilice el siguiente mandato para mostrar cada identificador de tarea del gestor de dispositivos DataPower:
    AdminTask.dpGetAllTaskIds()
    De lo contrario, utilice el mandato dpGetTask para determinar si el sistema ha completado las tareas. Ejecute el mandato para cada tarea, tal como aparece en los siguientes mandatos:
    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)

    Los mandatos devuelven 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.

    Para ver descripciones de los atributos adicionales que devuelve el mandato, consulte la documentación del grupo de mandatos dpManagerCommands del objeto AdminTask.

  6. Asigne los dispositivos de producción en el conjunto gestionado de producción.
    Para asignar dispositivos al conjunto gestionado, debe conocer los ID de los dispositivos de interés. Utilice el mandato dpGetAllApplianceIds para mostrar los ID de dispositivo de cada dispositivo de la configuración, tal como se muestra en el ejemplo siguiente:
    AdminTask.dpGetAllApplianceIds()
    Utilice el mandato dpGetAppliance para mostrar información adicional sobre un ID de dispositivo específico, tal como aparece en el ejemplo siguiente:
    AdminTask.dpGetAppliance('[-applianceId "00605 20356"]')

    Utilice el mandato dpManageAppliance para añadir cada dispositivo al conjunto gestionado, especificando el ID de dispositivo de cada dispositivo que desea añadir al conjunto gestionado.

    Avoid trouble Avoid trouble: Para asignar varios dispositivos a un conjunto gestionado, cada uno de los dispositivos debe ser tener el mismo tipo de dispositivo, por ejemplo, XI50 o XS40, y el mismo tipo de modelo. Asimismo, los dispositivos deben tener instaladas las mismas características necesarias. Al verificar que cada dispositivo sea exactamente el mismo, garantiza que el gestor de dispositivos DataPower pueda sincronizar el mismo firmware, dominios y valores para cada dispositivo en el conjunto gestionado.gotcha
    Los siguientes ejemplos de mandato añaden los dispositivos DipositivoProducción2, DipositivoProducción2 y DipositivoProducción3 al conjunto gestionado conjuntoProducción, y especifican el dispositivo DipositivoProducción2 como el dispositivo maestro. Si no especifica un dispositivo como dispositivo maestro, el sistema asigna automáticamente el primer dispositivo del conjunto gestionado como dispositivo maestro.
    manageTask1=AdminTask.dpManageAppliance('[-managedSetId
    conjuntoProducción -applianceId "00605 20351"]')
    manageTask2=AdminTask.dpManageAppliance('[-managedSetId conjuntoProducción
    -applianceId "00605 20352" -asMaster]') 
    manageTask3=AdminTask.dpManageAppliance('[-managedSetId conjuntoProducción
    -applianceId "00605 20353"]') 

    El mandato somete una tarea al sistema y establece los identificadores de tarea correspondientes a las variables manageTask1, manageTask2 y manageTask3.

  7. Asigne el dispositivo de prueba al conjunto gestionado de prueba.
    El siguiente mandato utiliza el mandato dpManageAppliance para añadir el dispositivo DipositivoPrueba1 al conjunto gestionado conjuntoPrueba, especificando el ID del dispositivo DipositivoPrueba1:
    manageTask4=AdminTask.dpManageAppliance('[-managedSetId conjuntoPrueba
    -applianceId
    "00605 20354"]')

    El mandato somete una tarea al sistema y establece los identificadores de tarea correspondientes a la variable manageTask4.

  8. Verifique que el sistema ha añadido los dispositivos a los conjuntos gestionados.

    Utilice el mandato dpGetTask para determinar el estado de las tareas manageTask1, manageTask2, manageTask3 y manageTask4 antes de continuar configurando el gestor de dispositivos DataPower.

Resultados

En este ejemplo, en la configuración del gestor de dispositivos DataPower existen un conjunto gestionado del entorno de prueba y un conjunto gestionado del entorno de producción. El conjunto gestionado del entorno de prueba gestiona el dispositivo DipositivoPrueba1. El conjunto gestionado del entorno de producción gestiona los dispositivos DispositivoProducción1, DispositivoProducción2 y DispositivoProducción3. Cada uno de los dispositivos de ambos conjuntos gestionados utiliza el dominio predeterminado.

Qué hacer a continuación

Puede utilizar la WebGUI de DataPower para configurar dominios para el dispositivo DispositivoPrueba1 en el entorno de prueba, si los dominios no existen previamente. Después de configurar y probar los dominios, puede utilizar la herramienta wsadmin para copiar la configuración de dispositivos del entorno de prueba en el conjunto gestionado del entorno de producción.

Tambié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_7datapowerep
File name: txml_7datapowerep.html