Migración de células utilizando las herramientas de línea de mandatos

Antes de empezar

Supported configurations Supported configurations:

En este artículo se describe la migración de la configuración de perfil. Para migrar sus aplicaciones a la versión más reciente, utilice WebSphere Application Server Migration Toolkit. Para obtener más información, consulte Migration Toolkit en WASdev.

sptcfg

Revise la información sobre planificación de la migración en Knowledge Collection: Migration planning for WebSphere Application Server.

Consejo: En lugar de especificar los parámetros individuales en los mandatos de migración, puede especificar el parámetro -properties nombre_archivo.properties para especificar un archivo de propiedades. Para obtener más información, consulte Definición de la migración mediante las propiedades.

Acerca de esta tarea

Puede utilizar las herramientas de línea de mandatos para migrar una célula de una versión anterior de WebSphere Application Server a la Versión 9.0. La configuración de célula consta de un gestor de despliegue con uno o más nodos, un servidor web y un cliente de aplicaciones. Todos los puertos se migran hacia la nueva configuración. En este procedimiento se supone que la configuración anterior no está en ejecución.

Avoid trouble Avoid trouble: Asegúrese de que el valor para el número máximo de archivos abiertos sea 10000 o superior. Si el número de archivos abiertos es demasiado bajo, pueden producirse diversos errores de migración. gotcha

