Installazione server applicazioni

NOTA

JAR e WAR sono i tipi di file AEM rilasciati in. Questi formati sono sottoposti a un controllo qualità per tenere conto dei livelli di supporto a cui l'Adobe si è impegnato.

Questa sezione spiega come installare Adobe Experience Manager (AEM) con un server applicazioni. Consulta la Piattaforme supportate per visualizzare i livelli di supporto specifici forniti per i singoli server applicazioni.

Vengono descritti i passaggi di installazione dei seguenti Application Server:

Per ulteriori informazioni sull'installazione di applicazioni Web, sulle configurazioni del server e su come avviare e arrestare il server, consultare la documentazione del server applicazioni appropriato.

NOTA

Se utilizzi Dynamic Media in un’implementazione WAR, consulta Documentazione di Dynamic Media.

Descrizione generale

Comportamento predefinito durante l’installazione di AEM in un server applicazioni

AEM viene distribuito come un singolo file .war.

Se implementato, si verificherà quanto segue per impostazione predefinita:

  • la modalità di esecuzione è author

  • l’istanza (archivio, ambiente Felix OSGI, bundle, ecc.) è installato in ${user.dir}/crx-quickstartdove ${user.dir} è la directory di lavoro corrente, il percorso di crx-quickstart viene chiamato sling.home

  • la directory principale del contesto è il nome del file .war, ad esempio : aem-6

Configurazione

È possibile modificare il comportamento predefinito nel modo seguente:

  • modalità di esecuzione : configura sling.run.modes parametro in WEB-INF/web.xml file del file .war dell’AEM prima della distribuzione

  • sling.home: configurare sling.home parametro in WEB-INF/web.xmlfile del file .war dell’AEM prima della distribuzione

  • directory principale del contesto: rinominare il file war dell’AEM

Pubblica installazione

Per distribuire un’istanza di pubblicazione, è necessario impostare la modalità di esecuzione su Pubblica:

  • Decomprimi il WEB-INF/web.xml dal file .war dell’AEM
  • Cambia il parametro sling.run.modes in publish
  • Ripristina il file web.xml nel file .war dell’AEM
  • Distribuisci file .war AEM

Controllo dell’installazione

Per verificare se è installato tutto è possibile:

  • coda error.logper verificare che tutto il contenuto sia installato
  • guarda in /system/console che tutti i bundle siano installati

Due istanze sullo stesso server applicazioni

A scopo dimostrativo, può essere opportuno installare l’istanza di authoring e pubblicazione in un server applicazioni. Per eseguire questa operazione:

  1. Modifica le variabili sling.home e sling.run.modes dell’istanza Publish.
  2. Decomprimi il file WEB-INF/web.xml dal file .war dell’AEM.
  3. Modifica il parametro sling.home in un percorso diverso (sono possibili percorsi assoluti e relativi).
  4. Modifica sling.run.modes per pubblicare l’istanza Publish.
  5. Ripristina il file web.xml.
  6. Rinominare i file war in modo che abbiano nomi diversi: ad esempio, uno rinomina in aemauthor.war e l'altro in aempublish.war.
  7. Usa impostazioni di memoria superiori. Esempio: -Xmx3072m per le istanze AEM predefinite
  8. Distribuisci le due applicazioni web.
  9. Dopo l’implementazione, arresta le due applicazioni web.
  10. Sia nelle istanze di authoring che in quelle di pubblicazione, assicurati che nei file sling.properties la proprietà felix.service.urlhandlers=false sia impostata su false (per impostazione predefinita è impostata su true).
  11. Avvia di nuovo le due applicazioni web.

Procedure di installazione degli Application Server

WebSphere 8.5

Prima di una distribuzione, leggi Descrizione generale sopra.

Preparazione server

  • Consenti alle intestazioni di autenticazione di base di passare:

    • Un modo per consentire all'AEM di autenticare un utente consiste nel disabilitare la sicurezza amministrativa globale del server WebSphere. A tale scopo, passare a Sicurezza -> Sicurezza globale e deselezionare la casella di controllo Abilita sicurezza amministrativa, salvare e riavviare il server.
  • set "JAVA_OPTS= -Xmx2048m"

  • Se desideri installare AEM utilizzando la directory principale del contesto = /, devi prima modificare la directory principale del contesto dell’applicazione web predefinita esistente

Distribuire l’applicazione web AEM

  • Scarica file .war AEM

  • Configurare le configurazioni in web.xml se necessario (vedi sopra nella Descrizione generale)

    • Decomprimi file WEB-INF/web.xml
    • cambiare il parametro sling.run.modes in publish
    • rimuovi il commento dal parametro iniziale sling.home e imposta il percorso come necessario
    • Ripristina file web.xml
  • Distribuisci file .war AEM

    • Scegli una directory principale di contesto (se desideri impostare le modalità di esecuzione sling, seleziona i passaggi dettagliati della procedura guidata di distribuzione, quindi specificala al passaggio 6 della procedura guidata)
  • Avviare l’applicazione web AEM

EAP JBoss 6.3.0/6.4.0

Prima di una distribuzione, leggi Descrizione generale sopra.

Preparare il server JBoss

Impostare gli argomenti di memoria nel file conf (ad es. standalone.conf)

  • JAVA_OPTS="-Xms64m -Xmx2048m"

