Commande mqsicreatebroker -Systèmes Linux et AIX

Utilisez la commande mqsicreatebroker pour créer un noeud d'intégration sur les systèmes Linux® et AIX® .

Syntaxe

Paramètres

integrationNodeName

(Obligatoire) Nom du noeud d'intégration que vous créez. Ce paramètre doit être le premier paramètre. Si vous créez un nœud d'intégration dont le nom est en majuscules, vous devez également indiquer ce nom en majuscules dans l 'outil IBM® App Connect Enterprise.

Pour connaître les restrictions relatives au jeu de caractères que vous pouvez utiliser, voir Caractères autorisés dans les noms d'objet.

-q | --queue-manager queueManagerName

(Facultatif) Nom du gestionnaire de files d'attente associé au noeud d'intégration. Utilisez le même nom pour votre noeud d'intégration et votre gestionnaire de files d'attente afin de simplifier l'organisation et l'administration de votre réseau. Les noms de gestionnaire de files d'attente sont limités à 48 caractères et sont sensibles à la casse. Ce gestionnaire de files d'attente est utilisé par défaut pour le traitement de l' IBM MQ ation dans le flux de messages si aucun gestionnaire de files d'attente n'est explicitement spécifié sur le nœud « IBM MQ ».

Le gestionnaire de files d'attente spécifié sur le noeud d'intégration est également requis pour les noeuds de flux de messages qui utilisent des files d'attente système pour stocker des informations d'état sur les messages. Par exemple, les noeuds CD et WebSphere MQ File Transfer Edition , ainsi que les noeuds de traitement événementiel utilisés pour les flux d'agrégation et de délai d'attente, les collections de messages et les séquences de messages. Ces noeuds nécessitent la spécification d'un gestionnaire de files d'attente sur le noeud d'intégration et la création d'un ensemble de files d'attente système. Vous créez les files d'attente en exécutant le script iib_createqueues.bat dans le répertoire rép_install\server\sample\wmq . Vous pouvez également créer les files d'attente en exécutant la commande ` define qlocalIBM MQ `. Pour plus d'informations sur l'utilisation de define qlocal la commande, consultez la documentation du produit IBM MQ. Pour plus d'informations sur les fonctionnalités d' IBM App Connect Enterprise. qui nécessitent des files d'attente système, consultez la commande mqsicreatebroker.

Si vous spécifiez un gestionnaire de files d'attente qui n'existe pas, vous devez le créer avant le déploiement du flux.

Si le -q paramètre n'est pas spécifié, certaines fonctionnalités nécessitant l'accès à IBM MQ ne sont pas disponibles. Pour plus d'informations sur l'utilisation d' IBM MQ avec IBM App Connect Enterprise, consultez les pages « Interaction entre IBM App Connect Enterprise et IBM MQ » et « Installation d' IBM MQ ».

Si vous créez un noeud d'intégration multi-instance sur lequel le gestionnaire de files d'attente n'existe pas sur le serveur, un gestionnaire de files d'attente multi-instance est créé sous le chemin de travail partagé du noeud d'intégration multi-instance. Le gestionnaire de file d'attente multi-instances est créé à l'aide de la commande ` crtmqmIBM MQ ` comme suit :

  crtmqm -md \<integration node sharedWorkPath>\mqm\qmdata
         -ld \\<integration node sharedWorkPath>\mqm\qmlog queueManagerName

Si ce chemin de gestionnaire de files d'attente partagées n'est pas approprié, créez le gestionnaire de files d'attente multi-instance sur le serveur avant d'exécuter cette commande. Pour plus d'informations, voir Création d'un noeud d'intégration multi-instance.

Pour connaître les restrictions relatives au jeu de caractères que vous pouvez utiliser, voir Caractères autorisés dans les noms d'objet.

-w | --workpath workPath

(Facultatif) Répertoire de travail dans lequel sont stockés les fichiers de travail de ce noeud d'intégration.

Si vous spécifiez ce paramètre, un sous-répertoire portant le nom de ce noeud d'intégration est créé pour stocker ses fichiers de travail. Par exemple, si vous spécifiez /var/mqsi/acework lorsque vous créez un noeud d'intégration nommé node_name, le sous-répertoire créé est /var/mqsi/acework/components/node_name. (Ce répertoire de travail est un sous-ensemble de la structure du répertoire de travail IBM App Connect Enterprise; il contient moins de sous-répertoires et ne comporte aucun common/profiles sous-répertoire.) Si vous indiquez un nom de répertoire qui n'existe pas, il est créé automatiquement. Vous devez disposer des droits permettant de créer ce répertoire, sinon la commande échoue et renvoie une erreur.

