Knowledge Center MQ Off-Line

Depuis plusieurs années, la documentation des logiciels IBM est disponible en ligne via des « Knowledge Center » (anciennement Infocenters).

Il s’agit des sites web, hébergés chez IBM, qui proposent via des arborescences de petits chapitres la documentation d’un produit. Après des débuts un peu laborieux, le système fonctionne plutôt bien, et permet de naviguer facilement dans la documentation.

Exemple pour le KC IBM MQ :

Il peut arriver que l’accès internet ne soit pas disponible, soit pour des raisons de sécurité, soit lors d’un déplacement. IBM propose donc une version off-line du KC, qui permet d’installer localement la documentation.

Le lien vers la page IBM de téléchargement est disponible dans le KC en ligne :

https://www.ibm.com/support/knowledgecenter/fr/SSFKSJ/com.ibm.mq.helphome.doc/mq_on_kcci.htm

L’installation nécessite deux composants :

• L’infrastructure MQ KC, qui est le moteur qui gère la documentation MQ
• La documentation proprement dite

Il est possible d’installer l’infrastructure KC sur Windows, Aix, Linux ou sur un serveur d’application type WebSphere Liberty.

La documentation est disponible depuis MQ Version 6.0 jusqu’à MQ Version 9.2, avec des packages spécifiques pour AMS, FTE, ou les clients MQTT.

Récupération des packages

Dans cet exemple, on va installer le l’infrastructure MQ KC sur un poste de travail Windows, en utilisant le package IBM-MQ-KC-Win64.151fp6.1. Ensuite, la documentation MQ version 9.2 sera installée, qui correspond au package mq92_docs_for_MQ_KC.zip.

Les différents packages sont téléchargés depuis FixCentral, les liens sont disponibles dans la page IBM ci-dessus.

Installation

Le principe est de créer un dossier dans lequel on va décomprimer le package d’infrastructure. Ici on va créer «D:\KC-MQ»

Le package IBM-MQ-KC-Win64.151fp6.1 contient MQ_KC_1.5.1.v201711290558-FP6.1.win64.zip, et est décomprimé dans F:\Documentation\Documentation2\KC. On obtient deux sous-dossiers : « KnowledgeCenter » et « licenses », avec un certain nombre de sous-dossiers dans  KnowledgeCenter » :

Décomprimez ensuite mq92_docs_for_MQ_KC.zip dans KnowledgeCenter\usr. Accepter le remplacement du fichier « KC_taxonomy.ditamap » si nécessaire.

Le résultat doit être le suivant :

Démarrage du KC off-line :

Dans le dossier KnowledgeCenter\bin, lancer « startKC.bat », et lors des invites du pare-feu, autoriser Java à utiliser le réseau.

Ensuite, utiliser un navigateur pour aller en : http://localhost:9090/kc. Résultat :

Autres points

• Il est possible d’installer plusieurs packages correspondant à des versions différentes de MQ
• Le fichier « mqkc_readme.txt », dans le dossier KnowledgeCenter, donne des détails supplémentaires sur l’installation
• Pour faciliter le lancement, faire un raccourci de startKC.bat, et y associer l’icône kc-48×48-desktop.png de ce même répertoire.