Pour plateformes répartiesPour plateformes z/OS

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.

Les commandes de la fonction Dynamic Routing sont les suivantes :

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.

Remarque : Le magasin de clés qui est généré par les commandes setup et genKeystore est au format JKS ou PKCS12. Il doit être copié dans un répertoire sur la machine de serveur Web et converti en un magasin au format CMS en exécutant la commande gskcmd. Le fichier magasin au format CMS (.kdb) doit être déplacé dans le répertoire <value of the --pluginInstallRoot argument>/config/<web server name>. Les fichiers .rdb et .sth doivent également être déplacés dans ce même répertoire.

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

Cette action génère les fichiers de configuration de plug-in.
 
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.

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: 7 juin 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=rwlp_wve_dynroutcollect
Nom du fichier : rwlp_wve_dynroutcollect.html