Procedimiento

  1. Realice una copia de seguridad del gestor de despliegue y de todos los nodos antiguos.

    En caso de error durante la migración, guarde el gestor de despliegue actual y la configuración de nodo en un archivo que puede utilizar más tarde para fines de recuperación utilizando el mandato backupConfig. Si desea más información, consulte backupConfig (mandato).

    1. Vaya al directorio raíz_perfil_gestor_despliegue/bin.
    2. Ejecute el mandato backupConfig con los parámetros adecuados y guarde la configuración de perfil actual en un archivo. Por ejemplo:
      /QIBM/UserData/WebSphere/AppServer/V7/ND/profiles/v70dmgr01/bin/backupConfig /mybackupdir/
      v70dmgr01backupBeforeV90migration.zip -username myuser -password mypass -nostop
    3. Para cada nodo de la configuración, vaya al directorio raíz_perfil_nodo/bin.
    4. Ejecute el mandato backupConfig con los parámetros adecuados y guarde la configuración de perfil actual en un archivo. Por ejemplo:
      /QIBM/UserData/WebSphere/AppServer/V7/ND/profiles/v70node01/bin/backupConfig 
      /mybackupdir/v70node01rbackupBeforeV90migration.zip -username myuser -password mypass -nostop
  2. Instale WebSphere Application Server Versión 9.0 en cada máquina de destino en un nuevo directorio.

    Para obtener más información, consulte la documentación sobre instalación.

  3. Cree el perfil del gestor de despliegue de destino ejecutando el mandato manageprofiles con los parámetros adecuados.

    El perfil del gestor de despliegue de destino es un perfil del gestor de despliegue nuevo que será el destino de la migración.

    Avoid trouble Avoid trouble: Los valores nombre_nodo y nombre_célula del perfil de la Versión 9.0 deben coincidir con los valores nombre_nodo y nombre_célulaust de la Versión 7.0 o posterior anterior. Si los valores nombre_célula o nombre_nodo del gestor de despliegue de la Versión 9.0 son distintos, la migración fallará. gotcha
    Por ejemplo:
    /QIBM/ProdData/WebSphere/AppServer/V9/ND/bin/manageprofiles -create -profileName 
    currentDmgrProfileName -templatePath /QIBM/ProdData/WebSphere/AppServer/V9/ND/
    profileTemplates/management -serverType DEPLOYMENT_MANAGER -nodeName 
    currentDmgrNodeName -cellName currentCellName -hostName mydmgrhost.company.com
  4. Guarde la configuración del gestor de despliegue actual ejecutando el mandato WASPreUpgrade desde el directorio bin del perfil del gestor de despliegue nuevo.

    El mandato WASPreUpgrade no cambia la configuración de la Versión 7.0 o posterior. Para obtener más información, consulte Mandato WASPreUpgrade.

    Nota: Si está migrando de la Versión 8.0 o posterior a la Versión 9.0 y el perfil es un gestor de despliegue, el perfil de la Versión 8.0 se detiene cuando se ejecuta el mandato WASPreUpgrade. El gestor de despliegue sólo se inicia antes de que WASPreUpgrade finalice si se proporciona -keepDmgrEnabled true en la línea de mandatos o se especifica la opción correspondiente en el asistente de migración.
    1. Ejecute el mandato WASPreUpgrade. Por ejemplo:
      /QIBM/ProdData/WebSphere/AppServer/V9/ND/bin/WASPreUpgrade /mybackup/v70toV90dmgr01 
      /QIBM/UserData/WebSphere/AppServer/V9/ND/profiles/myCurrentDmgrProfile 
    2. Revise los avisos o errores en la salida de la consola y los registros de WASPreUpgrade.

      Cuando el mandato WASPreUpgrade finalice, compruebe si la salida de la consola contiene los mensajes Ha habido errores o Se ha completado con avisos. A continuación, compruebe si los archivos de registro WASPreUpgrade.perfil_antiguo.indicación_fecha_hora.log y WASPreUpgrade.trace contienen avisos o errores.

      Si existen errores, soluciónelos y vuelva a ejecutar el mandato WASPreUpgrade. Compruebe si los avisos afectan a alguna migración u otras actividades en tiempo de ejecución en la Versión 9.0.

      Si el mandato ha finalizado correctamente, no es necesario comprobar si existen errores o avisos en los registros.

  5. Para restaurar la configuración del gestor de despliegue anterior que ha guardado en el directorio de copia de seguridad de migración ejecutando el mandato WASPostUpgrade.

    Si utiliza las opciones que se muestran en el ejemplo siguiente, se incluyen todos los puertos, el gestor de despliegue anterior se concluye y se inhabilita y todas las aplicaciones se instalan.

    Para obtener más información, consulte Mandato WASPostUpgrade.

    1. Ejecute el mandato WASPostUpgrade. Por ejemplo:
      /QIBM/ProdData/WebSphere/AppServer/V9/ND/bin/WASPostUpgrade /mybackup/v70toV90dmgr01 
      -profileName myCurrentDmgrProfile -oldProfile myCurrentDmgrProfile -resolvePortConflicts incrementCurrent 
      -backupConfig TRUE -includeApps TRUE -keepDmgrEnabled FALSE 
      -username myuser -password mypass
      Cuando se crean perfiles, sólo se considera un perfil como perfil predeterminado para cada instalación.

      Puede identificar los perfiles predeterminados buscando en el archivo profileRegistry.xml en el directorio WAS_HOME/properties. El archivo profileRegistry.xml de origen se copia en el directorio de copia de seguridad de migración como parte del mandato WASPreUpgrade.

      Avoid trouble Avoid trouble: Especifique siempre los parámetros -oldProfile y -profileName cuando ejecute el mandato WASPostUpgrade.gotcha
    2. Revise los avisos o errores en la salida de la consola y los registros de WASPostUpgrade. Cuando el mandato WASPostUpgrade finalice, compruebe si la salida de la consola contiene los mensajes Ha habido errores o Se ha completado con avisos. A continuación, compruebe si los archivos de registro dir_copia_seguridad_migración/logs/WASPostUpgrade.nombre_perfil_destino.indicación_fecha_hora.log y dir_copia_seguridad_migración/logs/WASPostUpgrade.nombre_perfil_destino.trace contienen avisos o errores. Si existen errores, soluciónelos y vuelva a ejecutar el mandato WASPostUpgrade. Compruebe si los avisos afectan a alguna migración u otras actividades en tiempo de ejecución en la Versión 9.0.

      Si la configuración se ha migrado correctamente, pero las aplicaciones no se han instalado, puede ejecutar el mandato WASMigrationAppInstaller para instalar sólo las aplicaciones que no se han migrado. Para obtener más información, consulte Mandato WASMigrationAppInstaller.

      Si el mandato ha finalizado correctamente, no es necesario comprobar si existen errores o avisos en los registros.

  6. Realice una copia de seguridad de la configuración del gestor de despliegue de la Versión 9.0 en un archivo ejecutando el mandato backupConfig en el gestor de despliegue de la Versión 9.0.
    Avoid trouble Avoid trouble: Se trata de un paso muy importante en el plan de migración de células. Si hay algún error de migración de nodo, puede restaurar la configuración de célula al punto antes del error y volver a intentar la migración de nodo.gotcha
    1. Vaya al directorio raíz_perfil_gestor_despliegue/bin
    2. Ejecute el mandato backupConfig con los parámetros adecuados. Por ejemplo:
      /QIBM/UserData/WebSphere/AppServer/V9/ND/profiles/myCurrentDmgrProfile/bin/
      backupConfig.sh /mybackupdir/v70toV90dmgr01backupMigratedDmgrOnly.zip 
      -username myuser -password mypass
  7. Inicie el gestor de despliegue de la Versión 9.0.

    Asegúrese de que la versión anterior del gestor de despliegue no está en ejecución.

    1. Vaya al nuevo directorio bin del perfil de gestor de despliegue de la Versión 9.0.
    2. Ejecute el mandato startManager.
    3. Mientras se está ejecutando el gestor de despliegue, consulte si hay avisos o errores en el archivo SystemOut.log.
      Nota: En este tema se hace referencia a uno o más de los archivos de registro del servidor de aplicaciones. Como alternativa recomendada, puede configurar el servidor para utilizar la infraestructura de registro y rastreo HPEL en lugar de utilizar los archivos SystemOut.log , SystemErr.log, trace.log y activity.log en sistemas distribuidos y de IBM® i. Puede también utilizar HPEL junto con sus recursos de registro nativos de z/OS. Si utiliza HPEL, puede acceder a toda la información de registro y rastreo utilizando la herramienta de línea de mandatos LogViewer desde el directorio bin de perfil de servidor. Consulte la información sobre la utilización de HPEL para resolver problemas de aplicaciones para obtener más información sobre la utilización de HPEL.
    4. Consulte todos los registros del agente de nodo y servidor de aplicaciones del nodo, por si hay mensajes de aviso o error. Si la sincronización automática está habilitada, permita que el nodo se sincronice, permita que las aplicaciones se reinicien y, a continuación, compruebe si hay nuevos avisos o errores en los registros.
  8. Migre los plug-ins para servidores web.
    1. Asegúrese de que el gestor de despliegue de la Versión 9.0 esté en ejecución.
    2. Actualice la versión del plug-in del servidor web que se utiliza en la célula.
    3. Consulte la información de soporte que se aplica a su tipo y versión de servidor web.
  9. Migre las instalaciones de cliente de aplicaciones.

    Migre los recursos cliente a los recursos de nivel de la Versión 9.0.

    1. Instale el cliente de aplicaciones WebSphere de la Versión 9.0.

      Para obtener más información, consulte la documentación sobre instalación.

    2. Ejecute el mandato WASPreUpgrade de la Versión 9.0 para guardar los valores de seguridad del cliente de aplicaciones en un directorio de copia de seguridad de migración. Por ejemplo:
      /opt/AppClientV90/bin/WASPreUpgrade.sh /mybackup/v70clientToV90 /opt/AppClientV70
    3. Ejecute el mandato WASPostUpgrade de la Versión 9.0 para restaurar los valores de seguridad del cliente de aplicaciones en el nuevo cliente de la Versión 9.0. Por ejemplo:
      /opt/AppClientV90/bin/WASPostUpgrade.sh /mybackup/v70clientToV90 
  10. Migre los nodos.

    Utilice las herramientas de migración para migrar las versiones anteriores de los nodos de la configuración a la Versión 9.0. Realice el procedimiento siguiente para cada nodo que tiene previsto migrar a la Versión 9.0.

    Avoid trouble Avoid trouble: Debe utilizar el mismo nombre de nodo de origen pero un nombre de célula temporal distinto para cada nodo que migre a la Versión 9.0. gotcha
    1. Asegúrese de que el gestor de despliegue de la Versión 9.0 esté en ejecución.
    2. Cree el perfil de nodo de destino. Ejecute el mandato manageprofiles con los parámetros correspondientes para crear un perfil gestionado nuevo. Por ejemplo:
      /QIBM/ProdData/WebSphere/AppServer/V9/ND/bin/manageprofiles -create 
      -profileName currentNode1Name -templatePath /QIBM/ProdData/WebSphere/AppServer
      /V9/ND/profileTemplates/managed -nodeName currentNode1Name -cellName currentCellName 
      -hostName mynode1host.company.com
    3. Ejecute el mandato WASPreUpgrade para guardar la información de la configuración del nodo actual en un directorio de copia de seguridad de la migración. Elija un directorio nuevo para los archivos de copia de seguridad. Por ejemplo:
      /QIBM/ProdData/WebSphere/AppServer/V9/ND/bin/WASPreUpgrade /mybackup/
      v70toV90node1 /QIBM/UserData/WebSphere/AppServer/V7/ND/profiles/currentNode1Name  
    4. Revise los avisos o errores en la salida de la consola y los registros de WASPreUpgrade.

      Compruebe si la salida de la consola de WASPreUpgrade contiene los mensajes siguientes: Ha habido errores o Se ha completado con avisos.

      Busque en los registros siguientes si hay avisos o errores:
      • dir_copia_seguridad_migración/logs/WASPreUpgrade.perfil_antiguo.indicación_fecha_hora.log
      • dir_copia_seguridad_migración/logs/WASPreUpgrade.trace

      Si el mandato WASPreUpgrade ha finalizado satisfactoriamente, no es necesario comprobar si hay errores o avisos en los registros.

    5. Detenga el agente de nodo. Si tiene nodos de la Versión 7.0 o posterior que se ejecutan durante una migración a la Versión 9.0, debe detener el agente de nodo en el nodo que se está migrando. Si no detiene el agente de nodo, podrían aparecer problemas de corrupción de datos.
    6. Ejecute el mandato WASPostUpgrade para restaurar la configuración de nodo guardada en el nuevo perfil gestionado de la Versión 9.0. Por ejemplo:
      /QIBM/ProdData/WebSphere/AppServer/V9/ND/bin/WASPostUpgrade /mybackup/v70toV90node1 
      -profileName currentNode1Name -oldProfile 70node1 -resolvePortConflicts incrementCurrent 
      -backupConfig TRUE -username myuser -password mypass
    7. Revise los avisos o errores en la salida de la consola y los registros de WASPostUpgrade.

      Busque en la salida de la consola de WASPostUpgrade los mensajes siguientes: Ha habido errores o Se ha completado con avisos.

      Consulte en los archivos de registro siguientes los errores o avisos:
      • dir_copia_seguridad_migración/logs/WASPostUpgrade.perfil_destino.indicación_fecha_hora.log
      • dir_copia_seguridad_migración/logs/WASPostUpgrade.perfil_destino.trace
      Nota: Si el mandato WASPostUpgrade falla, puede que tenga que restaurar el gestor de despliegue de la Versión 9.0 desde el archivo backupConfig. Si el proceso de WASPostUpgrade ha ejecutado el mandato syncNode, el gestor de despliegue sabrá que el nodo se ha migrado. El nodo no se migrará de nuevo hasta que el gestor de despliegue se haya restaurado al estado anterior a la migración del nodo.

      Si la configuración se ha migrado correctamente, pero las aplicaciones no se han instalado, puede ejecutar el mandato WASMigrationAppInstaller para instalar sólo las aplicaciones que no se han migrado. Para obtener más información, consulte Mandato WASMigrationAppInstaller.

      Si el mandato se ha completado satisfactoriamente, no será necesario comprobar los registros de errores o avisos.

    8. Compruebe si en el archivo systemout.log del gestor de despliegue de la Versión 9.0 hay avisos o errores.
      Nota: En este tema se hace referencia a uno o más de los archivos de registro del servidor de aplicaciones. Como alternativa recomendada, puede configurar el servidor para utilizar la infraestructura de registro y rastreo HPEL en lugar de utilizar los archivos SystemOut.log , SystemErr.log, trace.log y activity.log en sistemas distribuidos y de IBM i. Puede también utilizar HPEL junto con sus recursos de registro nativos de z/OS. Si utiliza HPEL, puede acceder a toda la información de registro y rastreo utilizando la herramienta de línea de mandatos LogViewer desde el directorio bin de perfil de servidor. Consulte la información sobre la utilización de HPEL para resolver problemas de aplicaciones para obtener más información sobre la utilización de HPEL.
    9. Inicie el agente de nodos migrado de la Versión 9.0.
    10. Compruebe el archivo SystemOut.log del gestor de despliegue y del nodo de la Versión 9.0 los avisos o errores.
    11. Sincronice la célula.
    12. Detenga todos los servidores de aplicaciones en el nodos migrado de la Versión 9.0.
    13. Inicie los servidores de aplicaciones adecuados en el nodo migrado de la Versión 9.0.
    14. Guarde la configuración del perfil de la Versión 9.0 en un archivo ejecutando el mandato backupConfig con los parámetros adecuados. Por ejemplo:
      /QIBM/UserData/WebSphere/AppServer/V9/profiles/v70toV90node1/bin/backupConfig 
      /mybackupdir/v70toV90node1.zip -username myuser -password mypass -nostop  
      Cada vez que ejecute el mandato backupConfig, utilice un nuevo nombre de archivo de copia de seguridad.
    15. Guarde la configuración del gestor de despliegue en un archivo ejecutando el mandato backupConfig con los parámetros adecuados. Antes de ejecutar el mandato, cambie al directorio raíz_perfil_gestor_despliegue/bin en el host del gestor de despliegue de la Versión 9.0.
      Nota: Para cada nodo migrado, realice una copia de seguridad de la configuración del gestor de despliegue de Versión 9.0 en un archivo de copia de seguridad nuevo.
      Por ejemplo:
      /QIBM/UserData/WebSphere/AppServer/V9/profiles/currentDmgrName/bin/
      backupConfig.sh /mybackupdir/v70toV90dmgr01backupMigratedDmgrPlusNodeX.zip 
      -username myuser -password mypass

Resultados

Ha realizado una migración desde una versión anterior a WebSphere Application Server Versión 9.0 utilizando las herramientas de migración.


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-iseries&topic=tmig_migrate_cells_commandline
File name: tmig_migrate_cells_commandline.html