

Commande de routage dynamique
Les actions de commande setup, genPluginCfg et genKeystore dynamicRouting permettent de générer la configuration de plug-in et les fichiers de magasin de clés. L'action de commande genPluginCfg dynamicRouting est utilisée à tout moment après la configuration initiale pour regénérer le fichier plugin-cfg.xml. Par exemple, lorsque la fonction Dynamic Routing est activée sur un nouveau contrôleur ou lorsqu'un nouveau serveur Web est ajouté. L'action de commande genKeystore dynamicRouting permet de générer le fichier de clés. Chacune des actions de commande dynamicRouting comporte une aide en ligne.
setup
La commande setup dynamicRouting génère un magasin de clés au format PKCS12 ou JKS et un ou plusieurs fichiers de configuration de plug-in WebSphere. Le magasin de clés contient un certificat personnel ainsi que les certificats de signataire memberRoot et controllerRoot qui permettent une communication sécurisée entre le plug-in WebSphere et le service de routage dynamique. Le même magasin de clés est utilisée pour l'envoi de demandes HTTPS aux applications des membres de collectivité Liberty. Le fichier de configuration de plug-in contient la section <IntelligentManagement>, qui active Intelligent Management dans un plug-in WebSphere. La section <IntelligentManagement> contient une section <ConnectorCluster> qui représente la collectivité. La section <ConnectorCluster> contient une section <Connector> pour chaque contrôleur où la fonction Dynamic Routing est activée.
Pour afficher de l'aide sur une commande, exécutez <Controller root>/bin/dynamicRouting help setup, qui affiche ce qui suit :
Description
La commande setup dynamicRouting génère un magasin de clés contenant un certificat personnel et les certificats de signataire requis pour permettre une communication sécurisée entre le service de routage dynamique et les clients. Elle génère également le fichier de configuration de plug-in WebSphere avec la section <IntelligentManagement>, laquelle active Intelligent Management dans le plug-in WebSphere.
Syntaxe
dynamicRouting setup [options]
Options
- --host=name
- Obligatoire. Nom d'hôte du contrôleur de collectivité cible.
- --password[=pwd]
- Obligatoire. Mot de passe pour l'utilisateur administrateur du contrôleur de collectivité cible. Si aucune valeur n'est définie, une invite s'affiche.
- --port=num
- Obligatoire. Numéro de port HTTPS du contrôleur de collectivité cible.
- --user=name
- Obligatoire. Utilisateur administrateur du contrôleur de collectivité cible.
- --pluginInstallRoot=path
- Obligatoire. Chemin d'accès complet du répertoire principal du plug-in WebSphere sur l'hôte de serveur Web.
- --webServerNames=webServerName[,webServerName1]
- Obligatoire. Noms, séparés par des virgules, des serveurs Web pour lesquels des fichier de configuration de plug-in WebSphere doivent être générés.
- --keystorePassword[=pwd]
- Obligatoire. Mot de passe du magasin de clés généré. Si ce paramètre est spécifié sans aucune valeur définie, une invite s'affiche.
- --keystoreType=type
- Facultatif. Type du magasin de clés généré. Le type par défaut est JKS. Les valeurs valides sont JKS et PKCS12.
- --certificateSubject=DN
- Remarque : Cette option est ignorée. En raison d'une amélioration de la génération des certificats, la spécification d'un sujet de certificat n'a plus d'utilité. L'option est maintenue afin que les scripts existants qui utilisent la commande dynamicRouting setup n'aient pas à être mis à jour.
Les certificats SSL peuvent être automatiquement sécurisés en définissant la propriété JVM com.ibm.websphere.dynamicRouting.utility.autoAcceptCertificates sur true.
Voici un exemple de sortie de la commande lorsqu'elle est exécutée avec tous les arguments obligatoires :
./dynamicRouting setup --port=9444 --host=controller1.acme.com --user=admin --password=mot_de_passe --keystorePassword=mot_de_passe_clés --pluginInstallRoot=/opt/HTTPServer_Plugins --webServerNames=webServer1,webServer2
Génération des fichiers de configuration de plug-in WebSphere pour les serveurs Web webServer1, webServer2
Acceptation automatique de la chaîne de certificat pour le serveur cible.
Certificate subject DN: CN=admin, OU=controller1, O=ibm, C=us
Successfully completed MBean request to the controller.
La génération des fichiers de configuration de plug-in WebSphere plugin-cfg-webServer1.xml, plugin-cfg-webServer2.xml a abouti.
Génération du fichier de clés pour les serveurs Web webServer1, webServer2
La requête de bean géré au contrôleur a abouti.
La génération du fichier de clés plugin-key.jks a abouti.
Les fichiers de configuration de plug-in WebSphere plugin-cfg-webServer1.xml, plugin-cfg-webServer2.xml pour les serveurs Web
webServer1, webServer2 ont été générés.
Le fichier de clés keystore file plugin-key.p12 qui active la communication sécurisée entre le service Dynamic Routing et les clients a aussi été généré.
Copiez le fichier de configuration de plug-in WebSphere dans le répertoire spécifié
dans l'instruction WebSpherePluginConfig du fichier IBM HTTP Server httpd.conffile.
Copiez le fichier de clés plugin-key.jks dans un répertoire sur
l'hôte du serveur Web et exécutez "gskcmd" pour convertir le fichier de clés au format CMS et
pour définir le certificat personnel comme certificat par défaut.
Par
exemple :
gskcmd -keydb -convert -pw <<mot_de_passe>> -db /tmp/plugin-key.jks -old_format jks -target /tmp/plugin-key.kdb -new_format cms -stash
gskcmd -cert -setdefault -pw <<mot_de_passe>> -db /tmp/plugin-key.kdb -label default
Copiez les fichiers /tmp/plugin-key.kdb, .sth, .rdb résultant dans le répertoire /opt/HTTPServer_Plugins/config/webServer1/
genPluginCfg
Cette action génère les fichiers de configuration de plug-in. Chaque fichier de configuration de plug-in contient la section <IntelligentManagement>, laquelle active les fonctions Intelligent Management du plug-in. La section <IntelligentManagement> contient une section <ConnectorCluster> qui représente la collectivité. La section <ConnectCluster> contient une section <Connector> pour chaque contrôleur où la fonction de routage dynamique est activée. Les noms de serveur Web, séparés par une virgule, sont spécifiés dans l'argument --webServerNames. Par exemple, si --webServerNames=webServer1,webServer2 est spécifié, les fichiers plugin-cfg-webServer1.xml et plugin-cfg-webServer2.xml sont générés.
Pour afficher l'aide en ligne, exécutez la commande <Controller root>/bin/dynamicRouting help genPluginCfg, qui affiche ce qui suit :
Description
Génère un fichier de configuration de plug-in WebSphere avec une section <IntelligentManagement> qui active Intelligent Management dans le plug-in WebSphere.
Syntaxe
dynamicRouting genPluginCfg [options]
Options
- --host=name
- Obligatoire. Nom d'hôte du contrôleur de collectivité cible.
- --password[=pwd]
- Obligatoire. Mot de passe pour l'utilisateur administrateur du contrôleur de collectivité cible. Si aucune valeur n'est définie, une invite s'affiche.
- --port=num
- Obligatoire. Numéro de port HTTPS du contrôleur de collectivité cible.
- --user=name
- Obligatoire. Utilisateur administrateur du contrôleur de collectivité cible.
- --pluginInstallRoot=path
- Obligatoire. Chemin d'accès complet du répertoire principal du plug-in WebSphere sur l'hôte de serveur Web.
- --webServerNames=webServerName[,webServerName1]
- Obligatoire. Noms, séparés par des virgules, des serveurs Web pour lesquels des fichier de configuration de plug-in WebSphere doivent être générés.
Les certificats SSL seront automatiquement sécurisés en définissant la propriété JVM com.ibm.websphere.dynamicRouting.utility.autoAcceptCertificates sur true.
Voici un exemple de sortie de la commande lorsqu'elle est exécutée avec tous les arguments obligatoires :
./dynamicRouting setup --port=9444 --host=controller1.acme.com --user=admin --password=mot_de_passe --keystorePassword=mot_de_passe_clés --pluginInstallRoot=/opt/HTTPServer_Plugins --webServerNames=webServer1,webServer2
Génération du fichier de configuration de plug-in WebSphere pour le serveur Web webServer1
Acceptation automatique de la chaîne de certificat pour le serveur cible.
Certificate subject DN: CN=admin, OU=controller1, O=ibm, C=us
Successfully completed MBean request to the controller.
Le fichier /home/user1/Liberty/wlp/bin/plugin-cfg.xml existe.
Enregistrement sous /home/user1/Liberty/wlp/bin/plugin-cfg.xml.old.
La génération du fichier de configuration de plug-in WebSphere plugin-cfg.xml a abouti.
Le fichier de configuration de plug-in WebSphere pour le serveur Web webServer1 a abouti.
Copiez le fichier de configuration de plug-in WebSphere dans le répertoire spécifié par l'instruction
WebSpherePluginConfig dans le fichier IBM HTTP Server httpd.conf.
genKeystore
Cette action génère un magasin de clés au format PKCS12 ou JKS. Utilisez l'action --keystoreType pour indiquer le format du magasin de clés. La génération du magasin de clés PKCS12 est uniquement prise en charge lors de l'utilisation d'IBM Java. Le magasin de clés contient un certificat personnel ainsi que les certificats de signataire memberRoot et controllerRoot qui permettent une communication sécurisée entre le plug-in WebSphere et le service de routage dynamique. Le même magasin de clés est utilisée pour l'envoi de demandes HTTPS aux applications des membres de collectivité Liberty.
Pour afficher l'aide en ligne, exécutez la commande <Controller root>/bin/dynamicRouting help genKeystore, qui affiche ce qui suit :
Description
Génère un magasin de clés contenant un certificat personnel et les certificats de signataire requis pour permettre une communication sécurisée entre le service de routage dynamique et les clients.
Syntaxe
dynamicRouting genKeystore [options]
Options
- --host=name
- Obligatoire. Nom d'hôte du contrôleur de collectivité cible.
- --password[=pwd]
- Obligatoire. Mot de passe pour l'utilisateur administrateur du contrôleur de collectivité cible. Si aucune valeur n'est définie, une invite s'affiche.
- --port=num
- Obligatoire. Numéro de port HTTPS du contrôleur de collectivité cible.
- --user=name
- Utilisateur administrateur du contrôleur de collectivité cible. (Obligatoire)
- --keystorePassword[=pwd]
- Obligatoire. Mot de passe du magasin de clés généré. Si ce paramètre est spécifié sans aucune valeur définie, une invite s'affiche.
- --keystoreType=type
- Facultatif. Type du magasin de clés généré. Le type par défaut est JKS. Les valeurs valides sont JKS et PKCS12.
- --certificateSubject=DN
- Remarque : Cette option est ignorée. En raison d'une amélioration de la génération des certificats, la spécification d'un sujet de certificat n'a plus d'utilité. L'option est maintenue afin que les scripts existants qui utilisent la commande dynamicRouting genKeystore n'aient pas à être mis à jour.
Les certificats SSL seront automatiquement sécurisés en définissant la propriété JVM com.ibm.websphere.dynamicRouting.utility.autoAcceptCertificates sur true.
Voici un exemple de sortie de la commande lorsqu'elle est exécutée avec tous les arguments obligatoires :
./dynamicRouting genKeystore --port=9444 --host=contoller1.acme.com --user=admin --password=mot_de_passe --keystorePassword
Entrez le mot de passe --keystorePassword:
Entrez à nouveau le mot de passe --keystorePassword:
Acceptation automatique de la chaîne de certificat pour le serveur cible.
Certificate subject DN: CN=admin, OU=mycontroller, O=ibm, C=us
Génération du fichier de clés...
La requête de bean géré au contrôleur a abouti.
La génération du fichier de clés plugin-key.jks a abouti.
Le fichier de clés keystore file plugin-key.jks qui active la communication sécurisée entre le service Dynamic Routing et les clients a été généré. Si vous
utilisez Intelligent Management dans le plug-in WebSphere,
copiez le fichier de clés plugin-key.jks dans un répertoire sur l'hôte du serveur Web et exécutez "gskcmd" pour convertir le fichier de clés au format
CMS et définir le certificat personnel comme certificat par défaut.
Par
exemple :
gskcmd -keydb -convert -pw <<mot_de_passe>> -db /tmp/plugin-key.jks -old_format jks -target /tmp/plugin-key.kdb -new_format cms -stash
gskcmd -cert -setdefault -pw <<mot_de_passe>> -db /tmp/plugin-key.kdb -label default
Copiez les fichiers /tmp/plugin-key.kdb, .sth, .rdb résultant dans le répertoire de fichiers de clés spécifié dans le fichier de configuration de plug-in
WebSphere.
Rubrique de référence