Installazione personalizzata indipendente

Questa sezione descrive le opzioni disponibili per l’installazione di un’istanza di AEM autonoma. È inoltre possibile leggere Elementi di storage per ulteriori informazioni sulla scelta del tipo di storage back-end dopo aver installato di recente AEM 6.

Modifica del numero di porta rinominando il file

La porta predefinita per AEM è 4502. Se la porta non è disponibile o è già in uso, Quickstart si configura automaticamente per utilizzare il primo numero di porta disponibile come segue: 4502, 8080, 8081, 8082, 8083, 8084, 8085, 8888, 9362, <*random*>.

Puoi anche impostare il numero di porta rinominando il file jar quickstart, in modo che il nome del file includa il numero di porta; ad esempio, cq5-publish-p4503.jar o cq5-author-p6754.jar.

Ci sono varie regole da seguire quando si rinomina il file jar quickstart:

  • Quando rinomini il file, deve iniziare con cq; come in cq5-publish-p4503.jar.

  • Si consiglia di sempre prefisso il numero di porta con -p; come in cq5-publish-p4503.jar o cq5-author-p6754.jar.

NOTA

Questo per evitare di doverti preoccupare di rispettare le regole utilizzate per estrarre il numero di porta:

  • il numero di porta deve essere di 4 o 5 cifre
  • queste cifre devono venire dopo un trattino
  • se nel nome del file sono presenti altre cifre, il numero di porta deve essere preceduto da -p
  • il prefisso "cq5" all'inizio del nome del file viene ignorato
NOTA

È inoltre possibile modificare il numero di porta utilizzando l'opzione -port nel comando start.

Considerazioni su Java 11

Se esegui Oracle Java 11 (o in genere versioni di Java successive a 8), all'avvio di AEM dovrai aggiungere altri switch alla riga di comando.

  • È necessario aggiungere gli switch seguenti - -add-opens per evitare che la riflessione correlata acceda ai messaggi WARNING nel 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
  • Inoltre, è necessario utilizzare l'interruttore -XX:+UseParallelGC per attenuare eventuali problemi di prestazioni.

Di seguito è riportato un esempio dell'aspetto dei parametri JVM aggiuntivi quando si avvia AEM su 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

Infine, se esegui un'istanza aggiornata da AEM 6.3, assicurati che la seguente proprietà sia impostata su true in sling.properties:

  • felix.bootdelegation.implicit

Modalità di esecuzione

Esegui il modem per ottimizzare la tua istanza di AEM per uno scopo specifico; ad esempio, autore o pubblicazione, test, sviluppo, Intranet ecc. Queste modalità consentono inoltre di controllare l’uso del contenuto campione. Questo contenuto di esempio viene definito prima della creazione dell’avvio rapido e può includere pacchetti, configurazioni e così via. Questa funzione può essere particolarmente utile per le installazioni pronte per la produzione quando si desidera mantenere l'installazione magra e senza contenuti di esempio. Per ulteriori informazioni, consultare:

Aggiunta di un provider di installazione file

Per impostazione predefinita, la cartella crx-quickstart/install viene controllata per verificare la presenza di file.
Questa cartella non esiste, ma può essere creata in fase di runtime.

Se un bundle, una configurazione o un pacchetto di contenuti viene inserito in questa directory, viene automaticamente rilevato e installato. Se viene rimosso, viene disinstallato.
È un altro modo per mettere bundle, pacchetti di contenuti o configurazioni nell'archivio.

Questo è particolarmente interessante per diversi casi d’uso:

  • Durante lo sviluppo, potrebbe essere più facile inserire qualcosa nel file system.
  • Se qualcosa non funziona, la console Web e l’archivio non sono raggiungibili. Con questo è possibile mettere bundle aggiuntivi in questa directory e dovrebbero essere installati.
  • È possibile creare la cartella crx-quickstart/install prima dell’avvio di quickstart e inserire in essa pacchetti aggiuntivi.

Installazione e avvio di Adobe Experience Manager as a Windows Service

NOTA

Assicurati di eseguire la seguente procedura durante l'accesso come Amministratore oppure di avviare/eseguire questi passaggi utilizzando la selezione del menu di scelta rapida Esegui come amministratore .

L'accesso come utente con privilegi di amministratore è insufficiente. Se non hai effettuato l'accesso come amministratore al completamento di questi passaggi, ricevi degli errori Accesso negato .

