Anpassad fristående installation

I det här avsnittet beskrivs de alternativ som är tillgängliga när du installerar en fristående AEM. Du kan även läsa Lagringselement om du vill ha mer information om hur du väljer lagringstyp för serverdelen efter att du har installerat AEM 6.

Ändra portnumret genom att byta namn på filen

Standardporten för AEM är 4502. Om porten inte är tillgänglig eller redan används, konfigureras Quickstart automatiskt till att använda det första tillgängliga portnumret enligt följande: 4502, 8080, 8081, 8082, 8083, 8084, 8085, 8888, 9362, <*random*>.

Du kan också ange portnumret genom att byta namn på filen quickstart jar så att filnamnet innehåller portnumret; till exempel cq5-publish-p4503.jar eller cq5-author-p6754.jar.

Det finns olika regler som ska följas när man byter namn på filen quickstart jar:

  • När du byter namn på filen måste den börja med cq; som i cq5-publish-p4503.jar.

  • Vi rekommenderar att du alltid prefix för portnumret med -p; som i cq5-publish-p4503.jar eller cq5-author-p6754.jar.

OBSERVERA

Detta för att säkerställa att du inte behöver bekymra dig om att du uppfyller reglerna som används för att extrahera portnumret:

  • portnumret måste bestå av 4 eller 5 siffror
  • dessa siffror måste komma efter ett streck
  • om det finns andra siffror i filnamnet måste portnumret föregås av -p
  • "cq5"-prefixet i början av filnamnet ignoreras
OBSERVERA

Du kan också ändra portnumret med -port i kommandot start.

Java 11 - överväganden

Om du kör Oracle Java 11 (eller i allmänhet versioner av Java nyare än 8) måste ytterligare växlar läggas till på kommandoraden när du startar AEM.

  • Följande - -add-opens switchar måste läggas till för att förhindra att relaterade reflektioner får åtkomst till VARNINGSmeddelanden i stdout.log
--add-opens=java.desktop/com.sun.imageio.plugins.jpeg=ALL-UNNAMED --add-opens=java.base/sun.net.www.protocol.jrt=ALL-UNNAMED --add-opens=java.naming/javax.naming.spi=ALL-UNNAMED --add-opens=java.xml/com.sun.org.apache.xerces.internal.dom=ALL-UNNAMED --add-opens=java.base/java.lang=ALL-UNNAMED --add-opens=java.base/jdk.internal.loader=ALL-UNNAMED --add-opens=java.base/java.net=ALL-UNNAMED -Dnashorn.args=--no-deprecation-warning
  • Dessutom måste du använda -XX:+UseParallelGC för att minska eventuella prestandaproblem.

Nedan visas ett exempel på hur de ytterligare JVM-parametrarna ska se ut när AEM startas i Java 11:

-XX:+UseParallelGC --add-opens=java.desktop/com.sun.imageio.plugins.jpeg=ALL-UNNAMED --add-opens=java.base/sun.net.www.protocol.jrt=ALL-UNNAMED --add-opens=java.naming/javax.naming.spi=ALL-UNNAMED --add-opens=java.xml/com.sun.org.apache.xerces.internal.dom=ALL-UNNAMED --add-opens=java.base/java.lang=ALL-UNNAMED --add-opens=java.base/jdk.internal.loader=ALL-UNNAMED --add-opens=java.base/java.net=ALL-UNNAMED -Dnashorn.args=--no-deprecation-warning

Om du kör en instans som är uppgraderad från AEM 6.3 ska du kontrollera att följande egenskap är inställd på true under sling.properties:

  • felix.bootdelegation.implicit

Körningslägen

Körningslägen gör att du kan justera AEM för ett visst ändamål, till exempel författare eller publicera, testa, utveckla, intranät etc. Med dessa lägen kan du styra användningen av exempelinnehåll. Det här exempelinnehållet definieras innan snabbstarten byggs och kan innehålla paket, konfigurationer osv. Detta kan vara särskilt användbart för produktionsklara installationer när du vill hålla installationen ren och utan exempelinnehåll. Mer information finns i:

Lägga till en filinstallationsprovider

Som standard är mappen crx-quickstart/install bevakas för filer.
Den här mappen finns inte, men kan skapas under körning.

