WebSphere Enterprise Service Bus, Versión 6.2.0 Sistemas operativos: AIX, HP-UX, i5/OS, Linux, Solaris, Windows


Programa de utilidad de línea de mandatos WBIPostUpgrade

Utilice el mandato WBIPostUpgrade para WebSphere ESB para recuperar del directorio_copia_seguridad que se ha especificado la configuración de perfil que se ha guardado mediante el mandato WBIPreUpgrade.

Para el sistema operativo i5/OS Importante: i5/OS sólo se admite si está realizando la migración desde versión 6.1.x a versión 6.2.
Nota: Si está realizando la migración en una plataforma i5/OS, el nombre de perfil de destino debe coincidir con el nombre de perfil del perfil de origen que se migra.

Detalles

El script WBIPostUpgrade de WebSphere ESB lee la configuración del directorio_copia_seguridad para migrar a WebSphere ESB versión 6.2 y añade todas las aplicaciones migradas al directorio raíz_perfil/installedApps para la nueva instalación de WebSphere ESB.

Ubicación

El archivo de mandatos está ubicado y se debe ejecutar en el directorio raíz_instalación/bin.

Sintaxis

La sintaxis es la siguiente:

Para el sistema operativo i5/OS
WBIPostUpgrade Directorio_copia_seguridad
                     [-username id_usuario]
                     [-password contraseña]
                     [-scriptCompatibility true | false]
                     [-portBlock número_puerto_inicial]
                     [-backupConfig true | false]
                     [-replacePorts true | false]
                     [-keepDmgrEnabled true | false]
                     [-keepAppDirectory true | false]
                     [-appInstallDirectory directorio_especificado_usuario]
                     [-traceString especificación_rastreo [-traceFile nombre_archivo ]]
                     [-createTargetProfile]	
Nota: El parámetro -Nombre_perfil no se admite en la plataforma i5/OS. Si se utiliza, se generará una excepción de parámetro no válido.

Para el sistema
operativo LinuxPara el sistema operativo UNIX
WBIPostUpgrade.sh directorio_copia_seguridad
                     [-username id_usuario]
                     [-password contraseña]
                     [-oldProfile nombre_perfil]
                     [-profileName nombre_perfil]
                     [-scriptCompatibility true | false]
                     [-portBlock número_puerto_inicial]
                     [-backupConfig true | false]
                     [-replacePorts true | false]
                     [-keepAppDirectory true | false]
                     [-keepDmgrEnabled true | false]
                     [-appInstallDirectory directorio_especificado_usuario]
                     [-traceString especificación_rastreo [-traceFile nombre_archivo ]]
                     [-createTargetProfile]

Para el sistema operativo Windows
WBIPostUpgrade.bat directorio_copia_seguridad
                     [-username id_usuario]
                     [-password contraseña]
                     [-oldProfile nombre_perfil]
                     [-profileName nombre_perfil]
                     [-scriptCompatibility true | false]
                     [-portBlock número_puerto_inicial]
                     [-backupConfig true | false]
                     [-replacePorts true | false]
                     [-keepAppDirectory true | false]
                     [-keepDmgrEnabled true | false]
                     [-appInstallDirectory directorio_especificado_usuario]
                     [-traceString especificación_rastreo [-traceFile nombre_archivo ]]
                     [-createTargetProfile]
Nota: El parámetro -oldProfile debe preceder al parámetro -profileName (nuevo perfil).

Parámetros

Los parámetros son los siguientes:

backupDirectory
Es un parámetro necesario. El valor backupDirectory especifica la vía de acceso del directorio en el que la herramienta WBIPreUpgrade ha almacenado la configuración y los archivos guardados y desde el que la herramienta WBIPostUpgrade lee la configuración y los archivos.
-username
Este es un parámetro opcional que es necesario si se configura la seguridad administrativa en la versión anterior de WebSphere ESB. El valor id_usuario especifica el nombre del usuario administrativo de la instalación de WebSphere ESB actual (antes de la migración).
-password
Este es un parámetro opcional que es necesario si se configura la seguridad administrativa en la versión anterior de WebSphere ESB. El valor contraseña especifica la contraseña para el nombre de usuario administrativo de la instalación de WebSphere ESB actual (antes de la migración).
-oldProfile
Restricción: Este parámetro no está disponible en las plataformas i5/OS.
Es un parámetro opcional para la migración de instancias o perfiles de versiones anteriores. La instancia o el perfil ya debe existir en el directorio de copia de seguridad de migración antes de ejecutar este mandato.

Si el parámetro -oldProfile no se especifica, se utilizará el perfil por omisión. Si no se encuentra ningún perfil por omisión, el sistema notificará un error.

