Configurazione della memorizzazione in cache per l’output configuring-caching-for-output

Il servizio di output unisce i dati del modulo XML con una struttura di modulo creata in Designer per creare un flusso di output di documenti in vari formati.

La pagina Output nella console di amministrazione contiene le impostazioni che controllano il modo in cui il servizio di output memorizza gli elementi nella cache. È possibile regolare queste impostazioni per ottimizzare le prestazioni del servizio di output.

Il servizio di output memorizza nella cache i seguenti elementi:

  • progettazioni moduli: Il servizio di output memorizza nella cache le progettazioni dei moduli recuperate dall'archivio o dalle origini HTTP. Questo caching migliora le prestazioni perché per le successive richieste di rendering, il servizio di output recupera la progettazione del modulo dalla cache anziché dall’archivio.
  • frammenti e immagini: Il servizio di output può memorizzare nella cache frammenti e immagini utilizzati nelle progettazioni di moduli. Quando il servizio di output memorizza nella cache questi oggetti, migliora le prestazioni perché i frammenti e le immagini vengono letti dal repository solo alla prima richiesta.

L’output memorizza la cache in due posizioni:

  • in memoria: elementi sono archiviati in memoria per l'accesso rapido. La cache in memoria ha dimensioni limitate e viene eliminata al riavvio del server.
  • su disco: elementi archiviati nel file system del server. La cache del disco ha una capacità maggiore della cache in memoria e viene mantenuta al riavvio del server. La posizione della cache del disco dipende dal server dell'applicazione. Per informazioni sulla modifica del percorso della cache del disco, vedere Specificare i percorsi dei file per l'output.

Specifica della modalità cache specifying-the-cache-mode

L'output supporta due modalità di caching:

  • incondizionato
  • utilizzo del punto di controllo della cache

Se passi da una modalità di cache all’altra, riavvia il servizio di output per rendere effettiva la modifica. Per riavviare il servizio, utilizzare Workbench o vedere Avviare o arrestare i servizi associati ai moduli AEM forms per le istruzioni.

Il tempo del punto di controllo della cache viene reimpostato automaticamente quando si passa da una modalità all'altra.

Utilizzo del caching non condizionale using-unconditional-caching

In questa modalità, quando il servizio di output riceve una richiesta, convalida le risorse necessarie (progettazione del modulo ed eventuali risorse correlate, come frammenti e immagini). Il servizio di output confronta la marca temporale delle risorse nell’archivio con la marca temporale delle risorse nella cache. Se la risorsa nella cache è meno recente, il servizio di output la aggiorna.

Questa modalità di cache garantisce l’utilizzo delle risorse più recenti. Tuttavia, le prestazioni sono influenzate dal fatto che il servizio di output convalida gli elementi memorizzati in cache rispetto all’archivio con ogni richiesta. Questa modalità cache è adatta per gli ambienti di sviluppo e staging in cui le risorse vengono aggiornate frequentemente e le prestazioni non rappresentano un problema primario.

Specificare il caching incondizionato

  1. Nella console di amministrazione, fai clic su Servizi > output.
  2. In Impostazioni controllo cache di output, selezionare Incondizionatamente e fare clic su Salva.

Utilizza il punto di controllo della cache use-the-cache-check-point

In questa modalità, il servizio di output controlla l’archivio solo per le versioni più recenti delle risorse quando la marca temporale della risorsa memorizzata in cache è precedente all’ora del punto di controllo della cache. L'ora dell'ultimo punto di controllo della cache viene visualizzata nella pagina Output di Admin Console.

Utilizza questa modalità cache in ambienti di produzione ad alte prestazioni in cui le prestazioni sono un problema e le modifiche alle risorse non sono frequenti. È possibile reimpostare l’ora del punto di controllo della cache quando si desidera distribuire eventuali modifiche apportate alle risorse dell’archivio.

Specificare l'utilizzo di un punto di controllo della cache

  1. In Administration Console, fare clic su Servizi > output.
  2. In Impostazioni controllo cache di output, selezionare Solo se l'ultima convalida è stata eseguita prima dell'ora del punto di controllo della cache e fare clic su Salva.

Reimpostare il punto di controllo della cache

  1. Nella console di amministrazione, fai clic su Servizi > output.
  2. In Impostazioni controllo cache di output fare clic su Punto di controllo cache.

Reimposta il contenuto della cache reset-the-cache-contents

Puoi cancellare il contenuto della cache in qualsiasi momento. Dopo un ripristino della cache, la prima richiesta per ciascun modulo è più lenta perché il servizio di output esegue un rendering completo e crea nuovo contenuto della cache.

  1. Nella console di amministrazione, fai clic su Servizi > output.
  2. In Impostazioni controllo cache di output fare clic su Reimposta cache.

Configurazione impostazioni cache configuring-cache-settings

Puoi specificare le impostazioni utilizzate da Output per il caching, in modo da ottimizzare le prestazioni dell’ambiente AEM Forms.

Per accedere a queste impostazioni, nella console di amministrazione, fai clic su Servizi > output.

NOTE
I requisiti del disco per la cache devono essere uguali all’archivio.

Specifica delle impostazioni globali della cache specifying-global-cache-settings