Om ett paket, en konfiguration eller ett innehållspaket placeras i den här katalogen hämtas det automatiskt och installeras. Om den tas bort avinstalleras den.
Det är ett annat sätt att skicka paket, innehållspaket eller konfigurationer till databasen.

Detta är särskilt intressant för flera användningsområden:

  • Under utvecklingen kan det vara enklare att lägga in något i filsystemet.
  • Om något går fel går det inte att nå webbkonsolen och databasen. Med detta kan du lägga in ytterligare paket i den här katalogen och de bör installeras.
  • The crx-quickstart/install kan skapas innan snabbstart startas och ytterligare paket kan placeras där.

Installera och starta Adobe Experience Manager som en Windows-tjänst

OBSERVERA

Var noga med att utföra följande procedur när du är inloggad som administratör eller starta/kör dessa steg med Kör som administratör val av snabbmeny.

Loggas in som en användare med administratörsbehörighet otillräcklig. Om du inte är inloggad som administratör när du slutför dessa steg får du Åtkomst nekad fel.

Så här installerar och startar du AEM som en Windows-tjänst:

  1. Öppna crx-quickstart\opt\helpers\instsrv.bat i en textredigerare.

  2. Om du konfigurerar en 64-bitars Windows-server ersätter du alla instanser av prunsrv med något av följande kommandon, enligt operativsystemet:

    • prunsrv_amd64
    • prunsrv_ia64

    Det här kommandot anropar rätt skript som startar Windows-tjänstdaemon i 64-bitars Java i stället för 32-bitars Java.

  3. Om du vill förhindra processen från att förfalska mer än en process ökar du JVM-parametern för PermGen. Leta reda på set jvm_options och ange värdet enligt följande:

    set jvm_options=-Xmx1792m

  4. Öppna kommandotolken, ändra den aktuella katalogen till mappen crx-quickstart/opt/help i AEM installation och ange följande kommando för att skapa tjänsten:

    instsrv.bat cq5

    Kontrollera att tjänsten har skapats genom att öppna Tjänster på kontrollpanelen Administrationsverktyg eller skriva start services.msc i kommandotolken. Cq5-tjänsten visas i listan.

  5. Starta tjänsten genom att göra något av följande:

    • Klicka på cq5 på kontrollpanelen Tjänster och klicka på Start.

    chlimage_1-11

    • Skriv net start cq5 på kommandoraden.

    chlimage_1-12

  6. Windows anger att tjänsten körs. AEM startar och den körbara filen prunsrv visas i Task Manager. I webbläsaren går du till AEM, till exempel https://localhost:4502 för att börja använda AEM.

    chlimage_1-13

OBSERVERA

Egenskapsvärdena i filen instsrv.bat används när Windows-tjänsten skapas. Om du redigerar egenskapsvärdena i instsrv.bat måste du avinstallera och sedan installera om tjänsten.

OBSERVERA

När du installerar AEM som tjänst måste du ange den absoluta sökvägen för loggkatalogen i com.adobe.xmp.worker.files.ncomm.XMPFilesNComm från Configuration Manager.

Om du vill avinstallera tjänsten klickar du på Stoppa i Tjänster navigera till mappen och skriv instsrv.bat -uninstall cq5. Tjänsten tas bort från listan i Tjänster kontrollpanelen eller från listan på kommandoraden när du skriver net start.

Definiera om platsen för den tillfälliga arbetskatalogen

Standardplatsen för den tillfälliga mappen på Java-datorn är /tmp. AEM använder den här mappen också, till exempel när paket skapas.

Om du vill ändra platsen för den tillfälliga mappen (till exempel om du behöver en katalog med mer ledigt utrymme) definierar du en * <new-tmp-path>* genom att lägga till JVM-parametern:

-Djava.io.tmpdir="/<*new-tmp-path*>"

till antingen

  • serverstartkommandoraden
  • CQ_JVM_OPTS-miljöparametern i serverctl eller startskriptet

Fler alternativ är tillgängliga från QuickStart-filen

Ytterligare alternativ och namnbyteskonventioner beskrivs i hjälpfilen för QuickStart, som är tillgänglig via alternativet -help. Om du vill komma åt hjälpen skriver du:

  • java -jar cq-quickstart-6.5.0.jar -help
FÖRSIKTIGHET

