Skip to main content

XTM Connect – Adobe Experience Manager 2.6

Installation (AEMaaCS)

Note

If you are using Adobe Experience Manager 6.5 (AEM 6.5), see Installation (AEM 6.5).

In AEM as a Cloud Service, XTM Connect – AEM cannot be installed from a package. This is because limitations have been introduced along with Adobe CI:

  • You cannot install any package directly, with either AEM as a Cloud Service CRX Package Manager or even cURL commands, as you have no permissions to do so.

  • Adobe CI is the only way to upload a CRX package and install it.

  • Only one package can be deployed onto the AEM as a Cloud Service environment using the Adobe CI pipeline. This package can contain sub-packages, in which case, the XTM Connect – AEM connector is one of them.

  • All extensions, such as XTM Connect – AEM, need to be added as a dependency to the main application project and embedded as part of the deployed package.

In simple terms, the XTM Connect – AEM installation process can be seen like this: to enable XTM Connect – AEM to connect to the AEM as a Cloud Service system, and be used in it, a specific URL needs to be added to a configuration file (Maven pom.xml). This URL is for the XTM Cloud JFrog libraries repository.

Important

XTM Connect – AEM can also be installed on the publisher instance, but the author runmode is required to enable and activate the connector on that instance.

Prerequisites

Important

The list below refers to projects generated using the official AEM Project Archetype (for details, see AEM Project Archetype (Adobe Inc. online help)). However, the same principles can be applied to any other AEM projects generated using different archetypes.

Before you can install XTM Connect – AEM, certain prerequisites must be met:

  1. We strongly recommend that you test the installation of AEM as a Cloud Service SDK on your local AEM as a Cloud Service system before you install it on your actual Adobe CI builds and deployments. For details, see Testing the build in AEM as a Cloud Service.

  2. You must have access to the Git repository which is used by Adobe CI for building and deploying the project.

  3. You must have access to your Adobe Cloud Manager system configuration, with permissions to run Adobe CI builds.

  4. You must have some basic knowledge of how to configure a Maven pom.xml file and how to build and deploy a project.

Installation tasks

Perform these installation tasks:
  1. Configure the Maven pom.xml configuration file in the local AEM as a Cloud Service system.

    Important

    The procedure described in this topic refers to projects generated using the official AEM Project Archetype (for details, see AEM Project Archetype (Adobe Inc. online help)). However, the same principles can be applied to any other AEM projects generated using different archetypes.

  2. Test the build in AEM as a Cloud Service.

When required, you can also upgrade the existing XTM Connect – AEM as a Cloud Service instance.