Commande restoreConfig
La commande restoreConfig permet de restaurer la configuration du noeud qui a été sauvegardée à l'aide de la commande backupConfig.

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.
sptcfgLa 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.
Si vous utilisez un répertoire logique pour racine_serveur_app/config, la commande restoreConfig ne fonctionne pas.
![[IBM i]](../images/iseries.gif)
![[IBM i]](../images/iseries.gif)
Emplacement
Lancez la commande depuis le répertoire racine_profil/bin.
Syntaxe
La syntaxe de la commande est la suivante :
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
restoreConfig.sh fichier_sauvegarde [options]
![[Windows]](../images/windows.gif)
restoreConfig.bat fichier_sauvegarde [options]
![[z/OS]](../images/ngzos.gif)
restoreConfig.sh fichier_sauvegarde [options]
![[IBM i]](../images/iseries.gif)
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_serveur_app/config.
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 :
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
restoreConfig.sh WebSphereConfig_2006-04-22.zip
![[Windows]](../images/windows.gif)
restoreConfig.bat WebSphereConfig_2006-04-22.zip
![[z/OS]](../images/ngzos.gif)
restoreConfig.sh WebSphereConfig_2006-04-22.zip
![[IBM i]](../images/iseries.gif)
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]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
restoreConfig.sh WebSphereConfig_2006-04-22.zip -location /tmp -nostop
![[Windows]](../images/windows.gif)
restoreConfig.bat WebSphereConfig_2006-04-22.zip -location /tmp -nostop
![[z/OS]](../images/ngzos.gif)
restoreConfig.sh WebSphereConfig_2006-04-22.zip -location /tmp -nostop
![[IBM i]](../images/iseries.gif)
restoreConfig WebSphereConfig_2006-04-22.zip -location /tmp -nostop
![[IBM i]](../images/iseries.gif)
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.