Optimización de los pasos de BuildPDFFromDocuments

El paso BuildPDFFromDocuments es un paso que consume muchos recursos y que ensambla un trabajo PDF a partir de documentos que han sido identificados por RICOH ProcessDirector. Si hay un gran número de documentos o si utiliza reglas complejas en su expediente, la duración del tratamiento de este paso se mide en horas, no en minutos. Existen opciones de configuración avanzadas para reducir el tiempo de procesamiento en este paso para trabajos muy grandes o muy complejos.
    Importante:
  • Esta configuración es muy avanzada. No se recomienda para todas las implementaciones de RICOH ProcessDirector.

Su sistema es un buen candidato para esta configuración si todo esto es cierto:

  • Procesar un único trabajo PDF más rápido es más importante que el rendimiento total.
  • Sus trabajos en PDF contienen muchos documentos o utilizan reglas complejas que hacen que el procesamiento lleve mucho tiempo.
  • Dispone (o puede adquirir) los recursos de hardware adecuados para el sistema que utiliza el paso. El sistema debe tener muchos núcleos de CPU, ya que cada hilo utilizado para el procesamiento requiere tres o cuatro hilos en segundo plano para gestionar el uso de la memoria y otras actividades. El sistema también debe tener al menos 16 GB de RAM disponibles para este procesamiento en su ordenador principal o en servidores adicionales para configurar como servidores secundarios.
  • Los miembros de su equipo disponen de las habilidades y herramientas necesarias para supervisar el rendimiento del sistema. Para ajustar el sistema correctamente, debe ser capaz de supervisar:
    • Memoria utilizada por los procesos Java
    • Recolección de elementos no utilizados en Java
    • Uso de la memoria del sistema
    • Utilización de CPU
    • Intercambio de recursos
    • E/S del sistema

En esta configuración, usted configura su sistema para ejecutar el paso BuildPDFFromDocuments utilizando múltiples hebras. La configuración requiere que el paso se ejecute en una máquina virtual Java (JVM) independiente. Para ejecutar el paso en su propia JVM, cree un servidor secundario y ajuste el paso BuildPDFFromDocuments para que se ejecute en ese servidor. No debe configurarse ningún otro paso para que se ejecute en ese servidor.

