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

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.
sptcfgRevise la información sobre planificación de la migración en Knowledge Collection: Migration planning for WebSphere Application Server.
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.

Procedimiento
- 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).
- Vaya al directorio raíz_perfil_gestor_despliegue/bin.
- 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
- Para cada nodo de la configuración, vaya al directorio raíz_perfil_nodo/bin.
- 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
- 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.
- 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.
Por ejemplo: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
/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
- 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.- Ejecute el mandato WASPreUpgrade. Por ejemplo:
/QIBM/ProdData/WebSphere/AppServer/V9/ND/bin/WASPreUpgrade /mybackup/v70toV90dmgr01 /QIBM/UserData/WebSphere/AppServer/V9/ND/profiles/myCurrentDmgrProfile
- 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.
- Ejecute el mandato WASPreUpgrade. Por ejemplo:
- 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.
- Ejecute el mandato WASPostUpgrade. Por ejemplo:
Cuando se crean perfiles, sólo se considera un perfil como perfil predeterminado para cada instalación./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
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: Especifique siempre los parámetros -oldProfile y -profileName cuando ejecute el mandato WASPostUpgrade.gotcha
- 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.
- Ejecute el mandato WASPostUpgrade. Por ejemplo:
- 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: 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
- Vaya al directorio raíz_perfil_gestor_despliegue/bin
- 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
- 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.
- Vaya al nuevo directorio bin del perfil de gestor de despliegue de la Versión 9.0.
- Ejecute el mandato startManager.
- 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.
- 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.
- Migre los plug-ins para servidores web.
- Asegúrese de que el gestor de despliegue de la Versión 9.0 esté en ejecución.
- Actualice la versión del plug-in del servidor web que se utiliza en la célula.
- Consulte la información de soporte que se aplica a su tipo y versión de servidor web.
- Migre las instalaciones de cliente de aplicaciones.
Migre los recursos cliente a los recursos de nivel de la Versión 9.0.
- 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.
- 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
- 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
- Instale el cliente de aplicaciones WebSphere de la Versión 9.0.
- 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: 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
- Asegúrese de que el gestor de despliegue de la Versión 9.0 esté en ejecución.
- 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
- 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
- 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.
- 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.
- 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
- 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.
- 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.
- Inicie el agente de nodos migrado de la Versión 9.0.
- Compruebe el archivo SystemOut.log del gestor de despliegue y del nodo de la Versión 9.0 los avisos o errores.
- Sincronice la célula.
- Detenga todos los servidores de aplicaciones en el nodos migrado de la Versión 9.0.
- Inicie los servidores de aplicaciones adecuados en el nodo migrado de la Versión 9.0.
- 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:
Cada vez que ejecute el mandato backupConfig, utilice un nuevo nombre de archivo de copia de seguridad./QIBM/UserData/WebSphere/AppServer/V9/profiles/v70toV90node1/bin/backupConfig /mybackupdir/v70toV90node1.zip -username myuser -password mypass -nostop
- 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.


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