Commande recoverMEConfig

La commande recoverMEConfig permet de récupérer depuis l'emplacement de stockage des messages les données de configuration du moteur de messagerie ayant échoué ou s'étant arrêté de manière anormale lorsqu'aucune sauvegarde n'est disponible. L'emplacement de stockage des messages peut être une base de données ou un système de magasin de fichiers auquel le moteur de messagerie antérieur était connecté.

Cette commande récupère les données de configuration du moteur de messagerie depuis les files d'attente et les rubriques de l'emplacement de stockage des messages.

La récupération des données persistantes du moteur de messagerie depuis l'emplacement de stockage des messages n'est pas possible si les données de configuration du moteur de messagerie précédent ne sont pas disponibles. La raison en est que lorsqu'un serveur est ajouté en tant que nouveau membre du bus d'intégration des services, le bus crée un nouvel identificateur unique universel (UUID) qui n'est pas le même que celui du moteur de messagerie stocké dans l'emplacement de stockage des messages. Utilisez cette commande pour récupérer l'UUID stocké du moteur de messagerie et ses données de configuration des files d'attente et des rubriques seulement. Les UUID des files d'attente et des rubriques sont restaurés avec leurs valeurs par défaut pour toutes les autres propriétés de configuration. Après la récupération des données de configuration, les messages préservés du moteur de messagerie en panne peuvent être récupérés et leur traitement peut se poursuivre.
Remarque : Vous devez vérifier qu'aucune commande recoverMEConfig n'est en exécution avant de lancer une nouvelle commande.
Les messages de trace suivants peuvent être utilisés pour déterminer si une commande antérieure est en cours d'exécution :
  • CWSJA0166E : La récupération de configuration de moteur de messagerie a démarré pour la base de données : avec utilisation du schéma : <nom_schéma pour nom JNDI : <nom_JNDI

    Ce message de trace signale le démarrage de la commande de reprise utilisant la base de données. Il s'agit de l'entrée de ligne de trace que l'utilisateur doit utiliser pour vérifier le démarrage de la commande de reprise.

  • CWSJA0166E : La récupération de configuration de moteur de messagerie a démarré pour le système de fichiers : avec utilisation du répertoire de journaux : <répertoire_journaux répertoire journaux permanents : <répertoire_journaux_permanents répertoire journaux temporaires : <répertoire_journaux_temporaires

    Ce message de trace signale le démarrage de la commande de reprise utilisant le système de fichiers.

  • CWSJA0167E : La récupération de configuration de moteur de messagerie a démarré pour la base de données : avec utilisation du schéma : <nom_schéma pour nom JNDI : <nom_JNDI est terminée.

Pour exécuter la commande, utilisez l'objet AdminTask du client de scriptage wsadmin.

[IBM i][IBM i]Le client de scriptage wsadmin est exécuté à partir de Qshell. [IBM i]Pour plus d'informations, voir Configuration de Qshell pour exécuter des scripts WebSphere à l'aide de l'outil de scriptage wsadmin.

L'aide de la ligne de commande est fournie pour les commandes de bus d'intégration de services :
  • Pour obtenir une liste des commandes de bus d'intégration de services disponibles dans Jython et une brève description de chacune d'elles, entrez la commande suivante à l'invite wsadmin :

    print AdminTask.help('SIBAdminCommands')

  • Pour obtenir une aide générale sur une commande donnée, entrez la commande suivante à l'invite wsadmin :

    print AdminTask.help('nom_commande')

Après avoir utilisé ces commandes, sauvegardez les modifications apportées à la configuration maîtresse en exécutant la commande suivante :

AdminConfig.save()

Rôle

Lorsqu'un membre du bus (tel qu'un serveur ou un cluster) du moteur de messagerie échoue ou s'arrête de manière anormale, les messages persistants du moteur de messagerie dans l'emplacement de stockage des messages peuvent être récupérés. A l'aide de cette commande, vous pouvez récupérer les données de configuration du moteur de messagerie en panne ou défaillant dans les espaces de files d'attente et de rubriques si une sauvegarde des données de configuration n'est pas disponible.
Remarque : Utilisez cette commande uniquement si une sauvegarde des données de configuration do moteur de messagerie en échec ou en panne n'est pas disponible.

Objet cible

Aucun.

Paramètres obligatoires

