Alfresco is een open source ECM-systeem (Enterprise Content Management) geschreven in Java dat elektronisch beheer, samenwerking en bedrijfsbeheer biedt.
Deze handleiding zal behandelen hoe Alfresco Community Edition te installeren en configureren op RHEL/CentOS 7/6, Debian 8 en Ubuntu systemen met Nginx server als frontend webserver voor de applicatie.
Vereisten
Wat betreft de minimale systeemvereisten, heeft Alfresco een machine nodig met minimaal 4 GB aan RAM en een 64-bits besturingssysteem.
Stap 1: Installeer Alfresco Community Edition
1. Voordat u doorgaat met de installatie van Alfresco, zorg er eerst voor dat de wget utility is geïnstalleerd op uw machine door het onderstaande commando met rootrechten of vanuit het rootaccount uit te voeren.
# yum install wget # apt-get install wget
2. Stel vervolgens de systeemhostnaam in en zorg ervoor dat de lokale resolutie naar het IP-adres van uw server verwijst door de volgende commando’s uit te voeren:
# hostnamectl set-hostname server.alfresco.lan # echo “192.168.0.40 server.alfresco.lan” >> /etc/hosts
3. Verwijder elke MTA van de machine (in dit geval Postfix Mailserver) door het onderstaande commando uit te voeren:
# yum remove postfix # apt-get remove postfix
4. Installeer de volgende afhankelijkheden die nodig zijn door de Alfresco-software om correct te kunnen werken:
# yum install fontconfig libSM libICE libXrender libXext cups-libs # apt-get install libice6 libsm6 libxt6 libxrender1 libfontconfig1 libcups2
5. Ga vervolgens naar de repositorypagina van Alfresco Community Edition gehost op de portal van sourceforge.net en pak de nieuwste binaire versie (d.w.z. alfresco-community-5.0.d-installer-linux-x64.bin) voor Linux met behulp van het wget-hulpprogramma.
# wget http://nchc.dl.sourceforge.net/project/alfresco/Alfresco%205.0.d%20Community/alfresco-community-5.0.d-installer-linux-x64.bin
6. Nadat het downloaden van het binaire bestand is voltooid, voer de volgende opdracht uit om uitvoeringsrechten te verlenen voor het bestand en voer de alfresco-installatie uit.
# chmod +x alfresco-community-5.0.d-installer-linux-x64.bin # ./alfresco-community-5.0.d-installer-linux-x64.bin
7. Nadat het installatieproces is gestart, selecteer de taal en ga verder met het installatieproces door de onderstaande installatiewizard te gebruiken als gids om Alfresco te configureren:
[root@server ~]# ./alfresco-community-5.0.d-installer-linux-x64.bin Language Selection Please select the installation language [1] English - English [2] French - Français [3] Spanish - Español [4] Italian - Italiano [5] German - Deutsch [6] Japanese - 日本語 [7] Dutch - Nederlands [8] Russian - Русский [9] Simplified Chinese - 简体中文 [10] Norwegian - Norsk bokmål [11] Brazilian Portuguese - Português Brasileiro Please choose an option [1] :1---------------------------------------------------------------------------- Welcome to the Alfresco Community Setup Wizard. ---------------------------------------------------------------------------- Installation Type [1] Easy - Installs servers with the default configuration [2] Advanced - Configures server ports and service properties.: Also choose optional components to install. Please choose an option [1] :2---------------------------------------------------------------------------- Select the components you want to install; clear the components you do not want to install. Click Next when you are ready to continue. Java [Y/n] :yPostgreSQL [Y/n] :yAlfresco : Y (Cannot be edited) Solr1 [y/N] :nSolr4 [Y/n] :ySharePoint [Y/n] :yWeb Quick Start [y/N] :yGoogle Docs Integration [Y/n] :yLibreOffice [Y/n] :yIs the selection above correct? [Y/n]:y
Alfresco Installatiewizard Gaat Verder…
---------------------------------------------------------------------------- Installation Folder Please choose a folder to install Alfresco Community Select a folder [/opt/alfresco-5.0.d]:[Press Enter key]---------------------------------------------------------------------------- Database Server Parameters Please enter the port of your database. Database Server port [5432]:[Press Enter key]---------------------------------------------------------------------------- Tomcat Port Configuration Please enter the Tomcat configuration parameters you wish to use. Web Server domain: [127.0.0.1]:192.168.0.15Tomcat Server Port: [8080]:[Press Enter keyTomcat Shutdown Port: [8005]:[Press Enter keyTomcat SSL Port [8443]:[Press Enter keyTomcat AJP Port: [8009]:[Press Enter key---------------------------------------------------------------------------- Alfresco FTP Port Please choose a port number to use for the integrated Alfresco FTP server. Port: [21]:[Press Enter key
Alfresco Installatie Gaat Verder…
---------------------------------------------------------------------------- Admin Password Please give a password to use for the Alfresco administrator account. Admin Password: :[Enter a strong password for Admin user]Repeat Password: :[Repeat the password for Admin User]---------------------------------------------------------------------------- Alfresco SharePoint Port Please choose a port number for the SharePoint protocol. Port: [7070]:[Press Enter key]---------------------------------------------------------------------------- Install as a service You can optionally register Alfresco Community as a service. This way it will automatically be started every time the machine is started. Install Alfresco Community as a service? [Y/n]:y---------------------------------------------------------------------------- LibreOffice Server Port Please enter the port that the Libreoffice Server will listen to by default. LibreOffice Server Port [8100]:[Press Enter key]----------------------------------------------------------------------------
Alfresco Installatie Setup Gaat Verder..
---------------------------------------------------------------------------- Setup is now ready to begin installing Alfresco Community on your computer. Do you want to continue? [Y/n]:y---------------------------------------------------------------------------- Please wait while Setup installs Alfresco Community on your computer. Installing 0% ______________ 50% ______________ 100% ######################################### ---------------------------------------------------------------------------- Setup has finished installing Alfresco Community on your computer. View Readme File [Y/n]:nLaunch Alfresco Community Share [Y/n]:ywaiting for server to start....[root@server ~]# done server started /opt/alfresco-5.0.d/postgresql/scripts/ctl.sh : postgresql started at port 5432 Using CATALINA_BASE: /opt/alfresco-5.0.d/tomcat Using CATALINA_HOME: /opt/alfresco-5.0.d/tomcat Using CATALINA_TMPDIR: /opt/alfresco-5.0.d/tomcat/temp Using JRE_HOME: /opt/alfresco-5.0.d/java Using CLASSPATH: /opt/alfresco-5.0.d/tomcat/bin/bootstrap.jar:/opt/alfresco-5.0.d/tomcat/bin/tomcat-juli.jar Using CATALINA_PID: /opt/alfresco-5.0.d/tomcat/temp/catalina.pid Tomcat started. /opt/alfresco-5.0.d/tomcat/scripts/ctl.sh : tomcat started
8. Nadat het installatieproces is voltooid en Alfresco-services zijn gestart, voer de onderstaande opdrachten uit om de volgende firewallpoorten te openen om externe hosts in uw netwerk toe te staan verbinding te maken met de webtoepassing.
# firewall-cmd --add-port=8080/tcp -permanent # firewall-cmd --add-port=8443/tcp -permanent # firewall-cmd --add-port=7070/tcp -permanent # firewall-cmd --reload
Indien u andere firewallregels moet toevoegen om poorten te openen om toegang te krijgen tot aangepaste Alfresco-services, voer het ss-commando uit om een lijst te krijgen van alle services die op uw machine draaien.
# ss -tulpn
9. Om toegang te krijgen tot Alfresco webdiensten, opent u een browser en gebruikt u de volgende URL’s (vervang het IP-adres of domein dienovereenkomstig). Meld u aan met de beheerdergebruiker en het wachtwoord dat is geconfigureerd voor Beheer tijdens het installatieproces.
http://IP-or-domain.tld:8080/share/
http://IP-or-domain.tld:8080/alfresco/
Voor WebDAV.
http://IP-or-domain.tld:8080/alfresco/webdav
Voor HTTPS, accepteer de beveiligingsuitzondering.
https://IP-or-domain.tld:8443/share/
Alfresco SharePoint-module met Microsoft.
http://IP-or-domain.tld:7070/
Stap 2: Configureer Nginx als frontend-webserver voor Alfresco
10. Om de Nginx-server op het systeem te installeren, voegt u eerst Epel Repositories toe aan CentOS/RHEL door het onderstaande commando uit te voeren:
# yum install epel-release
11. Nadat Epel-repos zijn toegevoegd aan het systeem, gaat u verder met de installatie van de Nginx-webserver door het volgende commando uit te voeren:
# yum install nginx [On RHEL/CentOS Systems] # apt-get install nginx [On Debian/Ubuntu Systems]
12. Op de volgende stap opent u het Nginx-configuratiebestand vanuit /etc/nginx/nginx.conf met een teksteditor en maakt u de volgende wijzigingen:
location / {
proxy_pass http://127.0.0.1:8080;
proxy_redirect off;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
Ga hieronder en zorg ervoor dat u de tweede locatieverklaring uitcommentarieert door een # voor de volgende regels te plaatsen:
#location / {
# }
13. Nadat u klaar bent, slaat u het Nginx-configuratiebestand op en sluit u het af en start u de daemon opnieuw op om de wijziging te weerspiegelen door het volgende commando uit te voeren:
# systemctl restart nginx.service
14. Om toegang te krijgen tot de Alfresco-webinterface, voegt u een nieuwe firewallregel toe om poort 80 op uw machine te openen en navigeert u naar de onderstaande URL. Zorg er ook voor dat het Selinux-beleid is uitgeschakeld op RHEL/CentOS-systemen.
# firewall-cmd --add-service=http -permanent # firewall-cmd --reload # setenforce 0
Om het Selinux-beleid volledig uit te schakelen op het systeem, opent u het bestand /etc/selinux/config en stelt u de regel SELINUX in van enforcing naar disabled.
15. Nu kunt u Alfresco benaderen via Nginx.
http://IP-or-domain.tld/share/ http://IP-or-domain.tld/alfresco/ http://IP-or-domain.tld/alfresco/webdav
15. Als u de Alfresco-webinterface veilig wilt bezoeken via Nginx-proxy met SSL, maak dan een zelfondertekend certificaat voor Nginx in de map /etc/nginx/ssl/ en vul het certificaat in met uw aangepaste instellingen zoals geïllustreerd op onderstaande schermafbeelding:
# mkdir /etc/nginx/ssl # cd /etc/nginx/ssl/ # openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout alfresco.key -out alfresco.crt
Let op Certificaat gemeenschappelijke naam om overeen te komen met de domeinnaam van uw hostname.
17. Vervolgens opent u het Nginx-configuratiebestand voor bewerken en voegt u het volgende blok toe vóór de laatste sluitende accolade (het symbool }).
# vi /etc/nginx/nginx.conf
Nginx SSL blok uittreksel:
server {
listen 443;
server_name _;
ssl_certificate /etc/nginx/ssl/alfresco.crt;
ssl_certificate_key /etc/nginx/ssl/alfresco.key;
ssl on;
ssl_session_cache builtin:1000 shared:SSL:10m;
ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
ssl_ciphers HIGH:!aNULL:!eNULL:!EXPORT:!CAMELLIA:!DES:!MD5:!PSK:!RC4;
ssl_prefer_server_ciphers on;
access_log /var/log/nginx/ssl.access.log;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_redirect off;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
## This is the last curly bracket before editing the file.
}
18. Ten slotte herstart u de Nginx-daemon om wijzigingen toe te passen, voegt u een nieuwe firewallregel toe voor poort 443.
# systemctl restart nginx # firewall-cmd -add-service=https --permanent # firewall-cmd --reload
en instrueer de browser naar uw domein-URL met behulp van het HTTPS-protocol.
https://IP_or_domain.tld/share/ https://IP_or_domain.tld/alfresco/
19. Om Alfresco en Nginx-daemons systeembreed in te schakelen, voert u de onderstaande opdracht uit:
# systemctl enable nginx alfresco
Dat is alles! Alfresco biedt integratie met MS Office en LibreOffice via CIFs-protocol, waardoor gebruikers een vertrouwde workflow krijgen.
Source:
https://www.tecmint.com/install-alfresco-community-edition-on-centos-debian-ubuntu/