[AIX Solaris HP-UX Linux Windows][IBM i]

Mandato WASPreUpgrade

El mandato WASPreUpgrade para WebSphere Application Server Versión 9.0 guarda la configuración de una versión instalada anteriormente de WebSphere Application Server en un directorio de copia de seguridad específico de migración.

Ubicación

El archivo de mandatos se encuentra en el directorio Versión 9.0 raíz_servidor_apl/bin y debe ejecutarse desde allí.

[IBM i]

Autorización

Para ejecutar este script de mandatos, el perfil de usuario debe tener autorización *ALLOBJ.

Sintaxis

[AIX][HP-UX][Linux][Solaris]
WASPreUpgrade.sh directorio_copia_seguridad
                 directorio_WebSphere_actual
                 [-properties nombre_archivo_propiedades]
                 [-traceString especificación_rastreo  [-traceFile nombre_archivo]]
                 [-machineChange true | false]
                 [-oldProfile nombre_perfil]
                 [-workspaceRoot profile1=nombre_carpeta_espacio_trabajo_usuario_1;profile2=nombre_carpeta_espacio_trabajo_usuario_2]
                 [-username < nombre de usuario >]
                 [-password < contraseña >]
                 [-javaoption < -Xms...m > -javaoption < -Xmx...m > ]                 [-requireEmbeddedDBMigration true | false]
                 [-keepDmgrEnabled true | false]
[Windows]
WASPreUpgrade.bat directorio_copia_seguridad
                  directorio_WebSphere_actual
                  [-properties nombre_archivo_propiedades]
                  [-traceString especificación_rastreo  [-traceFile nombre_archivo]]
                  [-machineChange true | false]
                  [-oldProfile nombre_perfil]
                  [-workspaceRoot profile1=nombre_carpeta_espacio_trabajo_usuario_1;profile2=nombre_carpeta_espacio_trabajo_usuario_2]
                  [-username < nombre de usuario >]
                  [-password < contraseña >]
                  [-javaoption < -Xms...m > -javaoption < -Xmx...m > ]                  [-requireEmbeddedDBMigration true | false]
                  [-keepDmgrEnabled true | false]
[IBM i]
WASPreUpgrade directorio_copia_seguridad
              directorio_WebSphere_actual
              [-properties nombre_archivo_propiedades]
              [-traceString especificación_rastreo  [-traceFile nombre_archivo]]
              [-workspaceRoot profile1=nombre_carpeta_espacio_trabajo_usuario_1;profile2=nombre_carpeta_espacio_trabajo_usuario_2]
              [-username < nombre de usuario >]
              [-password < contraseña >]
              [-javaoption < -Xms...m > -javaoption < -Xmx...m > ]              [-requireEmbeddedDBMigration true | false]
              [-keepDmgrEnabled true | false]

Parámetros

El mandato tiene los parámetros siguientes:

backupDirectory
Este es un parámetro necesario y debe ser el primer parámetro que especifique. El valor directorio_copia_seguridad especifica el nombre del directorio en el que el script de mandatos almacena la configuración guardada.
Avoid trouble Avoid trouble: Los directorios raíz WAS_INSTALL y USER_INSTALL no son directorios válidos para la ubicación del directorio de copia de seguridad de WebSphere Application Server.gotcha

Este es también el directorio desde el que el mandato WASPostUpgrade lee la configuración.

Si el directorio no existe, el script de mandatos WASPreUpgrade lo crea.

directorio_WebSphere_actual
Este es un parámetro necesario y debe ser el segundo parámetro que especifique. Esta puede ser cualquier edición de WebSphere Application Server Versión 7.0 o posterior para la que se admita la migración.

[AIX Solaris HP-UX Linux Windows]El valor directorio_WebSphere_actual especifica el nombre del directorio raíz de instalación para la instalación de origen de WebSphere Application Server.

[IBM i]El valor directorio_WebSphere_actual especifica el nombre del directorio raíz de la instancia o perfil para el perfil de la Versión 7.0 o posterior o la instancia de origen de WebSphere Application Server que desea migrar.
  • La raíz del perfil puede ser un valor exclusivo seleccionado durante la creación del perfil, pero los directorios siguientes son los valores predeterminados:
    • Para la versión 7.0 (base): /QIBM/UserData/WebSphere/AppServer/V7/Base/profiles/profile
    • Para la versión 7.0 WebSphere Application Server, Network Deployment: /QIBM/UserData/WebSphere/AppServer/V7/ND/profiles/perfil
[AIX Solaris HP-UX Linux Windows][IBM i]-properties
[AIX Solaris HP-UX Linux Windows][IBM i]Éste es un parámetro opcional. El valor nombre_archivo_propiedades especifica la vía de acceso de un archivo de propiedades que contiene propiedades de parámetros que definen cómo operan las herramientas de migración como WASPreUpgrade.

