Sådan installeres Alfresco Community Edition på RHEL/CentOS 7/6 og Debian 8


Alfresco er et open source ECM-system (Enterprise Content Management) skrevet i Java, der giver elektronisk styring, samarbejde og forretningskontrol.

Denne vejledning vil dække, hvordan du installerer og konfigurerer Alfresco Community Edition på RHEL/CentOS 7/6, Debian 8 og Ubuntu-systemer med Nginx-server som en frontend-webserver til applikationen.

Med hensyn til de minimale systemkrav har Alfresco brug for en maskine med mindst 4 GB RAM og et 64-bit operativsystem.

Trin 1: Installer Alfresco Community Edition

1. Før du fortsætter med Alfresco-installationen, skal du først sikre dig, at wget-værktøjet er installeret på din maskine ved at udstede kommandoen nedenfor med root-rettigheder eller fra root-konto.

# yum install wget
# apt-get install wget

2. Dernæst skal du konfigurere dit systemværtsnavn og sikre, at lokal opløsning peger på din server IP-adresse ved at udstede følgende kommandoer:

# hostnamectl set-hostname server.alfresco.lan
# echo “192.168.0.40 server.alfresco.lan” >> /etc/hosts

3. Fjern enhver MTA fra maskinen (i dette tilfælde Postfix Mail-server) ved at udstede nedenstående kommando:

# yum remove postfix
# apt-get remove postfix

4. Installer følgende afhængigheder, der kræves af Alfresco-softwaren for at køre korrekt:

# yum install fontconfig libSM libICE libXrender libXext cups-libs
# apt-get install libice6 libsm6 libxt6 libxrender1 libfontconfig1 libcups2

5. Gå derefter til wget-værktøjet.

# wget http://nchc.dl.sourceforge.net/project/alfresco/Alfresco%205.0.d%20Community/alfresco-community-5.0.d-installer-linux-x64.bin

6. Når den binære filoverførsel er færdig, skal du udstede følgende kommando for at give eksekveringstilladelser til filen og køre alfresco-installationsprogrammet.

# chmod +x alfresco-community-5.0.d-installer-linux-x64.bin
# ./alfresco-community-5.0.d-installer-linux-x64.bin

7. Når installationsprocessen starter, skal du vælge sprog og fortsætte installationsprocessen ved hjælp af nedenstående installationsguide som en guide til konfiguration af Alfresco:

 ./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] :y

PostgreSQL [Y/n] :y

Alfresco : Y (Cannot be edited)

Solr1 [y/N] : n

Solr4 [Y/n] :y

SharePoint [Y/n] :y

Web Quick Start [y/N] : y

Google Docs Integration [Y/n] :y

LibreOffice [Y/n] :y

Is the selection above correct? [Y/n]: y

Installationsguiden til Alfresco fortsætter….

----------------------------------------------------------------------------
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.15 

