Installazione dell’applicazione da server

In questa sezione viene illustrato come installare Adobe Experience Manager (AEM) con un application server. Consulta la sezione 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:

• WebSphere 8.5
• JBoss EAP 6.3.0/6.4.0
• Oracle WebLogic 12.1.3/12.2
• Tomcat 8/8.5

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.

Descrizione generale

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

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

Puoi modificare il comportamento predefinito nel modo seguente:

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

• sling.home: configura il parametro sling.home nel file WEB-INF/web.xmldel file di guerra AEM prima della distribuzione

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

Pubblica installazione

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

Per verificare se tutto è installato è possibile:

• tail il file error.logper vedere che tutto il contenuto è installato
• cerca in /system/console che tutti i bundle sono installati

Due istanze sullo stesso server applicazioni

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

WebSphere 8.5

Prima di una distribuzione leggere la Descrizione generale precedente.

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

Prima di una distribuzione leggere la Descrizione generale precedente.

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 valore deployment-timeout, per il quale impostare un attributo 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

Prima di una distribuzione leggere la Descrizione generale precedente.

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

Preparazione del server WebLogic

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

  • <enforce-valid-basic-auth-credentials>false</enforce-valid-basic-auth-credentials> vedi su https://xmlns.oracle.com/weblogic/domain/1.0/domain. xsdper la posizione corretta (per impostazione predefinita, posizionarla alla fine della sezione va bene)

• Aumenta le impostazioni della memoria VM:

  • aprire ${myDomain}/bin/setDomainEnv.cmd (risp.sh)cercare WLS_MEM_ARGS, impostare ad esempio set WLS_MEM_ARGS_64BIT=-Xms256m -Xmx2048m
  • riavvia server WebLogic

• Crea in ${myDomain} una cartella dei 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

• Effettua le configurazioni In WEB-INF/web.xml se necessario (vedi sopra nella descrizione generale)

  • Rimuovi dal pacchetto il file 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

Prima di una distribuzione leggere la Descrizione generale precedente.

• 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:

      <?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 il seguente multipart-config esempio di un file web.xml di questo tipo.

    <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

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

• Risoluzione dei problemi