Alfresco 7.3 - Upgrading to Transform Core 3.0.0

cancel
Showing results for 
Search instead for 
Did you mean: 

Alfresco 7.3 - Upgrading to Transform Core 3.0.0

angelborroy
Alfresco Employee
1 0 2,523

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

 

 

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

About the Author
Angel Borroy is Hyland Developer Evangelist. Over the last 15 years, he has been working as a software architect on Java, BPM, document management and electronic signatures. He has been working with Alfresco during the last years to customize several implementations in large organizations and to provide add-ons to the Community based on Record Management and Electronic Signature. He writes (sometimes) on his personal blog http://angelborroy.wordpress.com. He is (proud) member of the Order of the Bee.