La commande restoreConfig permet de
restaurer la configuration du noeud qui a été sauvegardée à l'aide de la
commande backupConfig.
Configurations prises en charge: Cet article traite de la migration de configuration de profil. Pour faire migrer vos applications vers la dernière version, utilisez le kit d'outils de migration de WebSphere Application Server. Pour plus d'informations, voir Migration
Toolkit on WASdev.
sptcfg
La commande restoreConfig est un simple utilitaire permettant de restaurer la configuration de votre noeud après qu'une sauvegarde en a été effectuée à l'aide de la commande backupConfig. Par défaut, tous les serveurs du noeud s'arrêtent avant la restauration de la
configuration afin d'éviter qu'une synchronisation de noeud ne se produise au cours de la
restauration. Si le répertoire de configuration existe déjà, il est renommé avant que la
restauration n'ait lieu. Pour plus d'informations sur l'emplacement depuis lequel exécuter cette commande, reportez-vous à la rubrique Utilisation des outils de ligne de commande.
Si vous apporté directement des modifications aux fichiers d'application dans le répertoire racine_serveur_app/installedApps (processus appelé "déploiement à chaud"), mais que vous n'effectuez pas les mêmes modifications dans le répertoire racine_serveur_app/config, les modifications risquent d'être écrasées si vous utilisez la commande restoreConfig.
La commande backupConfig ne sauvegarde ni les autorisations ni les droits de propriété des fichiers. La commande restoreConfig utilise l'umask en cours et l'ID utilisateur effectif (EUID) pour définir les autorisations et la propriété lors de la restauration d'un fichier. Si les autorisations et droits de propriété d'origine doivent être accordés aux fichiers restaurés, utilisez la commande tar (disponible sur tous les systèmes UNIX ou Linux) afin de sauvegarder et de restaurer la configuration.
La commande
restoreConfig s'exécute sous le profil utilisateur QEJBSVR pour garantir que ce dernier est le propriétaire des répertoires et fichiers créés. Le système paramètre sur *EXCLUDE le droit d'accès *PUBLIC aux répertoires qui ont été créés. Tous les droits d'accès privés déjà existants sur les répertoires et fichiers du répertoire de configuration sont perdus. Utilisez le script Qshell permettant d'accorder une autorisation WebSphere Application Server (
grtwasaut), ou la commande
CHGAUT CL, pour définir tous les droits d'accès privés qui ont été perdus.
Remarque : Le profil utilisateur QEJBSVR doit comporter au moins le droit d'accès *X à chaque répertoire du chemin contenant le fichier de sauvegarde, ainsi que le droit d'accès *R au fichier de sauvegarde.
La commande
restoreConfig
paramètre le propriétaire de l'arborescence de répertoires et son contenu
sur le profil utilisateur QEJBSVR, mais ne restaure pas les droits d'accès
privés.
Si vous utilisez une instance d'IBM® HTTP Server
ou de Lotus
Domino HTTP
Server dont le serveur d'applications réside sur le même système ou la même partition et que le fichier
plugin-cfg.xml de votre serveur d'applications se trouve dans l'arborescence de répertoires
racine_profil/config, utilisez les instructions ci-dessous pour accorder les droits d'accès privés nécessaires au profil utilisateur d'IBM HTTP Server ou de Lotus
Domino HTTP Server.
Remarque : Si vous n'utilisez pas IBM HTTP
Server ou Lotus
Domino HTTP Server sur le même système que le profil restauré, n'effectuez pas ces étapes. Ces étapes ne doivent pas non plus être effectuées si le fichier plugin-cfg.xml ne réside pas dans l'arborescence de répertoires config du profil.
- Connectez-vous au système.
- Démarrez une session Qshell à l'aide de la commande STRQSH.
- Accédez au répertoire racine_serveur_app/bin du serveur d'applications.
- Utilisez la commande Qshell grtwasaut suivante pour
accorder le droit d'exécution (x) à chaque répertoire du chemin contenant
le fichier plugin-cfg.xml, en commençant par le
répertoire config :
grtwasaut -profileName nom_profil -object chemin -dtaaut x -user utilisateur
où nom_profil correspond au nom de la configuration de profil restaurée, chemin au chemin de répertoire à modifier par rapport au répertoire racine de profil et utilisateur à QTMHHTTP (pour IBM HTTP Server) ou à QNOTES (pour Lotus
Domino HTTP Server).Par exemple, exécutez les commandes suivantes si vous utilisez IBM HTTP Server pour la plateforme iSeries et que le fichier
plugin-cfg.xml du profil myprofile réside dans le
répertoire
racine_profil/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 myprofile -object config -dtaaut x -user QTMHHTTP
Servez-vous de l'exemple suivant si vous utilisez IBM HTTP Server pour la plateforme iSeries et que le fichier
plugin-cfg.xml de votre profil myprofile réside dans le répertoire
racine_profil/config/cells :
grtwasaut -profileName myprofile -object config/cells -dtaaut x -user QTMHHTTP
grtwasaut -profileName myprofile -object config -dtaaut x -user QTMHHTTP
- Utilisez la commande grtwasaut suivante pour
accorder le droit d'accès en lecture/exécution (rx) au fichier
plugin-cfg.xml :
grtwasaut -profileName nom_profil -object chemin/plugin-cfg.xml -dtaaut x -user utilisateur
où nom_profil correspond au nom de la configuration de profil restaurée, chemin au chemin de répertoire à modifier par rapport au répertoire racine de profil et utilisateur à QTMHHTTP (pour IBM HTTP Server) ou à QNOTES (pour Lotus
Domino HTTP Server).Par exemple, exécutez la commande suivante si vous utilisez IBM HTTP Server pour la plateforme iSeries et que le fichier
plugin-cfg.xml du profil myprofile réside dans le
répertoire
racine_profil/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
Servez-vous de l'exemple suivant si vous utilisez IBM HTTP Server pour la plateforme iSeries et que le fichier
plugin-cfg.xml de votre profil myprofile réside dans le répertoire
racine_profil/config/cells :
grtwasaut -profileName myprofile -object config/cells/plugin-cfg.xml -dtaaut rx -user QTMHHTTP
Emplacement
Lancez la commande depuis le répertoire racine_profil/bin.
Syntaxe
La syntaxe de la commande est la suivante :
restoreConfig fichier_sauvegarde [options]
où
fichier_sauvegarde
indique le fichier à restaurer. Si vous ne précisez pas de fichier, la commande n'est pas
exécutée.
Paramètres
Les options ci-après sont disponibles pour la
commande restoreConfig :
- -help
- Imprime une syntaxe.
- -location nom_répertoire
- Indique le répertoire dans lequel le fichier de sauvegarde est restauré.
- L'emplacement par défaut est le répertoire racine_profil/config.
- -logfile nom_fichier
- Indique l'emplacement du fichier journal dans lequel sont consignées
les informations de trace.
Par défaut, le fichier journal est appelé
restoreConfig.log et créé dans le répertoire
logs.
- -nostop
- Indique à la commande restoreConfig de ne pas arrêter les serveurs avant de restaurer la configuration.
- -password password
- Indique le mot de passe pour l'authentification si la sécurité est
activée sur le serveur.
- -profileName nom_profil
- Définit le profil d'un processus Application Server dans une installation multiprofils.
L'option -profileName n'est pas nécessaire à l'exécution dans un environnement de profil unique. La valeur par défaut pour cette option correspond au profil par défaut.
- -quiet
- Supprime les informations de progression que la commande restoreConfig imprime en mode normal.
- -replacelog
- Remplace le fichier journal au lieu d'ajouter les données à celui en
cours.
- -trace
- Génère des informations de trace dans le fichier journal à des fins de
débogage.
- -username nom_utilisateur
- Indique le nom d'utilisateur pour l'authentification si la sécurité
est activée sur le serveur ; équivaut à l'option -user.
- -user nom_utilisateur
- Indique le nom d'utilisateur pour l'authentification si la sécurité
est activée sur le serveur ; équivaut à l'option -username.
- -?
- Imprime une syntaxe.
Utilisation
L'exemple suivant montre la syntaxe correcte :
restoreConfig WebSphereConfig_2006-04-22.zip
L'exemple
suivant restaure le fichier donné dans le répertoire /tmp et n'arrête
aucun serveur avant de commencer la restauration :
restoreConfig WebSphereConfig_2006-04-22.zip -location /tmp -nostop
L'exemple suivant restaure la configuration stockée dans /home/mydir/myprofileBackup.zip vers la configuration du profil myprofile :
restoreConfig /home/mydir/myprofileBackup.zip -profileName myprofile
Gardez à l'esprit que si vous restaurez la configuration dans un
répertoire autre que celui qui a été sauvegardé lorsque vous avez exécuté
la commande backupConfig, il peut s'avérer nécessaire
de mettre à jour manuellement les chemins d'accès dans le répertoire de
configuration.