Le impostazioni nell'area Global Cache Settings hanno effetto su tutti i tipi di cache. Se si modifica una di queste impostazioni, riavviare il servizio di output per rendere effettiva la modifica. Per riavviare il servizio, utilizzare Workbench o vedere Avviare o arrestare i servizi associati ai moduli AEM forms per le istruzioni.

Dimensione massima documento cache (KB): La dimensione massima, in kilobyte, di una struttura di modulo o di un'altra risorsa che può essere archiviata in qualsiasi cache in memoria. Si tratta di un’impostazione globale applicabile a tutte le cache in memoria. Se la risorsa è maggiore di questo valore, non viene memorizzata nella cache. Il valore predefinito è 1024 kilobyte. Questa impostazione non influisce sulla cache del disco.

Cache di rendering moduli abilitata: Per impostazione predefinita, questa opzione è selezionata, il che significa che i moduli sottoposti a rendering vengono memorizzati nella cache per il recupero successivo. Questa impostazione ha scarso effetto sulle prestazioni del servizio di output perché non memorizza in cache i documenti non interattivi. Questa opzione ha effetto quando si utilizza il servizio di output per i documenti non interattivi sottoposti a rendering sul client.

Memorizzazione in cache delle progettazioni dei moduli caching-form-designs

Quando il servizio di output riceve una richiesta di rendering, recupera la progettazione del modulo dal repository o da un'origine HTTP e la memorizza nella cache. Questo caching migliora le prestazioni perché per le successive richieste di rendering, il servizio di output recupera la progettazione del modulo dalla cache anziché dall’archivio.

Il servizio di output memorizza sempre nella cache le progettazioni dei moduli su disco. Se le progettazioni dei moduli sono memorizzate sul server, tali file vengono considerati cache del disco. Il servizio di output memorizza nella cache anche le progettazioni dei moduli in memoria, in base all'impostazione nell'area In Memory Template Cache. Se modifichi una di queste impostazioni, riavvia il servizio di output per rendere effettiva la modifica. Per riavviare il servizio, utilizzare Workbench o vedere Avviare o arrestare i servizi associati ai moduli AEM forms per le istruzioni.

Dimensioni cache configurazione modello: Il numero massimo di oggetti configurazione modello da mantenere in memoria. Il valore predefinito è 100. È consigliabile impostare questo valore su un valore maggiore o uguale al valore di Dimensione cache modello. Questa impostazione non influisce sulla cache del disco.

Dimensione cache modello: il numero massimo di oggetti contenuto modello da mantenere in memoria. Il valore predefinito è 100. Questa impostazione non influisce sulla cache del disco.

Abilitato: Per impostazione predefinita, questa casella di controllo è selezionata, il che significa che i modelli di modulo sono memorizzati nella cache. Se questa opzione non è selezionata, i modelli di modulo vengono memorizzati nella cache solo su disco.

Memorizzazione in cache di frammenti e immagini caching-fragments-and-images

Il servizio di output memorizza nella cache frammenti e immagini utilizzati nelle progettazioni di moduli su disco. Ciò migliora le prestazioni perché i frammenti e le immagini vengono letti dall’archivio solo alla prima richiesta. Quindi, nelle richieste successive, il servizio di output legge i frammenti e le immagini dalla cache del disco. I frammenti e le immagini vengono memorizzati nella cache solo su disco e non in memoria.

È possibile utilizzare le seguenti impostazioni per controllare la memorizzazione nella cache su disco di frammenti e immagini. Queste impostazioni si trovano nell'area Impostazioni cache risorse modello:

Memorizzazione in cache delle risorse Selezionare una delle opzioni seguenti dall'elenco:

Abilitato per frammenti e immagini: Il servizio di output memorizza nella cache frammenti e immagini. Questa è l'opzione predefinita.

Abilitato per i frammenti: Il servizio di output memorizza nella cache i frammenti, ma non le immagini.

Disabilitato: Il servizio di output non memorizza nella cache frammenti o immagini.

Intervallo di pulizia (secondi): Specifica la frequenza con cui il servizio di output rimuove i vecchi file della cache non validi. Il servizio di output non rimuove i file di cache validi. Se si modifica l'intervallo di pulizia, riavviare il servizio di output per rendere effettiva la modifica. Per riavviare il servizio, utilizzare Workbench o vedere Avviare o arrestare i servizi associati ai moduli AEM Forms per le istruzioni.

Considerazioni sul clustering per le cache clustering-considerations-for-caches

In un ambiente cluster, ogni nodo mantiene la propria cache in memoria e su disco. Il contenuto della cache di ciascun nodo dipende dai moduli di cui è stato eseguito il rendering su quel nodo.

La posizione della cache deve essere identica (stesso disco e percorso) in ogni nodo del cluster. Non inserire la cache nell'archiviazione condivisa.

Se utilizzi la pagina Output nella console di amministrazione per modificare le impostazioni della cache per un particolare nodo, le impostazioni della cache sugli altri nodi vengono aggiornate quando una richiesta viene indirizzata a tale nodo. Questo comportamento si applica anche al pulsante Reimposta cache. Se fai clic sul pulsante Reimposta cache per un nodo, la cache viene rimossa immediatamente da quel nodo. La cache sugli altri nodi viene cancellata quando una richiesta viene indirizzata a quel nodo.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2