Installation d'un serveur IBM MQ sous Linux Ubuntu à l'aide de packages Debian

Vous pouvez installer un serveur IBM® MQ sur un système Linux® Ubuntu , à l'aide d'un programme d'installation Debian , conformément à la page Web de la configuration système requise.

Avant de commencer

Voir Configuration système requise pourIBM MQ pour plus de détails sur les niveaux de logiciels pris en charge.

Avant de commencer la procédure d'installation, assurez-vous d'avoir d'abord effectué les étapes nécessaires décrites dans Préparation du système surLinux .

Si vous avez installé IBM MQ 9.0.2, ou une version antérieure, sous Ubuntu à l'aide de rpm, vous devez désinstaller toutes les versions rpm du produit avant d'installer la version Debian du produit.

Vous avez la possibilité d'accepter la licence avant ou après l'installation du produit. Voir Accepter la licence leIBMMQ pourLinux pour plus d'informations.

A propos de cette tâche

Installez le serveur à l'aide d'un programme d'installation Debian pour sélectionner les composants à installer. Les composants et les noms de packages sont répertoriés dansIBMMQDebian composants pourLinuxUbuntu systèmes .

Attention: veillez à télécharger la version Ubuntu du package tar.gz avant d'installer le produit, car cette version contient les fichiers deb dont vous avez besoin pour l'outil apt-get .

Vous pouvez utiliser divers programmes d'installation. Cette rubrique décrit l'utilisation des programmes d'installation apt-get et dpkg .

apt-get

Vous pouvez utiliser apt-get pour installer des packages ; il n'est pas nécessaire d'installer les packages dépendants. apt-get installe les packages de dépendance du package dont vous avez besoin.

Vous devez permettre à apt-get d'accéder à vos fichiers en vue de leur utilisation.

Pour ce faire, exécutez la commande chmod -R a+rx DIRNAME, où DIRNAME est le répertoire dans lequel vous avez décompressé le package tar.gz.

Attention: si vous ne rendez pas vos fichiers accessibles à apt-get, les erreurs suivantes s'affichent:

N : Le téléchargement est effectué sans bac à sable en tant que root en tant que fichier'/sw/9400deb/./InRelease' n'est pas accessible à l'utilisateur '_apt'. -pkgAcquire::Run (13 : Autorisation refusée)
E: Echec de l'extraction du fichier file:/sw/9400deb/./Packages introuvable- /sw/9400deb/./Packages (2: aucun fichier ou répertoire de ce type)
E: Some index files failed to download. They have been ignored, or old ones used instead.

où /sw/9400deb est le répertoire à partir duquel vous installez IBM MQ.

dpkg

Vous pouvez utiliser dpkg pour installer des packages individuels, mais vous devez veiller à installer toutes les dépendances car dpkg n'installe pas les packages dépendants pour le package dont vous avez besoin. Pour plus d'informations sur les dépendances de chaque package, reportez-vous à la table Table 1 .

Pour prendre en charge l'exécution d'un gestionnaire de files d'attente, vous devez installer au moins les composants ibmmq-runtime et ibmmq-server.

