Utilice el mandato restoreConfig para restaurar la configuración
del nodo después de hacer la copia de seguridad de la configuración utilizando el mandato backupConfig.
Supported configurations: 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.
sptcfg
El mandato restoreConfig es un programa de utilidad sencillo para restaurar la
configuración del nodo después de hacer una copia de seguridad de la configuración con el mandato backupConfig. De forma predeterminada, todos los servidores del nodo se detienen antes de que se restaura la configuración
de modo que no se produce una sincronización durante la restauración. Si ya existe el
directorio de configuración, se renombrará antes de que se produzca la restauración. Si desea más información sobre cómo ejecutar este mandato, consulte
Utilización de las herramientas de
línea de mandatos.
Si modifica directamente los archivos de aplicación del directorio raíz_servidor_aplic/installedApps, un proceso que se denomina "despliegue directo", pero no realiza los mismos cambios en los archivos de aplicación del directorio raíz_servidor_aplic/config, es posible que los cambios se sobrescriban si utiliza el mandato restoreConfig.
El mandato backupConfig no guarda los permisos de archivo ni la información de propiedad. El mandato
restoreConfig utiliza la máscara U y el ID de usuario en vigor
(EUID) para establecer los permisos y la propiedad al restaurar un
archivo. Si es necesario que los archivos restaurados tengan los
permisos y la propiedad originales, utilice el mandato
tar (disponible en todos los sistemas
UNIX
o
Linux)
para hacer una copia de seguridad de la configuración y restaurarla.
El mandato
restoreConfig se ejecuta bajo el perfil de usuario QEJBSVR
para garantizar que el perfil de usuario QEJBSVR sea el propietario de los directorios y archivos creados. El sistema establece la autorización *PUBLIC para los directorios que se han creado
en *EXCLUDE. Cualquier autorización privada que exista anteriormente en los directorios y archivos del directorio de configuración se perderá. Utilice el script del Qshell para conceder autorización de
WebSphere
Application Server (
grtwasaut) o el mandato
CHGAUT CL para establecer las autorizaciones
privadas que se hayan perdido.
Nota: El perfil de usuario QEJBSVR debe tener al menos autorización *X para cada directorio de la vía de acceso que contiene el archivo_copia_seguridad y autorización *R para el archivo_copia_seguridad.
El mandato
restoreConfig establece el propietario
de la estructura del directorio y su contenido en el perfil de usuario QEJBSVR, pero no restaura las autorizaciones privadas.
Si utiliza una instancia de
IBM®
HTTP Server o
Lotus
Domino
HTTP Server con el servidor de aplicaciones en el mismo sistema o
partición, y el archivo
plugin-cfg.xml del
servidor de aplicaciones reside en la estructura de directorio
raíz_perfil/config,
utilice las instrucciones siguientes para otorgar las autorizaciones
privadas necesarias al perfil de usuario para el servidor
IBM
HTTP Server o
Lotus
Domino
HTTP Server.
Nota: Si no está utilizando un
IBM
HTTP Server o
Lotus
Domino HTTP
Server en el mismo sistema que el perfil que se ha restaurado, no
realice estos pasos. Asimismo, no efectúe estos pasos si el archivo
plugin-cfg.xml no reside bajo la estructura de directorios
config para el perfil.
- Inicie la sesión en el sistema.
- Inicie una sesión de Qshell mediante el mandato STRQSH.
- Vaya hasta el directorio raíz_servidor_aplic/bin para el servidor de aplicaciones.
- Utilice el mandato grtwasaut de Qshell siguiente para otorgar la autorización
de ejecución (x) a cada directorio de la vía de acceso que contiene el archivo plugin-cfg.xml, empezando por el directorio config:
grtwasaut -profileName nombre_perfil -object vía_acceso -dtaaut x -user usuario
donde
nombre_perfil es el nombre de la configuración de
perfil que se ha restaurado, vía_acceso es la vía
de acceso del directorio que debe modificarse relativa al directorio
raíz de perfiles, y usuario es QTMHHTTP (para
IBM
HTTP Server) o QNOTES (para
Lotus
Domino
HTTP Server).Por ejemplo, ejecute los mandatos siguientes si
utiliza
IBM
HTTP Server para la plataforma
iSeries
y el archivo
plugin-cfg.xml para el perfil
myprofile reside en el directorio
raíz_perfil/config/cells/MYSYSTEM_myprofile/nodes/MYSYSTEM_myprofile/servers/myHTTPinstance.
grtwasaut
-profileName myprofile -object config/cells/MYSYSTEM_myprofile/nodes/MYSYSTEM_myprofile/
servers/myHTTPinstance -dtaaut x -user QTMHHTTP
grtwasaut
-profileName myprofile -object config/cells/MYSYSTEM_myprofile/nodes/MYSYSTEM_myprofile/
servers -dtaaut x -user QTMHHTTP
grtwasaut -profileName myprofile -object config/cells/MYSYSTEM_myprofile/nodes/MYSYSTEM_myprofile
-dtaaut x -user QTMHHTTP
grtwasaut -profileName myprofile -object config/cells/MYSYSTEM_myprofile/nodes -dtaaut x -user QTMHHTTP
grtwasaut -profileName myprofile -object config/cells/MYSYSTEM_myprofile -dtaaut x -user QTMHHTTP
grtwasaut -profileName myprofile -object config/cells -dtaaut x -user QTMHHTTP
grtwasaut -profileName miperfil -object config -dtaaut x -user QTMHHTTP
Utilice el ejemplo siguiente si utiliza
IBM
HTTP Server para la plataforma
iSeries
y el archivo
plugin-cfg.xml para el perfil
myprofile reside en el directorio
raíz_perfiles/config/cells:
grtwasaut -profileName myprofile -object config/cells -dtaaut x -user QTMHHTTP
grtwasaut -profileName miperfil -object config -dtaaut x -user QTMHHTTP
- Utilice el mandato grtwasaut siguiente para otorgar la autorización de lectura y ejecución (rx) al archivo plugin-cfg.xml:
grtwasaut -profileName nombre_perfil -object vía_acceso/plugin-cfg.xml -dtaaut x -user usuario
donde nombre_perfil es el nombre de la
configuración de perfil que se ha restaurado,
vía_acceso es la vía de acceso del directorio que
debe modificarse relativa al directorio raíz de perfiles, y
usuario es QTMHHTTP (para
IBM
HTTP Server) o QNOTES (para
Lotus
Domino
HTTP Server).Por ejemplo, ejecute el mandato siguiente si utiliza
IBM
HTTP Server para la plataforma
iSeries
y el archivo
plugin-cfg.xml para el perfil
myprofile reside en el directorio
raíz_perfil/config/cells/MYSYSTEM_myprofile/nodes/MYSYSTEM_myprofile/servers/myHTTPinstance.
grtwasaut -profileName myprofile -object config/cells/MYSYSTEM_myprofile/nodes/MYSYSTEM_myprofile
/servers/myHTTPinstance/plugin-cfg.xml -dtaaut rx -user QTMHHTTP
Utilice el ejemplo siguiente si utiliza
IBM
HTTP Server para la plataforma
iSeries
y el archivo
plugin-cfg.xml para el perfil
myprofile reside en el directorio
raíz_perfiles/config/cells:
grtwasaut -profileName myprofile -object config/cells/plugin-cfg.xml -dtaaut rx -user QTMHHTTP
Ubicación
Emita el mandato desde el directorio raíz_perfil/bin.
Sintaxis
La sintaxis del mandato es la siguiente:
restoreConfig archivo_copia_seguridad [opciones]
donde
archivo_copia_seguridad especifica el
archivo que se desea restaurar. Si no especifica ninguno, no se ejecutará el mandato.
Parámetros
Las siguientes opciones están disponibles para el mandato
restoreConfig:
- -help
- Imprime una sentencia de uso
- -location nombre_directorio
- Especifica el directorio donde se restaura el archivo de copia de seguridad
- La ubicación toma de forma predeterminada el
directorio
raíz_perfil/config.
- -logfile nombre_archivo
- Especifica la ubicación del archivo de registros cronológicos en el que se escribe la información de rastreo
De manera predeterminada, el archivo de registros cronológicos se denomina restoreConfig.log y se crea en el directorio logs.
- -nostop
- Indica al mandato restoreConfig que no detenga los servidores antes de restaurar la configuración
- -password contraseña
- Especifica la contraseña para la autenticación si la seguridad está habilitada en el servidor
- -profileName nombre_perfil
- Define el perfil del proceso del servidor de aplicaciones en una instalación de varios perfiles
La opción -profileName no es necesaria para la ejecución en un entorno de perfil único. El valor predeterminado de esta opción es el perfil por omisión.
- -quiet
- Suprime la información de progreso que imprime el mandato restoreConfig en la modalidad normal
- -replacelog
- Sustituye el archivo de anotaciones cronológicas en lugar de anexarlo al archivo de anotaciones
cronológicas actual.
- -trace
- Genera información de rastreo en el archivo de anotaciones cronológicas para depuración.
- -username nombre_usuario
- Especifica el nombre de usuario para la autenticación, si la seguridad está habilitada en el servidor; actúa igual que la opción -user.
- -user nombre_usuario
- Especifica el nombre de usuario para la autenticación si la seguridad está habilitada; actúa igual que la opción -username
- -?
- Imprime una sentencia de uso
Uso
El siguiente ejemplo muestra la sintaxis correcta:
restoreConfig WebSphereConfig_2006-04-22.zip
El
ejemplo siguiente restaura el archivo dado en el directorio /tmp y no detiene ningún
servidor antes de comenzar la restauración:
restoreConfig WebSphereConfig_2006-04-22.zip -location /tmp -nostop
En el siguiente ejemplo se restaura la configuración almacenada en
/home/mydir/myprofileBackup.zip a la configuración para el perfil miperfil:
restoreConfig /home/mydir/myprofileBackup.zip -profileName miperfil
Tenga en cuenta que si restaura la configuración en un directorio distinto al directorio
del que se realizó la copia de seguridad cuando ejecutó el mandato backupConfig, es posible que tenga que actualizar manualmente alguna de las vías de acceso en el directorio de configuración.