Per installare e avviare AEM come servizio Windows:

  1. Apri il file crx-quickstart\opt\helpers\instsrv.bat in un editor di testo.

  2. Se si sta configurando un server Windows a 64 bit, sostituire tutte le istanze di prunsrv con uno dei seguenti comandi, in base al sistema operativo in uso:

    • prunsrv_amd64
    • prunsrv_ia64

    Questo comando richiama lo script appropriato che avvia il daemon del servizio Windows in Java a 64 bit invece di Java a 32 bit.

  3. Per evitare che il processo si imbatte in più processi, aumenta la dimensione massima dell'heap e i parametri JVM PermGen. Individua il comando set jvm_options e imposta il valore come segue:

    set jvm_options=-XX:MaxPermSize=256M;-Xmx1792m

  4. Apri Prompt dei comandi, modifica la directory corrente nella cartella crx-quickstart/opt/helpers dell'installazione AEM e immetti il seguente comando per creare il servizio:

    instsrv.bat cq5

    Per verificare che il servizio sia stato creato, aprire Servizi nel pannello di controllo Strumenti di amministrazione o digitare start services.msc nel prompt dei comandi. Il servizio cq5 viene visualizzato nell'elenco.

  5. Avvia il servizio eseguendo una delle operazioni seguenti:

    • Nel pannello di controllo Servizi fare clic su cq5 e quindi su Start.

    chlimage_1-11

    • Nella riga di comando, digita net start cq5.

    chlimage_1-12

  6. Windows indica che il servizio è in esecuzione. AEM viene avviato e l'eseguibile prunsrv viene visualizzato in Task Manager. Nel browser Web, accedi a AEM, ad esempio, https://localhost:4502 per iniziare a utilizzare AEM.

    chlimage_1-13

NOTA

I valori delle proprietà nel file instsrv.bat vengono utilizzati durante la creazione del servizio Windows. Se si modificano i valori delle proprietà in instsrv.bat, è necessario disinstallare e reinstallare il servizio.

NOTA

Quando installi AEM come servizio, devi fornire il percorso assoluto della directory dei registri in com.adobe.xmp.worker.files.ncomm.XMPFilesNComm da Configuration Manager.

Per disinstallare il servizio, fai clic su Stop nel pannello di controllo Servizi o nella riga di comando, vai alla cartella e digita instsrv.bat -uninstall cq5. Il servizio viene rimosso dall'elenco nel pannello di controllo Servizi o dall'elenco nella riga di comando quando si digita net start.

Ridefinizione della posizione della directory del lavoro temporaneo

Il percorso predefinito della cartella temporanea del computer java è /tmp. AEM utilizza anche questa cartella, ad esempio per la creazione di pacchetti.

Se desideri modificare la posizione della cartella temporanea (ad esempio, se hai bisogno di una directory con più spazio libero), definisci un * <new-tmp-path>* aggiungendo il parametro JVM:

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

a:

  • la riga di comando di avvio del server
  • il parametro di ambiente CQ_JVM_OPTS nello script serverctl o start

Altre opzioni disponibili nel file Quickstart

Ulteriori opzioni e convenzioni di ridenominazione sono descritte nel file della guida di Quickstart, disponibile tramite l’opzione -help. Per accedere alla guida, digita:

  • java -jar cq5-<*version*>.jar -help
Loading quickstart properties: default
Loading quickstart properties: instance
Setting properties from filename '/Users/Desktop/AEM/cq-quickstart-5.6.0.jar'
--------------------------------------------------------------------------------
Adobe Experience Manager Quickstart (build 20130129)
--------------------------------------------------------------------------------
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
-ll <level>
         Define launchpad log level (1 = error...4 = debug)
--------------------------------------------------------------------------------
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 cq5 in "publish"
         mode, example: cq5-publish-7502.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
  ./crx-quickstart/logs.
--------------------------------------------------------------------------------

Installazione di AEM nell’ambiente Amazon EC2

Quando installi AEM su un'istanza Amazon Elastic Compute Cloud (EC2), se installi sia l'autore che la pubblicazione sull'istanza EC2, l'istanza Author viene installata correttamente seguendo la procedura in Installazione delle istanze di AEM Manager; tuttavia, l’istanza Pubblica diventa Autore.