Tableau 1. Dépendances des composant du package
Nom du package	Fonction de composant	Dépendances du package
ibmmq-runtime	Fonction commune pour tous les autres composants	Aucun
ibmmq-server	Gestionnaire de files d'attente	ibmmq-runtime ibmmq-gskit
ibmmq-client	Bibliothèques client C IBM MQ	ibmmq-runtime ibmmq-gskit
ibmmq-java	API Java et JMS IBM MQ	ibmmq-runtime
ibmmq-jre	environnement d'exécution Java (JRE)	ibmmq-runtime
ibmmq-sdk	Fichiers d'en-tête et bibliothèques pour les API nonJava	ibmmq-runtime
ibmmq-man	UNIX pages d'aide pour IBM MQ	ibmmq-runtime
ibmmq-samples	Exemples d'application IBM MQ	ibmmq-runtime
ibmmq-msg-cs ibmmq-msg-de ibmmq-msg-es ibmmq-msg-fr ibmmq-msg-hu ibmmq-msg-it ibmmq-msg-ja ibmmq-msg-ko ibmmq-msg-pl ibmmq-msg-pt ibmmq-msg-ru ¹ ibmmq-msg-zh-cn ibmmq-msg-zh-tw	Fichiers de catalogues de messages dans des langues supplémentaires. Les fichiers de catalogues de messages en anglais sont installés par défaut. Pour plus d'informations sur ces catalogues de messages, voir Sélection d'une langue nationale pour l'affichage des messages sous Linux	ibmmq-runtime
ibmmq-gskit	IBM Global Security Kit (GSKit)	ibmmq-runtime
ibmmq-web	REST API et IBM MQ Console.	ibmmq-runtime ibmmq-server ibmmq-java ibmmq-jre
ibmmq-ftbase	Composant Managed File Transfer	ibmmq-runtime ibmmq-java ibmmq-jre
ibmmq-ftlogger	Composant Managed File Transfer	ibmmq-runtime ibmmq-server ibmmq-ftbase ibmmq-java ibmmq-jre
ibmmq-fttools ibmmq-ftagent	Managed File Transfer composants	ibmmq-runtime ibmmq-ftbase ibmmq-java ibmmq-jre
ibmmq-ftservice	Composant Managed File Transfer	ibmmq-runtime ibmmq-server ibmmq-ftagent ibmmq-ftbase ibmmq-java ibmmq-jre
ibmmq-amqp	Composant Advanced Message Queuing Protocol	ibmmq-runtime ibmmq-java ibmmq-server
ibmmq-xrservice	Composant Telemetry Service Remarque : Le service MQ Telemetry n'est disponible que sur Linux pour x86-64 (64 bits) et Linux pour IBM Z.	ibmmq-runtime ibmmq-java ibmmq-jre ibmmq-server
ibmmq-ams	Composant d'Advanced Message Security	ibmmq-runtime ibmmq-server

Remarques :

