Installation av programserver application-server-install
JAR
och WAR
är de filtyper som Adobe Experience Manager (AEM) släpps i. Dessa format genomgår kvalitetssäkring för att passa de supportnivåer som Adobe har åtagit sig.I det här avsnittet beskrivs hur du installerar Adobe Experience Manager (AEM) med en programserver. Gå till avsnittet Plattformar som stöds om du vill läsa mer om de specifika supportnivåer som finns för de enskilda programservrarna.
Installationsstegen för följande programservrar beskrivs:
Mer information om hur du installerar webbprogram, serverkonfigurationer och hur du startar och stoppar servern finns i dokumentationen för respektive programserver.
Allmän beskrivning general-description
Standardbeteende vid installation av AEM i en programserver default-behaviour-when-installing-aem-in-an-application-server
AEM kommer som en enda krigsfil att distribuera.
Om den distribueras händer följande som standard:
-
körningsläget är
author
-
instansen (databas, Felix OSGI-miljö, paket och så vidare) är installerad i
${user.dir}/crx-quickstart
där${user.dir}
är den aktuella arbetskatalogen. Sökvägen till crx-quickstart kallassling.home
-
kontextroten är krigsfilens namn, till exempel
aem-6
Konfiguration configuration
Du kan ändra standardbeteendet på följande sätt:
-
körningsläge: konfigurera parametern
sling.run.modes
i filenWEB-INF/web.xml
i AEM krigsfil före distribution -
sling.home: konfigurera parametern
sling.home
i filenWEB-INF/web.xml
i AEM krigsfil före distributionen -
kontextrot: ändra namn på AEM krigsfil
Installation av Publish publish-installation
Om du vill distribuera en publiceringsinstans måste du ange att körningsläget ska publiceras:
- Packa upp WEB-INF/web.xml från AEM krigsfil
- Ändra parametern sling.run.modes till publicering
- Repetera web.xml-filen i AEM
- Distribuera AEM
Installationskontroll installation-check
Om du vill kontrollera om alla är installerade kan du:
- svansen för filen
error.log
för att se att allt innehåll är installerat - kontrollera i
/system/console
att alla paket är installerade
Två instanser på samma programserver two-instances-on-the-same-application-server
I demonstrationssyfte kan det vara lämpligt att installera författaren och publicera instansen i en programserver. Gör så här:
- Ändra variablerna sling.home och sling.run.modes i publiceringsinstansen.
- Packa upp WEB-INF/web.xml från AEM krigsfil.
- Ändra parametern sling.home till en annan sökväg (absoluta och relativa sökvägar är möjliga).
- Ändra sling.run.modes till publicering för publiceringsinstansen.
- Upprepa filen web.xml.
- Byt namn på krigsfilerna så att de har olika namn. Exempel: en byter namn till aemauthor.war och den andra till aempublish.war.
- Använd högre minnesinställningar. Standardinstanser AEM till exempel
-Xmx3072m
- Distribuera de två webbprogrammen.
- Stoppa de två webbprogrammen efter distributionen.
- I både författare- och publiceringsinstanser ser du till att egenskapen felix.service.urlhandlers=false anges i filen sling.properties (standard är att den är true).
- Starta de två webbprogrammen igen.
Installationsprocedurer för programservrar application-servers-installation-procedures
WebSphere® 8.5 websphere
Läs Allmän beskrivning ovan före en distribution.
Serverförberedelse
-
Låt Basic Auth Headers gå igenom:
- Ett sätt för AEM att autentisera en användare är att inaktivera den globala administrativa säkerheten för WebSphere®-servern: gå till Säkerhet > Global säkerhet och avmarkera kryssrutan Aktivera administrativ säkerhet, spara och starta om servern.
-
ange
"JAVA_OPTS= -Xmx2048m"
-
Om du vill installera AEM med kontextroten = /, ändrar du kontextroten för det befintliga standardwebbprogrammet.
Distribuera AEM webbprogram
-
Ladda ned AEM
-
Gör dina konfigurationer i web.xml vid behov (se ovan i den allmänna beskrivningen)
- Packa upp WEB-INF/web.xml
- ändra sling.run.modes-parameter för publicering
- avkommentera slinga.initial startparameter och ange den här sökvägen efter behov
- Replikera filen web.xml
-
Distribuera AEM
- Välj en kontextrot (om du vill ange de körningslägen för sling som du behöver för att välja detaljerade steg i distributionsguiden, anger du dem sedan i steg 6 i guiden)
-
Starta AEM
JBoss® EAP 6.3.0/6.4.0 jboss-eap
Läs Allmän beskrivning ovan före en distribution.
Förbered JBoss®-server
Ange minnesargument i din conf-fil (till exempel standalone.conf
)
- JAVA_OPTS="-Xms64m -Xmx2048m"
Om du använder distributionsskannern för att installera det AEM webbprogrammet kan det vara bra att öka deployment-timeout,
för det angivna attributet deployment-timeout
i xml-filen för instansen (till exempel 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>
Distribuera AEM webbprogram
-
Ladda upp det AEM webbprogrammet i JBoss® Administration Console.
-
Aktivera det AEM webbprogrammet.
Oracle WebLogic 12.1.3/12.2 oracle-weblogic
Läs Allmän beskrivning ovan före en distribution.
Detta använder en enkel serverlayout med endast en Admin Server.
Förberedelse av WebLogic-server
-
I
${myDomain}/config/config.xml
lägg till i avsnittet för säkerhetskonfiguration:<enforce-valid-basic-auth-credentials>false</enforce-valid-basic-auth-credentials>
finns på https://xmlns.oracle.com/weblogic/domain/1.0/domain.xsd för att se rätt position (som standard är OK för att placera den i slutet av avsnittet)
-
Öka inställningarna för virtuellt minne:
- öppna
${myDomain}/bin/setDomainEnv.cmd
(svara .sh) sökning efter WLS_MEM_ARGS, ange till exempelWLS_MEM_ARGS_64BIT=-Xms256m -Xmx2048m
- starta om WebLogic-server
- öppna
-
Skapa en paketmapp i
${myDomain}
och i en cq-mapp och i den en planmapp
Distribuera AEM webbprogram
-
Ladda ned AEM
-
Placera AEM i mappen ${myDomain}/packages/cq
-
Gör dina konfigurationer i
WEB-INF/web.xml
om det behövs (se ovan i den allmänna beskrivningen)- Packa upp filen
WEB-INF/web.xml
- ändra sling.run.modes-parameter för publicering
- avkommentera sling.home initial parameter och ange den här sökvägen efter behov (se General Description)
- Replikera filen web.xml
- Packa upp filen
-
Distribuera AEM krigsfil som ett program (använd standardinställningarna för de andra inställningarna)
-
Installationen kan ta tid…
-
Kontrollera att installationen har slutförts enligt beskrivningen ovan i den allmänna beskrivningen (t.ex. för att anpassa error.log)
-
Du kan ändra kontextroten på fliken Konfiguration i webbprogrammet i WebLogic
/console
Tomcat 8/8.5 tomcat
Läs Allmän beskrivning ovan före en distribution.
-
Förbered Tomcat Server
-
Öka inställningarna för virtuellt minne:
- I
bin/catalina.bat
(svaracatalina.sh
på UNIX®) lägger du till följande inställning: set "JAVA_OPTS= -Xmx2048m
- I
-
Tomcat ger inte administratörs- eller hanteraråtkomst vid installationen. Därför måste du redigera
tomcat-users.xml
manuellt för att tillåta åtkomst för dessa konton:-
Redigera
tomcat-users.xml
om du vill inkludera åtkomst för administratör och hanterare. Konfigurationen bör se ut ungefär som i följande exempel: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>
-
-
Om du vill distribuera AEM med kontextroten "/" måste du ändra kontextroten för den befintliga ROOT-webbappen:
- Stoppa och avdistribuera ROOT-webbprogram
- Byt namn på mappen ROOT.war i Tomcat-webbappen
- Starta webbprogrammet igen
-
Om du installerar AEM webbprogram med hanteraren-gui måste du öka den maximala storleken för en överförd fil, eftersom standardvärdet endast tillåter 50 MB uppladdningsstorlek. För att göra det öppnar web.xml för webbprogrammet manager,
webapps/manager/WEB-INF/web.xml
och öka storleken för max-file och max-request-size till minst 500 MB, se följande
multipart-config
exempel på en sådanweb.xml
-fil.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>
-
-
Distribuera AEM webbprogram
-
Ladda ned AEM.
-
Gör dina konfigurationer i web.xml om det behövs (se ovan i den allmänna beskrivningen).
- Packa upp WEB-INF/web.xml.
- Ändra parametern sling.run.modes till publish.
- Avkommentera sling.home initial parameter och ange den här sökvägen efter behov.
- Repackera filen web.xml.
-
Byt namn AEM krigsfilen till ROOT.war om du vill distribuera den som en rotwebbapp. Byt namn på den till aemauthor.war om du vill ha en aemauthor som kontextrot.
-
Kopiera den till Tomcat's webbapps folder.
-
Vänta tills AEM har installerats.
-
Felsökning troubleshooting
Information om hur du hanterar problem som kan uppstå under installationen finns i: