Instalación independiente personalizada custom-standalone-install

CAUTION
AEM 6.4 ha llegado al final de la compatibilidad ampliada y esta documentación ya no se actualiza. Para obtener más información, consulte nuestra períodos de asistencia técnica. Buscar las versiones compatibles here.

Esta sección describe las opciones disponibles al instalar una instancia de AEM independiente. También puede leer Elementos de almacenamiento para obtener más información sobre cómo elegir el tipo de almacenamiento back-end después de instalar recientemente AEM 6.

Cambio del número de puerto cambiando el nombre del archivo changing-the-port-number-by-renaming-the-file

El puerto predeterminado para AEM es 4502. Si ese puerto no está disponible o ya está en uso, Quickstart se configura automáticamente para utilizar el primer número de puerto disponible de la siguiente manera: 4502, 8080, 8081, 8082, 8083, 8084, 8085, 8888, 9362, <random>.

También puede establecer el número de puerto cambiando el nombre del archivo jar de inicio rápido, de modo que el nombre del archivo incluya el número de puerto; por ejemplo, cq5-publish-p4503.jar o cq5-author-p6754.jar.

Hay varias reglas que se deben seguir al cambiar el nombre del archivo jar de inicio rápido:

  • Al cambiar el nombre del archivo, debe empezar por cq; como en cq5-publish-p4503.jar.

  • Se recomienda que always anteponga el número de puerto con -p; como en cq5-publish-p4503.jar o cq5-author-p6754.jar.

NOTE
Esto sirve para garantizar que no tenga que preocuparse por cumplir las reglas utilizadas para extraer el número de puerto:
  • el número de puerto debe ser de 4 o 5 dígitos
  • estos dígitos deben aparecer después de un guión
  • si hay otros dígitos en el nombre del archivo, debe añadirse el prefijo al número de puerto -p
  • se ignora el prefijo "cq5" al principio del nombre del archivo
NOTE
También puede cambiar el número de puerto utilizando la variable -port en el comando start.

Ejecutar modos run-modes

Modos de ejecución permita ajustar la instancia de AEM para un fin específico; por ejemplo, crear o publicar, probar, desarrollar, intranet, etc. Estos modos también permiten controlar el uso del contenido de muestra. Este contenido de muestra se define antes de que se cree el inicio rápido y puede incluir paquetes, configuraciones, etc. Esto puede resultar especialmente útil para instalaciones preparadas para la producción cuando desea mantener la instalación limpia y sin contenido de muestra. Para obtener más información, consulte:

Adición de un proveedor de instalación de archivos adding-a-file-install-provider

De forma predeterminada, la carpeta crx-quickstart/install se ven los archivos.
Esta carpeta no existe, pero simplemente se puede crear durante la ejecución.

Si un paquete, configuración o paquete de contenido se coloca en este directorio, se recoge e instala automáticamente. Si se elimina, se desinstala.
Es otra forma de colocar paquetes, paquetes de contenido o configuraciones en el repositorio.

Esto es especialmente interesante para varios casos de uso:

  • Durante el desarrollo, puede ser más fácil colocar algo en el sistema de archivos.
  • Si algo sale mal, la consola web y el repositorio no están disponibles. Con esto puede poner paquetes adicionales en este directorio y deben instalarse.
  • La variable crx-quickstart/install se puede crear antes de iniciar el inicio rápido, y se pueden colocar paquetes adicionales allí.

Instalación e inicio de Adobe Experience Manager as a Windows Service installing-and-starting-adobe-experience-manager-as-a-windows-service

NOTE
Asegúrese de realizar el siguiente procedimiento mientras ha iniciado sesión como administrador o inicie/ejecute estos pasos utilizando la variable Ejecutar como administrador selección de menú contextual.
El hecho de haber iniciado sesión como usuario con privilegios de administrador es insuficiente. Si no ha iniciado sesión como administrador al completar estos pasos, recibirá Acceso denegado errores.

