Mandato WASPreUpgrade

Ubicación

El archivo de comandos se encuentra en el directorio «Version 9.0app_server_root/bin » y debe ejecutarse desde allí.

Sintaxis

WASPreUpgrade.sh backupDirectory 
                 currentWebSphereDirectory
                 [-properties properties_file_name]
                 [-traceString trace_spec [-traceFile file_name ]]
                 [-machineChange true | false]
                 [-oldProfile profile_name]
                 [-workspaceRoot profile1=user_workspace_folder_name_1;profile2=user_workspace_folder_name_2]
                 [-username < user name >]
                 [-password < password >]
                 [-javaoption < -Xms...m > -javaoption < -Xmx...m > ]
                 [-requireEmbeddedDBMigration true | false]
                 [-keepDmgrEnabled true | false]
                 [-allowSameRelease < true | false >]

WASPreUpgrade.bat backupDirectory 
                  currentWebSphereDirectory
                  [-properties properties_file_name]
                  [-traceString trace_spec [-traceFile file_name ]]
                  [-machineChange true | false]
                  [-oldProfile profile_name]
                  [-workspaceRoot profile1=user_workspace_folder_name_1;profile2=user_workspace_folder_name_2]
                  [-username < user name >]
                  [-password < password >]
                  [-javaoption < -Xms...m > -javaoption < -Xmx...m > ]
                  [-requireEmbeddedDBMigration true | false]
                  [-keepDmgrEnabled true | false]
                  [-allowSameRelease < 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.

Evita problemas: los WAS_INSTALL directorios raíz y USER_INSTALL no son válidos como ubicación para el directorio de copias de seguridad de WebSphere Application Server.

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.

currentWebSphereDirectory

Este es un parámetro necesario y debe ser el segundo parámetro que especifique. Puede tratarse de cualquier edición de « WebSphere Application Server » (versión 7.0 o posterior) para la que se admita la migración.

El valor « currentWebSphereDirectory » especifica el nombre del directorio raíz de instalación para la instalación de «source WebSphere Application Server ».

-propiedades

Este parámetro es 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 se pueden especificar en el archivo de propiedades, como el -properties propio parámetro y -username y -password. Para ver una lista de los parámetros que no se pueden definir como propiedad, consulta el archivo de plantilla migration.properties en el app_server_root/bin directorio.

-traceString

Este parámetro es opcional. El valor especificación_rastreo 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 predeterminado y lo coloca en el directorio directorio_copia_seguridad/logs.

-traceFile

Este parámetro es 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 predeterminado y lo coloca en el directorio directorio_copia_seguridad/logs.

-machineChange

Este parámetro opcional se utiliza para una migración que implique cruzar límites de sistema operativo y de máquina. Si se establece en «true», este parámetro permite cambiar el hardware físico durante la migración, ya que realiza una copia de seguridad de los elementos almacenados fuera de la jerarquía de carpetas de instalación o de perfiles de WebSphere Application Server. Si se establece en «false», durante la migración solo se copiarán al directorio de copia de seguridad los archivos almacenados en la carpeta de instalación de WebSphere Application Server o en las carpetas de perfil.

El valor predeterminado es false.

Cuando este valor es «false», la migración da por hecho que las instalaciones nuevas y antiguas de WebSphere Application Server se encuentran en el mismo equipo físico y comparten acceso al sistema de archivos. Por lo tanto, los archivos ubicados fuera de los directorios de WebSphere son comunes y se pueden compartir. La migración no copia los archivos que se encuentran fuera del árbol « WebSphere Application Server » al directorio de copia de seguridad cuando la opción « -machineChange » está desactivada. 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 seleccionas « -machineChange=true, », la migración creará un subdirectorio adicional (/migrated/) en el directorio de copias de seguridad de la migración que contenga cualquier archivo al que haga referencia la configuración de « WebSphere Application Server » y que se encuentre fuera de los directorios del producto o del perfil. Cuando ejecute el mandato WASPostUpgrade, estos archivos se devolverán a sus vías de acceso originales en la máquina nueva.

Aspectos relacionados con el 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 está ejecutando la migración, se realiza una copia de seguridad de todos los almacenes de archivos que se encuentran en el árbol « 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.

-oldProfile

Este es un parámetro opcional que se utiliza para migrar una instancia o un perfil concreto desde una versión anterior de WebSphere Application Server.

-workspaceRoot

Este parámetro es 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

Este parámetro es opcional. El valor «nombre de usuario» indica 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 está realizando la migración es la versión 8.0 o posterior.

-password

Este parámetro es opcional. El valor «password» indica la contraseña de administrador 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 está realizando la migración es la versión 8.0 o posterior.

-javaoption

Este parámetro es opcional. Utiliza este parámetro para especificar los tamaños de memoria del montón de Java™ que utiliza el WASPreUpgrade comando.

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 desea utilizar. 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.

-keepDmgrEnabled

Este es un parámetro opcional que se utiliza para migrar un perfil de gestor de despliegue.

Cuando se ejecuta WASPreUpgrade, los perfiles de gestor de despliegue 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.

-allowSameRelease

Este parámetro es opcional. Cuando este parámetro se establece en true, es posible migrar un perfil de WebSphere Application Server (versión 9.0 ) de una instalación de WebSphere Application Server (versión 9.0 ) a otra, incluso a una instalación en un equipo diferente. Cuando el -allowSameRelease parámetro se establece en true, el -clone parámetro del WASPostUpgrade comando debe establecerse en true.

Registro

La herramienta WASPreUpgrade muestra el estado en la pantalla mientras se ejecuta. La herramienta también guarda un conjunto más amplio de información de registro en el WASPreUpgrade.time_stamp.log archivo que se guarda en el backupDirectory directorio, donde « backupDirectory » es el valor especificado para el parámetro « backupDirectory ». Puedes abrir el WASPreUpgrade.time_stamp.log archivo con un editor de texto.

Recursos migrados

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