Dessa alternativ gäller från och med den ursprungliga versionen av AEM 6.5 (6.5.0.0). Ändringar i senare SP-versioner är möjliga.

Loading quickstart properties: default
Loading quickstart properties: instance
Setting properties from filename '/Users/Desktop/AEM/cq-quickstart-6.5.0.jar'
--------------------------------------------------------------------------------
Adobe Experience Manager Quickstart (build 20190328)
--------------------------------------------------------------------------------
Usage:
 Use these options on the Quickstart command line.
--------------------------------------------------------------------------------

-help (--help,-h)
         Show this help message
-quickstart.server.port (-p,-port) <port>
         Set server port number
-contextpath (-c,-org.apache.felix.http.context_path) <contextpath>
         Set context path
-debug <port>
         Enable Java Debugging on port number; forces forking
-gui
         Show GUI if running on a terminal
-nobrowser (-quickstart.nobrowser)
         Do not open browser at startup
-unpack
         Unpack installation files only, do not start the server (implies
         -verbose)
-v (-verbose)
         Do not redirect stdout/stderr to files and do not close stdin
-nofork
         Do not fork the JVM, even if not running on a console
-fork
         Force forking the JVM if running on a console, using recommended
         default memory settings for the forked JVM.
-forkargs <args> [<args> ...]
         Additional arguments for the forked JVM, defaults to '-Xmx1024m
         -XX:MaxPermSize=256m '.  Use -- to specify values starting with -,
         example: '-forkargs -- -server'
-a (--interface) <interface>
         Optional IP address (interface) to bind to
-pt <string>
         Process type (main/fork) - do not use directly, used when forking a
         process
-r <string> [<string> [<string> [<string> [<string> [<string> [<string> [<string> [<string> [<string>]]]]]]]]]
         Runmode(s) - Use this to define the run mode(s)
-b <string>
         Base folder - defines the path under which the quickstart work folder
         is created
-low-mem-action <string>
         Low memory action - what to do if memory is insufficient at startup
-use-control-port
         Start a control port
-nointeractive
         Start with no interactivity
-ll <level>
         Define launchpad log level (1 = error...4 = debug)
-n
         Do not install shutdown hook
-D<property>=<value>
         Additional framework properties.
-listener-port <listener-port>
         Set listener port number
-x <string>
         Run a Quickstart extension.
  Options for executing Quickstart extensions:

    -xargs <arg> [<arg> ...]
         Construct an arguments list for a Quickstart extension (e.g. -xargs --
         -arg1 val1 -arg2 val2).
--------------------------------------------------------------------------------
Quickstart filename options
--------------------------------------------------------------------------------
Usage:
 Rename the jar file, including one of the patterns shown below, to set the
corresponding option. Command-line options have priority on these filename
patterns.
--------------------------------------------------------------------------------

-NNNN
         Include -NNNN.jar or -pNNNN in the renamed jar filename to run on port
         NNNN, for example: quickstart-8085.jar
-nobrowser
         Include -nobrowser in the renamed jar filename to avoid opening the
         browser at startup, example: quickstart-nobrowser-8085.jar
-publish
         Include -publish in the renamed jar filename to run in "publish" mode,
         example: cq-publish-7502.jar
-dynamicmedia
         Include -dynamicmedia in the renamed jar filename to run in
         "dynamicmedia" mode, example: quickstart-dynamicmedia-4502.jar
-dynamicmedia_scene7
         Include -dynamicmedia_scene7 in the renamed jar filename to run in
         "dynamicmedia_scene7" mode, example:
         quickstart-dynamicmedia_scene7-p4502.jar
--------------------------------------------------------------------------------
The license.properties file
--------------------------------------------------------------------------------
  The license.properties file stores licensing information, created from the
  licensing form displayed on first startup and stored in the folder from where
  Quickstart is run.
--------------------------------------------------------------------------------
Log files
--------------------------------------------------------------------------------
  Once Quickstart has been unpacked and started, log files can be found under
  /Users/aemdocs/CQInstallationKits/AEM-65150-L8/crx-quickstart/logs.
--------------------------------------------------------------------------------

Installera AEM i Amazon EC2-miljön

När du installerar AEM på en Amazon Elastic Compute Cloud-instans (EC2) installeras Author-instansen korrekt om du installerar både författaren och publicerar på EC2-instansen enligt proceduren Installerar instanser av AEM Manager; Publiceringsinstansen blir dock författare.

