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.
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
- Inicie la herramienta de scripts wsadmin.
- 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.
- 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: 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.
- 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.
- 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.
- 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: 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.
- 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.
- 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.