Skip to main content

Customizing Alfresco Deployments

Customizing Alfresco: how to

In our last post, we talked about how to install and configure Alfresco on an AWS instance. We also learned how to create a simple site and upload documents. But customizing Alfresco can greatly widen your administration and accessibility options, and take you way beyond simple document sharing.

In this post, we will discover how to perform an unattended installation, how to integrate Amazon S3 content storage, and how to access Alfresco-based content using mobile apps and desktop clients.

Unattended Installations

Alfresco Community and Enterprise editions can be installed using Bitrock technology. This helps automate the installation process, allowing for scripted deployments. As a part of the unattended installation procedure, we can either pass command line arguments directly to the Alfresco installer or create an options file with all our requirements. The options file is, in turn, passed along to the installer, allowing us to enable or disable components or specify DB names, users or passwords.

Any setting which is available through your GUI or command line interfaces is also available through an option file. To fetch a list of all available options, pass the –help argument to the installer:

# sudo ./alfresco-community-5.0.c-installer-linux-x64.bin --help

Here’s a sample option file:

mode=unattended
components=javaalfresco,alfrescosharepoint,alfrescowcmqs,libreofficecomponent
disable-components=postgres
# Use JDBC settings for an existing database
jdbc_url=jdbc:postgresql://localhost/alfresco
jdbc_driver=org.postgresql.Driver
jdbc_database=alfresco
jdbc_username=alfresco
jdbc_password=alfresco
# Install location
prefix=/opt/alfresco
# Set Alfresco Administrator Password
alfresco_admin_password=admin123
# Install init scripts
baseunixservice_install_as_service=1

This option file can be saved with any name – say, “option_file” – and can be passed as a command line argument to Alfresco installer.

# sudo ./alfresco-community-5.0.c-installer-linux-x64.bin --optionfile option_file

Customizing Alfresco with Amazon S3 Connector

Alfresco offers multiple modules to help us integrate with other services. Alfresco’s Amazon S3 Connector module, for instance, allows us to store all uploaded documents in an Amazon S3 bucket, providing storage that’s highly durable and far less expensive than using an Amazon EBS volume. It also helps us to decouple storage from our Alfresco share, simplifying horizontal scaling.

According to Alfresco’s documentation:

”Using an Alfresco Module Package, the connector supplies a new content store which replaces the default file system-based implementation for the standard and deleted content stores. The content store implementation is responsible for reading and writing content streams using the S3 API, however, in order to improve performance a local Caching Content Store is used which uses the local disk to cache recently-used content items.”

To install the Amazon S3 Connector, you’ll need to download the module from their Documentation page. Once downloaded, follow these configuration steps:

Step 1: Move the downloaded AMP (Alfresco Module Package) file to the /opt/alfresco/amps folder.

# cp alfresco-s3-connector.amp /opt/alfresco/amps/

Step 2: Go to the /opt/alfresco/bin folder and locate the file apply_amps.sh.
Step 3: Execute apply_amps.sh (you might need to set the file as executable first: chmod +x apply_amps.sh):

# ./apply_amps.sh

This will install the S3 connector module.
Step 4: Once this is done, we’ll need to verify that the module was successfully installed:

# java -jar alfresco-mmt.jar list /opt/alfresco/tomcat/webapps/alfresco.war

Step 5: Now, add the following three lines of integration details to the alfresco-global.properties file (/opt/alfresco/tomcat/shared/classes/alfresco-global.properties)

### S3 Connector Details ###
s3.accessKey=<your-access-key>
s3.secretKey=<your-secret-access-key>
s3.bucketName=<S3-Bucket-Name>

Note: configuration might require single you to enclose your keys in either single or double quotes.
That’s it. Amazon S3 Connector for Alfresco is now configured and ready for use. Once we upload content to our Alfresco share, all content will be saved into our S3 Bucket.

Customizing Alfresco: Mobile Apps and Addons

Alfresco offers iOS and Android mobile apps for accessing our Alfresco share. These apps are very helpful when we want to quickly review a document and pass along feedback.

Apart from Alfresco mobile apps, Alfresco also offers addons, a place to find customizations, extensions and related projects for your Alfresco installations. Alfresco Desktop sync is a desktop client that allows us to sync all our Alfresco documents directly to our local system. Think of this as similar to Dropbox or Google Drive desktop clients. Alfresco Desktop Clients are supported on Windows and OS X operating systems.

Windows Easy Sync – Desktop Synchronization for Alfresco is another addon that acts as an embedded Alfresco Explorer for browsing the repository contents. Users can view, download, create, edit, move, or delete Alfresco documents or spaces directly on the server. The “Edit with WebDav” feature allows online editing of Alfresco contents with local client editors.

The possible options for customizing Alfresco through available integrations/add-ons/modules make for a very powerful enterprise content management system, allowing us to easily collaborate with a higher degree of control. In future blog posts, we will learn more about Alfresco’s internal workings.

Avatar

Written by

Sanket Dangi

