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í.
Autorización
Para ejecutar este script de mandatos, el perfil de usuario debe tener autorización *ALLOBJ.
Sintaxis
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:
- 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: 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.
- 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. 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.
- É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. - É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.
- É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.
- É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.
- É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.
- É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.
- É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
- 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).
- 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.