Hvernig á að setja upp Alfresco Community Edition á RHEL/CentOS 7/6 og Debian 8


Alfresco er opið ECM kerfi (Enterprise Content Management) skrifað í Java sem veitir rafræna stjórnun, samvinnu og viðskiptastjórnun.

Þessi handbók mun fjalla um hvernig á að setja upp og stilla Alfresco Community Edition á RHEL/CentOS 7/6, Debian 8 og Ubuntu kerfum með Nginx netþjóni sem framenda vefþjón fyrir forritið.

Hvað varðar lágmarkskerfiskröfur, þarf Alfresco vél með að minnsta kosti 4 GB af vinnsluminni og 64 bita stýrikerfi.

Skref 1: Settu upp Alfresco Community Edition

1. Áður en þú heldur áfram með Alfresco uppsetningu skaltu fyrst tryggja að wget tólið sé sett upp á vélinni þinni með því að gefa út skipunina hér að neðan með rótarréttindum eða frá rótarreikningi.

# yum install wget
# apt-get install wget

2. Næst skaltu setja upp hýsingarheiti kerfisins og tryggja að staðbundin upplausn bendi til IP tölu netþjónsins með því að gefa út eftirfarandi skipanir:

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

3. Fjarlægðu hvaða MTA sem er af vélinni (í þessu tilfelli Postfix Mail server) með því að gefa út skipunina hér að neðan:

# yum remove postfix
# apt-get remove postfix

4. Settu upp eftirfarandi ósjálfstæði sem Alfresco hugbúnaðurinn krefst til að geta keyrt rétt:

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

5. Næst skaltu fara í wget gagnsemi.

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

6. Eftir að niðurhali á tvöfaldri skrá lýkur skaltu gefa út eftirfarandi skipun til að veita framkvæmdarheimildir fyrir skrána og keyra alfresco uppsetningarforritið.

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

7. Eftir að uppsetningarferlið er hafið skaltu velja tungumálið og halda áfram með uppsetningarferlið með því að nota uppsetningarhjálpina hér að neðan sem leiðbeiningar til að stilla 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 Uppsetningarhjálp heldur áfram….

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

Uppsetning alfresco heldur áfram…

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

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

Uppsetning Alfresco heldur áfram..

----------------------------------------------------------------------------
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. Eftir að uppsetningarferlinu lýkur og Alfresco þjónusta er hafin skaltu gefa út skipanirnar hér að neðan til að opna eftirfarandi eldveggstengi til að leyfa ytri vélum á netinu þínu að tengjast vefforritinu.

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

Ef þú þarft að bæta öðrum eldveggsreglum við opnar gáttir til að fá aðgang að sérsniðnum Alfresco þjónustu skaltu gefa út ss skipunina til að fá lista yfir allar þjónustur sem keyra á vélinni þinni.

# ss -tulpn

9. Til að fá aðgang að Alfresco vefþjónustunni skaltu opna vafra og nota eftirfarandi vefslóðir (skipta um IP tölu eða lén í samræmi við það). Skráðu þig inn með admin notanda og lykilorðinu stillt fyrir Admin í gegnum uppsetningarferlið.

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

Fyrir WebDAV.

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

Fyrir HTTPS samþykktu öryggisundantekninguna.

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

Alfresco SharePoint Module með Microsoft.

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

Skref 2: Stilltu Nginx sem Frontend Web Server fyrir Alfresco

10. Til að setja upp Nginx netþjón á kerfinu skaltu fyrst bæta við Epel Repositories á CentOS/RHEL með því að gefa út skipunina hér að neðan:

# yum install epel-release

11. Eftir að Epel repos hefur verið bætt við kerfið skaltu halda áfram með uppsetningu Nginx vefþjónsins með því að gefa út eftirfarandi skipun:

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

12. Í næsta skrefi opnaðu Nginx stillingarskrá frá /etc/nginx/nginx.conf með textaritli og gerðu eftirfarandi breytingar:

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

Farðu fyrir neðan og vertu viss um að skrifa athugasemdir við seinni staðsetningaryfirlýsinguna með því að setja # fyrir framan eftirfarandi línur:

#location / {
#        }

13. Eftir að þú ert búinn skaltu vista og loka Nginx stillingarskránni og endurræsa púkann til að endurspegla breytingu með því að gefa út eftirfarandi skipun:

# systemctl restart nginx.service

14. Til að fá aðgang að Alfresco vefviðmótinu skaltu bæta við nýrri eldveggsreglu til að opna gátt 80 á vélinni þinni og fletta að neðangreindri vefslóð. Gakktu úr skugga um að Selinux stefnan sé óvirk á RHEL/CentOS kerfum.

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

Til að slökkva algjörlega á Selinux stefnu á kerfinu skaltu opna /etc/selinux/config skrána og stilla línu SELINUX frá enforcing í disabled.

15. Nú geturðu fengið aðgang að Alfresco í gegnum Nginx.

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

15. Ef þú vilt heimsækja Alfresco vefviðmótið á öruggan hátt í gegnum Nginx proxy með SSL, búðu til sjálfundirritað skírteini fyrir Nginx á /etc/nginx/ssl/ skránni og fylltu vottorðið með sérsniðnum stillingum þínum eins og sýnt er á skjámyndinni hér að neðan:

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

Gefðu gaum að Common Name Certificate til að passa við hýsingarheiti lénsins þíns.

17. Næst skaltu opna Nginx stillingarskrána til að breyta og bæta við eftirfarandi reit fyrir síðasta loki krullaða krappann (táknið }).

# vi /etc/nginx/nginx.conf

Nginx SSL blokk útdráttur:

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. Að lokum skaltu endurræsa Nginx púkinn til að beita breytingum, bæta við nýrri eldveggsreglu fyrir 443 tengi.

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

og leiðbeindu vafranum um vefslóð lénsins þíns með því að nota HTTPS samskiptareglur.

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

19. Til þess að virkja Alfresco og Nginx púka um allt kerfið skaltu keyra eftirfarandi skipun:

# systemctl enable nginx alfresco

Það er allt og sumt! Alfresco býður upp á samþættingu við MS Office og LibreOffice með CIF samskiptareglum sem veitir notendum kunnuglegt vinnuflæði.