Installazione del server applicazioni application-server-install

CAUTION
AEM 6.4 ha raggiunto la fine del supporto esteso e questa documentazione non viene più aggiornata. Per maggiori dettagli, consulta la nostra periodi di assistenza tecnica. Trova le versioni supportate qui.
NOTE
JAR e WAR sono i tipi di file AEM viene rilasciato in. Questi formati sono sottoposti a garanzia della qualità per soddisfare i livelli di supporto che l'Adobe si è impegnato a raggiungere.

In questa sezione viene illustrato come installare Adobe Experience Manager (AEM) con un application server. Consulta la Piattaforme supportate per visualizzare i livelli di supporto specifici forniti per i singoli server delle applicazioni.

Sono 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 appropriata del server applicazioni.

NOTE
Se utilizzi Dynamic Media in un’implementazione WAR, consulta la documentazione di dynamic media.

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 fornito come un singolo file di guerra da distribuire.

Se implementato, il seguente verrà attivato per impostazione predefinita:

  • la modalità di esecuzione è author

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

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

Configurazione configuration

Puoi modificare il comportamento predefinito nel modo seguente:

  • modalità di esecuzione : configura sling.run.modes nel WEB-INF/web.xml file del file di guerra AEM prima della distribuzione

  • sling.home: configura sling.home nel WEB-INF/web.xmlfile del file di guerra AEM prima della distribuzione

  • directory principale del contesto: rinominare il file di guerra AEM

Pubblica installazione publish-installation

Per distribuire un'istanza di pubblicazione è necessario impostare la modalità di esecuzione per la pubblicazione:

  • Estrai il file WEB-INF/web.xml dal file di guerra AEM
  • Modifica il parametro sling.run.modes in publish
  • Ricomprimi il file web.xml AEM file WAR
  • Distribuisci AEM file di guerra

Controllo dell'installazione installation-check

