Kako instalirati Alfresco Community Edition na RHEL/CentOS 7/6 i Debian 8


Alfresco je ECM sistem otvorenog koda (Enterprise Content Management) napisan na Javi koji pruža elektronsko upravljanje, saradnju i kontrolu poslovanja.

Ovaj vodič će pokriti kako instalirati i konfigurirati Alfresco Community Edition na RHEL/CentOS 7/6, Debian 8 i Ubuntu jaki> sistemi sa Nginx serverom kao frontend web serverom za aplikaciju.

Zahtjevi

Što se tiče minimalnih sistemskih zahtjeva, Alfresco treba mašina sa najmanje 4 GB RAM-a i 64-bitnim operativnim sistemom.

Korak 1: Instalirajte Alfresco Community Edition

1. Pre nego što nastavite sa Alfresco instalacijom, prvo se uverite da je wget uslužni program instaliran na vašem računaru tako što ćete izdati donju komandu sa root privilegijama ili sa root naloga.

yum install wget
apt-get install wget

2. Zatim postavite ime vašeg sistema i uvjerite se da lokalna rezolucija ukazuje na IP adresu vašeg servera izdavanjem sljedećih naredbi:

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

3. Uklonite sve MTA sa mašine (u ovom slučaju Postfix Mail server) izdavanjem naredbe ispod:

yum remove postfix
apt-get remove postfix

4. Instalirajte sljedeće ovisnosti koje zahtijeva Alfresco softver kako bi ispravno radio:

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

5. Zatim idite na stranicu spremišta Alfresco Community Edition koja se nalazi na portalu sourceforge.net i uzmite najnoviju binarnu verziju (tj. alfresco-community-5.0.d-installer-linux-x64.bin ) za Linux pomoću uslužnog programa wget.

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

6. Nakon što se preuzimanje binarne datoteke završi, izdajte sljedeću naredbu kako biste dodijelili dozvole za izvršavanje za datoteku i pokrenuli alfresco installer.

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

7. Nakon što započne proces instalacije, odaberite jezik i nastavite proces instalacije koristeći donji čarobnjak za instalaciju kao vodič za konfiguraciju Alfresco:

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

Alfresco čarobnjak za instalaciju se nastavlja….

----------------------------------------------------------------------------
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 instalacija se nastavlja…

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

----------------------------------------------------------------------------

Postavljanje Alfresco instalacije se nastavlja..

----------------------------------------------------------------------------
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....[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. Nakon završetka procesa instalacije i pokretanja Alfresco usluga izdajte donje naredbe kako biste otvorili sljedeće portove zaštitnog zida i omogućili vanjskim hostovima u vašoj mreži da se povežu na web aplikaciju.


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

U slučaju da trebate dodati druga pravila zaštitnog zida na otvorene portove da biste pristupili prilagođenim Alfresco uslugama, izdajte naredbu ss da biste dobili listu svih servisa koji rade na vašem računalu.

ss -tulpn

9. Za pristup Alfresco web uslugama, otvorite pretraživač i koristite sljedeće URL-ove (zamijenite IP adresu ili domenu u skladu s tim). Prijavite se s administratorskim korisnikom i lozinkom konfiguriranom za Admin kroz proces instalacije.

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

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

Za WebDAV.

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

Za HTTPS prihvatite sigurnosni izuzetak.

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

Alfresco SharePoint modul sa Microsoftom.

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

Korak 2: Konfigurišite Nginx kao Frontend Web server za Alfresco

10. Da biste instalirali Nginx server na sistem, prvo dodajte Epel Repositories na CentOS/RHEL izdavanjem donje naredbe:

yum install epel-release

11. Nakon što se Epel repo dodaju u sistem, nastavite sa instalacijom Nginx web servera izdavanjem sljedeće naredbe:

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

12. U sljedećem koraku otvorite Nginx konfiguracijsku datoteku iz /etc/nginx/nginx.conf pomoću uređivača teksta i napravite sljedeće promjene:

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

Idite dolje i provjerite jeste li komentirali drugu izjavu o lokaciji tako što ćete staviti # ispred sljedećih redaka:

#location / {
       }

13. Nakon što završite, sačuvajte i zatvorite Nginx konfiguracijsku datoteku i ponovo pokrenite demon da odrazite promjenu izdavanjem sljedeće naredbe:

systemctl restart nginx.service

14. Da biste pristupili Alfresco web interfejsu, dodajte novo pravilo zaštitnog zida za otvaranje porta 80 na vašem računaru i idite na URL u nastavku. Također, provjerite je li politika Selinuxa onemogućena na RHEL/CentOS sistemima.

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

Da biste potpuno onemogućili Selinux politiku na sistemu, otvorite datoteku /etc/selinux/config i postavite liniju SELINUX iz primjena na disabled.

15. Sada možete pristupiti Alfresco preko Nginxa.

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

15. U slučaju da želite sigurno posjetiti Alfresco web sučelje putem Nginx proxyja sa SSL-om, kreirajte samopotpisani certifikat za Nginx u /etc/nginx/ssl/ direktoriju i ispunite certifikat svojim prilagođenim postavkama kao što je prikazano na slici ispod:

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

Obratite pažnju na Certificate Common Name da se podudara s imenom hosta vaše domene.

17. Zatim otvorite Nginx konfiguracijsku datoteku za uređivanje i dodajte sljedeći blok prije zadnjeg zatvaranja vitičaste zagrade (simbol }).

vi /etc/nginx/nginx.conf

Nginx SSL blok izvod:

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. Konačno, ponovo pokrenite Nginx demon da biste primijenili promjene, dodajte novo pravilo zaštitnog zida za 443 port.

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

i uputite pretraživač na URL vaše domene koristeći HTTPS protokol.

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

19. Da biste omogućili Alfresco i Nginx demone širom sistema, pokrenite naredbu ispod:

systemctl enable nginx alfresco

To je sve! Alfresco nudi integraciju sa MS Office i LibreOffice putem CIFs protokola pružajući korisnicima poznat tok rada.