-busName nom_bus
Nom du bus d'intégration de services sous lequel existait le moteur de messagerie tombé en panne. Vous pouvez utiliser la commande listSIBuses pour afficher la liste des noms des bus existants. Si ce nom de bus n'existe pas, un nouveau bus est créé avec ce nom.
-messageStore type d'emplacement de stockage des messages
Spécifiez le type d'emplacement de stockage des messages depuis lequel doivent être récupérées les données du moteur de messagerie. Spécifiez FILE pour une récupération depuis le système de fichiers ou DB pour une récupération depuis la base de données.

Si la valeur sélectionnée est FILE, l'utilisateur doit renseigner les paramètres -logDirectory, -permLogDirectory, -tempLogDirectory, -nodeName et -serverName ou -clusterName.

Si la valeur sélectionnée est DB, l'utilisateur doit renseigner les paramètres -dataSource, -schema, -nodeName et -serverName ou -clusterName.

-nodeName nom_noeud
Spécifiez le nom du noeud sur lequel le moteur de messagerie précédent s'exécutait. Les données de configuration du moteur de messagerie précédent seront restaurées sous le même nom de noeud.
-serverName nom_serveur
Spécifiez le nom du serveur sur lequel le moteur de messagerie précédent s'exécutait.

Si vous spécifiez les paramètres nom_noeud et nom_serveur, ne spécifiez pas les paramètres -clusterName.

-clusterName nom_cluster
Pour ajouter un cluster de serveurs en tant que membre de bus, indiquez le nom de ce cluster.

Si vous spécifiez ce paramètre, ne spécifiez pas les paramètres -nodeName et -serverName.

-logDirectory nomrépertoirejournal
Chemin complet du répertoire de fichiers journaux utilisé par l'emplacement de stockage des messages du moteur de messagerie en panne. Utilisez ce paramètre si la valeur spécifiée pour le paramètre -messageStore est FILE.
-permLogDirectory nom_répertoire_journaux_permanents
Chemin complet du répertoire de journaux permanents utilisé par l'emplacement de stockage des messages du moteur de messagerie en panne pour stocker les objets permanents. Utilisez ce paramètre si la valeur spécifiée pour le paramètre -messageStore est FILE.
-tempLogDirectory nom_répertoire_journaux_temporaires
Chemin complet du répertoire de journaux temporaires utilisé par l'emplacement de stockage des messages du moteur de messagerie en panne pour stocker les objets permanents. Utilisez ce paramètre si la valeur spécifiée pour le paramètre -messageStore est FILE.
-dataSource nom_source_données
Nom de la source de données utilisée par le moteur de messagerie pour accéder au SGBD relationnel du magasin de données. Utilisez ce paramètre si la valeur spécifiée pour le paramètre -messageStore est DB.
Vous pouvez utiliser la commande $AdminConfig list DataSource pour obtenir la liste des noms d'objets source de données.
Remarque : Le paramètre -dataSource utilisé pour la récupération des données du moteur de messagerie peut être défini au niveau du serveur ou de la cellule, et si une commande de récupération existante est déjà en cours d'exécution, l'utilisateur doit vérifier qu'elle est terminée avant de lancer une nouvelle commande.
-schemaName nomschéma
Nom du schéma de base de données depuis lequel les données du moteur de messagerie doivent être récupérées. Utilisez ce paramètre si la valeur spécifiée pour le paramètre -messageStore est DB.

Exemple

Pour récupérer les données persistantes d'un système de fichiers depuis l'emplacement de stockage des messages au niveau du serveur :

$AdminTask recoverMEConfig {-busName Bus01 -messageStore FILE 
-logDirectory "c:\FileStoreLogs" -permLogDirectory "c:\PermFileStoreLogs" 
-tempLogDirectory "c:\TempFileStoreLogs" -nodeName node1 -serverName server1}

Pour récupérer les données persistantes d'un système de base de données depuis l'emplacement de stockage des messages au niveau du serveur :

$AdminTask recoverMEConfig {-busName bus55 -messageStore DB 
-dataSource "MyDataSource" -schemaName "server6" 
-nodeName node01 -serverName server01}

Pour récupérer les données persistantes d'un système de base de données depuis l'emplacement de stockage des messages au niveau du cluster :

$AdminTask recoverMEConfig {-busName bus55 -messageStore DB 
-dataSource "MyDataSource" 
-schemaName "server6" -clusterName cluster01}

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=rjk_recoverme_config
Nom du fichier : rjk_recoverme_config.html