Installazione server applicazioni application-server-install
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 sezione 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.
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-quickstart
dove${user.dir}
è la directory di lavoro corrente, il percorso a crx-quickstart è denominatosling.home
-
la radice 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 il parametro
sling.run.modes
nel fileWEB-INF/web.xml
del file .war AEM prima della distribuzione -
sling.home: configura il parametro
sling.home
nel fileWEB-INF/web.xml
del file .war dell'AEM prima della distribuzione -
directory principale del contesto: rinominare il file war dell’AEM
Installazione di Publish 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 il file
error.log
per verificare che tutto il contenuto sia installato - verifica 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:
- Modifica le variabili sling.home e sling.run.modes dell’istanza Publish.
- Decomprimi il file WEB-INF/web.xml dal file .war dell’AEM.
- Modifica il parametro sling.home in un percorso diverso (sono possibili percorsi assoluti e relativi).
- Modifica sling.run.modes per pubblicare l’istanza Publish.
- Ripristina il file web.xml.
- Rinominare i file di guerra in modo che abbiano nomi diversi. Ad esempio, uno rinomina aemauthor.war e l’altro in aempublish.war.
- Usa impostazioni di memoria superiori. Ad esempio, le istanze AEM predefinite utilizzano
-Xmx3072m
- Distribuisci le due applicazioni web.
- Dopo l’implementazione, arresta le due applicazioni web.
- 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).
- 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, leggere la Descrizione generale riportata 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.
-
imposta
"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.
Distribuisci 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, leggere la Descrizione generale riportata sopra.
Prepara 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 deployment-timeout,
per tale 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>
Distribuisci 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, leggere la Descrizione generale riportata sopra.
Questo utilizza un layout server semplice con un solo server amministratore.
Preparazione server WebLogic
-
In
${myDomain}/config/config.xml
aggiungi alla sezione di configurazione della protezione:<enforce-valid-basic-auth-credentials>false</enforce-valid-basic-auth-credentials>
vedere il https://xmlns.oracle.com/weblogic/domain/1.0/domain.xsd per la posizione corretta (per impostazione predefinita, la posizione alla fine della sezione è ok)
-
Aumentare le impostazioni della memoria VM:
- apri
${myDomain}/bin/setDomainEnv.cmd
(resp .sh) ricerca WLS_MEM_ARGS, impostato, ad esempio, impostatoWLS_MEM_ARGS_64BIT=-Xms256m -Xmx2048m
- riavviare il server WebLogic
- apri
-
Creare in
${myDomain}
una cartella di pacchetti e all'interno di una cartella cq e in essa una cartella Plan
Distribuisci applicazione Web AEM
-
Scarica file .war AEM
-
Inserisci il file .war dell'AEM nella cartella ${myDomain}/packages/cq
-
Configurare In
WEB-INF/web.xml
se necessario (vedi sopra nella Descrizione generale)- Decomprimi
WEB-INF/web.xml
file - 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
- Decomprimi
-
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, leggere la Descrizione generale riportata sopra.
-
Prepara server Tomcat
-
Aumentare le impostazioni della memoria VM:
- In
bin/catalina.bat
(respcatalina.sh
su UNIX®) aggiungere la seguente impostazione: set "JAVA_OPTS= -Xmx2048m
- In
-
Tomcat consente l'accesso non amministratore o manager al momento dell'installazione. Pertanto, è necessario modificare manualmente
tomcat-users.xml
per consentire l'accesso a questi account:-
Modificare
tomcat-users.xml
per includere l'accesso per l'amministratore e il 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 max-file-size e max-request-size ad almeno 500 MB, vedi il seguente esempio
multipart-config
di un fileweb.xml
di questo tipo.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>
-
-
Distribuisci applicazione Web AEM
-
Scarica il file .war dell'AEM.
-
Se necessario, effettua le configurazioni in web.xml (vedi sopra nella Descrizione generale).
- Decomprimi il file WEB-INF/web.xml.
- Modifica il parametro sling.run.modes in publish.
- Rimuovi il commento dal parametro iniziale sling.home e imposta il percorso come necessario.
- Ripristina il file web.xml.
-
Rinomina il file .war dell’AEM in ROOT.war se desideri distribuirlo come web app principale. Rinominalo in aemauthor.war se vuoi avere aemauthor come directory principale del contesto.
-
Copiatelo nella cartella Webapps di Tomcat.
-
Attendere l'installazione dell'AEM.
-
Risoluzione dei problemi troubleshooting
Per informazioni su come risolvere i problemi che possono verificarsi durante l'installazione, vedere: