Ottimizzazione delle operazioni BuildPDFFromDocuments

Il passo BuildPDFFromDocuments è un passo che richiede molte risorse e che assembla un lavoro PDF da documenti che sono stati identificati da RICOH ProcessDirector. Se il numero di documenti è elevato o se utilizza regole complesse nel suo file, la durata dell'elaborazione per questa fase si misura in ore, non in minuti. Sono disponibili opzioni di configurazione avanzate per ridurre il tempo di elaborazione in questa fase per lavori molto grandi o molto complessi.
    Importante:
  • Questa configurazione è molto avanzata. Non è raccomandato per tutte le implementazioni di RICOH ProcessDirector.

Il suo sistema è un buon candidato per questa configurazione se tutte queste cose sono vere:

  • L'elaborazione più rapida di un singolo lavoro PDF è più importante del throughput totale.
  • I suoi lavori PDF contengono molti documenti o utilizzano regole complesse che rendono l'elaborazione molto lunga.
  • Lei dispone (o può acquisire) risorse hardware adeguate per il sistema che utilizza il passo. Il sistema deve avere molti core della CPU, poiché ogni thread utilizzato per l'elaborazione richiede tre o quattro thread in background per gestire l'utilizzo della memoria e altre attività. Il sistema deve inoltre disporre di almeno 16 GB di RAM per questa elaborazione sul computer principale o su server aggiuntivi da configurare come server secondari.
  • I membri del suo team hanno le competenze e gli strumenti necessari per monitorare le prestazioni del sistema. Per sintonizzare correttamente il sistema, deve essere in grado di monitorare:
    • Memoria utilizzata dai processi Java
    • Garbage collection di Java
    • Utilizzo della memoria del sistema
    • Utilizzo della CPU
    • Scambio di risorse
    • I/O del sistema

In questa configurazione, lei imposta il suo sistema per eseguire il passo BuildPDFFromDocuments utilizzando più thread. La configurazione richiede che il passo venga eseguito in una macchina virtuale Java (JVM) separata. Per eseguire il passo nella propria JVM, crei un server secondario e metta a punto il passo BuildPDFFromDocuments per eseguirlo su quel server. Nessun altro passaggio deve essere configurato per essere eseguito su quel server.

