Cách cài đặt Alfresco Community Edition trên Ubuntu 16.04

• Điều kiện tiên quyết
• Cài đặt phụ thuộc
• Cài đặt Alfresco
• Cấu hình Reverse Proxy

Alfresco Community Edition là phiên bản mã nguồn mở của Dịch vụ nội dung Alfresco. Nó được viết bằng Java và sử dụng PostgreSQL để lưu trữ cơ sở dữ liệu của nó. Alfresco là một hệ thống quản lý nội dung doanh nghiệp cho nhiều loại tài sản kỹ thuật số như tài liệu, hồ sơ, web, hình ảnh, video và hơn thế nữa. Nó cũng được sử dụng để phát triển nội dung hợp tác. Kho lưu trữ tệp của Alfresco được lưu trữ của bạn có thể được truy cập bằng SMB, WebDAV, FTP và CIMS. Tìm kiếm thông qua các tệp được cung cấp bởi Apache Solr.

Điều kiện tiên quyết

• Một phiên bản máy chủ Vultr Ubuntu 16.04 có ít nhất 4GB RAM.
• Một người dùng sudo .
• Một tên miền chỉ về phía máy chủ.

Đối với hướng dẫn này, chúng tôi sẽ sử dụng 192.168.0.1 làm địa chỉ IP công cộng và share.example.com làm tên miền được chỉ vào đối tượng Vultr. Vui lòng đảm bảo thay thế tất cả các lần xuất hiện của tên miền mẫu và địa chỉ IP công cộng bằng địa chỉ thực tế.

Cập nhật hệ thống cơ sở của bạn bằng hướng dẫn Cách cập nhật Ubuntu 16.04 . Khi hệ thống của bạn đã được cập nhật, hãy tiến hành cài đặt các phụ thuộc.

Cài đặt phụ thuộc

Alfresco cung cấp gói cài đặt nhị phân sẵn sàng để cài đặt tất cả các phần mềm cần thiết để chạy ứng dụng. Tuy nhiên, chúng tôi cần cài đặt một vài phụ thuộc để hỗ trợ plugin LibreOffice.

sudo apt -y install fontconfig libsm-dev libice-dev libxt-dev libxrender-dev libxext-dev cups libglu1-mesa-dev libcairo2-dev libgl-dev
sudo ln -s /usr/lib/x86_64-linux-gnu/mesa/libGL.so.1 /usr/lib/x86_64-linux-gnu/libGL.so.1

Cài đặt Alfresco

Tải xuống gói cài đặt từ trang web Alfresco. Bạn luôn có thể tìm thấy liên kết đến trình cài đặt mới nhất trên trang tải xuống Alfresco .

wget https://download.alfresco.com/release/community/201707-build-00028/alfresco-community-installer-201707-linux-x64.bin

Cung cấp quyền thực thi cho tập tin cài đặt.

sudo chmod +x alfresco-community-installer-201707-linux-x64.bin

Bắt đầu cài đặt.

sudo ./alfresco-community-installer-201707-linux-x64.bin

Chọn ngôn ngữ cài đặt. Đối với loại cài đặt, bạn có thể chọn loại đầu tiên có chữ " Easy install". Điều này sẽ cài đặt ứng dụng với cấu hình mặc định.

Chọn vị trí mặc định /opt/alfresco-community, để cài đặt ứng dụng.

Chỉ định mật khẩu quản trị viên và chọn " Y" để cài đặt làm dịch vụ. Điều này sẽ tạo ra một dịch vụ khởi động để dễ dàng bắt đầu và quản lý quy trình ứng dụng.

Lưu ý: Alfresco khuyến nghị ít nhất 2 CPU và RAM 4GB. Nếu hệ thống của bạn không có cấu hình được đề xuất, bạn có thể nhận được cảnh báo cho biết môi trường không được định cấu hình tối ưu cho Dịch vụ Nội dung Alfresco. Tuy nhiên, bạn vẫn có thể tiến hành cài đặt.

Việc cài đặt ứng dụng nên bắt đầu ngay bây giờ. Sau khi ứng dụng được cài đặt, bạn sẽ được hỏi nếu bạn muốn khởi chạy máy chủ Cộng đồng Alfresco. Nếu bạn chọn " Y", ứng dụng sẽ khởi động máy chủ ngay lập tức và bạn sẽ thấy đầu ra sau.

Launch Alfresco Community [Y/n]: y

waiting for server to start.... done
server started
/opt/alfresco-community/postgresql/scripts/ctl.sh : postgresql  started at port 5432
Using CATALINA_BASE:   /opt/alfresco-community/tomcat
Using CATALINA_HOME:   /opt/alfresco-community/tomcat
Using CATALINA_TMPDIR: /opt/alfresco-community/tomcat/temp
Using JRE_HOME:        /opt/alfresco-community/java
Using CLASSPATH:       /opt/alfresco-community/tomcat/bin/bootstrap.jar:/opt/alfresco-community/tomcat/bin/tomcat-juli.jar
Using CATALINA_PID:    /opt/alfresco-community/tomcat/temp/catalina.pid
Tomcat started.
/opt/alfresco-community/tomcat/scripts/ctl.sh : tomcat started

