Commande createSIBEngine
La commande createSIBEngine permet de créer un moteur de messagerie pour un membre du bus du serveur ou du cluster à l'aide de l'outil wsadmin. Lorsque vous ajoutez un serveur ou un cluster comme membre d'un bus d'intégration de services, au moins un moteur de messagerie est créé automatiquement. La commande createSIBEngine permet de créer un moteur de messagerie supplémentaire pour un membre de bus de cluster.
Chaque membre de bus de serveur possède exactement un moteur de messagerie, mais les membres du bus de cluster peuvent prendre en charge des moteurs supplémentaires. Si vous créez un moteur supplémentaire pour un cluster et que vous utilisez un magasin de données pour l'emplacement de stockage des messages, vous devez configurer de manière explicite le magasin de données et la source de données JDBC que le moteur de messagerie utilise pour interagir avec le magasin de données. Vous devez créer la source de données dans la portée du cluster et non dans celle du noeud. Pour plus d'informations sur la création de moteurs de messagerie, voir Configuration d'une source de données pour un moteur de messagerie s'exécutant sur un cluster.
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 createSIBEngine permet de créer un moteur de messagerie pour un membre du bus du serveur ou du cluster. Utilisez cette commande pour créer un moteur supplémentaire pour un membre de bus du cluster.
Si l'assistant de création de règles de moteur de messagerie est activé pour le cluster et que la règle d'évolutivité ou la règle d'évolutivité avec haute disponibilité est définie, les paramètres du moteur de messagerie sont créés automatiquement pour se conformer à la règle indiquée.
Une fois cette commande exécutée, utilisez la commande createMissingSIBEnginePolicy pour créer une règle de groupe central si l'assistant de création de règles de moteur de messagerie est activé et que la règle personnalisée est indiquée.
Objet cible
Aucun.
Paramètres requis
- -bus nom_bus
- Nom du bus d'intégration de services sur lequel le membre de bus est configuré. 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 créer un moteur de messagerie d'un serveur qui est un membre de bus, indiquez le nom du noeud sur lequel le serveur est exécuté et le nom du serveur.
- -cluster nom_cluster
- Pour créer un moteur de messagerie d'un cluster de serveurs membre de bus, indiquez le nom de ce cluster.
Paramètres optionnels
- -description texte
- Description facultative du moteur de messagerie à des fins administratives.
- -initialState STARTED | STOPPED
- Etat initial déterminant si le moteur de messagerie est démarré automatiquement au démarrage du
serveur ou du cluster de serveurs.
- STARTED
- Lorsque le serveur d'applications associé est démarré, le moteur de messagerie l'est également et devient disponible pour traiter les messages.
- STOPPED
- Lorsque le serveur d'applications associé est démarré, le moteur de messagerie est arrêté et n'est pas disponible pour traiter les messages.
- -highMessageThreshold nombre
- Nombre maximal de messages que le moteur de messagerie peut placer sur son point de
message.
Lorsque le moteur de messagerie est créé, le seuil élevé des messages du bus est utilisé pour définir la valeur par défaut de cette propriété. Lorsqu'un point de message est créé sur ce moteur de messagerie, la valeur de cette propriété est utilisée pour définir le seuil supérieur des messages par défaut du point de message.
- -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 l'assistant de création de règles de moteur de messagerie est activé et si les règles personnalisées sont indiquées sur le cluster. Pour ce faire, utilisez la commande addSIBusMember ou modifySIBusMemberPolicy.
- -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 l'assistant de création de règles de moteur de messagerie est activé et si les règles personnalisées sont indiquées sur le cluster. Pour ce faire, utilisez les commandes addSIBusMember ou modifySIBusMemberPolicy.
- -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 l'assistant de création de règles de moteur de messagerie est activé et si les règles personnalisées sont indiquées sur le cluster. Pour ce faire, utilisez la commande addSIBusMember ou modifySIBusMemberPolicy.
- -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 l'assistant de création de règles de moteur de messagerie est activé et si les règles personnalisées sont indiquées sur le cluster. Pour ce faire, utilisez la commande addSIBusMember ou modifySIBusMemberPolicy.
- -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 taille
- Taille du fichier journal en mégaoctets. Utilisez ce paramètre si le paramètre -fileStore est indiqué.
- -logDirectory nom_répertoire
- 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 taille
- Taille minimale du magasin permanent en mégaoctets. Utilisez ce paramètre si le paramètre -fileStore est indiqué.
- -minTemporaryStoreSize taille
- Taille minimale du magasin temporaire en Mo. Utilisez ce paramètre si le paramètre -fileStore est indiqué.
- -maxPermanentStoreSize taille
- Taille maximale du magasin permanent en mégaoctets. Utilisez ce paramètre si le paramètre -fileStore est indiqué.
- -maxTemporaryStoreSize taille
- 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 nom_répertoire
- 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 nom_répertoire
- 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 nom_jndi
- 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 alias_authentification
- 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 TRUE | FALSE
- Paramètre qui indique si les tables de base de données doivent être automatiquement créées pour la source de données. Ce paramètre peut avoir l'une des valeurs suivantes :
- TRUE
- Crée des tables de base de données pour la source de données.
- FALSE
Ne crée pas de tables de base de données pour la source de données. Si vous utilisez cette option, l'administrateur des bases de données doit créer les tables.
Ne crée pas de tables de base de données pour la source de données. Vous devez utiliser cette option pour le système d'exploitation z/OS car vous ne devez pas créer de 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 nom_sché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é.
Vous indiquez des combinaisons de paramètres différentes en fonction du magasin de données choisi et de ses attributs. Pour éviter les erreurs lorsque vous indiquez l'emplacement de stockage des messages pour le moteur de messagerie, voir Comment éviter la génération d'erreurs lors de la création d'un moteur de messagerie avec un magasin de fichiers ou un magasin de données à l'aide de l'outil wsadmin.
Exemples
Création d'un moteur de messagerie pour cluster1 sur bus1 qui utilise un magasin de fichiers par défaut.
AdminTask.createSIBEngine ('[-bus bus1 -cluster cluster1]')
Création d'un moteur de messagerie pour cluster1 sur bus1 qui utilise un magasin de fichiers avec des valeurs par défaut.
AdminTask.createSIBEngine ('[-bus bus1 -cluster cluster1 -fileStore]')
Création d'un moteur de messagerie pour cluster1 sur bus1 qui utilise un magasin de fichiers avec des options.
AdminTask.createSIBEngine ('[-bus bus1 -cluster cluster1 -fileStore
-logSize 3636363 -logDirectory C:\mylogdirectory]')
Création d'un moteur de messagerie pour cluster1 sur bus1 qui utilise un magasin de données avec des valeurs par défaut.
AdminTask.createSIBEngine ('[-bus bus1 -cluster cluster1 -dataStore]')
Création d'un moteur de messagerie pour cluster1 sur bus1 qui utilise un magasin de données avec des options.
AdminTask.createSIBEngine ('[-bus bus1 -cluster cluster1 -dataStore
-createDefaultDatasource true -datasourceJndiName myjndi]')
Ajout d'un nouveau moteur de messagerie à cluster1 membre de bus1 et qui utilise un magasin de fichiers comme emplacement de stockage pour le moteur de messagerie.
AdminTask.createSIBEngine('[-bus bus1 -cluster cluster1 -fileStore true
-logSize 100 -minPermanentStoreSize 200 -maxPermanentStoreSize 500
-unlimitedPermanentStoreSize false -permanentStoreDirectory C:\myfilestore
-minTemporaryStoreSize 200 -maxTemporaryStoreSize 500
-unlimitedTemporaryStoreSize false -temporaryStoreDirectory C:\myfilestore
-logDirectory C:\myfilestore ]')
Ajout d'un nouveau moteur de messagerie à cluster1 membre de bus1, où cluster1 possède l'assistant de création de règles de moteur de messagerie activé et les règles de moteur de messagerie personnalisée indiqué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.createSIBEngine('[-bus bus1 -cluster cluster1 -fileStore true
-logSize 100 -minPermanentStoreSize 200 -maxPermanentStoreSize 500
-unlimitedPermanentStoreSize false -permanentStoreDirectory C:\myfilestore
-minTemporaryStoreSize 200 -maxTemporaryStoreSize 500
-unlimitedTemporaryStoreSize false -temporaryStoreDirectory C:\myfilestore
-logDirectory C:\myfilestore -failover true -failback false
-preferredServersOnly true -preferredServerList [[node1 server1] [node2 server2]]]')