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.
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.
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 ejecutar este script de mandato,
su perfil de usuario debe tener autoridad de *ALLOBJ.
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.

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.


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


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.