Vì trình cài đặt cũng đã thêm một dịch vụ khởi động, bạn cũng có thể khởi động ứng dụng.

sudo systemctl start alfresco

Theo mặc định, Alfresco khởi động máy chủ web Tomcat để phục vụ ứng dụng trên cổng 8080. Mở trình duyệt yêu thích của bạn và đi đến http://192.168.0.1:8080/share, bạn sẽ thấy trang đích Alfresco.

Cấu hình Reverse Proxy

Theo mặc định, máy chủ Tomcat của Alfresco lắng nghe cổng 8080. Trong hướng dẫn này, chúng tôi sẽ sử dụng Nginx làm proxy ngược để ứng dụng có thể được truy cập thông qua các cổng HTTP và HTTPScổng tiêu chuẩn . Chúng tôi cũng sẽ định cấu hình Nginx để sử dụng SSL được tạo bằng Let Encrypt.

Cài đặt Nginx.

sudo apt -y install nginx

Bắt đầu Nginx và cho phép nó tự động bắt đầu khi khởi động.

sudo systemctl start nginx
sudo systemctl enable nginx

Thêm kho lưu trữ Certbot.

sudo add-apt-repository --yes ppa:certbot/certbot
sudo apt-get update

Cài đặt Certbot, đây là ứng dụng khách cho Let Encrypt CA.

sudo apt -y install certbot

Note: To obtain certificates from Let's Encrypt CA, the domain for which the certificates are to be generated must be pointed towards the server. If not, make the necessary changes to the DNS records of the domain and wait for the DNS to propagate before making the certificate request again. Certbot checks the domain authority before providing the certificates.

Generate the SSL certificates.

sudo certbot certonly --webroot -w /var/www/html -d share.example.com

The generated certificates are likely to be stored in /etc/letsencrypt/live/share.example.com/. Let's Encrypt certificates expire in 90 days, hence it is recommended to set up auto-renewal of the certificates using Cron jobs.

Open the cron job file.

sudo crontab -e

Add the following line at the end of the file.

30 5 * * * /usr/bin/certbot renew --quiet

The above cron job will run every day at 5:30 AM. If the certificate is due for expiration, it will automatically be renewed.

Edit Alfresco's Tomcat server configuration file.

sudo nano /opt/alfresco-community/tomcat/conf/server.xml

Find the following lines.

<Connector port="8080" URIEncoding="UTF-8" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443" maxHttpHeaderSize="32768" />

Add the line proxyPort="443" scheme="https" in the above configuration block so that it looks like the block shown below.

<Connector port="8080" URIEncoding="UTF-8" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443" maxHttpHeaderSize="32768" 
               proxyPort="443" scheme="https" />

Open the Alfresco default configuration file.

sudo nano /opt/alfresco-community/tomcat/shared/classes/alfresco-global.properties

Find the following lines.

alfresco.context=alfresco
alfresco.host=127.0.0.1
alfresco.port=8080
alfresco.protocol=http

share.context=share
share.host=127.0.0.1
share.port=8080
share.protocol=http

...

system.serverMode=UNKNOWN

Change the above lines according to your system. It should look like what is shown below.

alfresco.context=alfresco
alfresco.host=share.example.com
alfresco.port=443
alfresco.protocol=https

share.context=share
share.host=share.example.com
share.port=443
share.protocol=https

...

system.serverMode=PRODUCTION

Create a new server block file for Alfresco.

sudo nano /etc/nginx/sites-available/alfresco

Populate the file.

server {
    listen 80;
    server_name share.example.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443;
    server_name share.example.com;

    ssl_certificate           /etc/letsencrypt/live/share.example.com/fullchain.pem;
    ssl_certificate_key       /etc/letsencrypt/live/share.example.com/privkey.pem;

    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/alfresco.access.log;
    location / {

           root /opt/alfresco-community/tomcat/webapps/ROOT;
           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;
           proxy_set_header Host $http_host;
           proxy_http_version 1.1;
           proxy_pass http://localhost:8080;
           proxy_redirect default;
    }

    location /share/ {
           root /opt/alfresco-community/tomcat/webapps/share/;
           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;
           proxy_set_header Host $http_host;
           proxy_http_version 1.1;
           proxy_pass http://localhost:8080/share/;
           proxy_redirect http:// https://;
    }

    location /alfresco/ {
           root /opt/alfresco-community/tomcat/webapps/alfresco/;
           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;
           proxy_set_header Host $http_host;
           proxy_http_version 1.1;
           proxy_pass http://localhost:8080/alfresco/;
           proxy_redirect http:// https://;
    }
}

Activate the configuration file.

sudo ln -s /etc/nginx/sites-available/alfresco /etc/nginx/sites-enabled/alfresco

Restart the web server and Alfresco so that the changes in the configuration can take effect.

sudo systemctl restart nginx alfresco

Alfresco is now installed and configured on your server. You can access the Alfresco modules at the following address.

https://share.example.com/alfresco

To access the Alfresco share services, visit the following address.

https://share.example.com/share

Log in using the initial administrator account, admin and the password you have chosen during installation.

Congratulations, Alfresco community edition is now installed on your server.