Si vous ne spécifiez pas ce paramètre, les fichiers sont enregistrés dans un sous-répertoire du répertoire de travail d' IBM App Connect Enterprise, défini lors de l'installation du produit. Par exemple, pour un nœud d'intégration nommé « node_name », le chemin d'accès par défaut vers le répertoire de travail sur les systèmes Linux et AIX est /var/mqsi/components node_name.

Lorsque vous activez un noeud d'intégration pour le mode multi-instance à l'aide de l'indicateur -e , le noeud d'intégration workPath est utilisé pour stocker les données spécifiques à ce noeud d'intégration. Le noeud d'intégration workPath est également utilisé pour stocker des données partagées entre ce noeud d'intégration et ses instances. Les instances sont créées à l'aide de la commande mqsiaddbrokerinstance . Les données spécifiques au noeud d'intégration activé pour plusieurs instances sont stockées dans le répertoire workPath sur le serveur local. Les données partagées sont stockées dans un répertoire du stockage réseau à l'emplacement spécifié à l'aide de l'indicateur -e .

Lorsque vous activez la fonction de trace, ce répertoire est également utilisé pour les enregistrements de trace créés. Ces enregistrements sont écrits dans un sous-répertoire, log, que vous devez créer avant de démarrer le noeud d'intégration.

Les journaux d'erreurs qui sont écrits par le noeud d'intégration lorsqu'un processus se termine de manière anormale sont stockés dans ce répertoire.

Le journal des erreurs est illimité et continue de croître. Vérifiez régulièrement ce répertoire et effacez les anciennes informations d'erreur.

Pour modifier le répertoire de chemin de travail après la configuration du noeud d'intégration, vous devez supprimer puis recréer le noeud d'intégration avec le nouveau répertoire de chemin de travail.

--node-conf-yaml fichier de travail

Fichier de configuration, node.conf.yaml, à utiliser pour le noeud d'intégration.

Lorsque le noeud d'intégration est créé, le fichier est copié dans workpath/components/integrationNodeName/node.conf.yaml. Si le paramètre node-conf-yaml n'est pas fourni, le fichier node.conf.yaml par défaut est copié.

--vault-key vaultKey

(Facultatif) Ce paramètre indique la clé de coffre à utiliser pour créer le coffre. Si le paramètre --vault-key ou --vaultrc-location est spécifié dans la commande, un coffre App Connect Enterprise est créé pour contenir les données d'identification utilisées par le noeud d'intégration lorsqu'il accède à des ressources sécurisées. Pour plus d'informations sur les coffres-forts, consultez la commande mqsivault et la section « Configuration d'un coffre-fort d' IBM App Connect Enterprise ».

--vaultrc-location

(Facultatif) Ce paramètre indique l'emplacement du fichier .mqsivaultrc utilisé pour localiser la clé de coffre et la clé de coffre de répertoire externe. Si le paramètre --vault-key ou --vaultrc-location est spécifié dans la commande, un coffre App Connect Enterprise est créé pour contenir les données d'identification utilisées par le noeud d'intégration lorsqu'il accède à des ressources sécurisées.

Si le répertoire spécifié n'existe pas, vous devez le créer avant d'exécuter la commande mqsicreatebroker avec le paramètre --vaultrc-location . Le répertoire doit contenir un fichier .mqsivaultrc que vous pouvez créer en exécutant la commande suivante:

mqsivault --vaultrc-store-default-key --vault-key 12345678 --vaultrc-location directory

Pour plus d'informations, voir Commande mqsivault.

--ext-vault-dir externalDirectoryVaultPath

(Facultatif) Ce paramètre indique le chemin d'accès au répertoire qui contient le coffre de répertoire externe. Ce répertoire doit déjà exister. Pour plus d'informations sur l'utilisation d'un coffre-fort de répertoire externe, consultez les sections « Configuration d'un coffre-fort d' IBM App Connect Enterprise » et « Configuration d'un coffre-fort de répertoire externe ».

-t | --trusted

(Facultatif) Le nœud d'intégration fonctionne à l'aide d'une liaison « fastpath » d' IBM MQ (appelée « application de confiance »)