Le site IBM MQ Bridge to Salesforce est obsolète dans toutes les versions à partir du 22 novembre 2022 (voir la lettre d'annonce américaine 222-341).
L'adresse IBM MQ Bridge to Salesforce est retirée du produit à l'adresse IBM MQ 9.4.0. La connectivité Salesforce peut être obtenue avec IBM App Connect Enterprise. Salesforce Les noeuds d'entrée et de demande Salesforce peuvent être utilisés pour interagir avec les applications Salesforce . Pour plus d'informations, voir Utilisation de Salesforce avec IBM App Connect Enterprise.
Pour Continuous Delivery, l'adresse IBM MQ Bridge to blockchain est retirée du produit à l'adresse IBM MQ 9.3.2.
Pour Long Term Support, IBM MQ Bridge to blockchain est supprimé à IBM MQ 9.3.0 Fix Pack 15.

La connectivité Blockchain peut être obtenue avec IBM App Connect ou via les fonctions App Connect disponibles avec IBM Cloud Pak® for Integration.
Depuis IBM MQ 9.3.0, IBM MQ Explorer a été supprimé du module d'installation d' IBM MQ . Il reste disponible en tant que téléchargement distinct et peut être installé à partir du téléchargement IBM MQ Explorer autonome disponible sur le site Fix Central. Pour plus d'informations, voir Installation et désinstallation de IBM MQ Explorer en tant qu'application autonome sous Linux et Windows.
À partir de IBM MQ 9.4.4 Continuous Delivery, la prise en charge de la traduction en langue russe est supprimée. Si vous mettez à niveau une version antérieure qui inclut ce composant sur la plate-forme Linux , vous devez le désinstaller manuellement avant de procéder à la mise à niveau. Dans le cas contraire, l'erreur suivante risque de se produire au cours de la procédure de mise à niveau :
```
MQSeriesRuntime = 9.x.x-0 is needed by (installed) MQSeriesMsg_ru-9.x.x-0.x86_64
```

Procédure

Ouvrez un terminal shell. Connectez-vous en tant que root ou passez à l'utilisateur root en utilisant les commandes su ou su - . Vous pouvez également utiliser la commande sudo pour exécuter des commandes en tant qu'utilisateur root, si votre administrateur système vous en a donné le droit.

Pour utiliser la commande sudo , ajoutez sudo avant la commande que vous souhaitez exécuter. Pour plus d'informations sur les commandes su et sudo , voir Explorer les différences entre les commandes sudo et su dans Linux sur le site web Red Hat® .
Définissez votre répertoire en cours sur l'emplacement des modules d'installation.

L'emplacement peut être un emplacement réseau ou un répertoire de système de fichiers local. Voir Où trouver les images d'installation téléchargeables.
Vous avez la possibilité d'accepter la licence avant ou après l'installation du produit. Pour accepter la licence avant l'installation, exécutez le script mqlicense.sh :
```
./mqlicense.sh
```
Le contrat de licence s'affiche dans une langue correspondant à votre environnement et vous êtes invité à accepter ou refuser les dispositions de la licence.

Si possible, mqlicense.sh ouvre une fenêtre X pour afficher la licence.
Si vous voulez consulter une version texte de la licence dans le shell en cours, lisible depuis un lecteur d'écran, entrez la commande suivante :
```
./mqlicense.sh -text_only 
```
Voir Acceptation de la licence sur IBM MQ pour Linux pour plus d'informations sur l'acceptation de la licence.
Choisissez le mode d'installation des packages IBM MQ :
Utilisez l'outil de gestion apt pour installer les packages IBM MQ de votre choix ou utilisez la commande dpkg pour installer les packages IBM MQ de votre choix avec leurs packages de dépendance.
- Pour utiliser l'outil de gestion apt-get afin d'installer les packages IBM MQ de votre choix avec leurs packages de dépendance:
  1. Créez un fichier avec le suffixe .list, par exemple, IBM_MQ.list, dans le répertoire /etc/apt/sources.list.d.
    Ce fichier doit contenir une entrée deb pour l'emplacement du répertoire contenant les modules IBM MQ.
    Exemple :
```
# Local directory containing IBM MQ packages 
deb [trusted=yes] file:/var/tmp/mq ./
```
    L'inclusion de l'instruction [trusted=yes] (y compris les crochets) est facultative et supprime les avertissements et les invites au cours des opérations suivantes.
  2. Exécutez la commande apt-get update pour ajouter ce répertoire et la liste des packages contenus dans le répertoire au cache d'apt.
    Reportez-vous à la remarque Attention dans apt-get pour connaître les erreurs possibles que vous pouvez recevoir.
    Vous pouvez maintenant utiliser apt pour installer IBM MQ. Par exemple, vous pouvez installer le produit complet avec la commande suivante :
```
apt-get install "ibmmq-*" 
```
    Vous pouvez installer le package du serveur et toutes ses dépendances avec la commande suivante :
```
 apt-get install ibmmq-server 
```
    Attention: N'exécutez pas la commande apt-get install ibmmq-* dans le répertoire qui contient les fichiers .deb , sauf si vous utilisez des guillemets dans le shell.
    Si vous utilisez des outils tels que aptitude ou synaptic, les packages d'installation se trouvent dans la catégorie misc\non-free.
- Pour utiliser la commande dpkg afin d'installer les packages IBM MQ de votre choix, exécutez la commande dpkg pour chaque package IBM MQ que vous souhaitez installer. Par exemple, émettez la commande suivante pour installer le package de l'environnement d'exécution :
```
dpkg -i ibmmq-runtime_9.4.0.0_amd64.deb
```
  Important: Bien que dpkg autorise plusieurs fichiers de package dans la même commande, cela ne fonctionnera pas comme prévu en raison des dépendances inter-package IBM MQ . Vous devez installer les paquets individuellement dans l'ordre suivant. Vous pouvez constater que l'utilisation de apt-get est une meilleure option.
  - ibmmq-runtime
  - ibmmq-jre
  - ibmmq-java
  - ibmmq-gskit
  - ibmmq-server
  - ibmmq-web
  - ibmmq-ftbase
  - ibmmq-ftagent
  - ibmmq-ftservice
  - ibmmq-ftlogger
  - ibmmq-fttools
  - ibmmq-amqp
  - ibmmq-ams
  - ibmmq-xrservice
  - ibmmq-client
  - ibmmq-man
  - ibmmq-msg_langue
  - ibmmq-samples
  - ibmmq-sdk

Résultats

Vous avez installé les packages dont vous avez besoin.

Etapes suivantes

Si vous avez choisi d'accepter la licence après l'installation, faites-le maintenant. Voir Accepter la licence après l'installation du produit.
Si nécessaire, vous pouvez maintenant définir cette installation comme installation principale. Entrez la commande suivante à l'invite de commande :
```
 MQ_INSTALLATION_PATH/bin/setmqinst -i -p MQ_INSTALLATION_PATH
```
où MQ_INSTALLATION_PATH représente le répertoire dans lequel IBM MQ est installé.
Vous souhaitez peut-être configurer l'environnement dans lequel cette copie va être installée. Vous pouvez utiliser la commande setmqenv ou crtmqenv pour définir diverses variables d'environnement pour une installation particulière de IBM MQ . Pour plus d'informations, voir setmqenv et crtmqenv.
Vous pouvez vérifier votre installation pour confirmer qu'elle s'est correctement déroulée. Voir Vérifier une installation IBM MQ sur Linux, pour plus d'informations.