Cara Install Alfresco Community Edition di RHEL/CentOS 7/6 dan Debian 8


Alfresco adalah sistem ECM sumber terbuka (Manajemen Konten Perusahaan) yang ditulis dalam Java yang menyediakan manajemen elektronik, kolaborasi, dan kontrol bisnis.

Panduan ini akan membahas cara menginstal dan mengonfigurasi Alfresco Community Edition di RHEL/CentOS 7/6, Debian 8 dan Ubuntu dengan server Nginx sebagai server web frontend untuk aplikasi tersebut.

Persyaratan

Mengenai persyaratan sistem minimum, Alfresco memerlukan mesin dengan RAM minimal 4 GB dan Sistem Operasi 64-bit.

Langkah 1: Instal Edisi Komunitas Alfresco

1. Sebelum melanjutkan instalasi Alfresco, pastikan terlebih dahulu bahwa utilitas wget telah diinstal pada mesin Anda dengan mengeluarkan perintah di bawah ini dengan hak akses root atau dari akun root.

yum install wget
apt-get install wget

2. Selanjutnya, siapkan nama host sistem Anda dan pastikan resolusi lokal mengarah ke Alamat IP server Anda dengan mengeluarkan perintah berikut:

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

3. Hapus MTA apa pun dari mesin (dalam hal ini server Email Postfix) dengan mengeluarkan perintah di bawah ini:

yum remove postfix
apt-get remove postfix

4. Instal dependensi berikut yang diperlukan oleh perangkat lunak Alfresco agar dapat berjalan dengan baik:

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

5. Selanjutnya, buka halaman repositori Alfresco Community Edition yang dihosting di portal sourceforge.net dan ambil versi biner terbaru (yaitu alfresco-community-5.0.d-installer-linux-x64.bin ) untuk Linux menggunakan utilitas wget.

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

6. Setelah pengunduhan file biner selesai, jalankan perintah berikut untuk memberikan izin eksekusi untuk file tersebut dan jalankan penginstal alfresco.

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

7. Setelah proses instalasi dimulai, pilih bahasa dan lanjutkan proses instalasi dengan menggunakan wizard instalasi di bawah ini sebagai panduan untuk mengkonfigurasi 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

Wizard Instalasi Alfresco Berlanjut….

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

Instalasi Alfresco Berlanjut…

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

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

Pengaturan Instalasi Alfresco Berlanjut..

----------------------------------------------------------------------------
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. Setelah proses instalasi selesai dan layanan Alfresco dimulai, jalankan perintah di bawah ini untuk membuka port firewall berikut agar host eksternal di jaringan Anda dapat terhubung ke aplikasi web.


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

Jika Anda perlu menambahkan aturan firewall lain ke port terbuka untuk mengakses layanan Alfresco khusus, jalankan perintah ss untuk mendapatkan daftar semua layanan yang berjalan di mesin Anda.

ss -tulpn

9. Untuk mengakses layanan web Alfresco, buka browser dan gunakan URL berikut (ganti Alamat IP atau domain yang sesuai). Login dengan pengguna admin dan kata sandi dikonfigurasi untuk Admin melalui proses instalasi.

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

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

Untuk WebDAV.

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

Untuk HTTPS, terima pengecualian keamanan.

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

Modul SharePoint Alfresco dengan Microsoft.

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

Langkah 2: Konfigurasikan Nginx sebagai Server Web Frontend untuk Alfresco

10. Untuk menginstal server Nginx pada sistem, pertama-tama tambahkan Repositori Epel di CentOS/RHEL dengan mengeluarkan perintah di bawah ini:

yum install epel-release

11. Setelah repo Epel ditambahkan ke sistem, lanjutkan dengan instalasi server web Nginx dengan mengeluarkan perintah berikut:

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

12. Pada langkah selanjutnya buka file konfigurasi Nginx dari /etc/nginx/nginx.conf dengan editor teks dan lakukan perubahan berikut:

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

Lihat di bawah dan pastikan Anda mengomentari pernyataan lokasi kedua dengan memberi tanda # di depan baris berikut:

#location / {
       }

13. Setelah selesai, simpan dan tutup file konfigurasi Nginx dan mulai ulang daemon untuk mencerminkan perubahan dengan mengeluarkan perintah berikut:

systemctl restart nginx.service

14. Untuk mengakses antarmuka web Alfresco, tambahkan aturan firewall baru untuk membuka port 80 di mesin Anda dan navigasikan ke URL di bawah. Selain itu, pastikan kebijakan Selinux dinonaktifkan pada sistem RHEL/CentOS.

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

Untuk sepenuhnya menonaktifkan kebijakan Selinux pada sistem, buka file /etc/selinux/config dan atur baris SELINUX dari enforcing menjadi disabled.

15. Sekarang Anda dapat mengakses Alfresco melalui Nginx.

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

15. Jika Anda ingin mengunjungi antarmuka web Alfresco dengan aman melalui proxy Nginx dengan SSL, buat Sertifikat yang Ditandatangani Sendiri untuk Nginx di direktori /etc/nginx/ssl/ dan isi sertifikat dengan pengaturan khusus Anda seperti yang diilustrasikan pada gambar di bawah:

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

Perhatikan Certificate Common Name agar sesuai dengan nama host domain Anda.

17. Selanjutnya, buka file konfigurasi Nginx untuk diedit dan tambahkan blok berikut sebelum tanda kurung kurawal penutup terakhir (simbol }).

vi /etc/nginx/nginx.conf

Kutipan blok 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. Terakhir, restart daemon Nginx untuk menerapkan perubahan, tambahkan aturan firewall baru untuk port 443.

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

dan instruksikan browser ke URL domain Anda menggunakan protokol HTTPS.

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

19. Untuk mengaktifkan daemon Alfresco dan Nginx di seluruh sistem, jalankan perintah di bawah ini:

systemctl enable nginx alfresco

Itu saja! Alfresco menawarkan integrasi dengan MS Office dan LibreOffice melalui protokol CIF yang menyediakan alur kerja yang familier bagi pengguna.