Alfresco Installation Guide
Author Anton Sokolov
Last Changed 12.12.2018
File name alfresco_installation_guide
Reviewer Sergey Palyukh
Customer 1simple1
Phone: +38(098)-240-00-763
E-mail: [email protected]
Website: www.flex-solution.com
1
Table of Contents
Overview……………………………………………………………………………...3
Download…….……………………………………………………………………….3
Prepare installer……………………………………………………………………….3
Installation process……………………………………………………………………4
Configure Alfresco …………………………………………..……………………….8
Setup FTP …………......……………………………………………………………...8
Setup Outbound Email .................................................................................................9
Setup Inbound Email ....................................................................................................9
Setup IMAP………….................................................................................................10
Start/Stop/Restart Alfresco……..................................................................................11
Setup CIFS…………………………………………………………………………...11
Setup E-mail Notifier...................................................................................................11
Install the theme...........................................................................................................13
Install Nginx................................................................................................................13
Configure Nginx …………………………………………………………………….14
Install Certbot ……………………………………………………………………….15
Configuring SSL certificate………………………………………………………….15
Set up the theme in Alfresco…………………………………………………………16
Update email templates ………………………………………………………..……19
Important Notes ……………………………………………………………………..19
Phone: +38(098)-240-00-763
E-mail: [email protected]
Website: www.flex-solution.com
2
Overview
The setup wizard installs all the components necessary for running Alfresco
content services. Application will be running inside Tomcat container and connected
to Postgres database
Downloads
You can download the installer file from the sourceforge:
https://netcologne.dl.sourceforge.net/project/alfresco/Alfresco%20201707%20Comm
unity/alfresco-community-installer-201707-linux-x64.bin
You can download file by using wget application directly from the linux
terminal :
`wget
https://netcologne.dl.sourceforge.net/project/alfresco/Alfresco%20201707%20Community/alfresco-
community-installer-201707-linux-x64.bin`
Prepare installer
To make the file executable in the terminal, run the following command:
Phone: +38(098)-240-00-763
E-mail: [email protected]
Website: www.flex-solution.com
3
`chmod +x ./ alfresco-community-installer-201707-linux-x64.bin`
Execute the downloaded file using the following command:
`sudo ./alfresco-community-installer-201707-linux-x64.bin`
Installation process
1. Select the language that you wish to use for the installation. This sets the
language to be used for the setup wizard, server logs, etc
2. Installation type.
Select installation type - «Advanced»
3. Select the components you want to install:
Phone: +38(098)-240-00-763
E-mail: [email protected]
Website: www.flex-solution.com
4
4. Choose a folder to install Alfresco Community.
Select path to a folder. By default, it's «opt/alfresco-community», where
«alfresco-community» - it's naming a folder where about will install Alfresco.
You can enter the desired path and own name a folder for Alfresco.
5. Enter the port of you database, for «PostgeSQL» by default – 5432.
6. Tomcat port configuration (web server domain, tomcat server port, tomcat
shutdown port, tomcat SSL port, tomcat AJP port). Before choosing, it is necessary to
check if the default ports are free command («ss -ln src :YOUR_PORT»), if the
Phone: +38(098)-240-00-763
E-mail: [email protected]
Website: www.flex-solution.com
5
default ones are free, you can simply click «Enter» in the following paragraphs,
otherwise enter the numbers of free ports. By default:
1. Web Server Domain: [127.0.0.1]:
2. Tomcat Server Port: [8080]:
3. Tomcat Shutdown Port: [8005]:
4. Tomcat SSL Port: [8443]:
5. Tomcat AJP Port: [8009]:
7. Enter the port that the LibreOffice Server will listen to, can be left as default
«8100».
Phone: +38(098)-240-00-763
E-mail: [email protected]
Website: www.flex-solution.com
6
8. Choose a port number for the FTP server. Default port is 21
9. Specify a password for the Alfresco Content Service administrator account.
10. If you register Alfresco Community as a service it will automatically start
Alfresco Community on machine startup
11. Press enter to continue installing.
12. Please wait the finish of installation.
Phone: +38(098)-240-00-763
E-mail: [email protected]
Website: www.flex-solution.com
7
13. After install, next steps can be to cancel.
1. View Readme File: No
2. Launch Alfresco Community: No
14. That’s all. Alfresco is installed
Configure Alfresco
All configurations should be added to alfresco-global.properties file that is stored by
the following path: «/opt/YOUR_ALFRESCO/tomcat/shared/classes», you can
open it by using any text editor.
Setup FTP
Add the following properties to alfresco-global.properties file:
1. ftp.enabled=true
2. ftp.dataPortFrom=21000
3. ftp.dataPortTo=21500
4. ftp.ipv6.enabled=false
Phone: +38(098)-240-00-763
E-mail: [email protected]
Website: www.flex-solution.com
8
Setup Outbound Email
Add the following properties to alfresco-global.properties file:
1. mail.host=ssl0.ovh.net
2. mail.port=465
3. [email protected]
4. mail.password=XEQh8u9uZQzxfa
5. mail.protocol=smtps
6. mail.smtps.starttls.enable=true
7. mail.smtps.auth=true
8. mail.from.enabled=false
9. [email protected]
Setup Inbound Email
Add the following properties to alfresco-global.properties file:
1. email.inbound.enabled=true
2. email.inbound.unknownUser=admin
3. email.server.enabled=true
4. email.server.port=25
5. email.server.domain=archico.1simple1.com
6. email.server.connections.max=10
7. email.server.auth.enabled=true
8. email.server.hideTLS=true
9. email.server.enableTLS=true
Phone: +38(098)-240-00-763
E-mail: [email protected]
Website: www.flex-solution.com
9
10.email.server.requireTLS=false
11.email.handler.folder.overwriteDuplicates=true
Setup IMAP
Add the following properties to alfresco-global.properties file:
1. imap.server.enabled=true
2. imap.server.port=143
3. imap.server.host=0.0.0.0
4. imap.server.attachments.extraction.enabled=true
Phone: +38(098)-240-00-763
E-mail: [email protected]
Website: www.flex-solution.com
10
Start/Stop/Restart Alfresco
Execute one of the commands:
`/opt/YOUR_ALFRESCO/alfresco.sh start`
`/opt/YOUR_ALFRESCO/alfresco.sh stop`
`/opt/YOUR_ALFRESCO/alfresco.sh restart`
Setup CIFS
Add the following properties to alfresco-global.properties file:
Setup E-mail Notifier
Add the following properties to alfresco-global.properties file:
1. activities.feed.max.size=100
2. activities feed.max.ageMins=44640
3. activities.feed.notifier.startDelayMins=${system.cronJob.startDelayMinutes}
4. activities.feed.notifier.cronExpression=0 0 1 * * ?
5. activities.feed.notifier.enabled=true
6.
«activities.feed.notifier.cronExpression=0 0 1 * * ?» - activates email
notifications at 00:00 on day-of-month 1.
Phone: +38(098)-240-00-763
E-mail: [email protected]
Website: www.flex-solution.com
11
Phone: +38(098)-240-00-763
E-mail: [email protected]
Website: www.flex-solution.com
12
Install the theme
1. Copy `1simple_archico-1.0.amp` file into `/opt/YOUR_ALFRESCO/amps_share`
folder.
2. Execute the following command `/opt/ YOUR_ALFRESCO/bin/apply_amps.sh -
force`
Install Nginx
Install nginx, check whether installed nginx «nginx -v», for install use next
commands:
1. sudo apt-get update
2. sudo apt-get install nginx
If the nginx is installed successfully:
Phone: +38(098)-240-00-763
E-mail: [email protected]
Website: www.flex-solution.com
13
Configure Nginx
1. Create new file called “1simple1.conf” in the `/etc/nginx/sites-available`
folder
2. Add the following content into the file `1simple1.conf`, but set the
hostname that you configured for Alfresco:
3. Create the link to config file by executing the following command:
`sudo ln -s /etc/nginx/sites-available/1simple1.conf /etc/nginx/sites-
enabled`
Phone: +38(098)-240-00-763
E-mail: [email protected]
Website: www.flex-solution.com
14
Install Certbot
Install certbot, check whether installed certbot «certbot --version», for install
use next commands:
1. sudo apt-get update
2. sudo apt-get install software-properties-common
3. sudo add-apt-repository universe
4. sudo add-apt-repository ppa:certbot/certbot
5. sudo apt-get update
6. sudo apt-get install python-certbot-nginx
If the certbot is installed successfully:
Configuring SSL certificate
Execute the command:
`sudo certbot --nginx`
And answer to the questions
Phone: +38(098)-240-00-763
E-mail: [email protected]
Website: www.flex-solution.com
15
Restart Nginx:
`sudo service nginx reload`
Set up the theme in Alfresco
Login to the Alfresco
Go to «Admin Tools»:
Phone: +38(098)-240-00-763
E-mail: [email protected]
Website: www.flex-solution.com
16
Choose our theme and click to button «Apply»:
As a result we have configured theme and successfully apply it:
Phone: +38(098)-240-00-763
E-mail: [email protected]
Website: www.flex-solution.com
17
Phone: +38(098)-240-00-763
E-mail: [email protected]
Website: www.flex-solution.com
18
Update email templates
1. Login to Alfresco and go to Repository > Data Dictionary > Email Templates
2. Use one of the following actions to edit email templates
Important Notes
1. Alfresco should be stopped while configuration and applying the theme
2. Alfresco should be running while configuration of Nginx
Phone: +38(098)-240-00-763
E-mail: [email protected]
Website: www.flex-solution.com
19