Puede definir propiedades de parámetro en el archivo de propiedades de migración, en lugar de especificar la mayoría de parámetros opcionales en la línea de mandatos. Si los parámetros se definen en el archivo de propiedades y se especifican en la línea de mandatos, los parámetros especificados en la línea de mandatos tienen prioridad.

Nota: Algunos parámetros no pueden especificarse en el archivo de propiedades, por ejemplo, los parámetros -properties, -username y -password. Para ver una lista de los parámetros que no pueden definirse como una propiedad, consulte el archivo de plantilla migration.properties en el directorio raíz_servidor_aplicaciones/bin.
-traceString
Éste es un parámetro opcional. El valor trace_spec especifica la información de rastreo que desea recopilar.

Para recopilar toda la información de rastreo, especifique "*=all=enabled" (con comillas).

Si no especifica el parámetro -traceString o -traceFile, el mandato crea un archivo de rastreo por omisión y lo coloca en el directorio directorio_copia_seguridad/logs.

-traceFile
Éste es un parámetro opcional. El valor nombre_archivo especifica el nombre del archivo de salida para la información de rastreo.

Si no especifica el parámetro -traceString o -traceFile, el mandato crea un archivo de rastreo por omisión y lo coloca en el directorio directorio_copia_seguridad/logs.

[AIX Solaris HP-UX Linux Windows]-machineChange
[AIX Solaris HP-UX Linux Windows]Este parámetro opcional se utiliza para una migración que implique cruzar límites de sistema operativo y de máquina. Si se especifica como verdadero (true), este parámetro proporciona soporte para cambiar hardware físico al migrar mediante la realización de una copia de seguridad de elementos que se almacenan fuera de la jerarquía de carpetas de perfil o instalación de WebSphere Application Server. Si se especifica como falso (false), sólo los archivos almacenados bajo la carpeta de instalación o las carpetas de perfil de WebSphere Application Server se copiarán en el directorio de copia de seguridad durante la migración.

El valor por omisión es false.

Cuando el valor es false (falso), la migración da por supuesto que las instalaciones nueva y antigua de WebSphere Application Server están en la misma máquina física con acceso compartido al sistema de archivos. Por lo tanto, los archivos ubicados fuera de los directorios WebSphere son comunes y se pueden compartir. La migración no copia archivos fuera del árbol de WebSphere Application Server en el directorio de copia de seguridad cuando -machineChange es false. [AIX Solaris HP-UX Linux Windows]False es la única opción cuando se utiliza el asistente de migración. Si selecciona -machineChange=false, debe ejecutar el mandato WASPostUpgrade en el mismo hardware físico.

Si pretende ejecutar el mandato WASPostUpgrade en una máquina distinta o en un sistema de archivos distinto, debería ejecutar el mandato WASPreUpgrade con -machineChange=true. Si selecciona -machineChange=true, la migración crea un subdirectorio adicional (/migrated/) en el directorio de copia de seguridad de la migración que contiene todos los archivos a los que hace referencia la configuración de WebSphere Application Server que reside fuera del producto o de los directorios del perfil. Cuando ejecute el mandato WASPostUpgrade, estos archivos se devolverán a sus vías de acceso originales en la máquina nueva.

Consideraciones de rendimiento:

Si realiza la migración con buses SIB (Service Integration Bus) configurados con repositorios de almacenamiento de archivos del sistema de archivos, puede que necesite más espacio en el directorio de almacenamiento dinámico de la migración y de copia de seguridad de la migración. Cada bus tiene tres valores de almacén de archivos: un registro, un espacio temporal y un repositorio. Estos tres archivos varían en cuanto al tamaño pero pueden tener entre 100 y 500 MB cada uno. Cuando se ejecuta la migración, realiza una copia de seguridad de los almacenes de archivos que haya en el árbol de WebSphere Application Server durante el proceso previo a la actualización. Tiene que haber espacio suficiente en el sistema de archivos para que permita esta acción. Si el almacén de archivos existe en la ubicación de destino ya durante el proceso posterior a la actualización, la migración realizar una copia de seguridad de los almacenes de archivos en la memoria para dar soporte a la acción de retrotracción.

