Installation and Setup

Owned by Aaron Sakievich (Unlicensed)
Last updated: Mar 04, 2024 by Kenny Teves
7 min read

Installation 

To install your Enterprise AEM connector:

  1. Log in to your instance of AEM. 

  2. Open CRX Package Manager

    1. https://your_aem_domain/crx/packmgr/index.jsp

    2. Tools > Deployment > Packages

  3. Select Upload Package.

  4. Browse your device for your Enterprise AEM package. If you have not yet received one, please reach out to support@lingotek.com. 

    1. You must upload the package as a zip file.

  5. Select Install. 

  6. A modal will appear asking you to confirm the installation.

    1. You don't need to adjust any advanced settings. 

    2. Select Install. 

  7. After a successful installation, your package will display that it has been installed. 

Setup

Adobe Experience Manager Web Console Configuration

  1. Go to the Adobe Experience Manager Web Console Configuration

    1. http://your_aem_domain/system/console/configMgr

    2. Tools > Operations > Web Console

  2. Use the find function on your browser to find Enterprise Translation Service quickly, or scroll until you find it. 

    1. Select the edit icon at the far right end of the row. 

    2. Ensure that the following is correct.

      1. AEM Instance Base URL should already be populated with the IP address where your AEM instance is hosted.

      2. Enterprise TMS Base URL should be populated with https://myaccount.lingotek.com. If it is not, change it to https://myaccount.lingotek.com.

      3. If everything looks correct, select Save. 

  3. Use the find function on your browser and search for Day CQ Link Externalizer. 

    1. Make sure the Local setting is correctly set to your Domain/IP address and the appropriate protocol. 

    2. Select Save. 

Translation Cloud Services - Global

You need to set up an Enterprise Connector and Translation Integration in the Translation Cloud Services to use the Enterprise AEM Connector. These are AEM and Enterprise translation settings that determine how content is sent to Enterprise by AEM. You must begin by creating an Enterprise Connector and Translation Integration under your Global path under Translation Cloud Services. 

Translation Connector

  1. Navigate to Translation Cloud Services. 

    1. Tools > Cloud Services > Translation Cloud Services

  2. Select Conf > Global > Enterprise Connector > Create

  3. A modal will appear where you will choose between creating an Enterprise Connector, Translation Integration, or Microsoft Translator. 

    1. Before setting up a Translation Integration, you must set up the Enterprise Connector. 

    2. You never need to select Microsoft Translator to enable Enterprise's AEM connector. 

  4. After selecting Enterprise Connector, you will land on a new page to connect to your Enterprise Account, select a community, and choose a Translation Profile. 

    1. Connect Account - Select Connect Account, and your browser will redirect you to Enterprise’s sign-in page. After you sign in, you will be redirected back to the previous page with new options. If you are already signed into the TMS in a separate tab in your browser, your page will simply refresh with the new option. 

    2. Enterprise Community - Select the Enterprise Community drop-down and choose the Enterprise Community you wish to associate with this AEM environment. 

    3. Translation Profile - The translation profile you select determines the project the connector sends your content to, the translation workflow used, and what Enterprise metadata should be attached to the uploaded content. See the Translation Profile documentation for more information. Once you have selected your Translation Profile, you will see its details appear below.

  5. Once you have successfully completed configuring your Enterprise Connector, you can Save and Close. 

  6. If needed, you can edit the settings in your Enterprise Connector later by selecting the Enterprise Connector and then selecting Edit. 

