كيفية تثبيت Alfresco Community Edition على Ubuntu 16.04

• المتطلبات الأساسية
• تثبيت التبعيات
• تثبيت الفريسكو
• تكوين وكيل عكسي

إصدار مجتمع الفريسكو هو إصدار مفتوح المصدر من خدمات الفريسكو للمحتوى. هو مكتوب بلغة جافا ويستخدم PostgreSQL لتخزين قاعدة البيانات الخاصة به. الفريسكو هو نظام إدارة محتوى مؤسسي للعديد من أنواع الأصول الرقمية مثل المستندات والسجلات والويب والصور ومقاطع الفيديو والمزيد. كما أنها تستخدم لتطوير المحتوى التعاوني. يمكن الوصول إلى مستودع الملفات الخاص بـ Alfresco المستضاف باستخدام SMB و WebDAV و FTP و CIMS. البحث في الملفات مدعوم بواسطة Apache Solr.

المتطلبات الأساسية

• نسخة خادم Vultr Ubuntu 16.04 مع ذاكرة وصول عشوائي سعتها 4 غيغابايت على الأقل.
• A المستخدم سودو .
• أشار اسم المجال نحو الخادم.

في هذا البرنامج التعليمي ، سوف نستخدم 192.168.0.1 كعنوان IP عام share.example.com ولكونه اسم النطاق الموجه نحو مثيل Vultr. يرجى التأكد من استبدال كل تكرارات مثال اسم النطاق وعنوان IP العام بالحدث الفعلي.

قم بتحديث نظامك الأساسي باستخدام الدليل كيفية تحديث Ubuntu 16.04 . بمجرد تحديث النظام الخاص بك ، انتقل إلى تثبيت التبعيات.

تثبيت التبعيات

توفر شركة Alfresco حزمة تثبيت ثنائية جاهزة للتثبيت تحتوي على جميع البرامج المطلوبة لتشغيل التطبيق. ومع ذلك ، نحتاج إلى تثبيت بعض التبعيات لدعم البرنامج الإضافي 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

تثبيت الفريسكو

قم بتنزيل حزمة المثبت من موقع Alfresco على الويب. يمكنك دائمًا العثور على رابط أحدث أداة تثبيت في صفحة تنزيل Alfresco .

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

توفير أذونات التنفيذ لملف المثبت.

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

ابدأ التثبيت.

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

حدد لغة التثبيت. بالنسبة لنوع التثبيت ، يمكنك اختيار النوع الأول الذي يقول " Easy install". سيؤدي هذا إلى تثبيت التطبيق مع التكوين الافتراضي.

اختر الموقع الافتراضي /opt/alfresco-communityلتثبيت التطبيق.

حدد كلمة مرور المسؤول واختر " Y" للتثبيت كخدمة. سيؤدي ذلك إلى إنشاء خدمة بدء تشغيل لبدء عملية التطبيق وإدارتها بسهولة.

ملاحظة: توصي شركة Alfresco بوحدتي معالجة على الأقل وذاكرة وصول عشوائي بسعة 4 غيغابايت. إذا لم يكن النظام الخاص بك يحتوي على التكوين الموصى به ، فقد تتلقى تحذيرًا يفيد بأن البيئة لم يتم تكوينها على النحو الأمثل لخدمة Alfresco Content Services. ومع ذلك ، لا يزال بإمكانك متابعة التثبيت.

يجب أن يبدأ تثبيت التطبيق الآن. بمجرد تثبيت التطبيق ، سيتم سؤالك عما إذا كنت تريد تشغيل خادم مجتمع Alfresco. إذا اخترت " Y" ، فسيقوم التطبيق بتشغيل الخادم على الفور وسترى النتيجة التالية.

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

نظرًا لأن المثبت أضاف أيضًا خدمة بدء التشغيل ، يمكنك أيضًا بدء التطبيق.

sudo systemctl start alfresco

بشكل افتراضي ، يبدأ Alfresco خادم الويب Tomcat لخدمة التطبيق على المنفذ 8080. افتح متصفحك المفضل وانتقل إلى http://192.168.0.1:8080/share، سترى صفحة الهبوط Alfresco.

تكوين وكيل عكسي

افتراضيًا ، يستمع خادم Tomcat الخاص بـ Alfresco إلى المنفذ 8080. في هذا البرنامج التعليمي، سوف نستخدم إنجن إكس باسم وكيل عكسي بحيث يمكن الوصول إلى التطبيق عبر المعيار HTTP و HTTPS الموانئ. سنقوم أيضًا بتكوين Nginx لاستخدام SSL الذي تم إنشاؤه باستخدام Let's Encrypt.

قم بتثبيت Nginx.

sudo apt -y install nginx

قم بتشغيل Nginx وتمكينه من البدء تلقائيًا في وقت التمهيد.

sudo systemctl start nginx
sudo systemctl enable nginx

أضف مستودع Certbot.

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

قم بتثبيت Certbot ، وهو تطبيق العميل لـ Let's Encrypt CA.

sudo apt -y install certbot

ملاحظة: للحصول على شهادات من Let's Encrypt CA ، يجب توجيه النطاق الذي سيتم إنشاء الشهادات من أجله إلى الخادم. إذا لم يكن الأمر كذلك ، قم بإجراء التغييرات اللازمة على سجلات DNS للمجال وانتظر DNS للنشر قبل إجراء طلب الشهادة مرة أخرى. يتحقق Certbot من سلطة المجال قبل تقديم الشهادات.

إنشاء شهادات SSL.

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

من المرجح أن يتم تخزين الشهادات التي تم إنشاؤها /etc/letsencrypt/live/share.example.com/. تنتهي صلاحية شهادات التشفير في غضون 90 يومًا ، وبالتالي يوصى بإعداد التجديد التلقائي للشهادات باستخدام وظائف Cron.

افتح ملف مهمة كرون.

sudo crontab -e

أضف السطر التالي في نهاية الملف.

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

سيتم تشغيل وظيفة cron المذكورة أعلاه كل يوم الساعة 5:30 صباحًا. إذا كانت الشهادة مستحقة للانتهاء ، فسيتم تجديدها تلقائيًا.

تحرير ملف تكوين خادم Tomcat الخاص بـ Alfresco.

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

ابحث عن الخطوط التالية.

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

أضف السطر proxyPort="443" scheme="https" في قالب التكوين أعلاه بحيث يبدو مثل الكتلة الموضحة أدناه.

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

افتح ملف التكوين الافتراضي لـ Alfresco.

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

ابحث عن الخطوط التالية.

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

قم بتغيير الخطوط المذكورة أعلاه وفقًا لنظامك. يجب أن تبدو كما هو موضح أدناه.

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

قم بإنشاء ملف كتلة خادم جديد لـ Alfresco.

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

تعبئة الملف.

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

قم بتنشيط ملف التكوين.

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

أعد تشغيل خادم الويب و Alfresco حتى تسري التغييرات في التكوين.

sudo systemctl restart nginx alfresco

تم تثبيت برنامج الفريسكو وتكوينه على خادمك. يمكنك الوصول إلى وحدات Alfresco على العنوان التالي.

https://share.example.com/alfresco

للوصول إلى خدمات سهم Alfresco ، قم بزيارة العنوان التالي.

https://share.example.com/share

قم بتسجيل الدخول باستخدام حساب المسؤول الأولي admin وكلمة المرور التي اخترتها أثناء التثبيت.

تهانينا ، تم تثبيت إصدار مجتمع الفريسكو الآن على خادمك.