Per verificare se tutto è installato è possibile:

  • tail error.logper vedere che tutto il contenuto è installato
  • cercare /system/console che tutti i bundle sono 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 unico server dell’applicazione. Per farlo, procedi come segue:

  1. Modifica le variabili sling.home e le variabili sling.run.modes dell'istanza Publish.
  2. Estrai il file WEB-INF/web.xml dal file di guerra AEM.
  3. Cambia il parametro sling.home in un percorso diverso (sono possibili percorsi assoluti e relativi).
  4. Modifica le modalità sling.run.modes per pubblicare per l'istanza di pubblicazione.
  5. Ricomprimi il file web.xml.
  6. Rinominare i file di guerra in modo che abbiano nomi diversi: Ad esempio, rinominare aemauthor.war e l'altro in aempublish.war.
  7. Utilizzare impostazioni di memoria più elevate, ad esempio per le istanze AEM predefinite che utilizzano ad esempio: -Xmx3072m
  8. Distribuire le due applicazioni web.
  9. Dopo la distribuzione, le due applicazioni Web vengono interrotte.
  10. Sia nelle istanze di authoring che di pubblicazione verificare che nei file sling.properties la proprietà felix.service.urlhandlers=false sia impostata su false (l'impostazione predefinita è true).
  11. Riavviare le due applicazioni Web.

Procedure di installazione dei server applicazioni application-servers-installation-procedures

WebSphere 8.5 websphere

Prima di leggere una distribuzione, consulta Descrizione generale sopra.

Preparazione del server

  • Lasciate passare le intestazioni di autenticazione di base:

    • Un modo per consentire AEM autenticare un utente è quello di disabilitare la sicurezza amministrativa globale del server WebSphere, per farlo: vai su Sicurezza -> Protezione globale e deseleziona la casella di controllo Abilita protezione amministrativa , salva e riavvia il server.
  • set "JAVA_OPTS= -Xmx2048m"

  • Se si desidera installare AEM utilizzando la directory principale del contesto = / allora è necessario prima modificare la directory principale del contesto dell'applicazione Web predefinita esistente

Distribuzione AEM applicazione Web

  • Scarica AEM file di guerra

  • Imposta le configurazioni In web.xml se necessario (vedi sopra nella descrizione generale)

    • Annulla il pacchetto WEB-INF/web.xml file
    • cambia il parametro sling.run.modes per pubblicare
    • decommenta il parametro iniziale sling.home e imposta questo percorso come necessario
    • Repack file web.xml
  • Distribuisci AEM file di guerra

    • Scegli una directory principale del contesto (se desideri impostare le modalità di esecuzione sling, devi selezionare i passaggi dettagliati della procedura guidata di distribuzione, quindi specificarlo nel passaggio 6 della procedura guidata)
  • Avvia AEM applicazione Web

JBoss EAP 6.3.0/6.4.0 jboss-eap

Prima di leggere una distribuzione, consulta Descrizione generale sopra.

Preparare il server JBoss

Imposta 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 utile aumentare il deployment-timeout, per l'impostazione di un 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>

Distribuzione AEM applicazione Web

  • 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 leggere una distribuzione, consulta Descrizione generale sopra.

Questo utilizza un layout server semplice con solo un Admin Server.

Preparazione del server WebLogic

  • In ${myDomain}/config/config.xmlaggiungi alla sezione security-configuration :

  • Aumenta le impostazioni della memoria VM:

    • open ${myDomain}/bin/setDomainEnv.cmd (risp.sh) cerca WLS_MEM_ARGS, impostato ad esempio set WLS_MEM_ARGS_64BIT=-Xms256m -Xmx2048m
    • riavvia server WebLogic
  • Crea in ${myDomain} una cartella pacchetti e all'interno di una cartella cq e in essa una cartella Plan

Distribuzione AEM applicazione Web

  • Scarica AEM file di guerra

  • Inserisci il file di guerra AEM nella cartella ${myDomain}/packages/cq

  • Crea le tue configurazioni in WEB-INF/web.xml se necessario (vedi sopra nella descrizione generale)

    • Rimuovi WEB-INF/web.xmlfile
    • cambia il parametro sling.run.modes per pubblicare
    • decommenta il parametro iniziale sling.home e imposta questo percorso come necessario (consulta Descrizione generale)
    • Repack file web.xml
  • Distribuire AEM file di guerra come applicazione (per le altre impostazioni utilizzare le impostazioni predefinite)

  • L'installazione può richiedere del tempo…

  • Verifica che l'installazione sia stata completata come indicato sopra nella Descrizione generale (ad esempio, la 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 leggere una distribuzione, consulta Descrizione generale sopra.

  • Prepara server Tomcat

    • Aumenta le impostazioni della memoria VM:

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

      • Modifica tomcat-users.xml per includere l'accesso per l'amministratore e il manager. La configurazione deve essere simile all'esempio seguente:
      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 AEM con la directory principale del contesto "/", devi modificare la directory principale del contesto dell'applicazione Web ROOT esistente:

      • Interrompi e disdistribuisci l'applicazione Web ROOT
      • Rinomina la cartella ROOT.war nella cartella webapps di tomcat
      • Avvia di nuovo l'app Web
    • Se installi l'applicazione web AEM utilizzando il manager-gui allora è necessario aumentare la dimensione massima di un file caricato, in quanto la dimensione predefinita consente solo 50 MB di caricamento. Per questo aprire il web.xml dell'applicazione web manager,

      webapps/manager/WEB-INF/web.xml

      e aumentare la dimensione massima del file e la dimensione massima della richiesta ad almeno 500 MB, vedi quanto segue multipart-config un esempio di tale web.xml file:

      code language-none
      <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>
      
  • Distribuzione AEM applicazione Web

    • Scarica AEM file di guerra

    • Imposta le configurazioni In web.xml se necessario (vedi sopra nella descrizione generale)

      • Annulla il pacchetto WEB-INF/web.xml file
      • cambia il parametro sling.run.modes per pubblicare
      • decommenta il parametro iniziale sling.home e imposta questo percorso come necessario
      • Repack file web.xml
    • Rinomina AEM file di guerra in ROOT.war se desideri distribuirlo come webapp principale, rinominalo ad esempio aemauthor.war se desideri che aemauthor sia la directory principale del contesto

    • copiarlo nella cartella webapps di tomcat

    • attendere fino a quando AEM installato

Risoluzione dei problemi troubleshooting

Per informazioni sui problemi che possono verificarsi durante l'installazione, vedi:

recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56