Πώς να εγκαταστήσετε το Alfresco Community Edition σε RHEL/CentOS 7/6 και Debian 8

Το Alfresco είναι ένα σύστημα ECM ανοιχτού κώδικα (Enterprise Content Management) γραμμένο σε Java το οποίο παρέχει ηλεκτρονική διαχείριση, συνεργασία και επιχειρηματικό έλεγχο.

Αυτός ο οδηγός θα καλύψει τον τρόπο εγκατάστασης και διαμόρφωσης της Alfresco Community Edition σε RHEL/CentOS 7/6, Debian 8 και Ubuntu ισχυρά> συστήματα με διακομιστή Nginx ως διακομιστή web frontend για την εφαρμογή.

Απαιτήσεις

Όσον αφορά τις ελάχιστες απαιτήσεις συστήματος, η Alfresco χρειάζεται ένα μηχάνημα με τουλάχιστον 4 GB RAM και λειτουργικό σύστημα 64 bit.

Βήμα 1: Εγκαταστήστε το Alfresco Community Edition

1. Πριν προχωρήσετε στην εγκατάσταση του Alfresco, πρώτα βεβαιωθείτε ότι το βοηθητικό πρόγραμμα wget είναι εγκατεστημένο στον υπολογιστή σας, εκδίδοντας την παρακάτω εντολή με δικαιώματα root ή από λογαριασμό root.

# yum install wget
# apt-get install wget

2. Στη συνέχεια, ρυθμίστε το όνομα κεντρικού υπολογιστή του συστήματός σας και βεβαιωθείτε ότι η τοπική ανάλυση οδηγεί στη διεύθυνση IP του διακομιστή σας, εκδίδοντας τις ακόλουθες εντολές:

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

3. Καταργήστε οποιοδήποτε MTA από το μηχάνημα (σε αυτήν την περίπτωση διακομιστή αλληλογραφίας Postfix) εκδίδοντας την παρακάτω εντολή:

# yum remove postfix
# apt-get remove postfix

4. Εγκαταστήστε τις ακόλουθες εξαρτήσεις που απαιτούνται από το λογισμικό Alfresco για να εκτελεστούν σωστά:

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

5. Στη συνέχεια, μεταβείτε στο βοηθητικό πρόγραμμα wget.

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

6. Αφού ολοκληρωθεί η λήψη του δυαδικού αρχείου, εκτελέστε την ακόλουθη εντολή για να εκχωρήσετε δικαιώματα εκτέλεσης για το αρχείο και να εκτελέσετε το πρόγραμμα εγκατάστασης alfresco.

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

7. Αφού ξεκινήσει η διαδικασία εγκατάστασης, επιλέξτε τη γλώσσα και συνεχίστε τη διαδικασία εγκατάστασης χρησιμοποιώντας τον παρακάτω οδηγό εγκατάστασης ως οδηγό για τη διαμόρφωση του 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

Ο Οδηγός εγκατάστασης Alfresco συνεχίζεται….

----------------------------------------------------------------------------
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 συνεχίζεται…

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

----------------------------------------------------------------------------
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. Αφού ολοκληρωθεί η διαδικασία εγκατάστασης και ξεκινήσουν οι υπηρεσίες Alfresco, εκδώστε τις παρακάτω εντολές για να ανοίξετε τις ακόλουθες θύρες τείχους προστασίας για να επιτρέψετε στους εξωτερικούς κεντρικούς υπολογιστές του δικτύου σας να συνδεθούν στην εφαρμογή Ιστού.

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

Σε περίπτωση που χρειαστεί να προσθέσετε άλλους κανόνες τείχους προστασίας σε ανοιχτές θύρες, προκειμένου να αποκτήσετε πρόσβαση στις προσαρμοσμένες υπηρεσίες Alfresco, εκδώστε την εντολή ss για να λάβετε μια λίστα με όλες τις υπηρεσίες που εκτελούνται στο μηχάνημά σας.

# ss -tulpn

9. Για να αποκτήσετε πρόσβαση στις υπηρεσίες web Alfresco, ανοίξτε ένα πρόγραμμα περιήγησης και χρησιμοποιήστε τις ακόλουθες διευθύνσεις URL (αντικαταστήστε τη Διεύθυνση IP ή τον τομέα αναλόγως). Συνδεθείτε με τον χρήστη διαχειριστή και τον κωδικό πρόσβασης που διαμορφώθηκε για τον Διαχειριστή μέσω της διαδικασίας εγκατάστασης.

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

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