Prima di installare l’istanza Publish nell’ambiente EC2, procedi come segue:

  1. Decomprimi il file jar per l’istanza Publish prima di avviare l’istanza per la prima volta. Per decomprimere il file, utilizzare il seguente comando:

    java -jar quickstart.jar -unpack
    
    NOTA

    Se si modifica la modalità dopo all'avvio dell'istanza la prima volta, non è possibile modificare la modalità di esecuzione.

  2. Avvia l'istanza eseguendo:

    java -jar quickstart.jar -r publish
    
    ATTENZIONE

    Assicurati di eseguire prima l'istanza dopo averlo decompresso eseguendo il comando precedente. In caso contrario, il riempimento quickstart.properties non verrà generato. Senza questo file, eventuali aggiornamenti futuri AEM non avranno esito positivo.

  3. Nella cartella bin , apri lo script start e controlla la sezione seguente:

    # runmode(s)
    if [ -z "$CQ_RUNMODE" ]; then
     CQ_RUNMODE='author'
    fi
    
  4. Cambia la modalità di esecuzione in pubblica e salva il file.

    # runmode(s)
    if [ -z "$CQ_RUNMODE" ]; then
     CQ_RUNMODE='publish'
    fi
    
  5. Arresta l'istanza e riavviala eseguendo lo script start .

Verifica dell'installazione

I seguenti collegamenti possono essere utilizzati per verificare che l'installazione sia operativa (tutti gli esempi sono sulla base del fatto che l'istanza è in esecuzione sulla porta 8080 del localhost, che CRX è installato sotto /crx e Launchpad sotto /):

  • https://localhost:8080/crx/de
    Console CRXDE Lite.

  • https://localhost:8080/system/console
    Console Web.

Azioni dopo l'installazione

Sebbene vi siano molte possibilità di configurare AEM WCM, alcune azioni devono essere intraprese o almeno riviste immediatamente dopo l'installazione:

  • Consulta la Lista di controllo protezione per le attività necessarie per garantire la protezione del sistema.
  • Rivedi l'elenco degli utenti e dei gruppi predefiniti installati con AEM WCM. Controlla se desideri intervenire su altri account. Per ulteriori informazioni, consulta Sicurezza e amministrazione utente .

Accesso a CRXDE Lite e alla console Web

Una volta avviato AEM WCM, puoi anche accedere a:

  • CRXDE Lite : utilizzato per accedere all’archivio e gestirlo
  • Console web : utilizzata per gestire o configurare i bundle OSGi (nota anche come Console OSGi)

Accesso a CRXDE Lite

Per aprire CRXDE Lite è possibile selezionare CRXDE Lite dalla schermata di benvenuto oppure utilizzare il browser per passare a

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

Esempio:
https://localhost:4502/crx/de/index.jsp

installcq_crxdelite

Accesso alla console Web

Per accedere alla console Web di Adobe CQ è possibile selezionare Console OSGi dalla schermata di benvenuto o utilizzare il browser per passare a

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

Ad esempio:
https://localhost:4502/system/console
o per la pagina Bundle
https://localhost:4502/system/console/bundles

chlimage_1-14

Per ulteriori informazioni, consulta Configurazione OSGi con la console Web .

Risoluzione dei problemi

Per informazioni sui problemi che possono verificarsi durante l'installazione, vedi:

Disinstallazione di Adobe Experience Manager

Poiché AEM installato in una singola directory, non è necessaria un'utilità di disinstallazione. La disinstallazione può essere semplice come l'eliminazione dell'intera directory di installazione, anche se la modalità di disinstallazione AEM dipende da ciò che si desidera ottenere e da quale memoria permanente si utilizza.

Se l'archiviazione permanente è incorporata nella directory di installazione, ad esempio, nell'installazione predefinita di TarPM, l'eliminazione delle cartelle rimuove anche i dati.

NOTA

L’Adobe consiglia vivamente di eseguire il backup dell’archivio prima di eliminare AEM. Se elimini l'intero <cq-installation-directory>, eliminerai l'archivio. Per mantenere i dati del repository prima di eliminare, spostare o copiare la cartella <cq-installation-directory>/crx-quickstart/repository da qualche altra parte prima di eliminare le altre cartelle.

Se l'installazione di AEM utilizza lo storage esterno, ad esempio un server di database, la rimozione della cartella non rimuove automaticamente i dati, ma rimuove la configurazione di archiviazione, il che rende difficile il ripristino del contenuto JCR.

In questa pagina