Acerca de esta tarea
Para utilizar Intelligent Management para direccionar las solicitudes
HTTP a un colectivo de Liberty, debe habilitar la característica
dynamicRouting-1.0 en uno o varios controladores colectivos
en un colectivo.
La característica proporciona el servicio de
direccionamiento dinámico, que recupera dinámicamente la información de direccionamiento
del repositorio del colectivo y la proporciona al plug-in de
WebSphere. La
característica también proporciona el mandato
dynamicRouting. Utilice sus acciones de mandato setup,
genPluginCfg y genKeystore para generar los almacenes de claves necesarios para proteger la comunicación entre el plug-in y el servicio de direccionamiento dinámico, y un archivo de configuración de plug-in que habilita Intelligent Management en el plug-in de WebSphere.
La prestación de reglas de direccionamiento permite que se direccionen las solicitudes entrantes del plug-in de WebSphere a un conjunto especificado de servidores. Además, las solicitudes se pueden rechazar o redireccionar de forma selectiva. La selección de si una regla se aplica a una solicitud entrante se realiza mediante la correlación de atributos de la solicitud entrante.
- Para habilitar el direccionamiento dinámico en un controlador, añada el código
siguiente al código featureManager en el
archivo server.xml del controlador.
<feature>dynamicRouting-1.0</feature>
- Inicie todos los controladores habilitados por la característica de direccionamiento dinámico.
- Ejecute el mandato dynamicRouting setup en uno de los
controladores para generar el almacén de claves y los archivos de configuración del
plug-in. Por ejemplo:
./dynamicRouting setup --port=9444 --host=controller1.acme.com --user=admin --password=passw0rd --keystorePassword=webAS --pluginInstallRoot=/opt/HTTPServer_Plugins/ --webServerNames=webserver1
Nota: Asegúrese de que exista un valor especificado del argumento --user en un registro de usuarios y que tenga asignado un rol administrativo.
Para obtener más
información, consulte Mandato de direccionamiento dinámico.
- Copie los archivos plugin-key.jks y
plugin-cfg.xml generados en un directorio temporal en el host del
servidor web.
- En el host de servidor web, ejecute gskcmd (que se
incluye en el paquete IHS) para convertir el almacén de claves al formato CMS y
establecer el certificado personal como el valor predeterminado. El formato CMS es el
formato soportado del plug-in de WebSphere. Por ejemplo:
gskcmd -keydb -convert -pw webAS -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
Para z/OS, consulte Conversión del almacén de claves a formato CMS en z/OS.
- Copie los archivos plugin-key.kdb, plugin-key.rdb y
plugin-key.sth creados por gskcmd desde el directorio temporal al directorio
valor de --pluginInstallRootargument/config/nombre_servidor_web/.
- Copie el archivo plugin-cfg.xml en el directorio especificado
en la directiva
WebSpherePluginConfig en el archivo
httpd.conf del servidor web. El archivo plugin-cfg.xml se genera con la stanza
<IntelligentManagement>. Cuando el direccionamiento dinámico está
habilitado en un colectivo, hay una stanza <Connector> para
cada controlador colectivo.
Por
ejemplo:
<IntelligentManagement>
<Property name="webserverName" value="webServer1"/>
<ConnectorCluster enabled="true" maxRetries="-1" name="default" retryInterval="60">
<Property name="uri" value="/ibm/api/dynamicRouting"/>
<Connector host="controller1.acme.com" port="9444" protocol="https">
<Property name="keyring" value="/opt/HTTPServer_Plugins/config/webserver1/plugin-key.kdb"/>
</Connector>
</ConnectorCluster>
</IntelligentManagement>
- Inicie el servidor web e inicie el direccionamiento a la aplicación instalada en el
colectivo.
- Opcional: Añada el elemento <dynamicRouting> al archivo
server.xml del controlador para especificar las propiedades para el direccionamiento dinámico.
La propiedad connectorClusterName especifica el nombre que el direccionamiento dinámico asocia con el colectivo. Si no se especifica la propiedad connectorClusterName, se utiliza el nombre del colectivo. La propiedad retryInterval especifica el tiempo que se esperará una reconexión a un controlador si una conexión falla. La propiedad
maxRetries especifica el número de veces que se intenta volver a conectar a un controlador colectivo que ha fallado.
Por
ejemplo:
<dynamicRouting maxRetries="4" retryInterval="20" connectorClusterName="collective1"/>
<TraceSpecification name="default" specification=":DEBUG"/>
</dynamicRouting>
El archivo
plugin-cfg.xml generado tiene las propiedades
<ConnectorCluster>:
<IntelligentManagement>
<TraceSpecification name="default" specification=":DEBUG"/>
<Property name="webserverName" value="webServer1"/>
<ConnectorCluster enabled="true" maxRetries="4" name="collective1" retryInterval="20">
<Property name="uri" value="/ibm/api/dynamicRouting"/>
<Connector host="controller1.acme.com" port="9444" protocol="https">
<Property name="keyring" value="/opt/HTTPServer_Plugins/config/webServer1/plugin-key.kdb"/>
</Connector>
</ConnectorCluster>
</IntelligentManagement>
Opcional: cree reglas de direccionamiento para especificar cómo se manejan solicitudes específicas. Se pueden especificar reglas de direccionamiento para:
- Rechazar solicitudes específicas.
- Redireccionar solicitudes específicas.
- Permitir que solicitudes específicas vayan a un subconjunto de los servidores disponibles.
- Realizar la migración tras error de solicitudes específicas de un conjunto de servidores a otro conjunto de servidores.
Consulte Reglas de direccionamiento para el direccionamiento dinámico de Liberty y Configuración de reglas de direccionamiento para el direccionamiento dinámico de Liberty.