Enable relational database microkernel support

Posted on Feb 5, 2015

Issues fixed in the QF

The hot fix enables supported relational database microkernel for AEM 6.1 forms on JEE Feature Pack 1. For the list of supported relational database microkernel see, supported platforms combinations document.  

Note:

The hot fix is for fresh installation of AEM 6.1. Install and configure the hot fix before running AEM 6.1 for the first time.

Installing and configuring the QF

  1. Log in to AEM Configuration Manager as an administrator. Search and open the Apache Sling Thread Pool Configuration service, select the Shutdown Graceful option, and click Save.

    Note:

    The default URL of the configuration manager is http://[server]:[port]/system/console/configMgr.

  2. Open AEM Package Share and search cq-6.1.0-hotfix-8420. In the search results, click cq-6.1.0-hotfix-8420. In the details window, open the Assets tab and click the Download to disk: cq-6.1.0-hotfix-8420-1.2 option. Accept the license agreement and save the archive to the local machine.

  3. (For JAR-based installations) In the folder containing AEM 6.1 setup JAR file, create a folder structure crx-quickstart\install. Place the cq-6.1.0-hotfix-8420 archive in the crx-quickstart\install folder and start the AEM instance.

    (For WAR-based installations) The sling.home property of the web.xml file of AEM 6.1 setup war file contains a path. At the path mentioned for the sling.home property, create a folder named install. Place the cq-6.1.0-hotfix-8420 archive in the install folder and start the AEM instance.

  4. After AEM server starts, continue with installing AEM forms add-on package. For detailed steps to install the add-on package, see Installing and Configuring AEM forms on OSGi article.

  5. To verify that the hot fix is installed and configured:

    • (For JAR-based installations): Log in to http://[server]:[port]/system/console. Search and locate the oak-core service. Open the service and ensure that the version of the service is 1.2.9.
    • (For WAR-based installations): Log in to http://[server]:[port]/[context path]/system/console. Search and locate the oak-core service. Open the service and ensure that the version of the service is 1.2.9.

  1. Log in to AEM Configuration Manager as an administrator. Search and open the Apache Sling Thread Pool Configuration service, select the Shutdown Graceful option, and click Save.

    Note:

    The default URL of the configuration manager is http://[system]:[port]/system/console/configMgr.

  2. Open AEM Package Share and search cq-6.1.0-hotfix-8420. In the search results, click cq-6.1.0-hotfix-8420. In the details window, open the Assets tab and click the Download to disk: cq-6.1.0-hotfix-8420-1.2 option. Accept the license agreement and save the archive to the local machine.

  3. Start AEM forms on JEE installer, complete the installation, and start the Configuration Manager.

  4. In Configuration Manager, the CRX Configuration screen allows you to configure path to the repository, repository type, and install the CRX repository to AEM forms on JEE Core EAR file. The default path of the repository is [aem-forms root]/crx-repository.

    After you click Next on the CRX Configuration screen, place the downloaded cq-6.1.0-hotfix-8420 package at [repository path]\install folder, and continue with configuration manager. The hot fix is installed.  

  5. To verify that the hot fix is installed and configured, log in to http://[server]:[port]/system/console. Search and locate the oak-core service. Open the service and ensure that the version of the service is 1.2.9.