Commande restoreConfig

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 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.

[Linux][IBM i][z/OS]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.

[AIX][z/OS]Si vous utilisez un répertoire logique pour racine_serveur_app/config, la commande restoreConfig ne fonctionne pas.

[IBM i]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.
[IBM i]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.
  1. Connectez-vous au système.
  2. Démarrez une session Qshell à l'aide de la commande STRQSH.
  3. Accédez au répertoire racine_serveur_app/bin du serveur d'applications.
  4. 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
    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
  5. 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
    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 :

[AIX][HP-UX][Linux][Solaris]
restoreConfig.sh fichier_sauvegarde [options]
[Windows]
restoreConfig.bat fichier_sauvegarde [options]
[z/OS]
restoreConfig.sh fichier_sauvegarde [options]
[IBM i]
restoreConfig fichier_sauvegarde [options]
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é.
[AIX Solaris HP-UX Linux Windows][z/OS] L'emplacement par défaut est le répertoire racine_serveur_app/config.
[IBM i]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.
[AIX Solaris HP-UX Linux Windows][IBM i]-profileName nom_profil
[AIX Solaris HP-UX Linux Windows][IBM i]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 :

[AIX][HP-UX][Linux][Solaris]
restoreConfig.sh WebSphereConfig_2006-04-22.zip
[Windows]
restoreConfig.bat WebSphereConfig_2006-04-22.zip
[z/OS]
restoreConfig.sh WebSphereConfig_2006-04-22.zip
[IBM i]
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 :

[AIX][HP-UX][Linux][Solaris]
restoreConfig.sh WebSphereConfig_2006-04-22.zip -location /tmp -nostop
[Windows]
restoreConfig.bat WebSphereConfig_2006-04-22.zip -location /tmp -nostop
[z/OS]
restoreConfig.sh WebSphereConfig_2006-04-22.zip -location /tmp -nostop
[IBM i]
restoreConfig WebSphereConfig_2006-04-22.zip -location /tmp -nostop
[IBM i]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.


Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_restoreconfig
Nom du fichier : rxml_restoreconfig.html