Skip to main content
 

How can we help?

Search

Install, Update, or Uninstall Acrolinx for AEM On-Premise

  • Updated

What you should know about installing, updating, and uninstalling.

Before You Install

Check our Compatibility Guide if you want to know whether Acrolinx for Adobe Experience Manager works with your local platforms.

Before you install, make sure that you have following:

Adobe AEM On-Premise

Acrolinx for Adobe AEM Versions

Acrolinx Platform

Supported Adobe AEM Versions

Supported AEM Components Version

Notes

2.3.7, 2.3.8

All latest official versions and all versions released within the last 12 months.

6.5.20

AEM Guides 4.4

2.23.4

2.3.6

2022.02 or later

6.5.19

AEM Guides 4.3.x

2.23.4

Install

Notice

You'll need Adobe Experience Manager (AEM) administrator rights to install Acrolinx for AEM.

To install Acrolinx for AEM, you'll need to upload and install the Acrolinx installation package in the Adobe CRX Package Manager.

To upload and install Acrolinx for AEM on-premise, do the following:

  1. Download the latest version of the Acrolinx for AEM .zip file from your company download area.

  2. In AEM, go to Tools > CRXDE Lite to open CRXDE Lite.

  3. Click Package to open the CRX Package Manager.

  4. Click Upload Package. In the Upload Package dialog box, select the Acrolinx for AEM .zip file and click OK.

  5. After the file has uploaded, click Install. When the installation is complete, you're ready to connect to Acrolinx.

Tip

Also, check the admin guide for more technical steps required for Acrolinx for AEM. For example, enabling single sign-on and configuring the connection to Acrolinx.

Update

If you're updating from an earlier version of Acrolinx for AEM, you'll need to remove any previous versions before installing this version.

Tip

Planning to update AEM? You’ll need to uninstall Acrolinx first. Check out our Compatibility Guide before you reinstall Acrolinx to make sure it works with your new editor version. We usually adapt Acrolinx to match the latest version of AEM.

To update Acrolinx for AEM, do the following:

  1. If you're updating from Acrolinx for AEM 1.6.1 or earlier, update your AEM Content Profile to include any components that you want to check. See the section Component Configuration in our AEM admin guide for details on how to do this.

    We recommend that you create a backup of the following customization files just in case:

    apps/acrolinxsidebar/authoring/layer/sidebar/common/config.json
apps/acrolinxsidebar/authoring/layer/sidebar/common/CustomComponents.json

  2. Download the latest version of the Acrolinx for AEM .zip file from your company download area. It'll be called acrolinx-for-aem.ui.apps.

  3. In AEM, go to Tools > CRXDE Lite to open CRXDE Lite.

  4. Click Package to open the CRX Package Manager. Find any old versions of Acrolinx for AEM. Uninstall and delete them.

  5. Clear the AEM client library cache:

    1. Go to https://<YOUR_AEM_SERVER>:<AEM_PORT>/libs/granite/ui/content/dumplibs.rebuild.html

    2. Click Invalidate Caches.

    Warning

    This clears the cache of all AEM packages at the same time.

  6. Clear your browser cache.

  7. Click Upload Package. In the Upload Package dialog box, select the Acrolinx for AEM .zip file and click OK.

  8. After the package has uploaded, click Reinstall. When the installation is complete, you're ready to connect to Acrolinx.

Uninstall

To uninstall or deactivate Acrolinx for AEM follow these steps:

  1. In AEM, go to Tools > CRXDE Lite to open CRXDE Lite.

  2. Click Package to open the CRX Package Manager. Find the Acrolinx for AEM package, and click More to open a dropdown menu.

  3. Click Uninstall and confirm.