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.
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):
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
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.
New Content: AWS Terraform, Java Programming Lab Challenges, Azure DP-900 & DP-300 Certification Exam Prep, Plus Plenty More Amazon, Google, Microsoft, and Big Data Courses
This month our Content Team continues building the catalog of courses for everyone learning about AWS, GCP, and Microsoft Azure. In addition, this month’s updates include several Java programming lab challenges and a couple of courses on big data. In total, we released five new learning...
Where Should You Be Focusing Your AWS Security Efforts?
Another day, another re:Invent session! This time I listened to Stephen Schmidt’s session, “AWS Security: Where we've been, where we're going.” Amongst covering the highlights of AWS security during 2020, a number of newly added AWS features/services were discussed, including: AWS Audit...
AWS re:Invent: 2020 Keynote Top Highlights and More
We’ve gotten through the first five days of the special all-virtual 2020 edition of AWS re:Invent. It’s always a really exciting time for practitioners in the field to see what features and services AWS has cooked up for the year ahead. This year’s conference is a marathon and not a...
WARNING: Great Cloud Content Ahead
At Cloud Academy, content is at the heart of what we do. We work with the world’s leading cloud and operations teams to develop video courses and learning paths that accelerate teams and drive digital transformation. First and foremost, we listen to our customers’ needs and we stay ahea...
Excelling in AWS, Azure, and Beyond – How Danut Prisacaru Prepares for the Future
Meet Danut Prisacaru. Danut has been a Software Architect for the past 10 years and has been involved in Software Engineering for 30 years. He’s passionate about software and learning, and jokes that coding is basically the only thing he can do well (!). We think his enthusiasm shines t...
New Content: AWS Data Analytics – Specialty Certification, Azure AI-900 Certification, Plus New Learning Paths, Courses, Labs, and More
This month our Content Team released two big certification Learning Paths: the AWS Certified Data Analytics - Speciality, and the Azure AI Fundamentals AI-900. In total, we released four new Learning Paths, 16 courses, 24 assessments, and 11 labs. New content on Cloud Academy At any ...
New Content: Azure DP-100 Certification, Alibaba Cloud Certified Associate Prep, 13 Security Labs, and Much More
This past month our Content Team served up a heaping spoonful of new and updated content. Not only did our experts release the brand new Azure DP-100 Certification Learning Path, but they also created 18 new hands-on labs — and so much more! New content on Cloud Academy At any time, y...
AWS Certification Practice Exam: What to Expect from Test Questions
If you’re building applications on the AWS cloud or looking to get started in cloud computing, certification is a way to build deep knowledge in key services unique to the AWS platform. AWS currently offers 12 certifications that cover major cloud roles including Solutions Architect, De...
Overcoming Unprecedented Business Challenges with AWS
From auto-scaling applications with high availability to video conferencing that’s used by everyone, every day — cloud technology has never been more popular or in-demand. But what does this mean for experienced cloud professionals and the challenges they face as they carve out a new p...
Constant Content: Cloud Academy’s Q3 2020 Roadmap
Hello — Andy Larkin here, VP of Content at Cloud Academy. I am pleased to release our roadmap for the next three months of 2020 — August through October. Let me walk you through the content we have planned for you and how this content can help you gain skills, get certified, and...
New Content: Alibaba, Azure AZ-303 and AZ-304, Site Reliability Engineering (SRE) Foundation, Python 3 Programming, 16 Hands-on Labs, and Much More
This month our Content Team did an amazing job at publishing and updating a ton of new content. Not only did our experts release the brand new AZ-303 and AZ-304 Certification Learning Paths, but they also created 16 new hands-on labs — and so much more! New content on Cloud Academy At...
Blog Digest: Which Certifications Should I Get?, The 12 Microsoft Azure Certifications, 6 Ways to Prevent a Data Breach, and More
This month, we were excited to announce that Cloud Academy was recognized in the G2 Summer 2020 reports! These reports highlight the top-rated solutions in the industry, as chosen by the source that matters most: customers. We're grateful to have been nominated as a High Performer in se...