Installation and Setup - AEM as a Cloud Service

Installation 

Section 1: Add S3 Bucket artefact information for Straker

1. Create a file in your repository called settings.xml (or modify the current one) in your AEM as a Cloud Service git repository. The path for this file should be .cloudmanager/maven /settings.xml

2. Add a straker-aem-repo with the AWS API keys given by Straker. The resulting file should look something like this : 

<?xml version="1.0" encoding="UTF-8"?>

<settings

 xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"

 xmlns="http://maven.apache.org/SETTINGS/1.0.0"

 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

 <servers>

 <server>

 <id>straker-aem-connector-snapshots</id>

 <username>AAAAAAAA</username> <!-- Straker given AWS API key -->

 <password>BBBBBBB</password> <!-- Straker given AWS API secret -->

 <configuration>

 <endpoint>https://s3.eu-de.cloud-object-storage.appdomain.cloud</endpoint>

 <region>eu-de</region>

 <pathStyleEnabled>true</pathStyleEnabled>

 <publicRepository>false</publicRepository>

 </configuration>

 </server>

 <server>

 <id>straker-aem-connector-release</id>

 <username>AAAAAAAA</username> <!-- Straker given AWS API key -->

 <password>BBBBBBB</password> <!-- Straker given AWS API secret -->

 <configuration>

 <endpoint>https://s3.eu-de.cloud-object-storage.appdomain.cloud</endpoint>

 <region>eu-de</region>

 <pathStyleEnabled>true</pathStyleEnabled>

 <publicRepository>false</publicRepository>

 </configuration>

 </server>

 </servers>

</settings>

3. In the reactor POM (the pom.xml at the root of the directory), add the following lines just before the closing tag (or add extension into existing <extensions> tag):

<extensions>

            <extension>

                <groupId>com.github.ehsaniara</groupId>

                <artifactId>maven-repository-aws-s3</artifactId>

                <version>1.2.11</version>

            </extension>

        </extensions>

4. In the same POM, add the following repository inside any profile that is activated by default (it can be added in the adobe-public profile):

<repository>

<id>straker-aem-connector-release</id>

<name>Straker S3 Repository - Release</name>

<url>s3://straker-aem-connector/release</url>

<releases>

<enabled>true</enabled>

<updatePolicy>interval:60</updatePolicy>

</releases>

<snapshots>

<enabled>false</enabled>

</snapshots>

</repository>

<repository>

<id>straker-aem-connector-snapshots</id>

<name>Straker S3 Repository - Snapshots</name>

<url>s3://straker-aem-connector/snapshots</url>

<releases>

<enabled>false</enabled>

</releases>

<snapshots>

<enabled>true</enabled>

<updatePolicy>interval:60</updatePolicy>

</snapshots>

</repository>

5. In the all POM (all/pom.xml), add the following segment inside the dependencies (substituting the correct {straker-version-number}):

<dependency>

   <groupId>com.adobe.granite.translation.connector</groupId>

   <artifactId>straker-connector.ui.apps</artifactId>

   <type>zip</type>

   <version>1.0.1-SNAPSHOT</version>

</dependency>

<dependency>

   <groupId>com.adobe.granite.translation.connector</groupId>

   <artifactId>straker-connector.ui.config</artifactId>

   <type>zip</type>

   <version>1.0.1-SNAPSHOT</version>

</dependency>

<dependency>

   <groupId>com.adobe.granite.translation.connector</groupId>

   <artifactId>straker-connector.ui.content</artifactId>

   <type>zip</type>

   <version>1.0.1-SNAPSHOT</version>

</dependency>

 

6.  Inside the same pom.xml (all/pom.xml), add the following snippet inside the <embedded>fort the filevault-maven-package-plugin artefact:

<embedded>

   <groupId>com.adobe.granite.translation.connector</groupId>

   <artifactId>straker-connector.ui.apps</artifactId>

   <type>zip</type>

   <target>/apps/straker-connector/application/install</target>

</embedded>

<embedded>

   <groupId>com.adobe.granite.translation.connector</groupId>

   <artifactId>straker-connector.ui.config</artifactId>

   <type>zip</type>

   <target>/apps/straker-connector/application/install</target>

</embedded>

<embedded>

   <groupId>com.adobe.granite.translation.connector</groupId>

   <artifactId>straker-connector.ui.content</artifactId>

   <type>zip</type>

   <target>/apps/straker-connector/content/install</target>

</embedded>

 

7. Add the following in filter .xml of your all Module

<filter root="/apps/straker-connector"/>

8. Commit all the changes to the branch and push the changes

9. The build for AEM as a Cloud Service can now be done.

Section 2 : Uploading filter Package 

1. Navigate to {base_URL}/crx/packmgr/index.jsp

2. Click on “Upload Package”

3. Click on “Browse”

4. Choose “contentPackageForStraker.zip” from your file system and click “Open”.

5. Check “Force Upload” and Click “OK”

6. Wait for the uploading to end, then click on “Install”

7. Click “Install” on the next screen

8. Ensure package is installed and the filters exist.

Section 3: Adding permissions

1. Navigate to “{base_URL}/ui#/aem/security/permissions.html/principal”

2. Change the dropdown to Users

 

3. Search for  “straker-service”. Click on it.

 

4. Click on “Add”, if no ACEs exist, or “Add ACE” if some exist.

 

5. Click on folder icon.

 

6. Check “Root” check box and click “Select”.

 

7. Type “read” in “Privileges” text box to bring up “jcr:read”, then click on it to choose it.

 

8. Make sure the “”Allow” is clicked instead of “Deny”. Click “Add”

 

9. Click “Add ACE”.  Then click on folder icon.

10. Check the “/var/starker-tms” check box. Then click “Select”.

11. In the “Privileges” text box, type “all” to bring up “jcr:all”.

12. Select “jcr:all” . Make sure the “”Allow” is clicked instead of “Deny” and click “Add”.

13. Repeat Step 9. Then check the “/content” check box, then click "Select"

14. In the “Privileges” text box, type “all” to bring up “jcr:all”. Select “jcr:all” . Make sure the “”Allow” is clicked instead of “Deny” and click “Add”.

15. Final screen of the permissions should have the three presently added permissions--

After compilation of these two sections, please wait for five minutes before proceeding with translation job creation/connector connection creation.

Section 4: Connector creation

1. Navigate to “{base_URL}/ui#/aem/mnt/overlay/cq/translation/gui/content/cloudservices.html”

2. Under /Conf/Global, click on “Straker Connector” and click “Create”.

 

3. Give Title and Name as “Straker”. This can be anything that you desire(without spaces and special characters). Click “Create”.

4. Provide the Access Token and click on Live. Click “Save and Close” after that.