Migración de un perfil de agente administrativo y su conjunto registrado de servidores de aplicaciones base gestionados

Los perfiles del agente administrativo gestionan varios servidores de aplicaciones base en entornos tales como desarrollo, prueba de unidades o la parte de un grupo de servidores que reside en una sola máquina. Antes de poder migrar servidores de aplicaciones base gestionados de la Versión 7.0 o posterior a la Versión 9.0, primero debe migrar el agente administrativo.

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 de planificación de la migración. Consulte 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

Un servidor de aplicaciones base se convierte en gestionado cuando se registra con un único agente administrativo. Un agente administrativo puede gestionar uno o más servidores de aplicaciones base y tener el mismo nivel de release y hacerlo en la misma máquina que los servidores de aplicaciones base que esté gestionando. Debido a esta restricción, los agentes administrativos tanto en el release nuevo como en el antiguo se ejecutan simultáneamente hasta que todos los servidores de aplicaciones base administrados se hayan migrado. La migración de un agente administrativo no muestra sus valores de puerto antiguos, sin embargo, se migran todos los demás datos de configuración.

Acceda a la consola del agente administrativo de Versión 9.0 utilizando los puertos seguros WC_ adminhost o WC_ adminhost_ como se define en el nuevo archivo serverindex.xml del agente administrativo de la Versión 9.0. Además, el agente administrativo de la Versión 7.0 o posterior no debe estar apagado o inhabilitado durante este procedimiento.