-profileName
Para el sistema operativo UNIXPara el sistema
operativo LinuxPara el sistema operativo Windows
Nota: Este parámetro no se admite en la plataforma i5/OS. Si se utiliza, se generará una excepción invalid parameter.
Es un parámetro opcional para la migración de perfiles específicos. El valor nombre_perfil especifica el nombre del perfil, ya creado en la versión más reciente de WebSphere ESB, a la que el script migra la configuración. Ya debe haber creado este perfil antes de llamar al mandato WBIPostUpgrade.

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 notificará un error.

Nota: Para garantizar que se ha migrado el perfil correcto, especifique el nombre de perfil mediante este parámetro sin basarse en el valor por omisión.
-scriptCompatibility
Nota: Este parámetro se ignora en migraciones de WebSphere ESB versión 6.1.x a versión 6.2.
Es un parámetro opcional que se utiliza para especificar si la migración debe crear las siguientes definiciones de configuración de la versión 6.0.2.x:
  • Transporte
  • Definición de proceso
  • SSL para 6.0.2
en lugar de las siguientes definiciones de configuración de la versión 6.2:
  • Canales
  • Definiciones de proceso
  • SSL para versión 6.2

El valor por omisión es true.

Especifique true en este parámetro para minimizar los impactos a los scripts de administración existentes. Por ejemplo, si tiene scripts o programas wsadmin existentes que utilicen API de configuración de terceros para crear o modificar las definiciones de configuración de la versión 6.0.2.x, es posible que desee especificar true para esta opción durante la migración.

Nota: Esto es temporal hasta que todos los nodos del entorno estén en el nivel de la versión 6.2. Cuando estén en el nuevo nivel, debe llevar a cabo las siguientes acciones:
  1. Modifique los scripts de administración de forma que utilicen todos los valores de la versión 6.2.
  2. Utilice el mandato convertScriptCompatability para convertir las configuraciones de forma que coincidan con todos los valores de la versión 6.2.

    Para obtener más información, consulte el mandato convertScriptCompatibility.

-portBlock
Se trata de un parámetro opcional. El valor número_puerto_inicial especifica el primer número de un bloque de números de puerto consecutivos que se asignarán cuando se ejecuta el script de mandato.
-replacePorts
Este parámetro opcional se utiliza para especificar cómo correlacionar valores de puerto para sistemas principales virtuales y puertos de transporte de contenedor Web.
  • False
    No sustituya las definiciones de puerto versión 6.0.x o 6.1.x durante la migración.
    • La configuración de la versión anterior se conserva, no se suprime ningún canal.
    • Los cuatro canales con nombre siguientes se han establecido en valores que son equivalentes a los valores establecidos para el release anterior:
      • WC_adminhost
      • WC_defaulthost
      • WC_adminhost_secure
      • WC_defaulthost_secure
    • El proceso de migración crea transportes o canales, basados en el valor de -scriptCompatibility, para todos los puertos del release anterior.
    • El proceso de migración establece todos los puertos de contenedor no de Web a los valores establecidos para el release anterior.
    • Pueden surgir conflictos de puertos si el proceso de migración crea un transporte o un canal que es igual al definido en el contenedor Web.

    Éste es el valor por omisión.

  • True

    Sustituya todos los valores de puerto de alias de sistema principal virtual durante la migración por las definiciones de puertos versión 6.2.

    Por omisión, el proceso de migración añade datos de configuración del entorno anterior a los datos del nuevo entorno de WebSphere ESB. Sin embargo, en algunos casos éste podría no ser el comportamiento que desee para estos valores de puerto. Por ejemplo, las definiciones de puerto del release anterior podrían establecerse cuidadosamente para evitar conflictos de puertos con otros productos; en dichos casos, es muy probable que desee migrar estos valores a la configuración de la nueva versión. Especifique true para este parámetro para que se eliminen de la configuración de la nueva versión todos los puertos de los sistemas principales virtuales que coincidan antes de añadir los nuevos valores.
    • Todos los canales de transporte asociados con el contenedor Web se suprimen, salvo para los cuatro canales con nombre siguientes, que se han establecido en valores equivalentes a los valores establecidos para el release anterior:
      • WC_adminhost
      • WC_defaulthost
      • WC_adminhost_secure
      • WC_defaulthost_secure
    • El proceso de migración crea transportes o canales, basados en el valor de -scriptCompatibility, para todos los puertos del release anterior.
    • El proceso de migración establece todos los puertos de contenedor no de Web a los valores establecidos para el release anterior.
-keepAppDirectory
Nota: Este parámetro se ignora en migraciones de WebSphere ESB versión 6.1 a versión 6.2.
Este parámetro opcional se utiliza para especificar si se deben instalar todas las aplicaciones en los mismos directorios en los que se encuentran actualmente. El valor por omisión es false.