Tomcat Server Port: [8080]: [Press Enter key

Tomcat Shutdown Port: [8005]: [Press Enter key

Tomcat SSL Port [8443]: [Press Enter key

Tomcat 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-installationen fortsætter ...

----------------------------------------------------------------------------
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 Installation Setup fortsætter ..

----------------------------------------------------------------------------
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]: n

Launch Alfresco Community Share [Y/n]: y

waiting for server to start....  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. Når installationen er afsluttet, og Alfresco-tjenester er startet, skal du udstede nedenstående kommandoer for at åbne følgende firewall-porte, så eksterne værter i dit netværk kan oprette forbindelse til webapplikationen.

# firewall-cmd --add-port=8080/tcp -permanent
# firewall-cmd --add-port=8443/tcp -permanent
# firewall-cmd --add-port=7070/tcp -permanent
# firewall-cmd --reload

Hvis du skal tilføje andre firewallregler for at åbne porte for at få adgang til brugerdefinerede Alfresco-tjenester, skal du udstede kommandoen ss for at få en liste over alle de tjenester, der kører på din maskine.

# ss -tulpn

9. For at få adgang til Alfresco-webtjenester skal du åbne en browser og bruge følgende URL'er (udskift IP-adressen eller domænet i overensstemmelse hermed). Log ind med administratorbruger og adgangskoden konfigureret til administrator gennem installationsprocessen.

http://IP-or-domain.tld:8080/share/ 
http://IP-or-domain.tld:8080/alfresco/ 

Til WebDAV.

http://IP-or-domain.tld:8080/alfresco/webdav 

Accepter sikkerhedsundtagelsen for HTTPS.

https://IP-or-domain.tld:8443/share/ 

Alfresco SharePoint-modul med Microsoft.

http://IP-or-domain.tld:7070/

Trin 2: Konfigurer Nginx som Frontend-webserver til Alfresco

10. For at installere Nginx-serveren på systemet skal du først tilføje Epel Repositories på CentOS/RHEL ved at udstede nedenstående kommando:

# yum install epel-release

11. Når Epel repos er tilføjet i systemet, skal du fortsætte med installationen af Nginx webserver ved at udstede følgende kommando:

# yum install nginx       [On RHEL/CentOS Systems]
# apt-get install nginx   [On Debian/Ubuntu Systems]  

12. På det næste trin skal du åbne Nginx-konfigurationsfil fra /etc/nginx/nginx.conf med en teksteditor og foretage følgende ændringer:

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;
    }

Gå nedenfor og sørg for at kommentere den anden placeringserklæring ved at placere et # foran følgende linjer:

#location / {
#        }

13. Når du er færdig, skal du gemme og lukke Nginx-konfigurationsfilen og genstarte dæmonen for at afspejle ændring ved at udstede følgende kommando:

# systemctl restart nginx.service

14. For at få adgang til Alfresco webgrænseflade skal du tilføje en ny firewallregel for at åbne port 80 på din maskine og navigere til nedenstående URL. Sørg også for, at Selinux-politik er deaktiveret på RHEL/CentOS-systemer.

# firewall-cmd --add-service=http -permanent
# firewall-cmd --reload
# setenforce 0

For fuldstændigt at deaktivere Selinux-politikken på systemet skal du åbne /etc/selinux/config -filen og indstille linjen SELINUX fra håndhævelse til deaktiveret .

15. Nu kan du få adgang til Alfresco gennem Nginx.

 http://IP-or-domain.tld/share/ 
 http://IP-or-domain.tld/alfresco/
 http://IP-or-domain.tld/alfresco/webdav 

15. Hvis du sikkert vil besøge Alfresco-webgrænsefladen via Nginx-proxy med SSL, skal du oprette et selvsigneret certifikat til Nginx i /etc/nginx/ssl/ -mappen og udfylde certifikatet med dine brugerdefinerede indstillinger som illustreret på nedenstående skærmbillede:

# mkdir /etc/nginx/ssl
# cd /etc/nginx/ssl/
# openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout alfresco.key -out alfresco.crt

Vær opmærksom på Certificate Common Name for at matche dit domænehostnavn.

17. Åbn derefter Nginx-konfigurationsfilen til redigering, og tilføj følgende blok inden den sidste lukkede krøllede parentes (symbolet } ).

# vi /etc/nginx/nginx.conf

Nginx SSL-blok uddrag:

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. Til sidst skal du genstarte Nginx-dæmonen for at anvende ændringer, tilføje en ny firewallregel til 443-port.

# systemctl restart nginx
# firewall-cmd -add-service=https --permanent
# firewall-cmd --reload

og instruer browseren til dit domæne URL ved hjælp af HTTPS-protokollen.

https://IP_or_domain.tld/share/
https://IP_or_domain.tld/alfresco/

19. Kør nedenstående kommando for at aktivere Alfresco og Nginx-dæmoner i hele systemet:

# systemctl enable nginx alfresco

Det er alt! Alfresco tilbyder integration med MS Office og LibreOffice via CIFs-protokol, der giver en velkendt arbejdsgang til brugerne.