For distributed platformsFor z/OS platforms[17.0.0.1 and later]

Configuración del direccionamiento dinámico para varios colectivos de Liberty

Puede configurar la característica de direccionamiento dinámico para direccionar solicitudes de aplicación a todas las instancias de aplicación cuando la aplicación se despliega en varios colectivos.

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

Intelligent Management para servidores web permite el direccionamiento de las solicitudes HTTP a los 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. Cuando se añaden, eliminan, inician, detienen o modifican servidores, miembros de clúster, aplicaciones o hosts virtuales, la nueva información se entrega dinámicamente al plug-in de WebSphere. Las solicitudes se direccionan basándose en la información actualizada.

Intelligent Management para servidores web direcciona solicitudes de aplicación a todas las instancias de aplicación cuando la aplicación se despliega en varios colectivos. Anteriormente, cuando las solicitudes se direccionaban a varios colectivos, no se permitía instalar una aplicación determinada en más de un colectivo.

Para utilizar Intelligent Management para servidores web para direccionar solicitudes HTTP a colectivos de Liberty, habilite la característica dynamicRouting-1.0 en todos los controladores colectivos de los colectivos. La característica dynamicRouting-1.0 proporciona un servicio de direccionamiento dinámico que proporciona información de direccionamiento a Intelligent Management para servidores web. Utilice las acciones del 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 para servidores web en el plug-in de WebSphere.

Importante: Para direccionar a la misma aplicación en varios colectivos, cada colectivo debe tener un nombre exclusivo. El nombre exclusivo de un colectivo pueden aparecer como uno de los dos ejemplos siguientes:
  • Utilice el atributo connectorClusterName del elemento XML <dynamicRouting> en el archivo server.xml de los controladores colectivos. Todos los controladores en el mismo colectivo deben utilizar el mismo valor para el atributo connectorClusterName. Los controladores en distintos colectivos deben utilizar distintos valores para el atributo connectorClusterName. Si se especifica el atributo connectorClusterName, el valor altera temporalmente el valor especificado con la opción –collectiveName utilizada al crear el colectivo.
  • Utilice la opción collectiveName cuando se cree el colectivo con el mandato collective create.

Los controladores de direccionamiento dinámico en cada colectivo informan al plug-in de WebSphere sobre el estado del colectivo, por lo que el plug-in puede direccionar dinámicamente las solicitudes para la misma aplicación entre varios colectivos. Los controladores de direccionamiento dinámico informan al plug-in de WebSphere sobre cada aplicación que está disponible en el colectivo del controlador. Por lo tanto, el plug-in de WebSphere sabe cuándo una aplicación está disponible en más de un colectivo. A menos que una regla indique lo contrario, todas las solicitudes a una aplicación se equilibran entre todos los servidores adecuados.

La prestación de reglas de direccionamiento permite que las solicitudes entrantes al plug-in de WebSphere se direccionen 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. 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.

    Por ejemplo, en el primer colectivo, especifique el siguiente nombre en todos los controladores:
    <dynamicRouting connectorClusterName="collective1"/>
    Por ejemplo, en el segundo colectivo, especifique el siguiente nombre en todos los controladores:
    <dynamicRouting connectorClusterName="collective2"/>
    Si una conexión falla, la propiedad retryInterval especifica el tiempo de espera antes de que se intente otra conexión a un controlador. La propiedad maxRetries especifica el número de veces que se intenta volver a conectar a un controlador colectivo que ha fallado. Consulte el ejemplo siguiente:
    <dynamicRouting maxRetries="4" retryInterval="20" connectorClusterName="collective1"/>
     <TraceSpecification name="default" specification=":DEBUG"/>
    </dynamicRouting>
    El archivo plugin-cfg.xml generado contiene las propiedades ConnectorCluster. Consulte el ejemplo siguiente:
    <IntelligentMangement>
     …
      <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>
  3. Inicie todos los controladores habilitados con la característica de direccionamiento dinámico.
  4. 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.
    Para crear los artefactos necesarios para el direccionamiento dinámico de varios colectivos, utilice la opción --collectives en lugar de las opciones --port, --host, --user o --password. Especifique los colectivos con el formato usuario_colectivo:contraseña_usuario@host_colectivo:puerto con una coma (,) separando cada colectivo. Consulte el ejemplo siguiente:
    ./dynamicRouting setup --collectives user1:password1@host1:port1,user2:password2@host2:port2,...
    --keystorePassword=webAS --pluginInstallRoot=/opt/HTTPServer_Plugins/ --webServerNames=webserver1

    Asegúrese de que cada colectivo tenga un nombre exclusivo. Además, asegúrese de que los usuarios existan en los registros de usuarios de sus colectivos y que tengan un rol administrativo. Si no especifica una contraseña, se le solicitará.

    Consulte los requisitos de para la opción --collectives.

    Para obtener más información sobre el mandato dynamicRouting setup, consulte Mandato de direccionamiento dinámico.

  5. Copie todos los archivos plugin-key*.jks generados y el archivo plugin-cfg.xml en un directorio temporal del host del servidor web.

    Para la opción --collectives se crean varios archivos de almacén de claves:

    • El archivo plugin-key.jks permite que los servidores miembro de colectivo en todos los colectivos acepten solicitudes con proxy mediante el servidor web.
    • El archivo plugin-key-nombre_colectivo.jks proporciona un archivo de claves de plug-in para cada colectivo especificado con la opción --collectives.

    Estos archivos permiten que el plug-in de WebSphere se comunique de forma segura con los controladores colectivos en el colectivo específico.

  6. 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. Consulte el ejemplo siguiente:
    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

    Ejecute gskcmd en todos los archivos plugin-key*.jks generados. Modifique las opciones –db y –target para especificar cada uno de los archivos.

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

  7. Copie todos los archivos plugin-key.kdb, plugin-key.rdb y plugin-key.sth creados por gskcmd del directorio temporal en el directorio valor de --pluginInstallRootargument/config/nombre_servidor_web/.
  8. 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 está habilitado en un colectivo el direccionamiento dinámico, el archivo tiene una stanza <Connector> para cada controlador colectivo. Para el direccionamiento de varios colectivos, cada colectivo tiene una stanza <ConnectorCluster>. Consulte el ejemplo siguiente:

    <Property Name="Keyfile" Value="/opt/IBM/WebSphere/Plugins/config/webserver1/plugin-key.kdb"/>
    <Property Name="Stashfile" Value="/opt/IBM/WebSphere/Plugins/config/webserver1/plugin-key.sth"/>
    <IntelligentMangement>
     <Property name="webserverName" value="webserver1"/>
     <Property name="RoutingRulesConnectorClusterName" value="collective1"/>
     <ConnectorCluster enabled="true" maxRetries="-1" name="collective1" 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-collective1.kdb"/>
      </Connector>
     </ConnectorCluster>
    <ConnectorCluster enabled="true" maxRetries="-1" name="collective2" retryInterval="60">
      <Property name="uri" value="/ibm/api/dynamicRouting"/>
      <Connector host="controller2.acme.com" port="9444" protocol="https">
       <Property name="keyring" value="/opt/HTTPServer_Plugins/config/webserver1/plugin-key-collective2.kdb"/>
      </Connector>
     </ConnectorCluster>
    </IntelligentManagement>
  9. Inicie el servidor web e inicie el direccionamiento a la aplicación instalada en el colectivo.
  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_multiple.html