Για WebDAV.

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

Για HTTPS αποδεχτείτε την εξαίρεση ασφαλείας.

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

Alfresco SharePoint Module με τη Microsoft.

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

Βήμα 2: Διαμόρφωση του Nginx ως διακομιστή Web Frontend για το Alfresco

10. Για να εγκαταστήσετε τον διακομιστή Nginx στο σύστημα, προσθέστε πρώτα τα αποθετήρια Epel στο CentOS/RHEL εκδίδοντας την παρακάτω εντολή:

# yum install epel-release

11. Αφού προστεθούν τα repos Epel στο σύστημα, προχωρήστε στην εγκατάσταση του διακομιστή web Nginx εκδίδοντας την ακόλουθη εντολή:

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

12. Στο επόμενο βήμα ανοίξτε το αρχείο διαμόρφωσης Nginx από το /etc/nginx/nginx.conf με ένα πρόγραμμα επεξεργασίας κειμένου και κάντε τις ακόλουθες αλλαγές:

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

Πηγαίνετε παρακάτω και βεβαιωθείτε ότι έχετε σχολιάσει τη δεύτερη δήλωση τοποθεσίας τοποθετώντας ένα # μπροστά από τις ακόλουθες γραμμές:

#location / {
#        }

13. Αφού τελειώσετε, αποθηκεύστε και κλείστε το αρχείο διαμόρφωσης Nginx και επανεκκινήστε τον δαίμονα για να αντικατοπτρίζει την αλλαγή εκδίδοντας την ακόλουθη εντολή:

# systemctl restart nginx.service

14. Για να αποκτήσετε πρόσβαση στη διεπαφή ιστού Alfresco, προσθέστε έναν νέο κανόνα τείχους προστασίας για να ανοίξετε τη θύρα 80 στον υπολογιστή σας και μεταβείτε στην παρακάτω διεύθυνση URL. Επίσης, βεβαιωθείτε ότι η πολιτική Selinux είναι απενεργοποιημένη σε συστήματα RHEL/CentOS.

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

Για να απενεργοποιήσετε πλήρως την πολιτική Selinux στο σύστημα, ανοίξτε το αρχείο /etc/selinux/config και ορίστε τη γραμμή SELINUX από επιβολή σε disabled.

15. Τώρα μπορείτε να αποκτήσετε πρόσβαση στο Alfresco μέσω του Nginx.

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

15. Σε περίπτωση που θέλετε να επισκεφθείτε με ασφάλεια τη διεπαφή ιστού Alfresco μέσω διακομιστή μεσολάβησης Nginx με SSL, δημιουργήστε ένα Αυτο-υπογεγραμμένο πιστοποιητικό για το Nginx στον κατάλογο /etc/nginx/ssl/ και συμπληρώστε το πιστοποιητικό με τις προσαρμοσμένες ρυθμίσεις σας όπως φαίνεται στο παρακάτω στιγμιότυπο οθόνης:

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

Δώστε προσοχή στο Κοινό όνομα πιστοποιητικού για να ταιριάζει με το όνομα κεντρικού υπολογιστή του τομέα σας.

17. Στη συνέχεια, ανοίξτε το αρχείο διαμόρφωσης Nginx για επεξεργασία και προσθέστε το ακόλουθο μπλοκ πριν από το τελευταίο σγουρό πλαίσιο κλεισίματος (το σύμβολο }).

# vi /etc/nginx/nginx.conf

Απόσπασμα μπλοκ 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. Τέλος, επανεκκινήστε το Nginx daemon για να εφαρμόσετε αλλαγές, προσθέστε έναν νέο κανόνα τείχους προστασίας για τη θύρα 443.

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

και καθοδηγήστε το πρόγραμμα περιήγησης στη διεύθυνση URL του τομέα σας χρησιμοποιώντας το πρωτόκολλο HTTPS.

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

19. Για να ενεργοποιήσετε τους δαίμονες Alfresco και Nginx σε όλο το σύστημα, εκτελέστε την παρακάτω εντολή:

# systemctl enable nginx alfresco

Αυτό είναι όλο! Η Alfresco προσφέρει ενοποίηση με το MS Office και το LibreOffice μέσω πρωτοκόλλου CIFs παρέχοντας μια οικεία ροή εργασίας για τους χρήστες.