

Mandato de direccionamiento dinámico
Las acciones de mandato setup, genPluginCfg y genKeystore de dynamicRouting se utilizan para generar los archivos de almacén de claves y de configuración del plug-in. La acción de mandato genPluginCfg de dynamicRouting se utiliza en algún momento posterior a la configuración inicial para volver a generar el archivo plugin-cfg.xml. Por ejemplo, cuando la característica Dynamic Routing se habilita en un controlador nuevo o se añade un servidor web nuevo. La acción de mandato genKeystore de dynamicRouting se utiliza para generar el archivo de almacén de claves. Cada una de las acciones de mandato de dynamicRouting admite ayuda en línea.
setup
El mandato setup de dynamicRouting genera un almacén de claves en formato JKS o PKCS12 y uno o varios archivos de configuración de plug-in de WebSphere. El almacén de claves contiene un certificado personal y los certificados de firmante memberRoot y controllerRoot que permiten una comunicación segura entre el plug-in de WebSphere y el servicio Dynamic Routing. El mismo almacén de claves también debe utilizarse para enviar solicitudes HTTPS a las aplicaciones en los miembros de colectivo de Liberty. El archivo de configuración del plug-in contiene la stanza <IntelligentManagement>, que habilita Intelligent Management en un plug-in de WebSphere. La stanza <IntelligentManagement> contiene una stanza <ConnectorCluster> que representa el colectivo. La stanza <ConnectorCluster> contiene una stanza <Connector> para cada controlador donde la característica Dynamic Routing está habilitada.
Para obtener ayuda del mandato, emita <Raíz controlador>/bin/dynamicRouting help setup, que muestra lo siguiente:
Descripción
El mandato setup de dynamicRouting genera un almacén de claves que contiene un certificado personal y los certificados de firmante necesarios para habilitar una comunicación segura entre el servicio Dynamic Routing y los clientes. También genera un archivo de configuración del plug-in de WebSphere con una stanza <IntelligentManagement>, que habilitará Intelligent Management en el plug-in de WebSphere.
Uso
dynamicRouting setup [opciones]
Opciones
- --host=name
- Obligatorio. El nombre de host del controlador de colectivo de destino.
- --password[=pwd]
- Obligatorio. La contraseña del usuario administrador para el controlador de colectivo de destino. Si no se define ningún valor, se le solicitará.
- --port=num
- Obligatorio. El número de puerto HTTPS del controlador de colectivo de destino.
- --user=name
- Obligatorio. Un usuario administrador para el controlador de colectivo de destino.
- --pluginInstallRoot=path
- Obligatorio. Vía de acceso completa del directorio raíz del plug-in de WebSphere en el host del servidor web.
- --webServerNames=webServerName[,webServerName1]
- Obligatorio. Los nombres separados por comas de los servidores web para los que deben generarse archivos de configuración del plug-in de WebSphere.
- --keystorePassword[=pwd]
- Obligatorio. La contraseña del almacén de claves generado. Si se especifica y no hay ningún valor definido, se le solicitará.
- --keystoreType=type
- Opcional. El tipo del almacén de claves generado. El tipo predeterminado es JKS. Los valores válidos son JKS y PKCS12.
- --certificateSubject=DN
- Nota: Se ignora esta opción. Debido a una mejora en la forma como se generan los certificados, especificar un sujeto de certificado ya no es útil. La opción se mantiene, de modo que los scripts existentes que utilizan el mandato dynamicRouting setup no se tendrán que actualizar.
Los certificados SSL pueden ser automáticamente de confianza estableciendo la propiedad de JVM com.ibm.websphere.dynamicRouting.utility.autoAcceptCertificates en true.
A continuación se muestra la salida del mandato cuando se ejecuta con todos los argumentos obligatorios:
./dynamicRouting setup --port=9444 --host=controller1.acme.com --user=admin --password=password --keystorePassword=keypass --pluginInstallRoot=/opt/HTTPServer_Plugins --webServerNames=webServer1,webServer2
Generando archivo de configuración del plug-in de WebSphere para los servidores web webServer1, webServer2
Aceptando automáticamente la cadena de certificados para el servidor de destino.
DN de sujeto de certificado: CN=admin, OU=controller1, O=ibm, C=us
Se ha completado satisfactoriamente la petición de MBean para el controlador.
Se han generado satisfactoriamente los archivos de configuración del plug-in de WebSphere plugin-cfg-webServer1.xml, plugin-cfg-webServer2.xml
Generando almacén de claves para los servidores web webServer1, webServer2 Se ha completado satisfactoriamente la petición de MBean para el controlador.
Successfully generated keystore plugin-key.jks.
Se han generado los archivos de configuración del plug-in de WebSphere plugin-cfg-webServer1.xml, plugin-cfg-webServer2.xml para los servidores web webServer1, webServer2.
Además, se ha generado el archivo de almacén de claves plugin-key.p12
que permite una comunicación segura entre el servicio y los clientes
de direccionamiento dinámico.
Copie el archivo de configuración del plug-in de WebSphere en el
directorio especificado
en la directiva de WebSpherePluginConfig en el httpd.conffile de IBM
HTTP Server.
Copie el archivo de almacén de claves plugin-key.jks en un directorio
en el
host de servidor web y ejecute "gskcmd" para convertir el almacén de
claves a formato CMS y
establezca el certificado personal como valor
predeterminado.
Por ejemplo:
gskcmd -keydb -convert -pw <<contraseña>> -db
/tmp/plugin-key.jks -old_format jks -target /tmp/plugin-key.kdb -new_format cms -stash
gskcmd -cert -setdefault -pw <<password>> -db /tmp/plugin-key.kdb -label default
Copie los archivos /tmp/plugin-key.kdb, .sth, .rdb resultantes en
el directorio /opt/HTTPServer_Plugins/config/webServer1/
genPluginCfg
Esta acción genera los archivos de configuración del plug-in. Cada archivo de configuración del plug-in contiene la stanza <IntelligentManagement>, que habilita las características de Intelligent Management del plug-in. La stanza <IntelligentManagement> contiene una stanza <ConnectorCluster>, que representa el colectivo. La stanza <ConnectCluster> contiene una stanza <Connector> para cada controlador donde la característica Dynamic Routing está habilitada. Los nombres de servidor web separados por comas se especifican en el argumento --webServerNames. Por ejemplo, si se especifica --webServerNames=webServer1,webServer2, se generan los archivos plugin-cfg-webServer1.xml y plugin-cfg-webServer2.xml.
Para obtener ayuda en línea, emita <Raíz controlador>/bin/dynamicRouting help genPluginCfg, que muestra lo siguiente:
Descripción
Genera un archivo de configuración del plug-in de WebSphere con una stanza <IntelligentManagement>, que habilitará Intelligent Management en el plug-in de WebSphere.
Uso
dynamicRouting genPluginCfg [opciones]
Opciones
- --host=name
- Obligatorio. El nombre de host del controlador de colectivo de destino.
- --password[=pwd]
- Obligatorio. La contraseña del usuario administrador para el controlador de colectivo de destino. Si no se define ningún valor, se le solicitará.
- --port=num
- Obligatorio. El número de puerto HTTPS del controlador de colectivo de destino.
- --user=name
- Obligatorio. Un usuario administrador para el controlador de colectivo de destino.
- --pluginInstallRoot=path
- Obligatorio. Vía de acceso completa del directorio raíz del plug-in de WebSphere en el host del servidor web.
- --webServerNames=webServerName[,webServerName1]
- Obligatorio. Los nombres separados por comas de los servidores web para los que deben generarse archivos de configuración del plug-in de WebSphere.
Los certificados SSL serán automáticamente de confianza estableciendo la propiedad de JVM com.ibm.websphere.dynamicRouting.utility.autoAcceptCertificates en true.
A continuación se muestra la salida del mandato cuando se ejecuta con todos los argumentos obligatorios:
./dynamicRouting setup --port=9444 --host=controller1.acme.com --user=admin --password=password --keystorePassword=keypass --pluginInstallRoot=/opt/HTTPServer_Plugins --webServerNames=webServer1,webServer2
Generando archivo de configuración del plug-in de WebSphere para el servidor web webServer1
Aceptando automáticamente la cadena de certificados para el servidor de destino.
DN de sujeto de certificado: CN=admin, OU=controller1, O=ibm, C=us
Se ha completado satisfactoriamente la petición de MBean para el controlador.
El archivo /home/user1/Liberty/wlp/bin/plugin-cfg.xml existe.
Guardando en /home/user1/Liberty/wlp/bin/plugin-cfg.xml.old.
Se ha generado correctamente el archivo de configuración del plug-in de WebSphere plugin-cfg.xml
Se ha generado el archivo de configuración del plug-in de WebSphere plugin-cfg.xml para el servidor Web webServer1. Copie el archivo de configuración del plug-in de WebSphere en el directorio especificado en la directiva WebSpherePluginConfig en el archivo httpd.conf de IBM HTTP Server.
genKeystore
Esta acción genera un almacén de claves en formato PKCS12 o JKS. Utilice la acción --keystoreType para especificar el formato del almacén de claves. La generación del almacén de claves PKCS12 sólo está soportada cuando se utiliza IBM Java. El almacén de claves contiene un certificado personal y los certificados de firmante memberRoot y controllerRoot que permiten una comunicación segura entre el plug-in de WebSphere y el servicio Dynamic Routing. El mismo almacén de claves también debe utilizarse para enviar solicitudes HTTPS a las aplicaciones en los miembros de colectivo de Liberty.
Para obtener ayuda en línea, emita <Raíz controlador>/bin/dynamicRouting help genKeystore, que muestra lo siguiente:
Descripción
Genera un almacén de claves que contiene un certificado personal y los certificados de firmante necesarios para habilitar una comunicación segura entre el servicio Dynamic Routing y los clientes.
Uso
dynamicRouting genKeystore [opciones]
Opciones
- --host=name
- Obligatorio. El nombre de host del controlador de colectivo de destino.
- --password[=pwd]
- Obligatorio. La contraseña del usuario administrador para el controlador de colectivo de destino. Si no se define ningún valor, se le solicitará.
- --port=num
- Obligatorio. El número de puerto HTTPS del controlador de colectivo de destino.
- --user=name
- Especifica un usuario administrador para el controlador de colectivo de destino. (Necesario)
- --keystorePassword[=pwd]
- Obligatorio. La contraseña del almacén de claves generado. Si se especifica y no hay ningún valor definido, se le solicitará.
- --keystoreType=type
- Opcional. El tipo del almacén de claves generado. El tipo predeterminado es JKS. Los valores válidos son JKS y PKCS12.
- --certificateSubject=DN
- Nota: Se ignora esta opción. Debido a una mejora en la forma como se generan los certificados, especificar un sujeto de certificado ya no es útil. La opción se mantiene, de forma que los scripts existentes que utilizan el mandato dynamicRouting genKeystore no se tendrán que actualizar.
Los certificados SSL serán automáticamente de confianza estableciendo la propiedad de JVM com.ibm.websphere.dynamicRouting.utility.autoAcceptCertificates en true.
A continuación se muestra la salida del mandato cuando se ejecuta con todos los argumentos obligatorios:
./dynamicRouting genKeystore --port=9444 --host=contoller1.acme.com --user=admin --password=password --keystorePassword
Especifique la contraseña --keystorePassword:
Vuelva a especificar la contraseña --keystorePassword:
Aceptando automáticamente la cadena de certificados para el servidor de destino.
DN de sujeto de certificado: CN=admin,
OU=mycontroller, O=ibm, C=us
Generando almacén de claves...
Se ha completado satisfactoriamente la petición de MBean para el controlador.
Successfully generated keystore plugin-key.jks.
Se ha generado el archivo de almacén de claves plugin-key.jks que
permite una comunicación segura entre el servicio y los clientes de
direccionamiento dinámico. Si está utilizando Intelligent Management
en el plug-in de WebSphere,
copie el archivo de almacén de claves plugin-key.jks en un directorio
en el host del servidor web, y ejecute "gskcmd" para convertir el
almacén de claves al formato CMS y para establecer el certificado
personal como el valor predeterminado.
Por ejemplo:
gskcmd -keydb -convert -pw <<contraseña>> -db
/tmp/plugin-key.jks -old_format jks -target /tmp/plugin-key.kdb
-new_format cms -stash
gskcmd -cert -setdefault -pw <<password>> -db /tmp/plugin-key.kdb -label default
Copie los archivos /tmp/plugin-key.kdb, .sth, .rdb resultantes en
el directorio de conjunto de claves especificado en el archivo de
configuración del plug-in de WebSphere.
Tema de referencia