Si ejecuta el mandato WASPreUpgrade con -machineChange=true, lo que provoca la existencia de un directorio de copia de seguridad que contiene objetos de almacén de archivos compartidos, es posible que encuentre que el proceso posterior a la actualización genera excepciones de memoria agotada porque el almacenamiento dinámico máximo predeterminado es demasiado pequeño para contener las copias de seguridad del almacén de archivos en el soporte de la retrotracción. Para resolver este problema, lleve a cabo una de estas tres tareas:
  • Si los almacenes de archivos de la ubicación del sistema son válidos, suprima las copias del directorio de copia de seguridad antes de ejecutar el mandato WASPostUpgrade.

    Al suprimir todo el subdirectorio /migrated/ del directorio de copia de seguridad de la migración antes de ejecutar el mandato WASPostUpgrade, convierte esencialmente la copia de seguridad previa a la actualización de -machineChange=true en -machineChange=false.

  • Si las copias de los almacenes de archivos del directorio de copia de seguridad son válidas, suprima las versiones de la ubicación de destino.

    De este modo cambia el soporte de retrotracción para que no existan archivos de destino y no ocupen espacio en memoria durante la migración.

  • Si necesita soporte de retrotracción y debe tener ambos archivos en el directorio de copia de seguridad así como los archivos del sistema de archivos, aumente el tamaño de almacenamiento dinámico máximo para el proceso posterior a la actualización en un valor que sea suficientemente grande para que dé soporte a todos los archivos SIB que entran en conflicto.
[AIX Solaris HP-UX Linux Windows]-oldProfile
[AIX Solaris HP-UX Linux Windows]Este parámetro opcional se utiliza para migrar una instancia o un perfil específicos de una versión anterior de WebSphere Application Server.
-workspaceRoot
Éste es un parámetro opcional. El valor nombre_carpeta_espacio_trabajo_usuario_x especifica la ubicación de los valores "Mis tareas" personalizados de la consola administrativa para uno o más perfiles.
-username
Éste es un parámetro opcional. El valor nombre de usuario especifica el nombre de usuario administrativo de la instalación actual de WebSphere Application Server.
Este parámetro es necesario si se cumplen las condiciones siguientes:
  • Está migrando un gestor de despliegue.
  • La seguridad administrativa o global está habilitada en la instalación de origen.
  • La instalación de WebSphere Application Server desde la que migra es la Versión 8.0 o superior.
-password
Éste es un parámetro opcional. El valor contraseña especifica la contraseña administrativa de la instalación actual de WebSphere Application Server.
Este parámetro es necesario si se cumplen las condiciones siguientes:
  • Está migrando un gestor de despliegue.
  • La seguridad administrativa o global está habilitada en la instalación de origen.
  • La instalación de WebSphere Application Server desde la que migra es la Versión 8.0 o superior.
-javaoption
Éste es un parámetro opcional. Utilice este parámetro para especificar tamaños de memoria para el almacenamiento dinámico Java™ utilizado por WASPreUpgrade.

El valor "-Xms...m" es el parámetro especificado para indicar el tamaño de almacenamiento dinámico inicial. Sustituya "..." por el tamaño en megabytes que necesite. Por ejemplo, si el tamaño de almacenamiento dinámico inicial es de 128 MB, especifique el parámetro como: -javaoption -Xms128m

El valor "-Xmx...m" es el parámetro especificado para indicar el tamaño de almacenamiento dinámico máximo. Sustituya "..." por el tamaño en megabytes que necesite. Por ejemplo, si el tamaño de almacenamiento dinámico máximo es de 1024 MB, especifique el parámetro como: -javaoption -Xmx1024m

-requireEmbeddedDBMigration
Es un parámetro opcional para migrar bases de datos incluidas.

Si el valor se especifica como true, cualquier excepción que ocurra cuando migra las bases de datos incluidas hace que el mandato WASPreUpgrade falle. Si el valor se especifica como false, cualquier excepción que ocurra cuando migra las bases de datos incluidas se registra en el archivo de rastreo y el mandato WASPreUpgrade continúa.

El valor predeterminado es true (verdadero).

-keepDmgrEnabled
Es un parámetro opcional que se utiliza para migrar un perfil de gestor de despliegue de la Versión 8.0.

Cuando se ejecuta WASPreUpgrade, los perfiles de gestor de despliegue de la Versión 8.0 se detienen. De forma predeterminada, el gestor de despliegue permanece detenido. Si el valor se especifica como true, WASPreUpgrade inicia el gestor de despliegue antes de que el mandato termine de ejecutarse.

El valor predeterminado es false.

Anotaciones cronológicas

La herramienta WASPreUpgrade muestra el estado en la pantalla mientras se ejecuta. Esta herramienta también guarda una información más amplia de la información de las anotaciones cronológicas en el archivo WASPreUpgrade.indicación_hora.log que se guarda en el directorio directorio_copia_seguridad, donde directorio_copia_seguridad es el valor especificado para el parámetro backupDirectory. Puede ver el archivo WASPreUpgrade.indicación_hora.log con un editor de texto.

Recursos migrados

WASPreUpgrade guarda todos los recursos pero no migra las entidades al directorio classes.

La migración guarda los archivos siguientes en el directorio directorio_copia_seguridad.
  • [AIX Solaris HP-UX Linux Windows]classes
  • config
  • properties

Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rmig_WASPreUpgrade
File name: rmig_WASPreUpgrade.html