Wednesday, 2 September 2015

Upgrade to AEM 6.1 forms from AEM 6.0 forms for OSGi

Before you upgrade

Perform the following steps, before upgrading from AEM 6.0 forms to AEM 6.1 forms:
  • Install the latest service pack and patches for AEM 6.0 forms.
  • (If your AEM 6.0.1 instance is running on CRX2 repository) Open the Web Bundles console http://localhost:4502/system/console/bundles, delete the com.day.crx.sling.server bundle, and shut down the AEM instance.\

Perform the upgrade

Perform the following steps to upgrade from AEM 6.0 forms to AEM 6.1 forms:
  1. Download the AEM 6.1 QuickStart.
  2. Replace the AEM 6.0 QuickStart with AEM 6.1 QuickStart and start the author instance.
    Starting the AEM 6.1 QuickStart, upgrades the existing crx-repository to AEM 6.1, automatically migrates the content from older version to newer version, and creates a folder named archived-versions.  
  3. After the server is up and running, shut down the AEM instance.
    It might take a few minutes for the AEM instance to be up and running. You can consider the AEM instance is up and running after the [AEM-root]/logs/error.log file becomes stable.
  4. Open the archived-versions folder and copy all the folders inside archived-versions folder to the [AEM_root]\crx-repository folder. Restart the AEM 6.1 QuickStart.  
  5. Download and install AEM forms add-on package.
    Note:
    Before installing the AEM forms add-on package, ensure that the installation path of the AEM Quickstart does not contain any spaces.  
    AEM forms 6.1 add-on packageDownload link
    AEM forms add-on package for AIXadobe-aemfd-aix-pkg
    AEM forms add-on package for Linuxadobe-aemfd-linux-pkg
    AEM forms add-on package for Solarisadobe-aemfd-solaris-pkg
    AEM forms add-on package for Windowsadobe-aemfd-win-pkg
    Central Migration Bridge and Send to printer Servicesadobe-aemfd-cmb-pkg
    Add on package for Geometrixx Finance sample sitecq-geometrixx-finance-pkg
    Caution:
    After installing the add-on package, you will get a prompt to restart the server. However, do not immediately restart. Ensure that error.log is stable and all bundles (except signatures) are in active mode before you restart the server.
  6. Configure the Doc Assurance Service
    The DocAssurance service is not available out of the box. It requires RSA and BouncyCastle libraries installed with AEM forms package. Perform the following steps to bootdelegate these libraries:   
    1. Stop the AEM server.
    2. Open the sling.properties at [AEM installation]\crx-quickstart\conf\ for editing.
      Note:
      If you use [AEM_root]\crx-quickstart\bin\start.bat to start AEM, then edit the sling.properties at [AEM_root]\crx-quickstart\
    3. Add the following properties to the sling.properties file:
      1
      2
      sling.bootdelegation.class.com.rsa.jsafe.provider.JsafeJCE=com.rsa.*
      sling.bootdelegation.class.org.bouncycastle.jce.provider.BouncyCastleProvider=org.bouncycastle.*
    4. Save and close the file. Restart the AEM server.

Verify the upgraded instance

  1. Open Web Bundles console and ensure that all the bundles at /system/console/bundle are active. The default address of the Web Bundles is http://localhost:4502/system/console/bundles.
  2. Open the package manager, ensure that a cq-content package with version 6.1 exists.

No comments:

Post a Comment