Pour plus d'informations sur l'utilisation des applications de confiance d' IBM MQ, consultez la section « Intercommunication » de la documentation en ligne du produit IBM MQ.

-m | --migration-required

Indique que la migration est requise à partir d'un noeud d'intégration de publication / abonnement IBM .

-l --user-lil-path userLilPath

(Facultatif) Liste de chemins (répertoires) à partir desquels le noeud d'intégration charge les bibliothèques d'implémentation chargeables (fichiers LIL) pour les noeuds de traitement de messages définis par l'utilisateur.

N'incluez pas de variables d'environnement dans le chemin ; le noeud d'intégration les ignore.

Créez votre propre répertoire pour stocker vos fichiers .lil ou .jar . Ne les enregistrez pas dans le répertoire d'installation d' IBM App Connect Enterprise.

Si vous spécifiez plusieurs répertoires, séparez-les par un point-virgule (;).

-P | --http-port httpListenerPort

(Facultatif) Entrez le numéro du port sur lequel le support des services Web écoute.

Le nœud d'intégration lance cet auditeur lorsqu'un flux de messages comprenant des nœuds HTTP ou la prise en charge de services web est démarré. La valeur par défaut est 7080.

Vérifiez que le port que vous spécifiez n'est pas spécifié à d'autres fins.

-v | --statistics-major-interval statisticsMajorInterval

(Facultatif) Indiquez l'intervalle (en minutes) d'écriture des enregistrements d'archive de statistiques et de comptabilité. La plage valide est comprise entre 1 et 43200 minutes ; la valeur par défaut est 60.

-y | --ldap-principal ldapPrincipal

(Facultatif, mais obligatoire lorsque ldapCredentials est fourni.) L'entité utilisateur permettant d'accéder à un répertoire facultatif « LDAP » qui contient le contexte initial géré par JNDI pour le fournisseur JMS.

-z ldapCredentials

(Facultatif, mais obligatoire lorsque ldapPrincipal est fourni.) Le mot de passe utilisateur permettant d'accéder à LDAP.

-c | --icu-converter-path icuConverterPath

(Facultatif) Ensemble délimité de répertoires permettant de rechercher des convertisseurs de page de codes supplémentaires. Sur les systèmes Windows , le délimiteur est un point-virgule (;). Sur les systèmes UNIX et Linux , le délimiteur est le signe deux-points (:).

N'utilisez pas ce paramètre pour définir le chemin du convertisseur si les deux conditions suivantes s'appliquent:

Vous utilisez un convertisseur qui correspond à l'un des convertisseurs intégrés fournis.
Ce convertisseur est la page de codes locale du noeud d'intégration.

Utilisez la variable d'environnement ICU_DATA à la place.

-x | --user-exit-path userExitPath

(Facultatif) Chemin contenant l'emplacement de tous les exits utilisateur à charger pour les serveurs d'intégration dans ce noeud d'intégration. Ce chemin est ajouté au chemin de recherche de la bibliothèque système (PATH,LIBPATH,LD_LIBRARY_PATH,SHLIBPATH) pour le processus du serveur d'intégration uniquement.

-s | --admin-security adminSecurity

(Facultatif) Réservé pour la compatibilité. Pour définir et afficher le mode de sécurité d'administration, utilisez la commande mqsichangeauthmode et la commande mqsireportauthmode à la place de ce paramètre.

Indiquez le statut de sécurité administrative du noeud d'intégration. Si vous spécifiez -s active, la sécurité d'administration est activée. Seuls les ID utilisateur que vous autorisez sont autorisés à effectuer des actions sur le noeud d'intégration. Le droit de lecture, d'écriture et d'exécution est toujours accordé sur le noeud d'intégration à tous les ID utilisateur appartenant au groupe de sécurité mqbrkrs. Lorsque le noeud d'intégration est créé, vous pouvez ajouter d'autres autorisations d'ID utilisateur.

Si vous utilisez la sécurité basée sur une file d'attente, la file d'attente SYSTEM.BROKER.AUTH.nom_serveur_intégration est créé lorsque vous créez un serveur d'intégration sur un noeud d'intégration pour lequel la sécurité administrative est activée. Remplissez la file d'attente avec l'autorisation utilisateur appropriée.

