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 WBIPreUpgrade

Utilice el mandato WBIPreUpgrade para WebSphere ESB para guardar la configuración de una versión instalada previamente de WebSphere ESB en el directorio de copia de seguridad específica de la migración.

Detalles

El mandato WBIPreUpgrade guarda los archivos seleccionados de los directorios raíz_instalación y raíz_perfil en un directorio de copia de seguridad que especifique. El valor por omisión de raíz_perfil es profiles/nombre_perfil. Los archivos copiados estarán en diversos subdirectorios, todos copiados por WBIPreUpgrade en el directorio de copia de seguridad especificado. Además, se crea un subdirectorio logs, que contiene los nuevos archivos de anotaciones cronológicas correspondientes a la instancia actual de ejecución del mandato WBIPreUpgrade.

Según la versión desde la que esté realizando la migración, el mandato WBIPreUpgrade realiza copias de seguridad de los perfiles existentes en WebSphere Enterprise Service Bus, de todos de una vez o de uno en uno.
  • Si está migrando desde la versión 6.0.2.x, el mandato WBIPreUpgrade realiza copias de seguridad de los perfiles existentes en WebSphere Enterprise Service Bus todos de una vez.
  • Si está migrando desde la versión 6.1.x, el mandato WBIPreUpgrade realiza copias de seguridad de los perfiles existentes de uno en uno, y sólo de los perfiles identificados con el parámetro-profileName.

Restricciones

  • Si está migrando desde la versión 6.1.x, el mandato WBIPreUpgrade hereda las siguientes limitaciones de los programas de utilidad backupConfig de WebSphere Application Server Network Deployment, versión 6.1:
    • De forma predeterminada, todos los servidores del nodo se detienen antes de que se haga la copia de seguridad, con lo que la información parcialmente sincronizada no se guarda.
    • Debe tener autoridad de root para realizar la migración.
    • En un entorno UNIX® o Linux®, el mandato backupConfig no guarda permisos de archivo ni información de propiedad.
    • Al restaurar un archivo, el mandato restoreConfig utiliza la umask actual y un ID de usuario efectivo (EUID) para establecer los permisos y la propiedad.
    • Debe detener el gestor de despliegue de origen antes de iniciar la migración. Si no detiene el gestor de despliegue de origen, el mandato WBIPreUpgrade lo detiene automáticamente.
  • Para el sistema operativo i5/OS Si realiza 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.
  • Para el sistema operativo i5/OS Si realiza la migración en una plataforma i5/OS, backUpConfig no guarda autorizaciones privadas en los archivos y directorios que pueda haber configurado en el perfil de origen. Por consiguiente, debe tomar nota de cualquier autorización privada que pueda existir en archivos y directorios bajo el árbol de configuración del perfil de origen y, a continuación, debe restaurar estas autorizaciones privadas manualmente en el perfil de destino después de haber ejecutado el mandato WBIPostUpgrade y de haber completado la migración del perfil.

Ubicación

En el directorio dir_instalación/bin se encuentra el archivo de mandato y se debe ejecutar desde este directorio.

Autoridad

Para el sistema operativo i5/OS Para ejecutar este script de mandato, su perfil de usuario debe tener autoridad de *ALLOBJ.

Sintaxis

La sintaxis es la siguiente:

Para el sistema operativo i5/OS
WBIPreUpgrade directorio_copia_seguridad 
                currentProfileDirectory
                [-username ID_usuario]
                [-password contraseña]
                [-traceString especificación_rastreo [-traceFile nombre_archivo ]]
Nota: Si realiza la migración de versión 6.0.2.x a versión 6.2, el parámetro -profileName no está soportado.
Para el sistema
operativo LinuxPara el sistema operativo UNIX
WBIPreUpgrade.sh directorio_copia_seguridad 
                directorio_WebSphere_actual
                [-profileName nombre_perfil]
                [-username ID_usuario]
                [-password contraseña]
                [-traceString especificación_rastreo [-traceFile nombre_archivo ]]
