For distributed platformsFor z/OS platforms

Configuración del direccionamiento dinámico para un único colectivo de Liberty

Puede configurar la característica de direccionamiento dinámico para direccionar solicitudes HTTP a miembros de los colectivos de Liberty sin necesidad de volver a generar el archivo de configuración del plug-in de WebSphere cuando el entorno cambia.

Antes de empezar

Complete los pasos de instalación del producto en Configuración del direccionamiento dinámico para los colectivos de Liberty.

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.

[17.0.0.1 and later]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.

Procedimiento

  1. 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>
  2. Inicie todos los controladores habilitados por la característica de direccionamiento dinámico.
  3. 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.

  4. Copie los archivos plugin-key.jks y plugin-cfg.xml generados en un directorio temporal en el host del servidor web.
  5. 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

    For z/OS platformsPara z/OS, consulte Conversión del almacén de claves a formato CMS en z/OS.

  6. 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/.
  7. 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>
  8. Inicie el servidor web e inicie el direccionamiento a la aplicación instalada en el colectivo.
  9. 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>
  10. [17.0.0.1 and later]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.

Resultados

Con la característica dynamicRouting-1.0 habilitada, ahora Intelligent Management puede direccionar dinámicamente solicitudes HTTP a colectivos de Liberty.


Icono que indica el tipo de tema Tema de tarea

Nombre de archivo: twlp_wve_enabledynrout_single.html