Hvordan installere Alfresco Community Edition på RHEL/CentOS 7/6 og Debian 8


Alfresco er et åpen kildekode ECM-system (Enterprise Content Management) skrevet i Java som gir elektronisk administrasjon, samarbeid og forretningskontroll.

Denne veiledningen vil dekke hvordan du installerer og konfigurerer Alfresco Community EditionRHEL/CentOS 7/6, Debian 8 og Ubuntu-systemer med Nginx-server som en frontend-webserver for applikasjonen.

Krav

Når det gjelder minimumssystemkravene, trenger Alfresco en maskin med minst 4 GB RAM og et 64-biters operativsystem.

Trinn 1: Installer Alfresco Community Edition

1. Før du fortsetter med Alfresco-installasjonen, forsikre deg først om at wget-verktøyet er installert på maskinen din ved å gi kommandoen nedenfor med root-privilegier eller fra root-kontoen.

yum install wget
apt-get install wget

2. Deretter konfigurerer du systemets vertsnavn og forsikrer at lokal oppløsning peker til serverens IP-adresse ved å utstede følgende kommandoer:

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

3. Fjern eventuell MTA fra maskinen (i dette tilfellet Postfix Mail-server) ved å gi kommandoen nedenfor:

yum remove postfix
apt-get remove postfix

4. Installer følgende avhengigheter som kreves av Alfresco-programvaren for å kjøre riktig:

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

5. Gå deretter til Alfresco Community Edition-repository-siden som ligger på sourceforge.net-portalen og hent den nyeste binære versjonen (dvs. alfresco-community-5.0.d-installer-linux-x64.bin ) for Linux ved å bruke wget-verktøyet.

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

6. Etter at nedlastingen av binærfilen er fullført, utfør følgende kommando for å gi utføringstillatelser for filen og kjøre alfresco-installasjonsprogrammet.

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

7. Etter at installasjonsprosessen starter, velg språk og fortsett installasjonsprosessen ved å bruke installasjonsveiviseren nedenfor som en veiledning for å konfigurere 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 Installation Wizard fortsetter...

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

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

----------------------------------------------------------------------------
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. Etter at installasjonsprosessen er ferdig og Alfresco-tjenester er startet, utfør kommandoene nedenfor for å åpne følgende brannmurporter for å tillate eksterne verter i nettverket ditt å koble til nettapplikasjonen.


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

I tilfelle du trenger å legge til andre brannmurregler for åpne porter for å få tilgang til tilpassede Alfresco-tjenester, utfør ss-kommandoen for å få en liste over alle tjenestene som kjører på maskinen din.

ss -tulpn

9. For å få tilgang til Alfresco-netttjenester, åpne en nettleser og bruk følgende URL-er (erstatt IP-adressen eller domenet tilsvarende). Logg på med admin-bruker og passordet som er konfigurert for Admin gjennom installasjonsprosessen.

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

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

For WebDAV.

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

Godta sikkerhetsunntaket for HTTPS.

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

Alfresco SharePoint-modul med Microsoft.

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

Trinn 2: Konfigurer Nginx som Frontend Web Server for Alfresco

10. For å installere Nginx-serveren på systemet, må du først legge til Epel Repositories på CentOS/RHEL ved å gi kommandoen nedenfor:

yum install epel-release

11. Etter at Epel-repos er lagt til systemet, fortsett med Nginx-nettserverinstallasjonen ved å utstede følgende kommando:

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

12. På neste trinn åpner du Nginx-konfigurasjonsfilen fra /etc/nginx/nginx.conf med et tekstredigeringsprogram og gjør følgende endringer:

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

Gå nedenfor og sørg for at du kommenterer den andre plasseringserklæringen ved å plassere et # foran følgende linjer:

#location / {
       }

13. Når du er ferdig, lagre og lukk Nginx-konfigurasjonsfilen og start daemon på nytt for å gjenspeile endringen ved å utstede følgende kommando:

systemctl restart nginx.service

14. For å få tilgang til Alfrescos nettgrensesnitt legg til en ny brannmurregel for å åpne port 80 på maskinen din og naviger til URL-en nedenfor. Sørg også for at Selinux-policyen er deaktivert på RHEL/CentOS-systemer.

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

For å fullstendig deaktivere Selinux-policy på systemet, åpne /etc/selinux/config-filen og sett linjen SELINUX fra enforcing til disabled.

15. Nå kan du få tilgang til Alfresco gjennom Nginx.

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

15. Hvis du ønsker å besøke Alfrescos nettgrensesnitt på en sikker måte gjennom Nginx proxy med SSL, oppretter du et selvsignert sertifikat for Nginx i katalogen /etc/nginx/ssl/ og fyll sertifikatet med dine egendefinerte innstillinger som illustrert på skjermbildet nedenfor:

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

Vær oppmerksom på Sertifikat Common Name for å matche domenevertsnavnet ditt.

17. Deretter åpner du Nginx-konfigurasjonsfilen for redigering og legger til følgende blokk før den siste krøllete parentesen (}-symbolet).

vi /etc/nginx/nginx.conf

Nginx SSL-blokkutdrag:

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. Til slutt, start Nginx daemon på nytt for å bruke endringer, legg til en ny brannmurregel for 443-port.

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

og instruer nettleseren til domenets URL ved hjelp av HTTPS-protokollen.

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

19. For å aktivere Alfresco- og Nginx-demoner for hele systemet, kjør kommandoen nedenfor:

systemctl enable nginx alfresco

Det er alt! Alfresco tilbyr integrasjon med MS Office og LibreOffice via CIFs-protokollen som gir brukerne en kjent arbeidsflyt.