• Skip to primary navigation
  • Skip to main content
  • Skip to primary sidebar
  • Skip to footer
TSB Alfresco Cobrand White tagline

Technology Services Group

  • Home
  • Products
    • Alfresco Enterprise Viewer
    • OpenContent Search
    • OpenContent Case
    • OpenContent Forms
    • OpenMigrate
    • OpenContent Web Services
    • OpenCapture
    • OpenOverlay
  • Solutions
    • Alfresco Content Accelerator for Claims Management
      • Claims Demo Series
    • Alfresco Content Accelerator for Policy & Procedure Management
      • Compliance Demo Series
    • OpenContent Accounts Payable
    • OpenContent Contract Management
    • OpenContent Batch Records
    • OpenContent Government
    • OpenContent Corporate Forms
    • OpenContent Construction Management
    • OpenContent Digital Archive
    • OpenContent Human Resources
    • OpenContent Patient Records
  • Platforms
    • Alfresco Consulting
      • Alfresco Case Study – Canadian Museum of Human Rights
      • Alfresco Case Study – New York Philharmonic
      • Alfresco Case Study – New York Property Insurance Underwriting Association
      • Alfresco Case Study – American Society for Clinical Pathology
      • Alfresco Case Study – American Association of Insurance Services
      • Alfresco Case Study – United Cerebral Palsy
    • HBase
    • DynamoDB
    • OpenText & Documentum Consulting
      • Upgrades – A Well Documented Approach
      • Life Science Solutions
        • Life Sciences Project Sampling
    • Veeva Consulting
    • Ephesoft
    • Workshare
  • Case Studies
    • White Papers
    • 11 Billion Document Migration
    • Learning Zone
    • Digital Asset Collection – Canadian Museum of Human Rights
    • Digital Archive and Retrieval – ASCP
    • Digital Archives – New York Philharmonic
    • Insurance Claim Processing – New York Property Insurance
    • Policy Forms Management with Machine Learning – AAIS
    • Liferay and Alfresco Portal – United Cerebral Palsy of Greater Chicago
  • About
    • Contact Us
  • Blog

Alfresco 5 Deployment : Tips and Tricks

You are here: Home / Alfresco / Alfresco 5 Deployment : Tips and Tricks

January 29, 2016

TSG has had two recent clients deploy Alfresco 5. After stabilizing the environments to handle the proper production load, we gathered a list of tips and tricks that have helped improve performance for Alfresco 5 around transformation and Microsoft SQL Server.  For clients familar with Alfresco 4, we have found making some small changes within client configurations in Alfresco 5 can result in a substantially improved performance. The remainder of this post will serve as a suggested checklist for consideration when deploying Alfresco 5.

Content Transformations

Thumbnail Generation for Share Previews

One large difference between Alfresco 4 and 5 relates to content transformations. By default, Alfresco 5 will try to create a thumbnail of any document as soon as it is created in the repository.  If you are using Alfresco Share, you will need these thumbnails.  For clients that have built their own interface or are using our HPI interface, thumbnails are unnecessary, and the generation only adds load to the system and utilizes unnecessary storage space. In one extreme case, the thumbnail generation was causing our client’s external Transformation Server to grind to a halt during the migration of content to the new environment. (Note that the external Alfresco Transformation Server is a separate product offered by Alfresco.) For another client, thumbnail generation was significantly slowing down a large scale content migration from a legacy system into Alfresco.

TSG’s recommendations: if you do not need to view content thumbnail within Share, disable thumbnail generation. If you are performing a large scale migration, temporarily disable thumbnail generation during the migration process. In order to disable thumbnail transformations, simply add the following to alfresco-global.properties and restart Alfresco:

system.thumbnail.generate=false

Arbitrary Image Renditions Generated by External Transformation Server

For our client with the external Alfresco Transformation Server, we noticed PDF files that were sent to the external Transformation Server were getting transformed into numerous image renditions. Because PDF is a universal format, we did not need the image renditions for normal client scenarios. Alfresco has three main content transformers when the external Transformation Server is configured: the Transformation Server, the out-of-the-box JOD converter and the out-of-the-box OpenOffice converter. Each category of transformers handles different types of transformations. The JOD converter typically handles image transformations, the OpenOffice converter handles Office document transformers (especially when the external Transformation Server is not deployed), and the external Transformation Server handles complex Office document transformations, including transformations of Outlook emails. Take care when configuring the properties below in case you do need image transformations in certain scenarios. The following lines can be added to alfresco-global.properties to prevent any documents (including PDFs) from being converted to various image types:

The general format of these properties is: content.transformer.<TRANSFORMER USED>.extensions.<STARTING EXTENSION>.<ENDING EXTENSION>.supported

# Disable image transformations by the external Transformation Server
content.transformer.remoteServer.extensions.*.gif.supported=false
content.transformer.remoteServer.extensions.*.jpg.supported=false
content.transformer.remoteServer.extensions.*.png.supported=false
content.transformer.remoteServer.extensions.*.swf.supported=false

