Installation av programserver

OBSERVERA

JAR och WAR är filtyperna 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. Läs Plattformar som stöds om du vill läsa om de specifika supportnivåerna 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.

OBSERVERA

Om du använder Dynamic Media i en WAR-distribution kan du läsa Dynamic Media-dokumentation.

Allmän beskrivning

Standardbeteende vid installation av AEM i en programserver

AEM kommer som en enda krigsfil att distribuera.

Om den distribueras händer följande som standard:

  • körningsläget är author

  • instansen (Repository, Felix OSGI environment, bundles, osv.) installeras i ${user.dir}/crx-quickstartdär ${user.dir} är den aktuella arbetskatalogen, den här sökvägen till crx-quickstart anropas sling.home

  • kontextroten är krigsfilens namn, till exempel: aem-6

Konfiguration

Du kan ändra standardbeteendet på följande sätt:

  • körningsläge: konfigurera sling.run.modes -parametern i WEB-INF/web.xml fil för AEM krigsfil före distribution

  • sling.home: konfigurera sling.home -parametern i WEB-INF/web.xmlfil för AEM krigsfil före distribution

  • kontextrot: byta namn på AEM krigsfil

Publicera 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

Om du vill kontrollera om alla är installerade kan du:

  • svansen error.logför att se att allt innehåll är installerat
  • titta in /system/console att alla paket är installerade

Två instanser på samma programserver

I demonstrationssyfte kan det vara lämpligt att installera författaren och publicera instansen i en programserver. Gör så här:

  1. Ändra variablerna sling.home och sling.run.modes i publiceringsinstansen.
  2. Packa upp WEB-INF/web.xml från AEM krigsfil.
  3. Ändra parametern sling.home till en annan sökväg (absoluta och relativa sökvägar är möjliga).
  4. Ändra sling.run.modes till publicering för publiceringsinstansen.
  5. Upprepa filen web.xml.
  6. Byt namn på krigsfilerna så att de har olika namn. Exempel: en byter namn till aemauthor.war och den andra till aempublish.war.
  7. Använd högre minnesinställningar. Standardinstanser AEM till exempel -Xmx3072m
  8. Distribuera de två webbprogrammen.
  9. Stoppa de två webbprogrammen efter distributionen.
  10. 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).
  11. Starta de två webbprogrammen igen.

Installationsprocedurer för programservrar

WebSphere® 8.5

Före en distribution ska du läsa Allmän beskrivning ovan.

Serverförberedelse

  • Låt Basic Auth Headers gå igenom:

    • Ett sätt för AEM att autentisera en användare är att inaktivera WebSphere®-serverns globala administrativa säkerhet: Gå till Säkerhet -> Global säkerhet och avmarkera kryssrutan Aktivera administrativ säkerhet, spara och starta om servern.
  • set "JAVA_OPTS= -Xmx2048m"

  • Om du vill installera AEM med kontextroten = /, ändrar du kontextroten för det befintliga standardwebbprogrammet.

Distribuera AEM webbprogram

  • Hämta 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 webbprogram

JBoss® EAP 6.3.0/6.4.0

Före en distribution ska du läsa Allmän beskrivning ovan.

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 den uppsättningen 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

Före en distribution ska du läsa Allmän beskrivning ovan.

Detta använder en enkel serverlayout med endast en Admin Server.

Förberedelse av WebLogic-server

  • I ${myDomain}/config/config.xmllägg till i avsnittet för säkerhetskonfiguration:

  • Öka inställningarna för virtuellt minne:

    • open ${myDomain}/bin/setDomainEnv.cmd (Svara .sh) sök efter WLS_MEM_ARGS, ange till exempel set WLS_MEM_ARGS_64BIT=-Xms256m -Xmx2048m
    • starta om WebLogic-server
  • Skapa i ${myDomain} en paketmapp och i en cq-mapp och i den en Plan-mapp

Distribuera AEM webbprogram

  • Hämta AEM

  • Lägg AEM i ${myDomain}/packages/cq mapp

  • Gör dina konfigurationer till WEB-INF/web.xml vid behov (se ovan i den allmänna beskrivningen)

    • Packa upp WEB-INF/web.xmlfil
    • ä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
  • Distribuera AEM krigsfil som ett program (för de andra inställningarna används standardinstä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

Före en distribution ska du läsa Allmän beskrivning ovan.

  • Förbered Tomcat Server

    • Öka inställningarna för virtuellt minne:

      • I bin/catalina.bat (rep catalina.sh på UNIX®) lägger du till följande inställning:
      • set "JAVA_OPTS= -Xmx2048m
    • Tomcat ger inte administratörs- eller hanteraråtkomst vid installationen. Därför måste du redigera manuellt tomcat-users.xml för att ge åtkomst till dessa konton:

      • Redigera tomcat-users.xml för att ge åtkomst till administratörer och chefer. Konfigurationen bör se ut ungefär som i följande exempel:

        <?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 max-file-size och max-request-size till minst 500 MB, se följande multipart-config exempel på en sådan web.xml -fil.

      <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

    • Hämta 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
    • Byt namn AEM krigsfil till ROOT.war om du vill distribuera den som en rotwebbapp, byt namn på den till exempel aemauthor.war om du vill ha en aemauthor som kontextrot

    • kopiera det till Tomcat-webbappen

    • vänta tills AEM har installerats

Felsökning

Information om hur du hanterar problem som kan uppstå under installationen finns i:

På denna sida