Upgrade Steps for Application Server Installations

First, start TomCat. In most situations, you can do this by running the ./catalina.sh start startup script, by running this command from the terminal:

$CATALINA_HOME/bin/catalina.sh start

If AEM 6.4 is already deployed, check that the bundles are functioning correctly by accessing:

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

Next, undeploy AEM 6.4. This can be done from the TomCat App Manager (http://serveraddress:serverport/manager/html)

Now, migrate the repository using the crx2oak migration tool. To do that, download the latest version of crx2oak from this location.

SLING_HOME= $AEM-HOME/crx-quickstart java -Xmx4096m -jar crx2oak.jar --load-profile segment-fds

Delete the necessary properties in the sling.properties file by doing the following:

1. Open the file located at crx-quickstart/launchpad/sling.properties

2. Step text Remove the following properties and save the file:

   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

Remove the files and folders that are no longer necessary. The items you need to specifically remove are:

• The launchpad/startup folder. You can delete it by running the following command in the terminal: rm -rf crx-quickstart/launchpad/startup

• The base.jar file: find crx-quickstart/launchpad -type f -name "org.apache.sling.launchpad.base.jar*" -exec rm -f {} \

• The BootstrapCommandFile_timestamp.txt file: rm -f crx-quickstart/launchpad/felix/bundle0/BootstrapCommandFile_timestamp.txt

• Remove sling.options.file by running: find crx-quickstart/launchpad -type f -name "sling.options.file" -exec rm -rf

Now, create the node store and data store that is used with AEM 6.5. You can do this by creating two files with the following names under crx-quickstart\install:

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

These two files will configure AEM to use a TarMK node store and a File data store.

Edit the configuration files to make them ready for use. More specifically:

• Add the following line to org.apache.jackrabbit.oak.segment.SegmentNodeStoreService.config:

  customBlobStore=true

• Then add the following lines to org.apache.jackrabbit.oak.plugins.blob.datastore.FileDataStore.config:

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

You now need to change the run modes in the AEM 6.5 war file. To do that, first create a temporary folder that will be housing the AEM 6.5 war. The name of the folder in this example will be temp. Once the war file has been copied over, extract its contents by running from inside the temp folder:

jar xvf aem-quickstart-6.5.0.war

Once the contents have been extracted, go to the WEB-INF folder and edit the web.xml file to change the run modes. To find the location where they are set in the XML, look for the sling.run.modes string. Once you find it, change the run modes in the next line of code, which by default is set to author:

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

Change the above author value and set the run modes to: author,crx3,crx3tar. The final block of code should look like this:

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

Recreate the jar with the modified contents:

jar cvf aem65.war

Finally, deploy the new war file in TomCat.