# Disable image transformations by the JOD converter
content.transformer.JodConverter.extensions.*.gif.supported=false
content.transformer.JodConverter.extensions.*.jpg.supported=false
content.transformer.JodConverter.extensions.*.png.supported=false
content.transformer.JodConverter.extensions.*.swf.supported=false

# Disable all image transformations for all converters
content.transformer.*.extensions.*.gif.supported=false
content.transformer.*.extensions.*.jpg.supported=false
content.transformer.*.extensions.*.png.supported=false
content.transformer.*.extensions.*.swf.supported=false

In the first and second section of properties, we are explicitly preventing image conversions for each specific converter (the external Transformation Server or the JOD converter, respectively). The final section of properties disables all image transformations. Choose the options that make the most sense for your setup – you will likely only need one section of properties.

Microsoft SQL Server

If you are using Microsoft SQL Server for the Alfresco database, there are two vital steps you should take BEFORE starting Alfresco for the first time after you install. First, transaction isolation must be enabled on your SQL database or Alfresco will not function. If Alfresco is started for the first time before transaction isolation is enabled on your database, you will have to reinstall Alfresco. In addition, the following property in alfresco-global.properties should be set:

db.txn.isolation=4096

We made the mistake of not setting this property in a client environment. We had transaction isolation enabled on the database, but without setting db.txn.isolation set properly, we were seeing the database grind to a halt due to poor transaction handling.
Another lesson learned was using the correct supported service pack from Alfresco, which is currently SP1 (with the latest being SP2). Be sure to check the Alfresco documentation for the latest supported version before installing. Lastly, with that in mind, it is always useful to review the Alfresco documentation in order to make sure all settings and configurations are optimized as much as possible:
http://docs.alfresco.com/5.0/tasks/sqlserver-config.html
http://docs.alfresco.com/5.0/concepts/mssql-config-settings.html

Of course this list is not exhaustive and will not solve all performance issues. Let us know any of your own tips and tricks below in the comments.

Filed Under: Alfresco, OpenMigrate Tagged With: Alfresco, OpenMigrate, Transformation

Reader Interactions

Leave a Reply Cancel reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Primary Sidebar

Search

Related Posts

  • Web Content Curating and Publishing (WCM) in Documentum and Alfresco
  • Migrating From Documentum with OpenMigrate: Best Practices
  • Alfresco Content Migrations – An OpenMigrate Update
  • OpenMigrate: Bulk Load Interface Available for Download
  • Migrating to Alfresco – Reducing Risk, Stress and Cost with a Rolling Migration
  • Hadoop – Why Hadoop as a Content Store when Caching Content for ECM Consumers
  • Canadian Museum of Human Rights – Opening Weekend
  • Documentum & Alfresco Migration Strategies – What Factors Should be Considered?
  • NY Philharmonic Digital Archives – 2012 Alfresco Implementation of the Year
  • Alfresco DevCon Wrap Up

Recent Posts

  • Alfresco Content Accelerator and Alfresco Enterprise Viewer – Improving User Collaboration Efficiency
  • Alfresco Content Accelerator – Document Notification Distribution Lists
  • Alfresco Webinar – Productivity Anywhere: How modern claim and policy document processing can help the new work-from-home normal succeed
  • Alfresco – Viewing Annotations on Versions
  • Alfresco Content Accelerator – Collaboration Enhancements
stacks-of-paper

11 BILLION DOCUMENT
BENCHMARK
OVERVIEW

Learn how TSG was able to leverage DynamoDB, S3, ElasticSearch & AWS to successfully migrate 11 Billion documents.

Download White Paper

Footer

Search

Contact

22 West Washington St
5th Floor
Chicago, IL 60602

inquiry@tsgrp.com

312.372.7777

Copyright © 2023 · Technology Services Group, Inc. · Log in

This website uses cookies to improve your experience. Please accept this site's cookies, but you can opt-out if you wish. Privacy Policy ACCEPT | Cookie settings
Privacy & Cookies Policy

Privacy Overview

This website uses cookies to improve your experience while you navigate through the website. Out of these cookies, the cookies that are categorized as necessary are stored on your browser as they are essential for the working of basic functionalities of the website. We also use third-party cookies that help us analyze and understand how you use this website. These cookies will be stored in your browser only with your consent. You also have the option to opt-out of these cookies. But opting out of some of these cookies may have an effect on your browsing experience.
Necessary
Always Enabled
Necessary cookies are absolutely essential for the website to function properly. This category only includes cookies that ensures basic functionalities and security features of the website. These cookies do not store any personal information.
Non-necessary
Any cookies that may not be particularly necessary for the website to function and is used specifically to collect user personal data via analytics, ads, other embedded contents are termed as non-necessary cookies. It is mandatory to procure user consent prior to running these cookies on your website.
SAVE & ACCEPT