Kako namestiti Alfresco Community Edition na RHEL/CentOS 7/6 in Debian 8


Alfresco je odprtokodni sistem ECM (Enterprise Content Management), napisan v Javi, ki zagotavlja elektronsko upravljanje, sodelovanje in nadzor poslovanja.

Ta priročnik bo opisal, kako namestiti in konfigurirati izdajo Alfresco Community Edition na sisteme RHEL/CentOS 7/6, Debian 8 in Ubuntu s strežnikom Nginx kot čelnim spletnim strežnikom za aplikacijo.

Kar zadeva minimalne sistemske zahteve, Alfresco potrebuje stroj z vsaj 4 GB RAM-a in 64-bitnim operacijskim sistemom.

1. korak: Namestite Alfresco Community Edition

1. Preden nadaljujete z namestitvijo Alfresca, najprej zagotovite, da je na vaši napravi nameščen pripomoček wget, tako da izdate spodnji ukaz s korenskimi pravicami ali iz korenskega računa.

# yum install wget
# apt-get install wget

2. Nato nastavite sistemsko ime gostitelja in zagotovite, da lokalna ločljivost kaže na naslov IP vašega strežnika, tako da izdate naslednje ukaze:

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

3. Odstranite morebitne MTA iz naprave (v tem primeru strežnik Postfix Mail), tako da izdate spodnji ukaz:

# yum remove postfix
# apt-get remove postfix

4. Za pravilno delovanje namestite naslednje odvisnosti, ki jih zahteva programska oprema Alfresco:

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

5. Nato pojdite na pripomoček wget.

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

6. Ko se prenos binarne datoteke konča, izdajte naslednji ukaz, da dodelite dovoljenja za izvajanje datoteke in zaženite namestitveni program alfresco.

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

7. Ko se postopek namestitve začne, izberite jezik in nadaljujte postopek namestitve s pomočjo spodnjega čarovnika za namestitev kot vodilo za konfiguriranje Alfresca:

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

Čarovnik za namestitev Alfresca se nadaljuje….

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

Namestitev Alfresca se nadaljuje…

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

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

Namestitev Alfresca se nadaljuje ..

----------------------------------------------------------------------------
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. Ko se postopek namestitve konča in se začnejo storitve Alfresco, izdajte spodnje ukaze, da odprete naslednja vrata požarnega zidu, da omogočite zunanjim gostiteljem v vašem omrežju, da se povežejo s spletno aplikacijo.

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

Če boste morali za odpiranje vrat dodati druga pravila požarnega zidu, da boste lahko dostopali do storitev Alfresco po meri, izdajte ukaz ss , da dobite seznam vseh storitev, ki se izvajajo v vaši napravi.

# ss -tulpn

9. Za dostop do spletnih storitev Alfresco odprite brskalnik in uporabite naslednje URL-je (ustrezno zamenjajte naslov IP ali domeno). V postopku namestitve se prijavite z skrbniškim uporabnikom in geslom, konfiguriranim za skrbnika.

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 sprejmite varnostno izjemo.

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

Modul Alfresco SharePoint z Microsoftom.

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

2. korak: Konfigurirajte Nginx kot spletni strežnik za Alfresco

10. Če želite v sistem namestiti strežnik Nginx, najprej dodajte Epel Repositories na CentOS/RHEL tako, da izdate spodnji ukaz:

# yum install epel-release

11. Po dodajanju repolov Epel v sistem nadaljujte z namestitvijo spletnega strežnika Nginx z izdajo naslednjega ukaza:

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

12. V naslednjem koraku odprite konfiguracijsko datoteko Nginx iz /etc/nginx/nginx.conf z urejevalnikom besedila in naredite naslednje spremembe:

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

Pojdite spodaj in obvezno komentirajte drugo izjavo o lokaciji, tako da postavite # pred naslednjimi vrsticami:

#location / {
#        }

13. Ko končate, shranite in zaprite konfiguracijsko datoteko Nginx in znova zaženite demon, da odraža spremembe, tako da izdate naslednji ukaz:

# systemctl restart nginx.service

14. Za dostop do spletnega vmesnika Alfresco dodajte novo pravilo požarnega zidu, da odprete vrata 80 na svoji napravi in se pomaknete na spodnji URL. Prepričajte se tudi, da je politika Selinux onemogočena v sistemih RHEL/CentOS.

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

Če želite popolnoma onemogočiti pravilnik Selinux v sistemu, odprite datoteko /etc/selinux/config in nastavite vrstico SELINUX od prisilne na disabled .

15. Zdaj lahko do Alfresca dostopate prek Nginxa.

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

15. Če želite varno obiskati spletni vmesnik Alfresco prek strežnika Nginx s protokolom SSL, v imeniku /etc/nginx/ssl/ ustvarite samopodpisano potrdilo za Nginx in potrdite z nastavitvami po meri. kot je prikazano na spodnjem posnetku zaslona:

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

Bodite pozorni na Splošno ime potrdila , da se ujema z imenom gostitelja vaše domene.

17. Nato odprite konfiguracijsko datoteko Nginx za urejanje in dodajte naslednji blok pred zadnjim zapiralnim oklepajem (simbol } ).

# vi /etc/nginx/nginx.conf

Izvleček bloka Nginx SSL:

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. Na koncu znova zaženite demon Nginx, da uveljavite spremembe, dodajte novo pravilo požarnega zidu za vrata 443.

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

in brskalniku naročite URL vaše domene s protokolom HTTPS.

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

19. Če želite omogočiti demona Alfresco in Nginx po vsem sistemu, zaženite spodnji ukaz:

# systemctl enable nginx alfresco

To je vse! Alfresco ponuja integracijo z MS Office in LibreOffice prek protokola CIFs, ki uporabnikom zagotavlja znan potek dela.