Friday, December 4, 2020

Setup ACS62-ga and ASS1.4 using distribution package step by step Part-1

 

ACS6.x is mainly based on containers which makes use of popular container platform Docker

Many of us are not familiar with containerization setup and may not be ready to use it yet. In previous versions we had option to use installers and it used to setup everything seamlessly. With ACS6.x we don’t have installer option available and it is expected to leverage the use of containerization technologies.

But there are ways to setup ACS6.x in the same ways as we used to do for previous versions i.e. using distribution package provided by Alfresco.

The purpose of this post is to document all the steps at one place when setting up ACS6.x manually using distribution package.

ACS 6.2.0-ga is the latest stable version available and we will use the same version here.


What we need before we start doing setup?

  1. ACS-6.2.0-ga package (alfresco-content-services-community-distribution-6.2.0-ga)
  2. ASS-1.4.0 package (alfresco-search-services-1.4.0)
  3. Java: Oracle jdk-11.0.1 or later/Open JDK 11.0.1 or later
  4. Tomcat: Tomcat 8.5.43
  5. ActiveMQ: ActiveMQ v5.15.8 (Optional). Mandatory for transformation services when using enterprise version (async transform service) and/or Out of process extensions.
  6. DB: PostgreSQL 11.4
  7. ImageMagick: ImageMagick v7.0.10
  8. Libreoffice: LibreOffice v6.3.5
Checkout this documentation for additional details on Supported Platforms

Platform:

  • Windows 10 x64
Type of deployment:

  • ACS, Share and SOLR6 on same machine
  • Setup Without SSL

For Linux based installation steps visit this post: 

Setup ACS62-ga and ASS1.4 using distribution package part2

Interested in ACS7.x? checkout this post:



Let’s start gathering all the required prerequisites listed above.



Visit Alfresco community download page and download latest stable versions of ACS and ASS:

  • Download ACS 6.2.0-ga:
https://download.alfresco.com/cloudfront/release/community/201911-GA-build-368/alfresco-content-services-community-distribution-6.2.0-ga.zip
  • Download ASS 1.4.0:
https://download.alfresco.com/cloudfront/release/community/SearchServices/1.4.0/alfresco-search-services-1.4.0.zip

Note: If you are planning to setup ACS 6.2.1/6.2.2 (Enterprise versions) and ASS 2.0, then download the appropriate distribution packages from Alfresco Support portal. All the steps outlined below will remain same. We are using community version of ACS 6.2  for this post hence we have to use ASS 1.4 as stated in the Supported platforms here


Download and Install Oracle JDK 11.0.4:

https://www.oracle.com/java/technologies/javase/jdk11-archive-downloads.html

https://www.oracle.com/webapps/redirect/signon?nexturl=https://download.oracle.com/otn/java/jdk/11.0.4+10/cf1bbcbf431a474eb9fc550051f4ee78/jdk-11.0.4_windows-x64_bin.zip

Note: Make sure you set the JAVA_HOME environment variable (on windows). It is the installation path of jdk. E.g. JAVA_HOME=C:\Program Files\Java\jdk-11.0.4

Download Tomcat 8.5.43 binary package:

https://archive.apache.org/dist/tomcat/tomcat-8/v8.5.43/bin/apache-tomcat-8.5.43-windows-x64.zip

Note: Make sure ports 8005, 8080, 8443, AJP port 8009 are open and not in use already. These are default ports used for tomcat. If you have these ports already in use, make sure you change the ports accordingly in <TOMCAT_INSTALLATION>/conf/server.xml.

Download ActiveMQ v5.15.8 binary package, it will be used for transformation services down the line:

https://archive.apache.org/dist/activemq/5.15.8/apache-activemq-5.15.8-bin.zip

Download and Install PostgreSQL 11.4:

https://get.enterprisedb.com/postgresql/postgresql-11.4-1-windows-x64.exe

Alternatively you can also download the binary package and extract it. No installation needed. It is useful if you have trouble doing installation on Windows 10.

Download PostgreSQL 11 binary

Note: Make sure port 5432 is open and not already in use. Port 5432 is default for postgres to get db connection. If you have this port already in use, make sure you select a different port and use the same while configuring alfresco-global.properties.


Download ImageMagick v7.0.10:

https://imagemagick.org/download/binaries/ImageMagick-7.0.10-45-Q16-HDRI-x64-dll.exe

Above version is no longer available to download, use the below given alternatives.


Alternative options:

Download LibreOffice v6.3.5:

https://downloadarchive.documentfoundation.org/libreoffice/old/6.3.5.2/win/x86_64/LibreOffice_6.3.5.2_Win_x64.msi (installer)

Optional Alfresco module packages (amps)-Useful for admins/developers:

https://repo1.maven.org/maven2/org/orderofthebee/support-tools/support-tools-repo/1.1.0.0/support-tools-repo-1.1.0.0-amp.amp 

https://repo1.maven.org/maven2/org/orderofthebee/support-tools/support-tools-share/1.1.0.0/support-tools-share-1.1.0.0-amp.amp 

https://repo1.maven.org/maven2/de/fmaul/javascript-console-repo/0.6/javascript-console-repo-0.6.amp 

https://repo1.maven.org/maven2/de/fmaul/javascript-console-share/0.6/javascript-console-share-0.6.amp