Jinsi ya kusakinisha Toleo la Jumuiya ya Alfresco kwenye RHEL/CentOS 7/6 na Debian 8


Alfresco ni mfumo huria wa ECM (Usimamizi wa Maudhui ya Biashara) ulioandikwa katika Java ambao hutoa usimamizi wa kielektroniki, ushirikiano na udhibiti wa biashara.

Mwongozo huu utashughulikia jinsi ya kusakinisha na kusanidi Toleo la Jumuiya ya Alfresco kwenye mifumo ya RHEL/CentOS 7/6, Debian 8 na Ubuntu yenye seva ya Nginx kama seva ya tovuti ya mbele kwa programu.

Kuhusu mahitaji ya chini ya mfumo, Alfresco inahitaji mashine yenye angalau GB 4 ya RAM na Mfumo wa Uendeshaji wa 64-bit.

Hatua ya 1: Sakinisha Toleo la Jumuiya ya Alfresco

1. Kabla ya kuendelea na usakinishaji wa Alfresco kwanza hakikisha kwamba matumizi ya wget yamesakinishwa kwenye mashine yako kwa kutoa amri iliyo hapa chini yenye haki za mizizi au kutoka kwa akaunti ya mizizi.

# yum install wget
# apt-get install wget

2. Kisha, sanidi jina la mpangishi wa mfumo wako na uhakikishe kuwa azimio la ndani linaelekeza kwenye Anwani ya IP ya seva yako kwa kutoa amri zifuatazo:

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

3. Ondoa MTA yoyote kutoka kwa mashine (katika kesi hii seva ya Postfix Mail) kwa kutoa amri iliyo hapa chini:

# yum remove postfix
# apt-get remove postfix

4. Sakinisha vitegemezi vifuatavyo vinavyohitajika na programu ya Alfresco ili kufanya kazi ipasavyo:

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

5. Kisha, nenda kwa matumizi ya wget.

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

6. Baada ya upakuaji wa faili ya binary kukamilika, toa amri ifuatayo ili kutoa ruhusa za utekelezaji wa faili na kuendesha kisakinishi cha alfresco.

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

7. Baada ya mchakato wa usakinishaji kuanza, chagua lugha na uendelee na usakinishaji kwa kutumia kichawi kilicho hapa chini kama mwongozo wa kusanidi 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

Mchawi wa Usakinishaji wa Alfresco Inaendelea….

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

Usakinishaji wa Alfresco Unaendelea...

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

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

Usanidi wa Usakinishaji wa Alfresco Unaendelea..

----------------------------------------------------------------------------
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. Baada ya mchakato wa usakinishaji kukamilika na huduma za Alfresco kuanza toa amri zilizo hapa chini ili kufungua milango ya ngome ifuatayo ili kuruhusu wapangishi wa nje katika mtandao wako kuunganishwa kwenye programu ya wavuti.

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

Iwapo utahitaji kuongeza sheria zingine za ngome ili kufungua milango ili kufikia huduma maalum za Alfresco toa amri ya ss ili kupata orodha ya huduma zote zinazoendeshwa kwenye mashine yako.

# ss -tulpn

9. Ili kufikia huduma za wavuti za Alfresco, fungua kivinjari na utumie URL zifuatazo (badilisha Anwani ya IP au kikoa ipasavyo). Ingia na mtumiaji wa msimamizi na nenosiri lililosanidiwa kwa Msimamizi kupitia mchakato wa usakinishaji.

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

Kwa WebDAV.

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

Kwa HTTPS ukubali ubaguzi wa usalama.

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

Alfresco SharePoint Moduli na Microsoft.

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

Hatua ya 2: Sanidi Nginx kama Seva ya Wavuti ya Frontend ya Alfresco

10. Ili kusakinisha seva ya Nginx kwenye mfumo, kwanza ongeza Hazina za Epel kwenye CentOS/RHEL kwa kutoa amri ifuatayo:

# yum install epel-release

11. Baada ya repos za Epel kuongezwa kwenye mfumo endelea na usakinishaji wa seva ya wavuti ya Nginx kwa kutoa amri ifuatayo:

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

12. Katika hatua inayofuata fungua faili ya usanidi ya Nginx kutoka /etc/nginx/nginx.conf na kihariri maandishi na ufanye mabadiliko yafuatayo:

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

Nenda hapa chini na hakikisha unatoa maoni kwa taarifa ya eneo la pili kwa kuweka # mbele ya mistari ifuatayo:

#location / {
#        }

13. Baada ya kumaliza, hifadhi na funga faili ya usanidi ya Nginx na uanze upya daemon ili kuonyesha mabadiliko kwa kutoa amri ifuatayo:

# systemctl restart nginx.service

14. Ili kufikia kiolesura cha wavuti cha Alfresco ongeza sheria mpya ya ngome ili kufungua mlango wa 80 kwenye mashine yako na uende kwenye URL iliyo hapa chini. Pia, hakikisha kuwa sera ya Selinux imezimwa kwenye mifumo ya RHEL/CentOS.

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

Ili kuzima kabisa sera ya Selinux kwenye mfumo, fungua faili ya /etc/selinux/config na uweke laini ya SELINUX kutoka kutekeleza hadi kuzimwa.

15. Sasa unaweza kufikia Alfresco kupitia Nginx.

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

15. Iwapo ungependa kutembelea kiolesura cha wavuti cha Alfresco kwa usalama kupitia seva mbadala ya Nginx iliyo na SSL, tengeneza Cheti cha Kujiandikisha kwa Nginx kwenye /etc/nginx/ssl/ saraka na ujaze cheti kwa mipangilio yako maalum. kama inavyoonyeshwa kwenye skrini hapa chini:

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

Zingatia Jina la Kawaida la Cheti ili kuendana na jina la mpangishi wa kikoa chako.

17. Kisha, fungua faili ya usanidi ya Nginx kwa ajili ya kuhaririwa na uongeze kizuizi kifuatacho kabla ya mabano yaliyojipinda ya mwisho ya kufunga (alama ya }).

# vi /etc/nginx/nginx.conf

Nukuu ya block ya 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. Hatimaye, anzisha upya daemon ya Nginx ili kutumia mabadiliko, ongeza sheria mpya ya ngome ya mlango wa 443.

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

na uelekeze kivinjari kwa URL ya kikoa chako kwa kutumia itifaki ya HTTPS.

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

19. Ili kuwezesha mfumo mzima wa daemoni za Alfresco na Nginx endesha amri ifuatayo:

# systemctl enable nginx alfresco

Ni hayo tu! Alfresco inatoa ushirikiano na MS Office na LibreOffice kupitia itifaki ya CIFs kutoa mtiririko wa kazi unaojulikana kwa watumiaji.