Installazione dell’applicazione da server

In questa sezione viene illustrato come installare Adobe Experience Manager (AEM) con un server applicazioni. Consultare 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 delle applicazioni Web, sulle configurazioni del server e su come avviare e arrestare il server, consultare la relativa documentazione del server applicazione.

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 distribuito, per impostazione predefinita si verifica quanto segue:

• la modalità di esecuzione è author

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

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

Configurazione

Potete modificare il comportamento predefinito nel modo seguente:

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

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

• context root: rinominare il file AEM guerra

Installazione di pubblicazione

Per implementare un’istanza di pubblicazione è necessario impostare la modalità di esecuzione per la pubblicazione:

• Rimuovere il WEB-INF/web.xml dal file di guerra AEM
• Cambia il parametro sling.run.mode in pubblicazione
• Repack file web.xml in AEM file di guerra
• Distribuisci AEM file di guerra

Controllo installazione

Per verificare se è installato tutto, è possibile:

• chiudere il file error.logper vedere che tutto il contenuto è installato
• verificare in /system/console che tutti i bundle siano installati

Due istanze sullo stesso server applicazione

A scopo dimostrativo può essere opportuno installare l’istanza di creazione e pubblicazione in un unico server applicazione. Per farlo, effettuate le seguenti operazioni:

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

Procedure di installazione dei server applicazioni

WebSphere 8.5

Prima di una distribuzione, leggere la Descrizione generale precedente.

Preparazione server

• Lasciate passare le intestazioni di autenticazione di base:

  • Un modo per consentire AEM autenticare un utente è disabilitare la protezione amministrativa globale del server WebSphere, per eseguire questa operazione: andate a Protezione > Sicurezza globale e deselezionate la casella di controllo Abilita protezione amministrativa, salvate e riavviate il server.

• imposta "JAVA_OPTS= -Xmx2048m"

• Se si desidera installare AEM utilizzando context root = /, è prima necessario modificare il context root dell'applicazione Web predefinita esistente

Implementare AEM'applicazione Web

• Scarica AEM file di guerra

• Configurare le configurazioni In web.xml se necessario (vedere sopra nella Descrizione generale)

  • Scomprimi file WEB-INF/web.xml
  • modifica il parametro sling.run.mode da pubblicare
  • rimuovete il commento dal parametro iniziale sling.home e impostate il percorso come necessario
  • Reimballaggio del file web.xml

• Distribuisci AEM file di guerra

  • Scegliere una directory principale di contesto (se si desidera impostare le modalità di esecuzione sling, è necessario selezionare i passaggi dettagliati della procedura guidata di distribuzione, quindi specificarla 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.

Preparazione del server JBoss

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

• JAVA_OPTS="-Xms64m -Xmx2048m"

se si utilizza lo scanner di distribuzione per installare l'applicazione Web AEM, potrebbe essere utile aumentare l'attributo deployment-timeout, per l'impostazione di 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>

Implementare AEM'applicazione Web

• Caricate l’applicazione Web AEM nella console di amministrazione JBoss.

• Abilitare 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 un solo Admin Server.

Preparazione server WebLogic

• In ${myDomain}/config/config.xmlaggiungere alla sezione di configurazione della sicurezza:

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

• Aumenta le impostazioni della memoria VM:

  • aprire ${myDomain}/bin/setDomainEnv.cmd (risp.sh) la ricerca per WLS_MEM_ARGS, impostare ad esempio WLS_MEM_ARGS_64BIT=-Xms256m -Xmx2048m
  • riavvio del server WebLogic

• Crea in ${myDomain} una cartella di pacchetti e all'interno di una cartella cq e in una cartella Plan

Implementare AEM'applicazione Web

• Scarica AEM file di guerra

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

• Se necessario, eseguire le configurazioni in WEB-INF/web.xml (vedere sopra nella Descrizione generale)

  • Rimuovi WEB-INF/web.xmlfile
  • modifica il parametro sling.run.mode da pubblicare
  • rimuovete il commento dal parametro iniziale sling.home e impostate il percorso come desiderate (consultate Descrizione generale)
  • Reimballaggio del file web.xml

• Distribuire AEM file di guerra come applicazione (per le altre impostazioni utilizzare le impostazioni predefinite)

• L'installazione può richiedere del tempo…

• Verificate che l'installazione sia stata completata come indicato sopra nella Descrizione generale (ad es., il file error.log)

• È possibile modificare la radice 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) aggiungere 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:

    • Modificate 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 radice contestuale "/", devi modificare la radice contestuale dell'app Web principale esistente:

    • Arrestare e annullare la distribuzione dell'app Web ROOT
    • Rinominare la cartella ROOT.war nella cartella delle app Web di Tomcat
    • Avvia di nuovo l'app Web

  • Se installate l'applicazione Web AEM utilizzando manager-gui, dovete aumentare la dimensione massima di un file caricato, in quanto l'impostazione 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 le dimensioni massime dei file e massime delle richieste ad almeno 500 MB, vedere l'esempio seguente di un file multipart-config di questo tipo.web.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>
    

• Implementare AEM'applicazione Web

  • Scarica AEM file di guerra

  • Configurare le configurazioni In web.xml se necessario (vedere sopra nella Descrizione generale)

    • Scomprimi file WEB-INF/web.xml
    • modifica il parametro sling.run.mode da pubblicare
    • rimuovete il commento dal parametro iniziale sling.home e impostate il percorso come necessario
    • Reimballaggio del file web.xml

  • Rinominare AEM file di guerra in ROOT.war se si desidera distribuirlo come root webapp, rinominarlo ad esempio aemauthor.war se si desidera avere aemauthor come context root

  • copiarlo nella cartella delle app Web di tomcat

  • attendere fino a quando AEM installato

Risoluzione dei problemi

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

• Risoluzione dei problemi