Commande addSIBusMember
La commande addSIBusMember permet d'ajouter un membre à un bus d'intégration de services à l'aide de l'outil wsadmin. Un membre de bus peut être un serveur d'applications, un serveur WebSphere MQ ou un cluster de serveurs.
Pour exécuter la commande, utilisez l'objet AdminTask du client de scriptage wsadmin.
Le client de scriptage wsadmin est exécuté à partir de Qshell.
Pour plus d'informations, voir Configuration de Qshell pour exécuter des scripts WebSphere à l'aide de l'outil de scriptage wsadmin.
- 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')
AdminConfig.save()
Rôle
La commande addSIBusMember ajoute un nouveau membre à un bus d'intégration de services. Lorsqu'un serveur d'applications est ajouté en tant que membre d'un bus, un moteur de messagerie est créé automatiquement avec les paramètres par défaut.
Lorsqu'un cluster est ajouté en tant que membre d'un bus et que l'assistant de création de règles de moteur de messagerie n'est pas activé, un moteur de message est créé automatiquement avec les paramètres par défaut. Pour créer un moteur de messagerie supplémentaire pour un membre du bus, utilisez la commande createSIBEngine.
Lorsqu'un cluster est ajouté à un bus et que l'assistant des règles de moteur de messagerie est activé avec un type de règle de moteur de messagerie à haute disponibilité, un moteur de messagerie est créé automatiquement avec des paramètres qui prennent en charge les règles de haute disponibilité.
Lorsqu'un cluster est ajouté à un bus et que l'assistant de création de règles de moteur de messagerie est activé avec l'option d'évolutivité ou d'évolutivité avec haute disponibilité, un moteur de messagerie est créé automatiquement avec des paramètres qui prennent en charge les règles sélectionnées. Vous devez ensuite utiliser la commande createSIBEngine pour créer d'autres moteurs de messagerie (un pour chaque serveur d'applications du cluster). Pour chaque moteur de messagerie créé, les paramètres qui prennent en charge la règle sélectionnée sont automatiquement créés.
Si vous utilisez la commande addSIBusMember avec l'assistant de création de règles de moteur de messagerie activé et que la règle du moteur de messagerie personnalisé est indiquée, vous pouvez définir le comportement du premier moteur de messagerie, puis utiliser la commande createSIBEngine pour créer des moteurs de messagerie supplémentaires.
Lorsqu'un serveur WebSphere MQ est ajouté en tant que membre d'un bus, un proxy de serveur est créé pour remplacer les propriétés de la connexion parent (hôte, port, canal et alias de configuration de sécurité SSL) définies dans le serveur WebSphere MQ. De la sorte, un ensemble de propriétés de connexion différent peut être affecté à chaque relation d'appartenance au bus.
Objet cible
Aucun
Un objet de membre de bus est créé. Si le membre de bus est un serveur ou un cluster de serveurs, un moteur de messagerie est également créé.
Paramètres requis
- -bus nom_bus
- Nom sous lequel le bus d'intégration de services est connu. Vous pouvez utiliser la commande listSIBuses pour afficher la liste des noms des bus existants.
Paramètres conditionnels
- -node nom_noeud
- -server nom_serveur
- Pour ajouter un serveur d'applications en tant que membre d'un bus, indiquez le nom du noeud
sur lequel le serveur est exécuté et le nom du serveur.
Si vous indiquez ces paramètres, n'indiquez pas les paramètres -cluster ou -wmqServer.
- -cluster nom_cluster
- Pour ajouter un cluster de serveurs en tant que membre de bus, indiquez le nom de ce cluster.
Si vous indiquez ce paramètre, n'indiquez pas les paramètres -node, -server ou -wmqServer.
- -wmqServer
- Pour ajouter un serveur WebSphere MQ en tant que membre du bus, indiquez le nom du serveur WebSphere MQ. Il s'agit du nom indiqué dans le paramètre -name lors de la création du serveur WebSphere MQ.
Si vous indiquez ce paramètre, n'indiquez pas les paramètres -cluster, -node ou -server.
Paramètres optionnels
- -description texte
- Description facultative du membre de bus à des fins d'administration.
- -virtualQueueManagerName
- Valeur de substitution pour le nom du gestionnaire de files d'attente virtuelles du serveur
WebSphere MQ. Lors de l'envoi de messages à IBM MQ, le gestionnaire de files d'attente de passerelle IBM MQ considère le bus comme un gestionnaire de files d'attente éloignées. Le nom du gestionnaire de files d'attente
virtuelles est celui qui est transmis à IBM MQ en tant que nom de ce gestionnaire de files d'attente éloignées. La valeur par défaut est le nom du bus. Si cette valeur n'est pas un nom valide pour un gestionnaire de files d'attente IBM MQ ou si un autre
gestionnaire de files d'attente IBM MQ porte déjà le même nom, remplacez la valeur par défaut par un nom valide et unique pour un
gestionnaire de files d'attente IBM MQ. Pour être valide,
le nom doit respecter les critères suivants :
- Il doit comporter entre 1 et 48 caractères.
- Il doit être conforme aux conventions de dénomination de file d'attente IBM MQ (voir la rubrique Rules for naming IBM MQ objects dans le centre de documentation IBM MQ).
- -host
- Valeur de substitution de l'attribut host du membre de bus du serveur WebSphere MQ. Cette valeur est le nom d'hôte ou l'adresse IP avec lequel une connexion est établie pour communiquer avec un gestionnaire de files d'attente ou un groupe de partage de files d'attente. Utilisez ce paramètre si le paramètre -wmqServer est indiqué.
- -port
- Valeur de substitution de l'attribut port du membre de bus du serveur WebSphere MQ. Le numéro de port est contrôlé par un module d'écoute du gestionnaire de files d'attente ou du groupe de partage de files d'attente qui écoute les connexions. La valeur par défaut est 1414. Utilisez ce paramètre si le paramètre -wmqServer est indiqué.
- -channel
- Valeur de substitution de l'attribut channel du membre de bus du serveur WebSphere MQ. Il s'agit du nom du canal de connexion du serveur utilisé pour établir une connexion au gestionnaire de files d'attente IBM MQ ou au groupe de partage de files d'attente IBM MQ for z/OS. La valeur par défaut est SYSTEM.DEF.SVRCONN. Utilisez ce paramètre si le paramètre -wmqServer est indiqué.
- -securityAuthAlias
- Valeur de substitution de l'attribut securityAuthAlias du membre de bus du serveur WebSphere MQ. Il s'agit de l'alias d'authentification fourni lors de la connexion au serveur WebSphere MQ. Ce paramètre ne comporte pas de valeur par défaut. Utilisez ce paramètre si le paramètre -wmqServer est indiqué.
- -transportChain
- Valeur de substitution de l'attribut transportChain du membre de bus du serveur WebSphere MQ. Il s'agit du nom de la chaîne de transport à utiliser lors de la communication avec IBM MQ. La valeur par défaut est OutboundBasicWMQClient. Utilisez ce paramètre si le paramètre -wmqServer est indiqué.
- -trustUserIds TRUE | FALSE
- Valeur de substitution de l'attribut trustUserIds du membre de bus du serveur WebSphere MQ. Cette valeur détermine si les ID utilisateur reçus dans les messages provenant de IBM MQ sont propagés dans les messages.
L'ID utilisateur de l'application est toujours défini à partir de la valeur jsAppUserIdRFH2.
Si cette valeur est absente (soit parce que la paire clé/valeur est absente du
dossier <sib> de l'en-tête RFH2 ou que le message ne comporte pas d'en-tête
RFH2), cette zone ne sera pas définie. Ce paramètre peut avoir l'une des valeurs suivantes :
- TRUE
- Les ID utilisateur sont propagés dans les messages.
- FALSE
- Les ID utilisateur ne sont pas propagés dans les messages.
La valeur par défaut est TRUE. Utilisez ce paramètre si le paramètre -wmqServer est indiqué.
- -enableAssistance TRUE | FALSE
- Paramètre qui indique si l'assistant de création de règles de moteur de messagerie doit être activé. Ce paramètre peut avoir l'une des valeurs suivantes :
- TRUE
- L'assistant de création de règles de moteur de messagerie est activé. Vous devez indiquer un paramètre -policyName.
- FALSE
- L'assistant de création de règles de moteur de messagerie n'est pas activé. Il s'agit de la valeur par défaut. Utilisez ce paramètre si le paramètre -cluster est indiqué.
- -policyName HA | SCALABILITY | SCALABILITY_HA | CUSTOM
- Type de règle de moteur de messagerie à appliquer au cluster. Ce paramètre peut posséder quatre valeurs :
- HA
- Applique la règle de moteur de messagerie à haute disponibilité au cluster.
- SCALABILITY
- Applique au cluster la règle de moteur de messagerie d'évolutivité.
- SCALABILITY_HA
- Applique au cluster la règle de moteur de messagerie d'évolutivité avec haute disponibilité.
- CUSTOM
- Applique la règle de moteur de messagerie au cluster.
Ce paramètre ne comporte pas de valeur par défaut. Utilisez ce paramètre si le paramètre -cluster est indiqué et que le paramètre -enableAssistance est défini à TRUE.
- -failover TRUE | FALSE
- Paramètre qui indique si le moteur de messagerie du cluster peut basculer sur un autre serveur du cluster en cas
de défaillance du serveur hôte du moteur de messagerie. Ce paramètre peut avoir l'une des valeurs suivantes :
- TRUE
- Le moteur de messagerie peut basculer sur un autre serveur.
- FALSE
- Le moteur de messagerie ne peut pas effectuer de basculement.
La valeur par défaut est FALSE. Utilisez ce paramètre si le paramètre -cluster est indiqué, et si les valeurs TRUE et CUSTOM sont respectivement attribuées aux paramètres -enableAssistance et -policyName.
- -failback TRUE | FALSE
- Paramètre qui indique si le moteur de messagerie du cluster qui a basculé sur un autre serveur peut rebasculer
sur un serveur favori de la liste des serveurs favoris si ce serveur est à nouveau disponible.
Ce paramètre peut avoir l'une des valeurs suivantes :
- TRUE
- Le moteur de messagerie peut rebasculer sur le serveur d'origine. Si vous utilisez cette option, vous devez indiquer le paramètre -preferredServerList.
- FALSE
- Le moteur de messagerie ne peut pas effectuer de basculement.
La valeur par défaut est FALSE. Utilisez ce paramètre si le paramètre -cluster est indiqué, et si les valeurs TRUE et CUSTOM sont respectivement attribuées aux paramètres -enableAssistance et -policyName.
- -preferredServersOnly TRUE | FALSE
- Paramètre qui indique si le moteur de messagerie du cluster peut s'exécuter uniquement sur des serveurs de la
liste des serveurs favoris, ou sur un serveur du cluster. Ce paramètre peut avoir l'une des valeurs suivantes :
- TRUE
- Le moteur de messagerie peut s'exécuter uniquement sur des serveurs de la liste des serveurs favoris. Si vous utilisez cette option, vous devez indiquer le paramètre -preferredServerList.
- FALSE
- Le moteur de messagerie peut s'exécuter sur un serveur du cluster.
La valeur par défaut est FALSE. Utilisez ce paramètre si le paramètre -cluster est indiqué, et si les valeurs TRUE et CUSTOM sont respectivement attribuées aux paramètres -enableAssistance et -policyName.
- -preferredServerList {{nom_noeud nom_serveur}}
- Liste de serveurs, par ordre de préférence, sur lesquels le moteur de messagerie du cluster préfère s'exécuter. Pour chaque serveur de la liste, indiquez le nom du noeud sur lequel le serveur s'exécute, ainsi que le nom du serveur. Il n'y a pas de valeur par défaut pour ce paramètre. Utilisez ce paramètre si le paramètre -cluster est indiqué, et si les valeurs TRUE et CUSTOM sont respectivement attribuées aux paramètres -enableAssistance et -policyName.
- -fileStore
- Crée un magasin de fichiers à utiliser comme emplacement de stockage des messages pour le moteur de messagerie.Un magasin de fichiers est un type d'emplacement de stockage des messages qui utilise directement les fichiers d'un système de fichiers sur le système d'exploitation. Vous pouvez également utiliser un magasin de données. Pour plus d'informations, voir les liens connexes.
- -logSize taillejournal
- Taille du fichier journal en mégaoctets. Utilisez ce paramètre si le paramètre -fileStore est indiqué.
- -logDirectory nomrépertoirejournal
- Nom du répertoire du fichier journal si vous ne souhaitez pas utiliser le répertoire du journal par défaut. Utilisez ce paramètre si le paramètre -fileStore est indiqué.
- -minPermanentStoreSize tailleminmagasinpermanent
- Taille minimale du magasin permanent en mégaoctets. Utilisez ce paramètre si le paramètre -fileStore est indiqué.
- -minTemporaryStoreSize tailleminmagasintemporaire
- Taille minimale du magasin temporaire en Mo. Utilisez ce paramètre si le paramètre -fileStore est indiqué.
- -maxPermanentStoreSize taillemaxmagasinpermanent
- Taille maximale du magasin permanent en mégaoctets. Utilisez ce paramètre si le paramètre -fileStore est indiqué.
- -maxTemporaryStoreSize taillemaxmagasintemporaire
- Taille maximale du magasin temporaire en Mo. Utilisez ce paramètre si le paramètre -fileStore est indiqué.
- -unlimitedPermanentStoreSize TRUE | FALSE
- Paramètre spécifiant si la taille du magasin permanent est illimitée. Ce paramètre peut avoir l'une des valeurs suivantes :
- TRUE
- La taille du magasin permanent est illimitée.
- FALSE
- La taille du magasin permanent est limitée. Si vous utilisez cette option, indiquez le paramètre -maxPermanentStoreSize.
Utilisez ce paramètre si le paramètre -fileStore est indiqué.
- -unlimitedTemporaryStoreSize TRUE | FALSE
- Paramètre spécifiant si la taille du magasin temporaire est illimitée. Ce paramètre peut avoir l'une des valeurs suivantes :
- TRUE
- La taille du magasin temporaire est illimitée.
- FALSE
- La taille du magasin temporaire est limitée. Si vous utilisez cette option, indiquez le paramètre -maxTemporaryStoreSize.
Utilisez ce paramètre si le paramètre -fileStore est indiqué.
- -permanentStoreDirectory nomrépertoiremagasinpermanent
- Nom du répertoire du magasin permanent si vous ne souhaitez pas utiliser le répertoire du journal par défaut. Utilisez ce paramètre si le paramètre -fileStore est indiqué.
- -temporaryStoreDirectory nomrépertoiremagasintemporaire
- Nom du répertoire du magasin temporaire si vous ne souhaitez pas utiliser le répertoire du magasin temporaire par défaut. Utilisez ce paramètre si le paramètre -fileStore est indiqué.
- -dataStore
- Crée un magasin de données à utiliser comme emplacement de stockage des messages pour le moteur de messagerie.
Un magasin de données se compose de l'ensemble de tables qu'un moteur de messagerie utilise pour stocker les données persistantes dans une base de données. Voir Tables des magasins de données pour la liste des tables constituant un magasin de données. Toutes les tables d'un magasin de données sont conservées dans le même schéma de base de données. Vous pouvez créer plusieurs magasins de données dans la même base de données si vous utilisez un schéma distinct pour chacun d'eux.
Vous pouvez également utiliser le magasin de fichiers (par défaut). Pour plus d'informations, voir les liens connexes. - -createDefaultDatasource TRUE | FALSE
- Paramètre qui indique si une source de données par défaut doit être créée lors de la création du
moteur de messagerie. Ce paramètre peut avoir l'une des valeurs suivantes :
- TRUE
- Crée une source de données par défaut.
- FALSE
- Ne crée pas de source de données par défaut.
Utilisez ce paramètre si le paramètre -dataStore est indiqué. N'utilisez ce paramètre si le paramètre -cluster est indiqué.
- -datasourceJndiName nomjndi
- Nom JNDI de la source de données utilisé par le moteur de messagerie pour accéder au système de gestion de base de données relationnelle du magasin de données. Utilisez ce paramètre si le paramètre -dataStore est indiqué.
- -authAlias aliasauth
- Nom de l'alias d'authentification que le moteur de messagerie utilise pour se connecter à la base de données dans son magasin de données. Utilisez ce paramètre si le paramètre -dataStore est indiqué.
- -createTables sourcedonnées
- Crée automatiquement des tables de base de données pour la source de données indiquée. Si cette option n'est pas indiquée, l'administrateur des bases de données doit créer les tables. Utilisez ce paramètre si le paramètre -dataStore est indiqué.
- -restrictLongDBLock TRUE | FALSE
- Paramètre indiquant si le moteur de messagerie actif doit conserver des verrous de longue durée sur la table SIBOWNER de la base de données.
Si vous sélectionnez cette option, le moteur de messagerie verrouille la base
de données uniquement pendant de courtes périodes. Lorsque le moteur de messagerie
actif ne répond pas à la base de données, celui de secours pourra
en devenir propriétaire car les verrous établis par le moteur de messagerie actif
ne sont que de courte durée. Ce paramètre peut avoir l'une des valeurs suivantes :
- TRUE
- Restreindre les verrous de longue durée sur la base de données.
- FALSE
- Ne pas restreindre les verrous de longue durée sur la base de données.
Utilisez ce paramètre si le paramètre -dataStore est indiqué.
Important : Bien que la propriété soit sélectionnée, elle ne sera pas effective tant que les tables de base de données ne seront pas mises à niveau à l'aide de la commande sibDBUpgrade pour WebSphere Application Server Version 9.0 et versions ultérieures. - -schemaName nomschéma
- Nom du schéma de base de données qui contient les tables du magasin de données, si vous ne souhaitez pas utiliser le nom de schéma par défaut. Pour plus de détails sur le schéma par défaut, voir Création d'utilisateurs et de schémas dans la base de données. Utilisez ce paramètre si le paramètre -dataStore est indiqué.
- -initialHeapSize taille
- Taille de pile de la machine virtuelle
Java™ (JVM) initiale (en Mo)
du serveur ou de chaque serveur du cluster.
Il n'existe pas de valeur par défaut. Si ce paramètre n'est pas spécifié, aucune modification n'est effectuée. Si ce paramètre est
spécifié, la valeur fournie doit être supérieure ou égale à zéro et inférieure
ou égale à 2048.
Si ce paramètre est fourni sans valeur, un
message d'erreur est généré.
Remarque : Ce paramètre est ignoré si le serveur cible de la commande addSIBusMember fonctionne sous z/OS ou, lorsque la cible est un cluster, si tout serveur de ce cluster fonctionne sous z/OS.
- -maxHeapSize taille
- Taille de pile maximale de la machine virtuelle Java (en Mo) du serveur ou de chaque
serveur d'un cluster. Il n'existe pas de valeur par défaut. Si ce paramètre n'est pas spécifié, aucune modification n'est effectuée. Si ce paramètre est
spécifié, la valeur fournie doit être supérieure ou égale à zéro et inférieure
ou égale à 2048. Si ce paramètre est fourni sans valeur, un message d'erreur
est généré.
Remarque : Ce paramètre est ignoré si le serveur cible de la commande addSIBusMember fonctionne sous z/OS ou, lorsque la cible est un cluster, si tout serveur de ce cluster fonctionne sous z/OS.
Exemples
Ajoutez le serveur server1 sur le noeud node1 en tant que membre du bus bus1 avec un magasin de fichiers par défaut.
AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1 ]')
Ajoutez le serveur server1 en tant que membre de bus1, en utilisant un magasin de fichiers pour stocker les messages.
AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1 -fileStore ]')
Ajoutez server1 en tant que membre de bus1, en utilisant un magasin de fichiers pour stocker les messages avec les options.
AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1 -fileStore
-logSize 100 -logDirectory C:\\filestore1 ]')
Ajoutez le serveur server1 en tant que membre de bus1, en utilisant un magasin de données pour stocker les messages.
AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1 -dataStore ]')
Ajoutez server1 en tant que membre de bus1, en utilisant un magasin de données pour sauvegarder les messages avec les options.
AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1 -dataStore
-createDefaultDatasource true -datasourceJndiName myjndi]')
Ajoutez cluster1 à bus1 sans utiliser l'assistant de création de règles de moteur de messagerie et en utilisant un magasin de fichiers comme emplacement de stockage des messages du moteur de messagerie.
AdminTask.addSIBusMember('[-bus bus1 -cluster cluster1 -fileStore true
-logDirectory C:\\filestore1 -permanentStoreDirectory C:\\filestore2
-temporaryStoreDirectory C:\\filestore3]')
Ajoutez cluster1 à bus1 et utilisez l'assistant de création de règles de moteur de messagerie et la stratégie du moteur de messagerie haute disponibilité. Utilisez un magasin de fichiers comme emplacement de stockage des messages pour le moteur de messagerie.
AdminTask.addSIBusMember('[-bus bus1 -cluster cluster1 -enableAssistance true
-policyName HA -fileStore -permanentStoreDirectory C:\\filestore1
-temporaryStoreDirectory C:\\filestore1 -logDirectory C:\\filestore1 ]')
Ajoutez cluster1 au bus1 et utilisez l'assistant de création de règles de moteur de messagerie et la stratégie de moteur de messageroe personnalisée. Utilisez un magasin de fichiers comme emplacement de stockage des messages pour le moteur de messagerie. Indiquez que le moteur de messagerie doit basculer sur un autre serveur, pas sur le serveur initial et qu'il doit s'exécuter sur server1 et server2.
AdminTask.addSIBusMember('[-bus bus1 -cluster cluster1 -enableAssistance true
-policyName CUSTOM -fileStore -permanentStoreDirectory C:\\filestore1
-temporaryStoreDirectory C:\\filestore1 -logDirectory C:\\temp\filestore
-failover true -failback false -preferredServersOnly true
-preferredServerList [[node1 server1] [node2 server2]]]')
Remplacez la taille initiale des segments de mémoire de la machine JVM (256)
par la taille maximale des segments de mémoire de la machine JVM (512).
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1
-initialHeapSize 256 -maxHeapSize 512]')