Mandato WASPostUpgrade
El mandato WASPostUpgrade de WebSphere Application Server recupera la configuración guardad que ha creado el mandato WASPreUpgrade desde el directorio de copia de seguridad que haya especificado. El script WASPostUpgrade para la Versión 9.0 de WebSphere Application Server lee la configuración de este directorio para migrar a la Versión 9.0 de WebSphere Application Server y añade todas las aplicaciones migradas al directorio raíz_servidor_aplic/installedApps para la instalación de la Versión 9.0.
Ubicación

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.
sptcfgEl archivo de mandatos se encuentra en el directorio raíz_servidor_aplicaciones/bin y se debe ejecutar desde este directorio.
Sintaxis
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
WASPostUpgrade.sh directorio_copia_seguridad
[-properties nombre_archivo_propiedades]
[-username ID_usuario]
[-password contraseña]
[-oldProfile nombre_perfil]
[-profileName nombre_perfil]
[-setPorts useOld | generateNew |
número_puerto_inicio]
[-resolvePortConflicts incrementCurrent |
número_puerto_inicio]
[-backupConfig true | false]
[-includeApps true | false | script]
[-clone true | false]
[-newDmgrHostname nombre_host]
[[-newDmgrSoapPort número_puerto] | [-newDmgrRmiPort número_puerto]]
[-keepDmgrEnabled true | false]
[-requestTimeout segundos]
[-javaoption -Xms...m -javaoption -Xmx...m]
[[-appInstallDirectory directorio_especificado_usuario] | [-keepAppDirectory true | false]]
[-traceString especificación_rastreo [-traceFile nombre_archivo]]
![[Windows]](../images/windows.gif)
WASPostUpgrade.bat directorio_copia_seguridad
[-properties nombre_archivo_propiedades]
[-username ID_usuario]
[-password contraseña]
[-oldProfile nombre_perfil]
[-profileName nombre_perfil]
[-setPorts useOld | generateNew | número_puerto_inicio]
[-resolvePortConflicts incrementCurrent | número_puerto_inicio]
[-backupConfig true | false]
[-includeApps true | false | script]
[-clone true | false]
[-newDmgrHostname nombre_host]
[[-newDmgrSoapPort número_puerto] | [-newDmgrRmiPort número_puerto]]
[-keepDmgrEnabled true | false]
[-requestTimeout segundos]
[-javaoption -Xms...m -javaoption -Xmx...m]
[[-appInstallDirectory directorio_especificado_usuario] | [-keepAppDirectory true | false]]
[-traceString especificación_rastreo [-traceFile nombre_archivo]]
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
WASPostUpgrade.sh directorio_copia_seguridad
[-oldAdminAgentProfilePath vía de acceso al antiguo agente administrativo]
[-oldAdminAgentSoapPort puerto de soap del antiguo agente administrativo]
[-oldAdminAgentHostname nombre de host del antiguo agente administrativo, el valor predeterminado es localhost ]
[-oldAdminAgentUsername nombre de usuario de inicio de sesión de antiguo agente administrativo, si la seguridad administrativa está habilitada ]
[-oldAdminAgentPassword contraseña de inicio de sesión de antiguo agente administrativo, si la seguridad administrativa está habilitada ]
[-newAdminAgentProfilePath vía de acceso al nuevo agente administrativo ]
[-newAdminAgentSoapPort puerto de soap del nuevo agente administrativo]
[-newAdminAgentHostname nombre de host del nuevo agente administrativo, el valor predeterminado es localhost ]
[-newAdminAgentUsername nombre de usuario de inicio de sesión del nuevo agente administrativo, si la seguridad administrativa está habilitada ]
[-newAdminAgentPassword contraseña de inicio de sesión del nuevo agente administrativo, si la seguridad administrativa está habilitada ]
![[Windows]](../images/windows.gif)
WASPostUpgrade.bat directorio_copia_seguridad
[-oldAdminAgentProfilePath vía de acceso al antiguo agente administrativo]
[-oldAdminAgentSoapPort puerto de soap del antiguo agente administrativo]
[-oldAdminAgentHostname nombre de host del antiguo agente administrativo, el valor predeterminado es localhost ]
[-oldAdminAgentUsername nombre de usuario de inicio de sesión de antiguo agente administrativo, si la seguridad administrativa está habilitada ]
[-oldAdminAgentPassword contraseña de inicio de sesión de antiguo agente administrativo, si la seguridad administrativa está habilitada ]
[-newAdminAgentProfilePath vía de acceso al nuevo agente administrativo ]
[-newAdminAgentSoapPort puerto de soap del nuevo agente administrativo]
[-newAdminAgentHostname nombre de host del nuevo agente administrativo, el valor predeterminado es localhost ]
[-newAdminAgentUsername nombre de usuario de inicio de sesión del nuevo agente administrativo, si la seguridad administrativa está habilitada ]
[-newAdminAgentPassword contraseña de inicio de sesión del nuevo agente administrativo, si la seguridad administrativa está habilitada ]
Parámetros
El mandato tiene los parámetros siguientes:
- Este parámetro es necesario. El valor directorio_copia_seguridad especifica el nombre del directorio en el que la herramienta WASPreUpgrade almacena la configuración guardada y los archivos y desde la cual la herramienta WASPostUpgrade lee la configuración y los archivos.
- É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 WASPostUpgrade.
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 ID_usuario especifica el nombre de usuario administrativo de la instalación actual de WebSphere Application Server Versión 7.0 o posterior. Este parámetro es necesario si se cumplen las condiciones siguientes:
- Éste es un parámetro opcional.
El valor contraseña especifica la contraseña para el nombre de usuario administrativo de la instalación actual de WebSphere Application Server Versión 7.0 o posterior.Este parámetro es necesario si se cumplen las condiciones siguientes:Consejo: Cuando deba especificar una contraseña en el asistente de migración o deba utilizar el mandato WASPostUpgrade con el parámetro -password en la línea de mandatos, puede escribir la contraseña en texto sin formato o utilizar un valor con cifrado xor. Para utilizar el valor con cifrado xor, escriba todo el cifrado incluyendo el prefijo {xor} como valor para el parámetro. Este valor con cifrado xor puede especificarse en cualquier archivo de configuración de WebSphere Application Server para la configuración anterior, incluyendo los archivos soap.client.props, ssl.client.props y security.xml.Consejo: Cuando utiliza el mandato WASPostUpgrade con el parámetro -password en la línea de mandatos, puede escribir la contraseña en texto sin formato o utilizar un valor con cifrado xor. Para utilizar el valor con cifrado xor, escriba todo el cifrado incluyendo el prefijo {xor} como valor para el parámetro. Este valor con cifrado xor puede especificarse en cualquier archivo de configuración de WebSphere Application Server para la configuración anterior, incluyendo los archivos soap.client.props, ssl.client.props y security.xml.
- Este es un parámetro opcional para migrar instancias o perfiles desde versiones o
perfiles de versiones anteriores de WebSphere Application Server. La instancia o el
perfil ya deben existir en el directorio de copia de seguridad de la
migración antes de ejecutar este mandato. Si no se especifica el parámetro -oldProfile, se utiliza el perfil predeterminado. Si no se encuentra ningún perfil por omisión, el sistema informa de un error.
Avoid trouble: Si no especifica el nombre de perfil específico en -oldprofile, se migrará el perfil designado como "default". Es posible que tenga que migrar cada perfil en la copia de seguridad realizada durante el proceso previo a la migración, utilizando el mandato posterior a la migración WASPostUpgrade y especificando los parámetros -oldprofile y -profilename para cada uno de los perfiles que el cliente desea en el nuevo entorno de Versión 9.0. Si el perfil antiguo contiene aplicaciones instaladas (installedApps) además de la aplicación de ejemplo y las aplicaciones del sistema, el proceso de migración migra automáticamente esas aplicaciones.gotcha
- Este es un parámetro opcional para migrar a perfiles específicos de la Versión 9.0 de WebSphere Application Server. El valor nombre_perfil especifica el nombre del perfil de Versión 9.0 al que el script migra la configuración. Ya debe haber creado este perfil antes de invocar el mandato WASPostUpgrade. Si no se especifica el parámetro -profileName, se utilizará el perfil por omisión. Si no se encuentra ningún perfil por omisión, el sistema informa de un error.
Avoid trouble: Si no especifica el nombre de perfil específico en -profileName, se migrará el perfil designado como "default". Es posible que tenga que migrar cada perfil en la copia de seguridad realizada durante el proceso previo a la migración, utilizando el mandato posterior a la migración WASPostUpgrade y especificando los parámetros -oldprofile y -profilename para cada uno de los perfiles que el cliente desea en el nuevo entorno. Si el perfil antiguo contiene aplicaciones instaladas (installedApps) además de la aplicación de ejemplo y las aplicaciones del sistema, el proceso de migración migra automáticamente esas aplicaciones.gotcha
Nota: Cuando se migra un servidor de aplicaciones autónomo de la Versión 9.0, puede elegir un nodo de servidor de aplicaciones autónomo que ya se haya registrado en un agente administrativo como destino de la migración. - Este es un parámetro opcional que se utiliza para especificar si la configuración existente de la Versión 9.0 de WebSphere Application Server se guarda antes de que se hagan los cambios mediante la herramienta WASPostUpgrade. El valor por omisión es true, esto es, se ha de utilizar el mandato backupConfig para guardar una copia de la configuración actual en el directorio nombre_perfil/temp.
Utilice el mandato restoreConfig para restaurar la configuración según sea necesario. Para obtener más información, consulte Mandato restoreConfig.
- Es un parámetro opcional que especifica cómo establecer los puertos para el nuevo perfil. El
parámetro adopta los siguientes valores:
Si se especifica un valor para este parámetro, los puertos nuevos que se asignen se establecen basándose en este valor. Cada vez que se necesita un nuevo valor de puerto, el puerto se crea basándose en este valor y se incrementa el valor semilla para el uso siguiente. No se asignan puertos duplicados.
- Este parámetro opcional se utiliza para especificar cómo
correlacionar los valores de puerto. Cuando un puerto no puede
utilizarse, su valor se incrementa a partir de un valor inicial hasta
que se encuentra un valor disponible.
- Puede incluir aplicaciones de nivel empresarial, activos y unidades de composición como parte de la migración. Opcionalmente, puede migrar estos elementos utilizando el parámetro-IncludeApps en el mandato WASPostUpgrade. Este es un parámetro opcional que se puede especificar del modo siguiente:
Las aplicaciones del sistema de WebSphere Application Server se migran independientemente del valor establecido por este parámetro.
- Este parámetro opcional indica si se debe realizar una migración de clon, lo que significa que puede seguir utilizando el perfil de origen después de migrarlo al entorno de la Versión 9.0. El valor predeterminado es false.
Cuando el parámetro -clone es true, no puede especificar -setPorts useold. La nueva configuración del perfil debe utilizar números de puerto exclusivos para que las configuraciones nuevas y antiguas que coexisten ahora no tengan conflictos de puerto.
Si clona un gestor de despliegue, también debe clonar sus nodos federados, y no puede clonar los nodos federados sin clonar el gestor de despliegue. Las migraciones de clon de nodos federados requieren el establecimiento del nuevo nombre de host y el puerto SOAP del nodo o el puerto RMI en los siguientes parámetros.- -newDmgrHostname
- El nombre de host del gestor de despliegue de la Versión 9.0
- -newDmgrSoapPort
- El puerto SOAP (Protocolo de acceso a objectos simple) del gestor de despliegue de la Versión 9.0.
- -newDmgrRmiPort
- El puerto RMI (Invocación a método remoto) del gestor de despliegue de la Versión 9.0.
- Es un parámetro opcional que se utiliza para especificar si se ha de inhabilitar el gestor de despliegue existente de WebSphere Application Server
Versión 7.0 o posterior. El valor predeterminado es false a menos que el parámetro -clone sea true, en cuyo caso -keepDmgrEnabled también se establece en true.
Si se especifica este parámetro como true, puede utilizar el gestor de despliegue de la Versión 7.0 o posterior mientras se completa la migración. Esto sólo es válido cuando migra un gestor de despliegue, se ignora en todas las demás migraciones.
Precaución: Utilice este parámetro con atención. - Este es un parámetro opcional que se utiliza para especificar si se instalan todas las aplicaciones en los mismos directorios en los que están situados actualmente. El valor predeterminado es false.
Si se especifica este parámetro como true, cada aplicación individual retiene su ubicación.
Si especifica este parámetro, no puede especificar el parámetro -appInstallDirectory.
Restricciones: Si se especifica este parámetro como true, la ubicación la comparten la instalación de WebSphere Application Server Versión 7.0 o posterior y la instalación de la Versión 9.0. Si mantiene las aplicaciones migradas en las mismas ubicaciones que la versión anterior, se aplican las siguientes restricciones: - Este es un parámetro opcional que se utiliza para pasar el nombre del directorio
que se utilizará cuando se instalen todas las aplicaciones durante la migración. Si no se especifica este parámetro, se utiliza el valor predeterminado de nombre_perfil\installedApps.
Si especifica este parámetro, no puede especificar el parámetro -keepAppDirectory.
Si el nombre de directorio contiene uno o más espacios, se deberá escribir dicho nombre entre comillas.
Si utiliza este parámetro, las herramientas de migración investigan las variables de nivel de nodo correspondientes el nodo que se está migrando en el directorio de copia de seguridad (variables para el release anterior) y en el perfil de destino (variables del nuevo release). Si la vía de acceso forma parte de cualquiera de las variables siguientes en alguno de estos releases, las herramientas contraen la información de vía de acceso para utilizar la variable relacionada:
Por ejemplo:MIGR0341W: El directorio de instalación de aplicación se ha actualizado a {0}.
oMIGR0341W: El directorio de instalación de aplicación se ha actualizado a ${USER_INSTALL_ROOT}\customAppDirectory.
MIGR0341W: El directorio de instalación de aplicación se ha actualizado a ${APP_INSTALL_ROOT}\ cellName\customAppDirectory\.
- Éste es un parámetro 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 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 segundos hace referencia al número de segundos que la migración espera antes de que se consideren como fallidos los intentos de conexión wsadmin.
Este valor también se utiliza como el parámetro de tiempo de espera durante la migración de aplicaciones.
- Éste es un parámetro opcional.
El valor vía de acceso al antiguo agente administrativo hace referencia a la vía de acceso del sistema de archivos del directorio del perfil del agente administrativo original.
Este parámetro sólo es necesario si el servidor de aplicaciones que se está migrando es gestionado por un agente administrativo.
- Éste es un parámetro opcional.
El valor puerto soap de antiguo agente administrativo hace referencia al puerto SOAP utilizado por el agente administrativo original para conexiones administrativas.
Este parámetro sólo es necesario si el servidor de aplicaciones que se está migrando es gestionado por un agente administrativo.
- Éste es un parámetro opcional.
El valor nombre de host de antiguo agente administrativo hace referencia a la ubicación de nombre de hsot del agente administrativo original. Si no se especifica el parámetro, el valor se establece por defecto en "localhost".
Este parámetro sólo es necesario si el servidor de aplicaciones que se está migrando es gestionado por un agente administrativo.
- Éste es un parámetro opcional.
El valor nombre de usuario de inicio de sesión del antiguo agente administrativo hace referencia a la ubicación de nombre de usuario del agente administrativo original.
Este parámetro sólo es necesario si el servidor de aplicaciones que se está migrando es gestionado por un agente administrativo con la seguridad administrativa habilitada.
- Éste es un parámetro opcional.
El valor vía de acceso al nuevo agente administrativo hace referencia a la vía de acceso del sistema de archivos del directorio del agente administrativo que se acaba de migrar.
Este parámetro sólo es necesario si el servidor de aplicaciones que se está migrando es gestionado por un agente administrativo.
- Éste es un parámetro opcional.
El valor puerto soap de antiguo agente administrativo hace referencia al puerto SOAP utilizado por el agente administrativo recién migrado para conexiones administrativas.
Este parámetro sólo es necesario si el servidor de aplicaciones que se está migrando es gestionado por un agente administrativo.
- Éste es un parámetro opcional.
El valor nombre de host de antiguo agente administrativo hace referencia a la ubicación de nombre de host del nuevo agente administrativo. Si no se especifica el parámetro, el valor se establece por defecto en "localhost".
Este parámetro sólo es necesario si el servidor de aplicaciones que se está migrando es gestionado por un agente administrativo.
- Éste es un parámetro opcional.
El valor nombre de usuario de inicio de sesión del antiguo agente administrativo hace referencia a la ubicación de nombre de usuario del nuevo agente administrativo.
Este parámetro sólo es necesario si el servidor de aplicaciones que se está migrando es gestionado por un agente administrativo con la seguridad administrativa habilitada.
- Éste es un parámetro opcional.
El valor contraseña de inicio de sesión del antiguo agente administrativo hace referencia a la ubicación de nombre de usuario del nuevo agente administrativo.
Este parámetro sólo es necesario si el servidor de aplicaciones que se está migrando es gestionado por un agente administrativo con la seguridad administrativa habilitada.
- Éste es un parámetro opcional.
Utilice este parámetro para especificar tamaños de memoria para el almacenamiento dinámico Java utilizado por WASPostUpgrade.
El valor "-Xms...m" especifica 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" especifica el tamaño máximo de almacenamiento dinámico. 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
Anotaciones cronológicas
La herramienta WASPostUpgrade muestra el estado en la pantalla mientras se ejecuta. Esta herramienta también guarda un conjunto más amplio de información de anotación cronológica en el archivo WASPostUpgrade.indicación_hora.log ubicado en el directorio directorio_copia_seguridad/logs. Puede ver el archivo WASPostUpgrade.indicación_hora.log con un editor de texto.
Consideraciones sobre la seguridad
El sistema de destino debe tener inhabilitada la seguridad antes de la migración. Si migra desde una configuración de origen que tiene habilitada la seguridad, el mandato WASPostUpgrade habilita automáticamente la seguridad para la configuración de destino de la Versión 9.0 durante la migración.