Para instalar e iniciar AEM como un servicio de Windows:

  1. Abra el archivo crx-quickstart\opt\helpers\instsrv.bat en un editor de texto.

  2. Si está configurando un servidor Windows de 64 bits, reemplace todas las instancias de prunsrv con uno de los siguientes comandos, según su sistema operativo:

    • prunsrv_amd64
    • prunsrv_ia64

    Este comando invoca el script apropiado que inicia el daemon de servicio de Windows en Java de 64 bits en lugar de Java de 32 bits.

  3. Para evitar que el proceso se ramifique en más de un proceso, aumente el tamaño máximo de pila y los parámetros JVM de PermGen. Busque la variable set jvm_options y establezca el valor como se indica a continuación:

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

  4. Abra el símbolo del sistema, cambie el directorio actual a la carpeta crx-quickstart/opt/helpers de la instalación de AEM e introduzca el siguiente comando para crear el servicio:

    instsrv.bat cq5

    Para verificar que el servicio se ha creado, abra Servicios en el panel de control Herramientas administrativas o escriba start services.msc en el símbolo del sistema. El servicio cq5 aparece en la lista.

  5. Inicie el servicio haciendo una de las siguientes acciones:

    • En el panel de control de Servicios, haga clic en cq5 y en Inicio.

    chlimage_1-71

    • En la línea de comandos, escriba net start cq5.

    chlimage_1-72

  6. Windows indica que el servicio se está ejecutando. AEM se inicia y el ejecutable prunsrv aparece en el Administrador de tareas. En el explorador web, vaya a AEM, por ejemplo, http://localhost:4502 para empezar a usar AEM.

    chlimage_1-73

NOTE
Los valores de propiedad del archivo instsrv.bat se utilizan al crear el servicio de Windows. Si edita los valores de las propiedades en instsrv.bat, debe desinstalar y volver a instalar el servicio.
NOTE
Al instalar AEM como servicio, debe proporcionar la ruta absoluta para el directorio de registros en com.adobe.xmp.worker.files.ncomm.XMPFilesNComm de Configuration Manager.

Para desinstalar el servicio, haga clic en Stop en el Servicios o en la línea de comandos, vaya a la carpeta y escriba instsrv.bat -uninstall cq5. El servicio se elimina de la lista en la Servicios panel de control o de la lista de la línea de comandos cuando escriba net start.

Redefinición de la ubicación del directorio de trabajo temporal redefining-the-location-of-the-temporary-work-directory

La ubicación predeterminada de la carpeta temporal del equipo Java es /tmp. AEM utiliza esta carpeta también, por ejemplo, al crear paquetes.

Si desea cambiar la ubicación de la carpeta temporal (por ejemplo, si necesita un directorio con más espacio libre), defina una <new-tmp-path> añadiendo el parámetro JVM:

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

para:

  • la línea de comandos de inicio del servidor
  • el parámetro de entorno CQ_JVM_OPTS en el script serverctl o start

Otras opciones disponibles en el archivo de inicio rápido further-options-available-from-the-quickstart-file

En el archivo de ayuda de inicio rápido, que está disponible a través de la opción -help , se describen más opciones y convenciones de cambio de nombre. Para acceder a la ayuda, escriba:

  • 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.
--------------------------------------------------------------------------------

Instalación de AEM en el entorno Amazon EC2 installing-aem-in-the-amazon-ec-environment

Al instalar AEM en una instancia de Amazon Elastic Compute Cloud (EC2), si instala author y publish en la instancia EC2, la instancia de autor se instala correctamente siguiendo el procedimiento sobre cómo instalar una instancia de AEM; sin embargo, la instancia Publicar se convierte en Autor.

