Installazione server applicazioni application-server-install

NOTE
JAR e WAR sono i tipi di file Adobe Experience Manager (AEM) rilasciati in. Questi formati sono sottoposti a un controllo di qualità che tiene conto dei livelli di supporto a cui l’Adobe si è impegnato.

In questa sezione viene descritto come installare Adobe Experience Manager (AEM) con un server applicazioni. Consulta la Piattaforme supportate per informazioni sui 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.

NOTE
Se utilizzi Dynamic Medie in una distribuzione WAR, consulta Documentazione di Dynamic Medie.

Descrizione generale general-description

Comportamento predefinito durante l’installazione di AEM in un server applicazioni default-behaviour-when-installing-aem-in-an-application-server

AEM viene distribuito come un singolo file .war.

Se implementato, si verifica quanto segue per impostazione predefinita:

  • la modalità di esecuzione è author

  • l’istanza (archivio, ambiente Felix OSGI, bundle e così via) è installata 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 configuration

È 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 publish-installation

Per distribuire un’istanza Publish, devi 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 installation-check

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 two-instances-on-the-same-application-server

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 di guerra in modo che abbiano nomi diversi. Ad esempio, uno rinomina aemauthor.war e l’altro in aempublish.war.
  7. Usa impostazioni di memoria superiori. Ad esempio, le istanze AEM predefinite utilizzano -Xmx3072m
  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 application-servers-installation-procedures

WebSphere® 8.5 websphere

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 si desidera installare AEM utilizzando la directory principale del contesto = /, 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 (per 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

JBoss® EAP 6.3.0/6.4.0 jboss-eap

Prima di una distribuzione, leggi Descrizione generale sopra.

Preparare il server JBoss®

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

  • JAVA_OPTS="-Xms64m -Xmx2048m"

Se si utilizza lo scanner di distribuzione 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 esempio, 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 oracle-weblogic

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) cerca WLS_MEM_ARGS, impostato, 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

  • Metti il file di guerra dell'AEM in ${myDomain}cartella /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 AEM come applicazione (per le altre impostazioni, utilizzare le impostazioni predefinite)

  • L'installazione può richiedere tempo…

  • Verifica che l’installazione sia stata completata come indicato in precedenza nella Descrizione generale (ad esempio, coda del file error.log).

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

Tomcat 8/8,5 tomcat

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 in UNIX®) aggiungere la seguente impostazione:
      • set "JAVA_OPTS= -Xmx2048m
    • Tomcat consente l'accesso non amministratore o manager al momento dell'installazione. Pertanto, devi 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:

        code language-xml
        <?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.

      code language-xml
      <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 in 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 troubleshooting

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

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