Si este parámetro especifica el valor true, cada aplicación individual conserva su ubicación.

Restricciones: Si este parámetro especifica el valor true, la ubicación se comparte entre el programa WebSphere ESB existente y la nueva instalación. Si mantiene las aplicaciones migradas en las mismas ubicaciones que las de la versión anterior, se aplican las siguientes restricciones:
  • Deben tenerse en cuenta las limitaciones de soporte de nodos combinados de la versión 6.2. Esto significa que el siguiente soporte no se puede utilizar al evocar el mandato wsadmin:
    • Precompilar JSP
    • Utilizar configuración binaria
    • Desplegar EJB
  • Si más adelante suprime las aplicaciones de estas ubicaciones al administrar (por ejemplo, al desinstalar) la instalación existente anteriormente, corre el riesgo de perder sin querer las aplicaciones migradas.
-keepDmgrEnabled
Nota: Este parámetro se ignora en migraciones de WebSphere ESB versión 6.1 a versión 6.2.
Este parámetro opcional se utiliza para especificar si desea inhabilitar el gestor de despliegue de WebSphere ESB existente. El valor por omisión es false.

Si este parámetro especifica el valor true, puede utilizar el gestor de despliegue existente mientras se completa la migración. Sólo es válido cuando está migrando un gestor de despliegue; se ignora en las demás migraciones.

Precaución: Tenga mucho cuidado al utilizar este parámetro.
  • La razón de que las configuraciones del gestor de despliegue de WebSphere ESB normalmente están detenidas e inhabilitadas es para impedir que varios gestores de despliegue gestionen los mismos nodos. Debe detener el gestor de despliegue existente antes de empezar a utilizar el gestor de despliegue de la nueva versión. Si esto no se realiza, las condiciones de error más probables que ocurrirán serán conflictos de puertos cuando se inicie la segunda instancia del gestor de despliegue.
  • Si especifica true para este parámetro significa que todos los cambios realizados en la configuración antigua durante la migración pueden no migrarse.
-appInstallDirectory
Nota: Este parámetro se ignora en migraciones de WebSphere ESB versión 6.1 a versión 6.2.
Este parámetro opcional se utiliza para pasar el nombre de directorio que se va a utilizar al instalar todas las aplicaciones durante la migración. Si este parámetro no se especifica, se utiliza el valor por omisión de nombre_perfil\installedApps.

Si el nombre contiene uno o más espacios en blanco, dicho nombre se deberá especificar entre comillas.

Consejo: Puede incluir la variable ${USER_INSTALL_ROOT} en el argumento. Esta variable se expande en <WPS HOME>\profiles\<nombre perfil>. Por ejemplo, si WebSphere ESB, versión 6.2 está instalado en C:\wps\ y el perfil de destino es ProcSrv01, entonces ${USER_INSTALL_ROOT} representa C:\wps62\profiles\ProcSrv01.
-traceString
Nota: Este parámetro se ignora en migraciones de WebSphere ESB versión 6.0.2.x a versión 6.2.
Se trata de 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" (entre comillas).

Importante: Si especifica este parámetro, también debe especificar el parámetro -traceFile. Si especifica el parámetro -traceString pero no especifica el parámetro -traceFile, el mandato crea un archivo de rastreo y lo coloca en el directorio directorio_copia_seguridad/logs.
-traceFile
Nota: Este parámetro se ignora en migraciones de WebSphere ESB versión 6.0.2.x a versión 6.2.
Se trata de un parámetro opcional. El valor nombre_archivo especifica el nombre del archivo de salida para la información de rastreo.
Importante: Si especifica este parámetro, también debe especificar el parámetro -traceString. Si especifica el parámetro -traceFile pero no especifica el parámetro -traceString, el mandato utiliza la profundidad de rastreo por omisión, y almacena el archivo de rastreo en la ubicación que especifique.
-createTargetProfile

Este parámetro opcional crea un nuevo perfil con los valores de configuración correctos con fines de migración.

Anotación cronológica

El mandato WBIPostUpgrade muestra el estado en pantalla mientras se está ejecutando. Este mandato también guarda un conjunto más amplio de información de anotaciones cronológicas en el archivo WBIPostUpgrade.indicación_fecha_hora.log que se encuentra en el directorio directorio_copia_seguridad/logs. Puede ver el archivo WBIPostUpgrade.nombre_perfilindicación_hora_fecha.log con un editor de texto.


reference Tema de referencia

Condiciones de uso | Comentarios


Icono de indicación de la hora Última actualización: 05 julio 2010


http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r2mx/topic//com.ibm.websphere.wesb620.doc/doc/rmig_wbipostupgrade.html
Copyright IBM Corporation 2005, 2010. Reservados todos los derechos.
Este centro de información está basado en tecnología Eclipse (http://www.eclipse.org).