Para optimizar los pasos de BuildPDFFromDocuments:

  1. Determine si su ordenador principal tiene memoria suficiente para soportar esta configuración.
    Repase el tema Ajuste de la asignación de memoria a Java. Recomendamos asignar al menos 16 GB de RAM al servidor secundario local. Si sus cálculos de ese tema indican que dispone de 16 GB de RAM o que puede instalar memoria adicional en el sistema, puede utilizar un servidor secundario local. Continúe con el paso .
  2. Cree un servidor secundario local mediante este procedimiento: Definición de los servidores secundarios en el ordenador principal.
    Establezca la propiedad En agrupación de servidor general en No y deje el Recuento máximo de pasos de recursos de servidor significativos en 1.
      Nota:
    • Deténgase después de crear el servidor secundario. No ajuste aún la plantilla de pasos BuildPDFFromDocuments.
  3. Actualice la configuración de la JVM para este servidor secundario.
    1. Abra el archivo %AIWDATA%\config\jvmsettings.cfg con un editor de texto.
      Por omisión, %AIWDATA% es /aiw/aiw1.
    2. Copie la línea para el servidor primario que tiene este aspecto:
      primary=-Xmx2048m -Djava.net.preferIPv4Stack=true -Djava.awt.headless=true

      Péguelo en una nueva línea del archivo.

      El valor tras primary=-Xmx es la cantidad máxima de memoria heap que el entorno de ejecución Java RICOH ProcessDirector puede utilizar para el proceso primario RICOH ProcessDirector. En este ejemplo, el servidor primario puede utilizar 2048 MB (2 GB) de RAM para su heap.

    3. Actualice la línea que ha copiado para cambiar primary por el valor de la propiedad Nombre de servidor para el servidor secundario.
    4. Actualice el valor después de nombre_servidor_secundario=-Xmx a la cantidad de memoria que tiene disponible para este proceso. El valor debe ser de al menos 16 g.
    5. Si la línea de su servidor secundario no incluye este ajuste: -XX:+UseG1GC, actualice la línea para añadirlo.
    6. Guarde y cierre el archivo.
  4. Reinicie el servicio RICOH ProcessDirector para aplicar los nuevos ajustes.
  5. Habilite el servidor secundario en la interfaz RICOH ProcessDirector.
  6. Ajuste la plantilla de pasos BuildPDFFromDocuments.
    Recomendamos hacer una copia de la plantilla de pasos para utilizarla en la configuración multihilo.
    1. Abra Flujo de trabajo ⇒ Plantillas de pasos.
    2. Busque la plantilla de pasos BuildPDFFromDocuments, haga clic con el botón derecho y seleccione Copiar.
    3. En la pestaña General, introduzca un valor para la propiedad Nombre.

      Elija un nombre que muestre claramente que se trata de la versión multihilo del paso.

    4. En la pestaña Ajuste:
      • Establezca Ajuste avanzado en Ejecutar este paso utilizando múltiples hilos de ejecución.
      • Establezca Servidores que se deben utilizar en Ejecutar en servidores específicos y, a continuación, seleccione sólo el servidor secundario que ha creado.
    5. En la pestaña PDF, observe todas las propiedades Crear archivo de control PDF.
      • Si su paso utiliza uno o más archivos de control, compruebe que Crear biblioteca está configurada como Utilizar archivo de control o predeterminado.
      • Si su paso no utiliza ningún archivo de control, establezca Crear biblioteca en PDF Java Toolkit.
        Nota:
      • Los valores de la pestaña PDF pueden ser diferentes para cada flujo de trabajo. Actualice estos valores según sea necesario después de añadir esta plantilla de pasos a un flujo de trabajo.
    6. Actualice cualquier otra configuración según sea necesario para su instalación.
    7. Pulse Aceptar.
  7. Habilite la plantilla de pasos.
  8. Establezca el número máximo de hilos que se permite utilizar a la plantilla de pasos.
    • Comience con un número de hilos que sea aproximadamente el 25% de los núcleos de la máquina. Cada hilo utilizado por este paso requiere de otros hilos que lo soporten, por lo que no puede utilizar todos los hilos para el paso. Por ejemplo, si tiene un servidor de 16 núcleos, asigne 4 hilos a este paso.
    • Puede que tenga que experimentar para determinar el número óptimo de roscas para su instalación.
    1. Abra %AIWDATA%\config\product.cfg en un editor de texto.
    2. Añada esta línea al final del archivo, sustituyendo el número de hilos que desea utilizar por número_de_hilos: 
      useBuildPdfMT_MaxThreads=number_of_threads
        Nota:
      • Recomendamos empezar con 4 hilos.
    3. Guarde y cierre el archivo.
  9. Reinicie el servicio RICOH ProcessDirector para aplicar la nueva configuración.
  10. Pruebe un flujo de trabajo con el nuevo paso.
    Le recomendamos que copie el flujo de trabajo cuyo rendimiento está intentando mejorar y, a continuación, sustituya el paso BuildPDFFromDocuments actual por la versión multihilo. Ejecute un trabajo representativo a través del flujo de trabajo.

    Durante las pruebas, controle lo siguiente:

    • Uso de la memoria del proceso Java

      Si el proceso ha alcanzado el máximo configurado para la memoria java y el rendimiento sigue siendo inaceptable, considere la posibilidad de aumentar la asignación de memoria. Manténgase dentro de las directrices señaladas en Ajuste de la asignación de memoria a Java. Reinicie el servidor secundario cada vez que actualice el archivo jvmsettings.cfg.

    • Uso de la memoria del sistema
    • Uso de la CPU
    • Intercambio de recursos
    • Recolección de elementos no utilizados en Java

      Si ve muchos hilos de recolección de basura, active el registro para la recolección de basura. Actualice jvmsettings.cfg para añadir estos parámetros:

      • -verbose:gc
      • -XX:+PrintGCDetails
      • -XX:+PrintGCTimeStamps
      • -XX:+PrintGCDateStamps
      • -Xloggc:/aiw/aiw1/trace/gc_secondary.log
      • -XX:+UseGCLogFileRotation
      • -XX:NumberOfGCLogFiles=10

        Ajuste esta configuración según sus necesidades.

      • -XX:GCLogFileSize=8m

        Ajuste esta configuración según sus necesidades.

      Debe reiniciar el servicio RICOH ProcessDirector cada vez que actualice jvmsettings.cfg.

      Revise los registros para determinar la frecuencia y la duración de la recogida de basura completa. Si el proceso tarda más de cinco o diez segundos en completarse, podría afectar al rendimiento.
    • Uso de E/S

  11. Después de cada prueba, ajuste la configuración para optimizar el procesamiento. Cuando termine de ajustar el paso, actualice sus flujos de trabajo de producción para utilizarlo en lugar del paso BuildPDFFromDocuments actual.
Tema principal: Consideraciones de capacidad y rendimiento para las características de procesamiento de documentos