Head of Managed Services at REAN Cloud. Before joining REAN Cloud, I was CEO and Founder of StraightArc Solutions which was later acquired by REAN Cloud.I started my career working on cloud computing. Loves to talk about DevOps, System Administration, Scalability, High Availability, Disaster Recovery and Cloud Security. Apart from work, I love to meet people, travel and watch sports.

Related Posts

Avatar
John Chell
— June 13, 2019

AWS Certified Solutions Architect Associate: A Study Guide

The AWS Solutions Architect - Associate Certification (or Sol Arch Associate for short) offers some clear benefits: Increases marketability to employers Provides solid credentials in a growing industry (with projected growth of as much as 70 percent in five years) Market anal...

Read more
  • AWS
  • AWS Certifications
Chris Gambino and Joe Niemiec
Chris Gambino and Joe Niemiec
— June 11, 2019

Moving Data to S3 with Apache NiFi

Moving data to the cloud is one of the cornerstones of any cloud migration. Apache NiFi is an open source tool that enables you to easily move and process data using a graphical user interface (GUI).  In this blog post, we will examine a simple way to move data to the cloud using NiFi c...

Read more
  • AWS
  • S3
Avatar
Chandan Patra
— June 11, 2019

Amazon DynamoDB: 10 Things You Should Know

Amazon DynamoDB is a managed NoSQL service with strong consistency and predictable performance that shields users from the complexities of manual setup.Whether or not you've actually used a NoSQL data store yourself, it's probably a good idea to make sure you fully understand the key ...

Read more
  • AWS
  • DynamoDB
Avatar
Andrew Larkin
— June 6, 2019

The 11 AWS Certifications: Which is Right for You and Your Team?

As companies increasingly shift workloads to the public cloud, cloud computing has moved from a nice-to-have to a core competency in the enterprise. This shift requires a new set of skills to design, deploy, and manage applications in cloud computing.As the market leader and most ma...

Read more
  • AWS
  • AWS Certifications
Sam Ghardashem
Sam Ghardashem
— May 15, 2019

Aviatrix Integration of a NextGen Firewall in AWS Transit Gateway

Learn how Aviatrix’s intelligent orchestration and control eliminates unwanted tradeoffs encountered when deploying Palo Alto Networks VM-Series Firewalls with AWS Transit Gateway.Deploying any next generation firewall in a public cloud environment is challenging, not because of the f...

Read more
  • AWS
Joe Nemer
Joe Nemer
— May 3, 2019

AWS Config Best Practices for Compliance

Use AWS Config the Right Way for Successful ComplianceIt’s well-known that AWS Config is a powerful service for monitoring all changes across your resources. As AWS Config has constantly evolved and improved over the years, it has transformed into a true powerhouse for monitoring your...

Read more
  • AWS
  • Compliance
Avatar
Francesca Vigliani
— April 30, 2019

Cloud Academy is Coming to the AWS Summits in Atlanta, London, and Chicago

Cloud Academy is a proud sponsor of the 2019 AWS Summits in Atlanta, London, and Chicago. We hope you plan to attend these free events that bring the cloud computing community together to connect, collaborate, and learn about AWS. These events are all about learning. You can learn how t...

Read more
  • AWS
  • AWS Summits
Paul Hortop
Paul Hortop
— April 2, 2019

How to Monitor Your AWS Infrastructure

The AWS cloud platform has made it easier than ever to be flexible, efficient, and cost-effective. However, monitoring your AWS infrastructure is the key to getting all of these benefits. Realizing these benefits requires that you follow AWS best practices which constantly change as AWS...

Read more
  • AWS
  • Monitoring
Joe Nemer
Joe Nemer
— April 1, 2019

AWS EC2 Instance Types Explained

Amazon Web Services’ resource offerings are constantly changing, and staying on top of their evolution can be a challenge. Elastic Cloud Compute (EC2) instances are one of their core resource offerings, and they form the backbone of most cloud deployments. EC2 instances provide you with...

Read more
  • AWS
  • EC2
Avatar
Nitheesh Poojary
— March 26, 2019

How DNS Works – the Domain Name System (Part One)

Before migrating domains to Amazon's Route53, we should first make sure we properly understand how DNS worksWhile we'll get to AWS's Route53 Domain Name System (DNS) service in the second part of this series, I thought it would be helpful to first make sure that we properly understand...

Read more
  • AWS
Avatar
Stuart Scott
— March 14, 2019

Multiple AWS Account Management using AWS Organizations

As businesses expand their footprint on AWS and utilize more services to build and deploy their applications, it becomes apparent that multiple AWS accounts are required to manage the environment and infrastructure.  A multi-account strategy is beneficial for a number of reasons as ...

Read more
  • AWS
  • Identity Access Management
Avatar
Sanket Dangi
— February 11, 2019

WaitCondition Controls the Pace of AWS CloudFormation Templates

AWS's WaitCondition can be used with CloudFormation templates to ensure required resources are running.As you may already be aware, AWS CloudFormation is used for infrastructure automation by allowing you to write JSON templates to automatically install, configure, and bootstrap your ...

Read more
  • AWS
  • CloudFormation