Translation Integration

  1. Choose the same Global Path where you configured your Enterprise Connector and again select create.  

    1. This time, choose Translation Integration. Enterprise Connector should not be an option. If it is, you have selected the wrong path. 

    2. Provide a title. 

    3. Optionally, provide a name. 

  2. Fill out the required settings under Sites and Assets. You will also be able to configure Communities, but those settings do not affect the Enterprise Connector, so you can leave Communites with the default settings.

    1. Sites

      1. Translation Method: Choose Human Translation for the Enterprise connector.

      2. Translation Providers: Enterprise if you are using our connector.

      3. Translate Page Assets: You have the option to use the Sites Translation Workflow for associated assets or use the asset translation workflow. 

      4. Choose associated content you want to send for translation and if the translation should be executed as soon as the job is created. 

    2. Assets

      1. Translation Method: Human Translation if you are using the Enterprise Connector.

      2. Translation Providers: Enterprise if you are using our connector.

      3. Translate Content Fragment Assets: Choose how you want inline Media Assets and Associated Collections to be translated.  

      4. Choose which types of information should be sent up for translation and if the translation should be executed as soon as the job is created. 

Translation Cloud Services - Additional Site Paths

You also have the option to create Enterprise Connector settings for other Site paths under Translation Cloud configs. Please note that you should only ever create one Translation Integration under your Global path. The following documentation is for Connector settings only.  

Configuring one Enterprise Connector

  1. Configure an Enterprise Connector for the desired site path. Select the desired path, select create, and then follow the same steps described above.  

  2. If you select this path when Applying a Translation Configuration Path (see the next section), it will use the Translation Integration settings of the Global Path with the Enterprise Connector configuration.

Configuring Multiple Enterprise Connectors

  1. If you want to create multiple Enterprise Connector settings for a site path, you must first open the Configuration Browser. 

    1. Tools > General > Configuration Browser

  2. Select the path you want to configure Enterprise Connectors and select Create.

  3. A modal will appear. Give the new configuration a title and select the Cloud Configuration checkbox. 

  4. Repeat this process as many times as desired to use multiple translation profiles so content can be uploaded to different projects, using different workflows, or tagged with unique metadata.

  5. Return to the Translation Cloud Services and open the path where you just created multiple Cloud Configurations. 

  6. For each newly created Cloud Configuration, configure an Enterprise Connector using the same steps described previously. Whenever you apply a translation configuration path while creating projects, AEM will default to using the Global Translation Integration settings. 

Applying a Translation Configuration Path

  1. When creating Translation Projects Manually, choose which Translation Config you want to use in the Advanced Settings under Cloud Configuration. See Creating Translation Projects for more information.  

  2. When creating a language copy from the Sites page, you select Cloud Configuration on step 2. If you have properly set up your Enterprise Connector and your Translation Integration, all other settings will be filled out for you.

Organizing AEM Content

The Enterprise AEM connector closely follows AEM best practices. To correctly prepare content for translation, your source content must be organized under a single source language folder. This is a folder that is named after your source language. Note that even though AEM supports various formats, they auto-generate language copies with the <language-code>_<locale-code> format (all lowercase), so we recommend you do the same for your source language folder for simplicity. 

Site Examples of a Source Language folder

Asset Examples of a Source Language Folder

When you submit content from within the source language folder for translation, a Language Copy (or several Language Copies) of the source language folder will be created named the locales of your translation.  

User Permissions for In-Context Translation

Our Workbench allows linguists to translate your AEM site content in-context. You will need to give linguists permission to view the site content for them to access it in our context viewer. The simplest way to do this is outlined below:

  1. Create an AEM User Group with the following permissions for /content and /conf paths.

    1. Permission = Allow

    2. Privileges = jcr:read

  2. Create shared, or unique AEM user accounts for the linguists who will be assigned to work on your AEM content. 

  3. Add those accounts to the AEM User Group. We recommend linguists sign in to your AEM instance before getting started on their translation tasks. We support SAML 2.0 single sign-on, and we have a verified integration with Okta.

Upgrade the Enterprise AEM Connector

As the Enterprise AEM connector improves, you will want to upgrade your connector to the latest version. To do this, we recommend you:

  1. Reach out to your support team for the latest version of our AEM connector.

  2. Create a backup of the /conf path inside CRXDE to be prepared for any unexpected complications.

  3. Install the new package before uninstalling the old package. This will ensure your cloud configurations are not removed.

  4. Once the new package finishes installing, uninstall the old package. This ensures you don’t have two packages running at the same time.