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.

[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

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
[IBM i][AIX Solaris HP-UX Linux Windows]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.
[z/OS]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]]]') 

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_cli_me_create
Nom du fichier : rjk_cli_me_create.html