Cuando migre el servidor de aplicaciones base gestionado en un entorno de gestión flexible, asegúrese de que los nombres de nodo son los mismos en Versión 9.0 y en los releases anteriores.

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. Instale WebSphere Application Server Versión 9.0 en el host de destino en directorio nuevo.

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

  2. Cree un perfil de agente administrativo de la Versión 9.0 que será el destino de la migración del agente administrativo.

    Ejecute el mandato manageprofiles con los parámetros adecuados para crear un nuevo perfil de agente administrativo.

    Por ejemplo:
    C:\WebSphere\AppServer90\bin>manageprofiles.bat -create -profileName AdminAgent01 -profilePath 
    C:\WebSphere\AppServer90\profiles\AdminAgent01 -templatePath C:\WebSphere\AppServer90\profileTemplates\management 
    -serverType ADMIN_AGENT -nodeName AdminAgentNode01 -cellName AdminAgentCell01 -hostName <myhostname>
  3. Asegúrese de que todos los trabajos en curso se hayan completado en los perfiles gestionados.
  4. Detenga el sondeo del gestor de trabajos en los perfiles que están obteniendo trabajos del gestor de trabajos.

    Antes de iniciar el sondeo para trabajos, complete WASPreUpgrade y WASPostUpgrade para el perfil gestionado. Para obtener más información, consulte Grupo de mandatos ManagedNodeAgent para el objeto AdminTask utilizando scripts wsadmin.

  5. Guarde la configuración del agente administrativo actual en el directorio de copia de seguridad de migración ejecutando el mandato WASPreUpgrade desde el nuevo directorio bin de la raíz de instalación de WebSphere Application Server.

    El mandato WASPreUpgrade no realiza ningún cambio en la configuración antigua.

    1. Ejecute el mandato WASPreUpgrade.

      Para obtener información sobre los parámetros de mandato, consulte Mandato WASPreUpgrade.

      Por ejemplo:
      C:\WebSphere\AppServer90\bin>WASPreUpgrade.bat C:\WAS70AdminAgentbackup C:\WebSphere\AppServer70 -oldProfile AdminAgent01 
      -traceString *=all=enabled -tracefile C:\WAS70AdminAgentbackup\logs\WASPreMigrationSummary.log
    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 siguientes contienen avisos o errores:
      • dir_copia_seguridad_migración/logs/WASPreMigrationSummary.log
      • WASPreUpgrade.indicación_fecha_hora.log
      • WASPreUpgrade.trace

      Si hay errores, corrija los errores 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.

  6. Restaure la configuración del agente administrativo anterior ejecutando el mandato WASPostUpgrade desde el nuevo directorio bin de la raíz de instalación de WebSphere Application Server.
    1. Ejecute el mandato WASPostUpgrade para restaurar la configuración del agente administrativo guardada en el nuevo perfil de agente administrativo de la Versión 9.0. Por ejemplo:
      C:\IBM\WebSphere\AppServer90\bin>WASPostUpgrade.bat C:\WAS70AdminAgentbackup -oldProfile AdminAgent01 -profileName AdminAgent01 
      -traceString *=all=enabled -tracefile C:\WAS70AdminAgentbackup\logs\WASPostMigrationSummary.log -username myuser -password mypass
    2. Compruebe si hay 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 siguientes contienen avisos o errores:
      • dir_copia_seguridad_migración/logs/WASPostMigrationSummary.log
      • WASPostUpgrade.nombre_perfil_destino.indicación_fecha_hora.log
      • WASPostUpgrade.nombre_perfil_destino.trace

      Si hay errores, corrija los errores 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 el mandato ha finalizado correctamente, no es necesario comprobar si existen errores o avisos en los registros.

  7. Inicie el agente administrativo de la Versión 9.0 y asegúrese de que se estén ejecutando los agentes administrativos de la Versión 7.0 o posterior y la Versión 9.0.
    1. Vaya al nuevo directorio bin del perfil de agente administrativo de la Versión 9.0.
    2. Ejecute el mandato startServer adminagent.
    3. Compruebe si el archivo SystemOut.log contiene 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.
  8. Migre los servidores de aplicaciones base gestionados.
    Avoid trouble Avoid trouble: Para que la migración sea satisfactoria:
    • Los servidores de aplicaciones base administrados deben estar en la misma máquina que el agente administrativo asociado.
    • Los nombres de nodo deben ser los mismos en Versión 9.0 y en releases anteriores.
    • [Windows]Detenga el servidor AppSrv antes de ejecutar una migración si tiene una plataforma Windows y tiene previsto migrar un componente SIB.
    gotcha

    Para cada servidor de aplicaciones base gestionado que vaya a migrar a Versión 9.0, realice los pasos siguientes:

    1. Cree el perfil del servidor de aplicaciones base de destino. Ejecute el mandato manageprofiles con los parámetros correspondientes para crear un perfil gestionado nuevo. Por ejemplo:
      C:\WebSphere\AppServer90\bin>manageprofiles.bat -create -profileName AppSrv01 
      -profilePath C:\WebSphere\AppServer90\profiles\AppSrv01
      -templatePath C:\WebSphere\AppServer90\profileTemplates\default 
      -serverType APPLICATION_SERVER -nodeName AppSrv01Node01 
      -cellName AppSrv01Cell01 -hostName <myhostname>
    2. Ejecute el mandato WASPreUpgrade para guardar la información del servidor de aplicaciones base gestionado actual en un directorio de copia de seguridad de migración. Elija un directorio nuevo para los archivos de copia de seguridad. Por ejemplo:
      C:\WebSphere\AppServer90\bin>WASPreUpgrade.bat C:\WAS70Appserver01backup 
      C:\WebSphere\AppServer70 -oldProfile Appserver01 -traceString *=all=enabled 
      -summaryLogName C:\WAS70Appserver01backup\logs\WASPreMigrationSummary.log
    3. 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 siguientes contienen avisos o errores:
      • dir_copia_seguridad_migración/logs/WASPreMigrationSummary.log
      • WASPreUpgrade.indicación_fecha_hora.log
      • WASPreUpgrade.trace

      Si hay errores, corrija los errores 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.

    4. Ejecute el mandato WASPostUpgrade para restaurar la configuración del perfil de servidor de aplicaciones gestionado actual en el nuevo perfil de servidor de aplicaciones base de la Versión 9.0.
      Avoid trouble Avoid trouble: Este mandato requiere parámetros adicionales y en el siguiente ejemplo se supone que está habilitada la seguridad en los agentes administrativos. gotcha
      Por ejemplo:
      C:\IBM\WebSphere\AppServer90\bin>WASPostUpgrade.bat C:\WAS70Appserver01backup 
      -oldProfile AppSrv01 -profileName AppSrv01 -traceString *=all=enabled 
      -summaryLogName C:\WAS70Appserver01backup\logs\WASPostMigrationSummary.log 
      -oldAdminAgentProfilePath C:\WebSphere\Appserver70\profiles\AdminAgent01
      -oldAdminAgentHostname myhostname -oldAdminAgentSoapPort 8879 -oldAdminAgentUsername 
      myusername -oldAdminAgentPassword mypassword -newAdminAgentProfilePath 
      C:\WebSphere\AppServer90\profiles\AdminAgent01 -newAdminAgentHostname 
      myhostname -newAdminAgentSoapPort 8887 -newAdminAgentUsername 
      myusername1 -newAdminAgentPassword mypassword1
    5. Compruebe si hay 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 siguientes contienen avisos o errores:
      • dir_copia_seguridad_migración/logs/WASPostMigrationSummary.log
      • WASPostUpgrade.nombre_perfil_destino.indicación_fecha_hora.log
      • WASPostUpgrade.nombre_perfil_destino.trace

      Si hay errores, corrija los errores 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 el mandato ha finalizado correctamente, no es necesario comprobar si existen errores o avisos en los registros.

    6. Inicie el servidor de aplicaciones gestionado migrado de Versión 9.0.
    7. Compruebe si el archivo SystemOut.log del servidor de aplicaciones gestionado de la Versión 9.0 contiene 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.

Resultados

Ha migrado un perfil de agente administrativo y sus servidores de aplicaciones base gestionados asociados de WebSphere Application Server Versión 7.0 o posterior a la Versión 9.0 utilizando las herramientas de migración. Puede detener el agente administrativo de la Versión 7.0 o posterior y puede asignar los puertos de la Versión 7.0 o posterior al agente administrativo de la Versión 9.0.


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