Pasos de actualización para las instalaciones del servidor de aplicaciones

En esta sección se describe el procedimiento que debe seguirse para actualizar la AEM de las instalaciones de Application Server.

Todos los ejemplos de este procedimiento utilizan JBoss como servidor de aplicaciones e implican que ya tiene implementada una versión de trabajo de AEM. El procedimiento tiene por objeto el documento de las actualizaciones realizadas desde AEM versión 5.6 a 6.3.

1. Primero, inicio JBoss. En la mayoría de los casos, puede hacerlo ejecutando la secuencia de comandos de inicio standalone.sh, ejecutando este comando desde el terminal:

   jboss-install-folder/bin/standalone.sh
   

2. Si AEM 5.6 ya está implementado, compruebe que los paquetes funcionan correctamente al ejecutar:

   wget https://<serveraddress:port>/cq/system/console/bundles
   

3. A continuación, anule la implementación de AEM 5.6:

   rm jboss-install-folder/standalone/deployments/cq.war
   

4. Detenga JBoss.

5. Ahora, migre el repositorio utilizando la herramienta de migración crx2oak:

   java -jar crx2oak.jar crx-quickstart/repository/ crx-quickstart/oak-repository
   

   NOTA

   En este ejemplo, oak-repository es el directorio temporal donde residirá el repositorio recientemente convertido. Antes de realizar este paso, asegúrese de tener la última versión de crx2oak.jar.

6. Elimine las propiedades necesarias del archivo sling.properties haciendo lo siguiente:

   1. Abra el archivo ubicado en crx-quickstart/launchpad/sling.properties

   2. Texto del paso Elimine las siguientes propiedades y guarde el archivo:

      1. sling.installer.dir
      2. felix.cm.dir
      3. granite.product.version
      4. org.osgi.framework.system.packages
      5. osgi-core-packages
      6. osgi-compendium-services
      7. jre-*
      8. sling.run.mode.install.options

7. Quite los archivos y las carpetas que ya no sean necesarios. Los elementos que debe eliminar específicamente son:

   • La carpeta launchpad/startup. Puede eliminarlo ejecutando el siguiente comando en el terminal: rm -rf crx-quickstart/launchpad/startup
   • El archivo base.jar: find crx-quickstart/launchpad -type f -name "org.apache.sling.launchpad.base.jar*" -exec rm -f {} \
   • El archivo BootstrapCommandFile_timestamp.txt: rm -f crx-quickstart/launchpad/felix/bundle0/BootstrapCommandFile_timestamp.txt

8. Copie el almacén de segmentos recién migrado a su ubicación correcta:

   mv crx-quickstart/oak-repository/segmentstore crx-quickstart/repository/segmentstore
   

9. Copie también el almacén de datos:

   mv crx-quickstart/repository/repository/datastore crx-quickstart/repository/datastore
   

10. A continuación, debe crear la carpeta que contendrá las configuraciones de OSGi que se utilizarán con la nueva instancia actualizada. Más concretamente, es necesario crear una carpeta denominada install en crx-quickstart.

11. Ahora, cree el almacén de nodos y el almacén de datos que se utilizarán con AEM 6.3. Para ello, cree dos archivos con los siguientes nombres en crx-quickstart\install:

    • org.apache.jackrabbit.oak.segment.SegmentNodeStoreService.cfg

    • org.apache.jackrabbit.oak.plugins.blob.datastore.FileDataStore.cfg

    Estos dos archivos configurarán AEM para utilizar un almacén de nodos TarMK y un almacén de datos File.

12. Edite los archivos de configuración para que estén listos para su uso. Más específicamente:

    • Añada la siguiente línea a org.apache.jackrabbit.oak.segment.SegmentNodeStoreService.config:

      customBlobStore=true

    • A continuación, agregue las siguientes líneas a org.apache.jackrabbit.oak.plugins.blob.datastore.FileDataStore.config:

      path=./crx-quickstart/repository/datastore
       minRecordLength=4096
      

13. Quite el modo de ejecución crx2 ejecutando:

    find crx-quickstart/launchpad -type f -name "sling.options.file" -exec rm -rf {} \
    

14. Ahora debe cambiar los modos de ejecución en el archivo de guerra AEM 6.3. Para hacerlo, primero cree una carpeta temporal que albergue la guerra de AEM 6.3. El nombre de la carpeta en este ejemplo será temp. Una vez copiado el archivo de guerra, extraiga su contenido ejecutándose desde la carpeta temp:

    jar xvf aem-quickstart-6.3.0.war
    

15. Una vez extraído el contenido, vaya a la carpeta WEB-INF y edite el archivo web.xml para cambiar los modos de ejecución. Para encontrar la ubicación donde se han establecido en XML, busque la cadena sling.run.modes. Una vez que lo encuentre, cambie los modos de ejecución en la siguiente línea de código, que de forma predeterminada se establece en author:

    <param-value >author</param-value>
    

16. Cambie el valor de autor anterior y defina los modos de ejecución en: author,crx3,crx3tar El bloque final de código debería tener este aspecto:

    <init-param>
    <param-name>sling.run.modes</param-name>
    <param-value>author,crx3,crx3tar</param-value>
    </init-param>
    <load-on-startup>100</load-on-startup>
    </servlet>
    

17. Volver a crear el frasco con el contenido modificado:

    jar cvf aem62.war
    

18. Finalmente, despliegue el nuevo archivo de guerra:

    cp temp/aem62.war jboss-install-folder/standalone/deployments/aem61.war