Innan du installerar Publish-instansen i EC2-miljön gör du följande:

  1. Packa upp jar-filen för Publish-instansen innan du startar instansen för första gången. Använd följande kommando för att packa upp filen:

    java -jar quickstart.jar -unpack
    
    OBSERVERA

    Om du ändrar läge efter när du startar instansen första gången kan du inte ändra körningsläget.

  2. Starta instansen genom att köra:

    java -jar quickstart.jar -r publish
    
    FÖRSIKTIGHET

    Kontrollera att du först kör instansen när du har packat upp den genom att köra kommandot ovan. Annars genereras inte fyllningen quickstart.properties. Utan den här filen kommer eventuella framtida AEM inte att kunna uppgraderas.

  3. I bin mapp, öppna start och kontrollera följande avsnitt:

    # runmode(s)
    if [ -z "$CQ_RUNMODE" ]; then
     CQ_RUNMODE='author'
    fi
    
  4. Ändra runmode till publicera och spara filen.

    # runmode(s)
    if [ -z "$CQ_RUNMODE" ]; then
     CQ_RUNMODE='publish'
    fi
    
  5. Stoppa instansen och starta om den genom att köra start skript.

Verifierar installationen

Följande länkar kan användas för att verifiera att installationen fungerar (alla exempel baseras på att instansen körs på port 8080 på den lokala värden, att CRX är installerat under /crx och Launchpad under /):

  • https://localhost:8080/crx/de
    CRXDE Lite-konsolen.

  • https://localhost:8080/system/console
    Webbkonsolen.

Åtgärder efter installation

Även om det finns många möjligheter att konfigurera AEM WCM bör vissa åtgärder vidtas eller åtminstone granskas omedelbart efter installationen:

  • Läs Säkerhetschecklista för uppgifter som krävs för att säkerställa att systemet förblir säkert.
  • Granska listan över standardanvändare och -grupper som installeras med AEM WCM. Kontrollera om du vill vidta åtgärder för andra konton - se Säkerhet och användaradministration för mer information.

Åtkomst till CRXDE Lite och webbkonsolen

När AEM WCM har startats kan du även få åtkomst till:

  • CRXDE Lite - används för att få åtkomst till och hantera databasen
  • Webbkonsol - används för att hantera eller konfigurera OSGi-paket (kallas även OSGi-konsolen)

Åtkomst till CRXDE Lite

Om du vill öppna CRXDE Lite kan du välja CRXDE Lite från välkomstskärmen eller använd webbläsaren för att navigera till

 https://<<i>host</i>>:<<i>port</i>>/crx/de/index.jsp

Till exempel:
https://localhost:4502/crx/de/index.jsp

installcq_crxdelite

Åtkomst till webbkonsolen

Om du vill komma åt Adobe CQ webbkonsol kan du välja OSGi Console från välkomstskärmen eller använd webbläsaren för att navigera till

 https://<host>:<port>/system/console

Till exempel:
https://localhost:4502/system/console
eller för sidan Bundles
https://localhost:4502/system/console/bundles

chlimage_1-14

Se OSGi-konfiguration med webbkonsolen för mer information.

Felsökning

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

Avinstallerar Adobe Experience Manager

Eftersom AEM installeras i en enda katalog behövs inget avinstallationsverktyg. Avinstallationen kan vara så enkel som att ta bort hela installationskatalogen, men hur du avinstallerar AEM beror på vad du vill uppnå och vilken beständig lagring du använder.

Om beständig lagring är inbäddad i installationskatalogen, till exempel i standardinstallationen av TPM, tas även data bort när du tar bort mappar.

OBSERVERA

Adobe rekommenderar att du säkerhetskopierar databasen innan du tar bort AEM. Om du tar bort hela <cq-installation-directory>tar du bort databasen. Om du vill behålla databasdata innan du tar bort, flyttar eller kopierar du <cq-installation-directory>/crx-quickstart/databasmapp någon annanstans innan de andra mapparna tas bort.

Om din installation av AEM använder extern lagring, till exempel en databasserver, tas inte data bort automatiskt när du tar bort mappen, men lagringskonfigurationen tas bort, vilket gör det svårt att återställa JCR-innehållet.

På denna sida