Commande restoreConfig

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

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 dans lequel exécuter cette commande, voir Utilisation des outils de ligne de commande.

Si vous modifiez directement les fichiers de l'application dans le répertoire app_server_root/installedApps (processus appelé « déploiement à chaud »), mais que vous n'apportez pas les mêmes modifications aux fichiers de l'application dans le répertoire app_server_root/config , ces modifications risquent d'être écrasées si vous utilisez la restoreConfig commande.

[Linux]Cette backupConfig commande ne conserve pas les droits d'accès ni les informations relatives à la 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 vous souhaitez que les fichiers restaurés conservent leurs droits d'accès et leur propriété d'origine, utilisez la tar commande (disponible sur tous les systèmes UNIX ou Linux® ) pour sauvegarder et restaurer la configuration.

[AIX]Si vous utilisez un répertoire logique pour app_server_root/config, la restoreConfig commande ne fonctionnera pas.

Emplacement

Exécutez la commande depuis le répertoire profile_root/bin .

Syntaxe

La syntaxe de la commande est la suivante :

[Linux][AIX][HP-UX][Solaris]
restoreConfig.sh backup_file [options]
[Windows]
restoreConfig.bat backup_file [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_du_répertoire
Indique le répertoire dans lequel le fichier de sauvegarde est restauré.
Par défaut, l'emplacement est le répertoire app_server_root/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 mot de passe
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.

Syntaxe

L'exemple suivant montre la syntaxe correcte :

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

[Linux][AIX][HP-UX][Solaris]
restoreConfig.sh WebSphereConfig_2006-04-22.zip -location /tmp -nostop
[Windows]
restoreConfig.bat WebSphereConfig_2006-04-22.zip -location /tmp -nostop

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.