se si utilizza lo scanner di distribuzione per per installare l'applicazione web AEM, potrebbe essere opportuno aumentare il deployment-timeout, per il set a deployment-timeout nel file xml dell'istanza (ad es. configuration/standalone.xml):

<subsystem xmlns="urn:jboss:domain:deployment-scanner:1.1">
            <deployment-scanner path="deployments" relative-to="jboss.server.base.dir" scan-interval="5000" deployment-timeout="1000"/>
</subsystem>

Distribuire l’applicazione web AEM

  • Carica l’applicazione web AEM nella console di amministrazione JBoss.

  • Abilita l’applicazione web AEM.

Oracle WebLogic 12.1.3/12.2

Prima di una distribuzione, leggi Descrizione generale sopra.

Questo utilizza un layout server semplice con un solo server amministratore.

Preparazione server WebLogic

  • In entrata ${myDomain}/config/config.xmlaggiungi alla sezione configurazione protezione:

  • Aumentare le impostazioni della memoria VM:

    • apri ${myDomain}/bin/setDomainEnv.cmd (resp .sh)Cercare WLS_MEM_ARGS, impostare ad esempio set WLS_MEM_ARGS_64BIT=-Xms256m -Xmx2048m
    • riavviare il server WebLogic
  • Crea in ${myDomain} una cartella di pacchetti e all’interno di una cartella cq e in essa una cartella Plan

Distribuire l’applicazione web AEM

  • Scarica file .war AEM

  • Inserisci il file .war AEM nella cartella ${myDomain}/packages/cq

  • Configurare in WEB-INF/web.xml se necessario (vedi sopra nella Descrizione generale)

    • Decomprimi WEB-INF/web.xmlfile
    • cambiare il parametro sling.run.modes in publish
    • rimuovi il commento dal parametro iniziale sling.home e imposta il percorso come necessario (vedi Descrizione generale)
    • Ripristina file web.xml
  • Distribuire il file .war dell'AEM come applicazione (per le altre impostazioni utilizzare le impostazioni predefinite)

  • L'installazione può richiedere tempo…

  • Controllare che l’installazione sia stata completata come indicato in precedenza nella Descrizione generale (ad esempio, code the error.log).

  • È possibile modificare la directory principale del contesto nella scheda Configurazione dell’applicazione web in WebLogic /console

Tomcat 8/8,5

Prima di una distribuzione, leggi Descrizione generale sopra.

  • Prepara server Tomcat

    • Aumentare le impostazioni della memoria VM:

      • In entrata bin/catalina.bat (resp catalina.sh su unix) aggiungi la seguente impostazione:
      • set "JAVA_OPTS= -Xmx2048m
    • Tomcat non consente l'accesso né all'amministratore né al manager al momento dell'installazione. Pertanto è necessario modificare manualmente tomcat-users.xml per consentire l'accesso a questi account:

      • Modifica tomcat-users.xml per includere l’accesso per amministratore e manager. La configurazione deve essere simile al seguente esempio:

        <?xml version='1.0' encoding='utf-8'?>
        <tomcat-users>
        role rolename="manager"/>
        role rolename="tomcat"/>
        <role rolename="admin"/>
        <role rolename="role1"/>
        <role rolename="manager-gui"/>
        <user username="both" password="tomcat" roles="tomcat,role1"/>
        <user username="tomcat" password="tomcat" roles="tomcat"/>
        <user username="admin" password="admin" roles="admin,manager-gui"/>
        <user username="role1" password="tomcat" roles="role1"/>
        </tomcat-users>
        
    • Se desideri distribuire l’AEM con la directory principale del contesto "/", devi modificare la directory principale del contesto dell’app web ROOT esistente:

      • Arresta e annulla la distribuzione di ROOT Web app
      • Rinomina cartella ROOT.war nella cartella webapps di tomcat
      • Avvia di nuovo l'app Web
    • Se installi l’applicazione web AEM utilizzando il gestore-gui, devi aumentare le dimensioni massime di un file caricato, poiché l’impostazione predefinita consente solo 50 MB di dimensioni di caricamento. Per aprire il file web.xml dell’applicazione web manager,

      webapps/manager/WEB-INF/web.xml

      e aumentare le dimensioni massime dei file e delle richieste ad almeno 500 MB, vedere quanto segue multipart-config esempio di tale web.xml file.

      <multipart-config>
      <!-- 500MB max -->
      <max-file-size>524288000</max-file-size>
      <max-request-size>524288000</max-request-size>
      <file-size-threshold>0</file-size-threshold>
      </multipart-config>
      
  • Distribuire l’applicazione web AEM

    • Scarica file .war AEM

    • Configurare le configurazioni in web.xml se necessario (vedi sopra nella Descrizione generale)

      • Decomprimi file WEB-INF/web.xml
      • cambiare il parametro sling.run.modes in publish
      • rimuovi il commento dal parametro iniziale sling.home e imposta il percorso come necessario
      • Ripristina file web.xml
    • Rinomina il file .war dell’AEM in ROOT.war se desideri distribuirlo come web app principale, rinominalo ad esempio aemauthor.war se desideri avere aemauthor come directory principale del contesto

    • copiarlo nella cartella webapps di tomcat

    • attendi l’installazione di AEM

Risoluzione dei problemi

Per informazioni su come risolvere i problemi che possono verificarsi durante l'installazione, vedere:

In questa pagina