Para el sistema operativo Windows
WBIPreUpgrade.bat directorio_copia_seguridad 
                directorio_WebSphere_actual
                [-profileName nombre_perfil]
                [-username ID_usuario]
                [-password contraseña]
                [-traceString especificación_rastreo [-traceFile nombre_archivo ]]

Parámetros

Los parámetros son los siguientes:

backupDirectory
Se trata de un parámetro necesario y debe ser el primer parámetro que especifique. El valor de directorio_copia_seguridad especifica el nombre del directorio donde el script del mandato almacena la configuración y los archivos de anotaciones cronológicas guardados que se crearon durante WBIPreUpgrade y WBIPostUpgrade.

También es el directorio desde el cual el mandato WBIPostUpgrade lee la configuración.

Si el directorio no existe, el script del mandato WBIPreUpgrade lo crea.

currentWebSphereDirectory
Se trata de un parámetro necesario y debe ser el segundo parámetro que especifique. Puede ser cualquier edición de WebSphere ESB para el cual está soportada la migración.
Para el sistema operativo i5/OS El valor de directorio_WebSphere_actual especifica el nombre del directorio raíz para el perfil de WebSphere ESB existente que desea migrar. En i5/OS, el formato de esta vía de acceso de directorio es el siguiente: raíz_datos_usuario/profiles/nombre_perfil, donde nombre_perfil es el nombre del perfil y raíz_datos_usuario es el directorio de datos de usuario por omisión para WebSphere ESB (/QIBM/UserData/WebSphere/ESB). Al instalar el producto, se crean los subdirectorios profiles y profileRegistry en este directorio.
Nota: La i5/OS plataforma sólo se soporta si está migrando de la versión 6.1.x a la versión 6.2.

Para el sistema operativo UNIXPara el sistema
operativo LinuxPara el sistema operativo Windows El valor de directorio_WebSphere_actual especifica el nombre del directorio raíz de la instalación para la instalación existente de WebSphere ESB.

Los directorios siguientes son los predeterminados para WebSphere ESB versión 6.1.x. Es posible que se haya utilizado una vía de acceso distinta a la predeterminada en su instalación.
  • Si, para la instalación anterior, WebSphere Application Server y WebSphere ESB se instalaron conjuntamente en el mismo proceso de instalación: /QIBM/UserData/WebSphere/ProcServer/profiles/nombre_perfil.
  • Si, para la instalación anterior, WebSphere Application Server ya estaba instalado y se instaló WebSphere ESB encima: /QIBM/UserData/WebSphere/AppServer/V61/ND/profiles/nombre_perfil.
-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).
-profileName
Para el sistema operativo UNIXPara el sistema
operativo LinuxPara el sistema operativo Windows
Nota: Este parámetro no está soportado en la plataforma i5/OS. Si se utiliza, se generará una excepción de parámetro no válido.
Es un parámetro opcional para la migración desde perfiles específicos. El valor nombre_perfil especifica el nombre del perfil creado en la versión anterior de WebSphere ESB, desde la cual el script migra la configuración.

Si el parámetro -profileName 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.

Nota: Para asegurarse de que se migra el perfil correcto, especifique el nombre de perfil mediante este parámetro, en vez de suponer que el valor predeterminado ya lo especifica correctamente.
-traceFile
Nota: Este parámetro se ignora para la migración de WebSphere ESB de la versión 6.1.x a la 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.
-traceString
Nota: Este parámetro se ignora para la migración de WebSphere ESB de la versión 6.1.x a la 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.
-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).

Anotación cronológica

El mandato WBIPreUpgrade muestra su estado en pantalla cuando se ejecuta. También guarda un conjunto más amplio de información de anotación cronológica en el archivo WBIPreUpgrade.indicación_fecha_hora.log grabado en el directorio directorio_copia_seguridad/logs, directorio_copia_seguridad es el valor especificado para el parámetro backupDirectory. Puede visualizar el archivo WBIPreUpgrade.nombre_perfil.indicación_hora.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_wbipreupgrade.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).