Alfresco 7.3 - Upgrading to Transform Core 3.0.0

[angelborroy]

This blog post includes the new features provided by Transform Core 3.0.0, released together with ACS Community 7.3.x.

Source Code

All the Source Code from Transform Core is available in following Alfresco GitHub project:

https://github.com/Alfresco/alfresco-transform-core

The project includes a number of Transformation Engines that can be deployed together (AIO) or separately:

https://github.com/Alfresco/alfresco-transform-core/tree/master/engines

Additional resources

• ImageMagick: images and thumbnails
• LibreOffice: office documents (including Microsoft formats)
• pdfrenderer: PDF format
• Apache Tika: metadata extraction
• Misc: HTML, iWorks, EML...

Deployment

Sample project is available in https://github.com/aborroy/alfresco-transform-service-3.0.0

Deployment as a single Core AIO (All-In-One) T-Engine:

services:

  alfresco:
    image: alfresco/alfresco-content-repository-community:7.3.0
    environment:
	  JAVA_OPTS: >-
	    -DlocalTransform.core-aio.url=http://transform-core-aio:8090/

  transform-core-aio:
    image: alfresco/alfresco-transform-core-aio:3.0.0

Deployment as a set of individual T-Engines:

services:

  alfresco:
    image: alfresco/alfresco-content-repository-community:7.3.0
    environment:
      JAVA_OPTS: >-
        -DlocalTransform.core-aio.url=
        -DlocalTransform.pdfrenderer.url=http://alfresco-pdf-renderer:8090/
        -DlocalTransform.imagemagick.url=http://imagemagick:8090/
        -DlocalTransform.libreoffice.url=http://libreoffice:8090/
        -DlocalTransform.tika.url=http://tika:8090/
        -DlocalTransform.misc.url=http://transform-misc:8090/

  alfresco-pdf-renderer:
    image: alfresco/alfresco-pdf-renderer:3.0.0

  imagemagick:
    image: alfresco/alfresco-imagemagick:3.0.0

  libreoffice:
      image: alfresco/alfresco-libreoffice:3.0.0

  tika:
      image: alfresco/alfresco-tika:3.0.0

  transform-misc:
      image: alfresco/alfresco-transform-misc:3.0.0

Configuration endpoints

Registered transformations are available in Transform Configuration endpoint:

http://localhost:8090/transform/config

Additional endpoints for http://localhost:8090:

• "POST /transform" to perform a transform. Performs a transform on content uploaded as a Multipart File and provides the resulting content as a download. Transform options are extracted from the request properties. The following are not added as transform options, but are used to select the transformer: sourceMimetype & targetMimetype
• "GET /" provides an html test page to upload a source file, enter transform options and issue a synchronous transform request.
• "GET /log" provides a page with basic log information.
• "GET /error" provides an error page when testing.
• "GET /version" provides a String message to be included in client debug messages.

Changing default configuration

From Transform Core 3.0.0, several methods are available to override default configuration. Additional details are available in https://github.com/aborroy/alfresco-transform-service-3.0.0#changing-default-configuration

Creating a new Transform Engine

Instructions to create a new Transform Engine are available in https://github.com/aborroy/alfresco-transform-service-3.0.0#creating-new-transform-engine

Additional deployment configurations

Limit the number of threads to be used for transformation operations (between 4 and 12 in the sample) and change the log level (to ERROR in the sample):

    transform-core-aio:
        image: alfresco/alfresco-transform-core-aio:3.0.0
        environment:
            JAVA_OPTS: "
              -Dserver.tomcat.threads.max=12
              -Dserver.tomcat.threads.min=4
              -Dlogging.level.org.alfresco.transform.common.TransformerDebug=ERROR
            "

Scaling up Transform Service samples are available in https://github.com/aborroy/acs-transform-cluster

SSL/TLS configuration sample is available in https://github.com/aborroy/alfresco-transform-ssl

Additional resources

https://www.slideshare.net/angelborroy/alfresco-transform-core-300 

https://www.slideshare.net/angelborroy/alfresco-transform-services-400