Antes de instalar la instancia de publicación en el entorno EC2, haga lo siguiente:

  1. Desempaquete el archivo jar para la instancia Publicar antes de iniciar la instancia por primera vez. Para desempaquetar el archivo, utilice el siguiente comando:

    code language-xml
    java -jar quickstart.jar -unpack
    
    note note
    NOTE
    Si cambia el modo after al iniciar la instancia por primera vez, no se puede cambiar el modo de ejecución.
  2. Inicie la instancia ejecutando:

    code language-xml
    java -jar quickstart.jar -r publish
    
    note caution
    CAUTION
    Asegúrese de ejecutar primero la instancia después de descomprimirla ejecutando el comando anterior. De lo contrario, el relleno quickstart.properties no se generará. Sin este archivo, cualquier actualización AEM futura fallará.
  3. En el bin carpeta, abra start y compruebe la siguiente sección:

    code language-xml
    # runmode(s)
    if [ -z "$CQ_RUNMODE" ]; then
     CQ_RUNMODE='author'
    fi
    
  4. Cambie runmode a publicar y guarde el archivo.

    code language-xml
    # runmode(s)
    if [ -z "$CQ_RUNMODE" ]; then
     CQ_RUNMODE='publish'
    fi
    
  5. Detenga la instancia y reiníciela ejecutando el start secuencia de comandos.

Verificación de la instalación verifying-the-installation

Los siguientes vínculos pueden utilizarse para verificar que su instalación está operativa (todos los ejemplos se basan en que la instancia se está ejecutando en el puerto 8080 del host local, que CRX está instalado en /crx y Launchpad en /):

  • http://localhost:8080/crx/de

    La consola del CRXDE Lite.

  • http://localhost:8080/system/console

    La Consola Web.

Acciones después de la instalación actions-after-installation

Aunque hay muchas posibilidades de configurar AEM WCM, se deben realizar determinadas acciones o, al menos, revisarlas inmediatamente después de la instalación:

Acceso al CRXDE Lite y a la consola web accessing-crxde-lite-and-the-web-console

Una vez iniciado AEM WCM, también puede acceder a:

  • CRXDE Lite - se utiliza para acceder y administrar el repositorio
  • Consola web - se utiliza para administrar o configurar los paquetes OSGi (también conocidos como la consola OSGi)

Acceso al CRXDE Lite accessing-crxde-lite

Para abrir el CRXDE Lite, puede seleccionar CRXDE Lite en la pantalla de bienvenida o utilice el navegador para desplazarse a

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

Por ejemplo:
http://localhost:4502/crx/de/index.jsp ``

installcq_crxdelite

Acceso a la consola web accessing-the-web-console

Para acceder a la consola web de Adobe CQ, puede seleccionar Consola OSGi en la pantalla de bienvenida o utilice el navegador para desplazarse a

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

Por ejemplo:
http://localhost:4502/system/console
o para la página Paquetes
http://localhost:4502/system/console/bundles

chlimage_1-74

Consulte Configuración de OSGi con la consola web para obtener más información.

Solución de problemas troubleshooting

Para obtener información sobre cómo tratar los problemas que pueden surgir durante la instalación, consulte:

Desinstalación de Adobe Experience Manager uninstalling-adobe-experience-manager

Debido a que AEM instala en un solo directorio, no es necesario desinstalar una utilidad. La desinstalación puede ser tan simple como borrar todo el directorio de instalación, aunque la forma en que desinstale AEM depende de lo que desee conseguir y del almacenamiento persistente que utilice.

Si el almacenamiento persistente está incrustado en el directorio de instalación, por ejemplo, en la instalación predeterminada de TarPM, al eliminar carpetas también se eliminan datos.

NOTE
Adobe recomienda encarecidamente que realice una copia de seguridad del repositorio antes de eliminar AEM. Si elimina todo el <cq-installation-directory>, eliminará el repositorio. Para conservar los datos del repositorio antes de eliminarlos, moverlos o copiarlos <cq-installation-directory>/crx-quickstart/repository carpeta en otro lugar antes de eliminar las otras carpetas.

Si la instalación de AEM utiliza almacenamiento externo, por ejemplo, un servidor de base de datos, la eliminación de la carpeta no elimina los datos automáticamente, pero sí la configuración de almacenamiento, lo que dificulta la restauración del contenido de JCR.

recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56