This the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Before You Install

Before you begin to install the Lionbridge Connector (“Connector”) for Adobe Experience Manager, please review the system requirements, described in System Requirements, and perform the following pre-installation procedures:

Very important: Do not use the same account keys on multiple instances, because this is a violation of the License Agreement. Using the same account keys on multiple instances will cause the Connector to behave unexpectedly, which can result in lost translation content, orphaned projects, and inaccurate translation status reports. The Lionbridge Connector team will support technical issues caused by duplicating or incorrectly installing CMS address keys only on a time and materials basis.

Note: If you are installing the Connector in a clustered environment, see Installing the Connector in a Clustered Environment.

Note: If you are installing on Java version 8 or above, make sure you specify the JVM option -Djava.locale.providers=COMPAT under the AEM startup script, as described in the next image:

1 - System Requirements

The Lionbridge Connector for Adobe Experience Manager must be installed on the Adobe Experience Manager Author server. The Lionbridge Connector for Adobe Experience Manager supports Adobe Experience Manager versions 6.2 and higher.

The Lionbridge Connector for Adobe Experience Manager has no additional hardware or software requirements beyond those of Adobe Experience Manager. For detailed requirements, refer to the appropriate version of the Adobe Experience Manager Technical Requirements.

2 - Setting Your System Date, Time, and Time Zone Correctly

The Connector sends content to and receives content from the Content API Platform, which is hosted in the Lionbridge environment and requires any machines that connect to its applications to have the correct system time and date settings.

Important: Before proceeding, ensure that the system date, time, and time zone are set correctly on any systems that will run the Connector. If these settings are incorrect, the following error message is displayed: Error. The difference between the request time and the current time is too large.

3 - Downloading the Delivery Package

  1. Download the Lionbridge Connector (“Connector”) delivery package from the link that Lionbridge Connector Support sends you. This is a .zip file, and it contains the following folders:
Folder Name Description
Lionbridge connector for Adobe Experience Manager a.v-x.y.z-<datetimestamp> The installation package that you will install into your Adobe Experience Manager system using the Package Manager tool. This has the following format: Lionbridge connector for Adobe Experience Manager a.v-x.y.z-yyyy-MMddkkmm.zip, where a.v is the supported Adobe Experience Manager version number, and x.y.z is the Connector version number, for example, Lionbridge connector for Adobe Experience Manager 6.3-4.0.0-2019-03141609.zip.
Note about upgrading from a previous version of the Connector: There is a single package for both new installations and upgrades from previous installations. This redesigned package prevents overwriting your configuration settings while upgrading.
Freeway support package Lionbridge connector addon - Freeway Support.zip, which is the Freeway-support add-on installation package that you will install into your Adobe Experience Manager system using the Package Manager tool. This package supports all versions of Adobe Experience Manager and all versions of the Connector.
Note: This is required only if you are using the Connector’s add-on for Lionbridge Freeway.
CTC Data The Connector Data folder zip archive, CTCData.zip.
Note: This folder is optional.
Documents 1. Lionbridge Connector for Adobe Experience Manager Installation and Configuration Guide (this document)
2. Lionbridge Connector for Adobe Experience Manager User Guide
Key Client ID for CTCConfig UI This is the file containing the license for the configuration UI if the Content API Platform is hosted on AWS. The file name is License_ID.txt.
  1. Unzip the delivery package file you downloaded, and save its contents to a convenient location.

4 - Creating or Updating a Connector Database on your Database Server Instance

The Connector requires one of the following databases for its database engine:

  • MySQL version 5.0 or higher
  • Microsoft SQL Server version 2012 or higher
  • Oracle 11g and 12c
  • PostgreSQL

For new Connector installations, create a database container, such as CTCTRANSLATION. The Connector will automatically create all tables and columns.

When upgrading from a previous version, the Connector automatically updates all tables and columns.

Note: If the automatic upgrade of the database fails while upgrading your version of the Connector, for example, because of insufficient permissions, the Errors and SQL Scripts buttons are displayed in the JDBC SQL Connection section of the Configuration page. Click Errors to view the related error messages. Click SQL Scripts to download the generated SQL scripts. A DBA can then run the scripts. Refer to the ct_db_update.Sql file in the Adobe Experience Manager quickstart folder for the list of SQL commands required to manually update the database.

Note about MySQL: You may need to edit the mysql.ini file to add the following lines:
[mysql]
default-character-set=utf8
[mysqld]
character-set-server=utf8

Translation Database Size Requirements
Minimum size 1 GB
Recommended size 10 GB

Recommendation: Increase the database size relative to the site content.

5 - Creating the Connector Folders

This section describes how to create a data folder that Connector uses to store licensing information and translation data. This step is optional. The Connector uses the sub-folders to store data for translation updates and shared configuration files. It may also store log files.

  1. On your Adobe Experience Manager server, navigate to the file system and create a folder called CTCdata.

  2. Unzip the CTCData.zip archive folder from the delivery package you downloaded and unzipped, as described in Downloading the Delivery Package, and extract all the included folders into the target CTCdata folder. This creates the following two subfolders in the CTCdata folder:

Sub-Folder Folder Access Permissions Description
update Full This folder will contain manually updated translated files.
Note: Use this feature only if translation providers have edited XML files that were already returned into Adobe Experience Manager, or if a file was not successfully inserted back into Adobe Experience Manager.
logs Full This folder may be used by the Connector to store Connector log files, if you select the Logs check box in the Folder and Permissions section of the Configuration page. For details, see Folder and Permissions.
  1. Set the access permission for each folder according to the above table.