Per ottimizzare i passaggi di BuildPDFFromDocuments:

  1. Determini se il suo computer principale dispone di una memoria sufficiente per supportare questa configurazione.
    Riveda l'argomento Regolazione dell'allocazione della memoria Java. Si consiglia di allocare almeno 16 GB di RAM al server secondario locale. Se i calcoli effettuati in questo argomento indicano che ha a disposizione 16 GB di RAM o che può installare una memoria aggiuntiva sul sistema, può utilizzare un server secondario locale. Continuare con il passo .
  2. Crea un server secondario locale con questa procedura: Definizione di server secondari sul computer primario.
    Imposti la proprietà In gruppo stampanti generale su No e lasci il Numero massimo di operazioni a elevato utilizzo di risorse impostato a 1.
      Nota:
    • Si fermi dopo aver creato il server secondario. Non metta ancora a punto il modello di passo BuildPDFFromDocuments.
  3. Aggiornare le impostazioni JVM per questo server secondario.
    1. Aprire %AIWDATA%\config\jvmsettings.cfg in un editor di testo.
      Per impostazione predefinita, %AIWDATA% è \aiw\aiw1.
    2. Copi la riga per il server primario che assomiglia a questa:
      primary=-Xmx2048m -Djava.net.preferIPv4Stack=true -Djava.awt.headless=true

      Lo incolli in una nuova riga del file.

      Il valore dopo primary=-Xmx è la quantità massima di memoria heap che l'ambiente di run time Java RICOH ProcessDirector può utilizzare per il processo primario RICOH ProcessDirector. In questo esempio, il server primario può utilizzare 2048 MB (2 GB) di RAM per il suo heap.

    3. Aggiorni la riga che ha copiato per cambiare primary con il valore della proprietà Nome server per il server secondario.
    4. Aggiorni il valore dopo secondary_server_name=-Xmx alla quantità di memoria che ha a disposizione per questo processo. Il valore dovrebbe essere di almeno 16 g.
    5. Se la riga per il suo server secondario non include questa impostazione: -XX:+UseG1GC, aggiorni la riga per aggiungerla.
    6. Salvare e chiudere il file.
  4. Riavviare il servizio RICOH ProcessDirector per applicare le nuove impostazioni.
  5. Abilita il server secondario nell'interfaccia RICOH ProcessDirector.
  6. Metta a punto il modello di operazione BuildPDFFromDocuments.
    Si consiglia di fare una copia del modello di operazione da utilizzare nella configurazione multithread.
    1. Aprire Flusso di lavoro ⇒ Modelli di operazione.
    2. Trovi il modello di operazione BuildPDFFromDocuments, faccia clic con il pulsante destro del mouse e scelga Copia.
    3. Nella scheda Generale, inserisca un valore per la proprietà Nome.

      Scelga un nome che indichi chiaramente che si tratta della versione multithreaded del passo.

    4. Nella scheda Regolazione:
      • Imposti Sintonizzazione avanzata su Thread multiplo di questa operazione.
      • Imposti Server da usare su Esegui su server specifici, quindi selezioni solo il server secondario che ha creato.
    5. Nella scheda PDF, osservi tutte le proprietà File di controllo Crea PDF.
      • Se il suo passo utilizza uno o più file di controllo, verifichi che Crea libreria sia impostata su Utilizza file predefinito o di controllo.
      • Se il suo passo non utilizza alcun file di controllo, imposti Crea libreria su PDF Java Toolkit.
        Nota:
      • I valori della scheda PDF possono essere diversi per ogni flusso di lavoro. Aggiorni questi valori come necessario dopo aver aggiunto questo modello di passo a un flusso di lavoro.
    6. Aggiorni tutte le altre impostazioni necessarie per la sua installazione.
    7. Fare clic su OK.
  7. Abilita il modello di operazione.
  8. Imposta il numero massimo di thread che il modello di operazione può utilizzare.
    • Inizia con un numero di thread pari a circa il 25% dei core della macchina. Ogni thread utilizzato da questo passo richiede altri thread per supportarlo, quindi non può utilizzare tutti i thread per il passo. Ad esempio, se dispone di un server a 16 core, assegni 4 thread a questa fase.
    • Potrebbe dover fare degli esperimenti per determinare il numero ottimale di fili per la sua installazione.
    1. Apra %AIWDATA%\config\product.cfg in un editor di testo.
    2. Aggiunga questa riga alla fine del file, sostituendo il numero di thread che desidera utilizzare con numero_di_thread: 
      useBuildPdfMT_MaxThreads=number_of_threads
        Nota:
      • Consigliamo di iniziare con 4 thread.
    3. Salvare e chiudere il file.
  9. Riavviare il servizio RICOH ProcessDirector per applicare la nuova impostazione.
  10. Provi un flusso di lavoro con il nuovo passo.
    Consigliamo di copiare il flusso di lavoro di cui sta cercando di migliorare le prestazioni, quindi di sostituire il passo BuildPDFFromDocuments attuale con la versione multithread. Esegua un lavoro rappresentativo attraverso il flusso di lavoro.

    Durante il test, controlli quanto segue:

    • Utilizzo della memoria del processo Java

      Se il processo ha raggiunto il massimo configurato per la memoria java e le prestazioni sono ancora inaccettabili, consideri di aumentare l'allocazione della memoria. Rimanga all'interno delle linee guida delineate in Regolazione dell'allocazione della memoria Java. Riavvii il server secondario ogni volta che aggiorna il file jvmsettings.cfg.

    • Utilizzo della memoria del sistema
    • Utilizzo della CPU
    • Scambio di risorse
    • Garbage collection di Java

      Se vede molti thread di garbage collection, attivi la registrazione per la garbage collection. Aggiornare jvmsettings.cfg per aggiungere questi parametri:

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

        Regoli questa impostazione in base alle sue esigenze.

      • -XX:GCLogFileSize=8m

        Regoli questa impostazione in base alle sue esigenze.

      Deve riavviare il servizio RICOH ProcessDirector ogni volta che aggiorna jvmsettings.cfg.

      Esamini i registri per determinare la frequenza e la durata della raccolta completa dei rifiuti. Se il processo richiede più di cinque-dieci secondi per essere completato, potrebbe influire sulle prestazioni.
    • Uso dell'I/O

  11. Dopo ogni test, regoli le impostazioni per ottimizzare l'elaborazione. Una volta terminata la regolazione del passo, aggiorni i flussi di lavoro di produzione per utilizzarlo al posto del passo BuildPDFFromDocuments attuale.
Argomento collegato: Considerazioni di prestazioni e capacità con le funzioni di elaborazione dei documenti