End-2-End Deployment Steps of ACS-7.2 with Transformation-Engine

As we transition to the new Hyland Community, some post links may be temporarily disrupted as we finalize redirects. We apologize for the inconvenience and are working to resolve this as quickly as possible. Details.

nishantosaha

1> Install Utility tools
    yum install net-tools
    yum install unzip
    yum install wget

2> Install 3rd Party software
    2.1> JAVA
        yum install java-11-openjdk-devel
    2.2> Postgres
        yum install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-7-x86_64/pgdg-redhat-repo-latest.noarch.rpm
        yum install -y postgresql13-server
        /usr/pgsql-13/bin/postgresql-13-setup initdb
        systemctl enable --now postgresql-13
        sudo su postgres
        psql
            create database alfresco encoding 'utf8';
            create role alfresco LOGIN password 'alfresco';
            grant all on database alfresco to alfresco;
    2.3> Tomcat
        useradd -m -U -d /opt/tomcat -s /bin/false tomcat
        Download tomcat for linux (https://tomcat.apache.org/download-90.cgi0) and transfer to Linux machine to /tmp
        mkdir /opt/tomcat
        tar -vxf apache-tomcat-9.0.68.tar.gz -C /opt/tomcat/
        ln -s /opt/tomcat/apache-tomcat-9.0.68 /opt/tomcat/latest
        chown -R tomcat: /opt/tomcat
        sh -c 'chmod +x /opt/tomcat/latest/bin/*.sh'
    2.4> ActiveMQ
        wget https://archive.apache.org/dist/activemq/5.14.3/apache-activemq-5.14.3-bin.tar.gz
        tar -zxvf apache-activemq-5.14.3-bin.tar.gz -C /opt
        ln -s /opt/apache-activemq-5.14.3 /opt/activemq
    2.5> LibreOffice
        wget https://download.documentfoundation.org/libreoffice/stable/7.4.2/rpm/x86_64/LibreOffice_7.4.2_Linux_x86-64_rpm.tar.gz
        tar -xvf LibreOffice_7.4.2_Linux_x86-64_rpm.tar.gz
        cd /tmp/LibreOffice_7.4.2.3_Linux_x86-64_rpm/RPMS
        yum localinstall *.rpm
        yum install -y cairo
        *note home_location as "/opt/libreoffice7.3"
    2.6> ImageMagick
        yum install php-pear php-devel gcc
        yum install ImageMagick ImageMagick-devel ImageMagick-perl
        run "convert -list configure" and note below paths
        CODER_PATH /usr/lib64/ImageMagick-6.9.10/modules-Q16/coders
        CONVERT_PATH /usr/bin/convert
        *note home_path as "/opt/imageMagick/ImageMagick-7.1.0-52"
    2.7> ExifTool
        Download and transfer "image-exiftool-12.25.tgz" to Linux machine say "\tmp"
        mkdir /opt/exiftool
        tar -zxvf image-exiftool-12.25.tgz -C /opt/exiftool
        export PATH=$PATH:/usr/local/acs72/exiftool/Image-ExifTool-12.25
       
3> Install Transformation Engine
    3.1> Download and Extract PDF Renderer & Transform Service Packages from Community
        Download alfresco-pdf-renderer-1.1-linux.zip & alfresco-transform-service-distribution-1.5.3.zip from community site
        Extract the packages in location say "/alfresco/Transform-Engine"
    3.2> Start alfresco shared file-store controller on port 8099
        move to "/alfresco/Transform-Engine"
        Execute below command in background mode with output log in "/alfresco/Transform-Engine/shared-file.log" file
        java -DfileStorePath=/opt/tomcat/apache-tomcat-9.0.68/temp -Dscheduler.contract.path=/opt/tomcat/apache-tomcat-9.0.68/temp/scheduler.json -jar alfresco-shared-file-store-controller-1.5.3.jar >shared-file.log 2>&1 &
    3.3> Start Transform All-in-one Core process on port 8090
        Execute below command in background mode with output log in "/alfresco/Transform-Engine/aio-boot.log" file
        java -DPDFRENDERER_EXE=/alfresco/pdf_renderer -DLIBREOFFICE_HOME=/opt/libreoffice7.3 -DIMAGEMAGICK_EXE=/usr/bin/convert -DIMAGEMAGICK_CODERS=/usr/lib64/ImageMagick-6.9.10/modules-Q16/coders -DACTIVEMQ_URL=tcp://localhost:61616 -DFILE_STORE_URL=http://localhost:8099/alfresco/api/-default-/private/sfs/versions/1/file
                -jar alfresco-transform-core-aio-boot-2.6.0.jar >aio-boot.log 2>&1 &
    3.4> Start T-Engine Router Process on port 8095
            Execute below command in background mode with output log in "/alfreso/Transform-Engine/aio-boot.log" file
            java -DCORE_AIO_URL=http://localhost:8090 -DCORE_AIO_QUEUE=org.alfresco.transform.engine.aio.acs
                     -DACTIVEMQ_URL=tcp://localhost:61616 -DFILE_STORE_URL=http://localhost:8099/alfresco/api/-default-/private/sfs/versions/1/file
                     -jar alfresco-transform-router-1.5.3.jar >t-engine.log 2>&1 &

4> Install ACS 7.2 (Alfresco Content Service)
        4.1> Download and extract ACS package
                Create package folder in linux say "mkdir /alfresco/package/"
                Download ACS 7.2 from Community "https://community.hyland.com/en/products/alfresco/release-notes/release-notes/alfresco-content-                                 services-72"
                Extract the Zip on your laptop and transfer the content say "/alfresco/package/"
        4.2> Stop tomcat
                systemctl stop tomcat
        4.3> Apply share amp to alfresco war file
                cd /alfresco/package/bin
                java -jar alfresco-mmt.jar install ../amps/alfresco-share-services.amp ../web-server/webapps/alfresco.war
        4.4> Copy Files from package to Tomcat Server
                create ACS Data Directory say "mkdir /alfresco/acs_data" and ownership to tomcat "chown -R tomcat: /alfresco/acs_data"
                create log Directory say "mkdir /alfresco/logs" and ownership to tomcat "chown -R tomcat: /alfresco/logs"
                copy amps dir "sudo -su tomcat cp -r /alfresco/package/amps /opt/tomcat/apache-tomcat-9.0.68/"
               copy shared dir "sudo -su tomcat cp -r /alfresco/package/web-server/shared /opt/tomcat/apache-tomcat-9.0.68/"
               copy keystore directory "sudo -su tomcat cp -r /alfresco/package/keystore/ /alfresco/acs_data"
               copy wars files "sudo -su tomcat cp /alfresco/package/web-server/webapps/* /opt/tomcat/apache-tomcat-9.0.68/webapps/"
               copy postgres library "sudo -su tomcat cp /alfresco/package/web-server/lib/postgresql-42.3.2.jar /opt/tomcat/apache-tomcat-9.0.68/lib/"
               clean tomcat webapps directory "sudo -su tomcat rm -rf /opt/tomcat/apache-tomcat-9.0.68/webapps/*"
    4.5> Configure Tomcat
        edit <TOMCAT_HOME>/conf/catalina.properties "sudo -su tomcat vi /opt/tomcat/apache-tomcat-9.0.68/conf/catalina.properties"
        add this line " shared.loader=${catalina.base}/shared/classes,${catalina.base}/shared/lib/*.jar"
        add below lines in "/opt/tomcat/apache-tomcat-9.0.68/bin/catalina.sh" file
        vi /opt/tomcat/apache-tomcat-9.0.68/bin/catalina.sh
        JAVA_TOOL_OPTIONS="-Dencryption.keystore.type=JCEKS -Dencryption.cipherAlgorithm=DESede/CBC/PKCS5Padding -Dencryption.keyAlgorithm=DESede -Dencryption.keystore.location=/alfresco/acs_data/keystore/metadata-keystore/keystore -Dmetadata-keystore.password=mp6yc0UD9e -Dmetadata-keystore.aliases=metadata -Dmetadata-keystore.metadata.password=oKIWzVdEdA -Dmetadata-keystore.metadata.algorithm=DESede"
        export JAVA_TOOL_OPTIONS
    4.6> Configure Global Propertices file
        cd /opt/tomcat/apache-tomcat-9.0.68/shared/classes
        vi alfresco-global.properties
        Copy the content as below

          alfresco-global.properties
    4.7 > Start tomcat
        systemctl start tomcat