Si vous spécifiez -s inactiveou que vous omettez ce paramètre, la sécurité d'administration du noeud d'intégration n'est pas activée. Tous les utilisateurs peuvent effectuer toutes les actions sur le noeud d'intégration et tous les serveurs d'intégration.

Si la sécurité d'administration du noeud d'intégration n'est pas activée, les utilisateurs Web peuvent accéder à l'interface utilisateur Web en tant qu'utilisateur par défaut, avec un accès illimité aux données et aux ressources du noeud d'intégration.

Pour plus d'informations sur la sécurité, voir Présentation de la sécurité d'administration et Autorisation des utilisateurs pour l'administration.

-e | --shared-workpath sharedWorkPath

(Facultatif) La définition de cette valeur active le noeud d'intégration pour le mode de fonctionnement multi-instance.

Vous devez spécifier un gestionnaire de files d'attente (-q) pour que le noeud d'intégration utilise ce paramètre. Vous devez vous assurer que le noeud d'intégration a accès à cet emplacement de stockage réseau avant de démarrer le noeud d'intégration. Vous devez également vous assurer que le gestionnaire de files d'attente du nœud d'intégration est configuré en tant que gestionnaire de files d'attente multi-instances IBM MQ. Les informations stockées dans ce répertoire partagé incluent:

Registre de noeud d'intégration
Répertoires de composant
Tables et fichiers de noeud d'intégration internes pour les flux de messages déployés
Propriétés de la règle.

-d | --mq-managed-service MQService

Remarque: Vous devez être membre du groupe mqm pour exécuter la commande mqsicreatebroker avec le paramètre -d .

(Facultatif) Indiquez si vous souhaitez qu'un nœud d'intégration puisse être démarré et arrêté en tant que service d' IBM MQ lors du démarrage et de l'arrêt du gestionnaire de files d'attente. Si vous définissez ce paramètre, vous pouvez modifier ultérieurement le réglage à l'aide de la mqsichangeproperties commande. Pour plus d'informations, consultez les exemples dans la commande mqsichangeproperties.
Vous devez spécifier un gestionnaire de file d'attente (-q) pour que le nœud d'intégration puisse utiliser ce paramètre.

Cette option est une alternative au démarrage d'un noeud d'intégration multi-instance en mode veille à l'aide de la commande mqsistart .

Si vous spécifiez -d defined, le serviceMQ est défini sur le gestionnaire de files d'attente, et le noeud d'intégration démarre et s'arrête lorsque le gestionnaire de files d'attente démarre et s'arrête.

Remarque: Vérifiez que l'ID utilisateur mqm est membre du groupe du système d'exploitation mqbrkrs car le noeud d'intégration est démarré par l'ID utilisateur mqm .

Si vous spécifiez -d undefined, le serviceMQ n'est pas défini dans le gestionnaire de files d'attente et le noeud d'intégration ne démarre pas et ne s'arrête pas lorsque le gestionnaire de files d'attente démarre et s'arrête. Il s'agit du paramètre par défaut.

Pour plus d'informations sur l'exécution du nœud d'intégration en tant que service d' MQ, consultez Création d'un nœud d'intégration multi-instances.

-C | --ccsid CCSID

(Facultatif) CCSID interne du noeud d'intégration. La valeur par défaut est définie lors de l'installation et est basée sur les valeurs définies pour les variables d'environnement local et de langue. Si ces variables ne sont pas définies, la valeur par défaut 1208 est utilisée.

--trace traceFileName

(Facultatif) Utilisez ce paramètre pour envoyer une trace interne prolixe au fichier spécifié.

Exemples

Créez un nœud d'intégration avec un gestionnaire de files d'attente associé appelé monQmgr:

mqsicreatebroker INODE -q myQmgr

Créez un noeud d'intégration à exécuter en tant qu'application sécurisée:

mqsicreatebroker INODE -t

Créez un noeud d'intégration qui fait référence à des exits utilisateur:

mqsicreatebroker INODE -x /opt/3rdparty/wmbexits

Créez un noeud d'intégration avec la sécurité administrative activée:

mqsicreatebroker INODE -s active

Créez un nœud d'intégration en utilisant le gestionnaire de files d'attente MyQMGR multi-instances et le chemin de MyNetworkSharedWorkpathtravail partagé, le nœud d'intégration démarrant en tant que service d' IBM MQ :

mqsicreatebroker INODE 
	-q MyQmgr -e MyNetworkSharedWorkpath -d defined