كيفية تثبيت XWiki 9.11.x على Ubuntu 16.04 LTS

• المتطلبات الأساسية
• قم بإعداد الريبو XWiki LTS APT
• قم بتثبيت حزمة XWiki الكل في واحد (بما في ذلك XWiki LTS 9.11.2 و Tomcat 8 و MySQL 5.7 والمزيد.)
• قم بتهيئة XWiki على واجهة الويب "Distribution Wizard"
• (اختياري) اختصر عنوان URL لموقع XWiki
• (اختياري) قم بإعداد وكيل Nginx عكسي

XWiki هي منصة wiki مفتوحة المصدر على مستوى المؤسسة شائعة مكتوبة بلغة Java. مع التوسعة وسهولة الاستخدام ، يتم نشر XWiki في العديد من الشركات كمخزن للمعرفة وبوابة عامة والمزيد.

في هذه المقالة ، سأوجهك خلال عملية تثبيت XWiki 9.11.2 على مثيل خادم Ubuntu 16.04 LTS. سيتم تثبيت OpenJDK 8 و Tomcat 8 و MySQL 5.7 تلقائيًا كتبعيات أثناء عملية التثبيت.

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

• نسخة جديدة من خادم Vultr Ubuntu 16.04 LTS x64 مع 2 غيغابايت على الأقل من الذاكرة ، 4 غيغابايت أو أكثر مستحسن. لنفترض أن عنوان IP الخاص به هو 203.0.113.1.
• A المستخدم سودو .
• تم تحديث نسخة الخادم إلى أحدث حالة مستقرة باستخدام apt.

قم بإعداد الريبو XWiki LTS APT

قم بتسجيل الدخول كمستخدم sudo ، ثم قم بتنزيل وإعداد XWiki LTS (دعم طويل الأمد) APT على مثيل الخادم الخاص بك:

cd
wget -q "https://maven.xwiki.org/public.gpg" -O- | sudo apt-key add -
sudo wget "https://maven.xwiki.org/lts/xwiki-lts.list" -P /etc/apt/sources.list.d/
sudo apt update

ملاحظة: إذا كنت ترغب في تجربة أحدث إصدار ثابت من XWiki (ولكن ليس LTS) ، فيمكنك تنزيل الإصدار التالي من XWiki APT بدلاً من ذلك:

cd
wget -q "https://maven.xwiki.org/public.gpg" -O- | sudo apt-key add -
sudo wget "https://maven.xwiki.org/stable/xwiki-stable.list" -P /etc/apt/sources.list.d/
sudo apt update

قم بتثبيت حزمة XWiki الكل في واحد (بما في ذلك XWiki LTS 9.11.2 و Tomcat 8 و MySQL 5.7 والمزيد.)

عند نشره في الإنتاج ، يحتاج XWiki إلى العمل مع حاوية Java Servlet وبرنامج قاعدة بيانات. باعتبارها منصة wiki مرنة ، يوفر XWiki بشكل رسمي خيارات تكامل متنوعة. يمكنك استخدام الأمر التالي لإظهار كل الخيارات المتاحة في XWiki LTS APT repo:

apt search xwiki

ستشبه نتيجة البحث ما يلي:

xwiki-common/lts 9.11.2 all
xwiki-mysql-common/lts 9.11.2 all
xwiki-pgsql-common/lts 9.11.2 all
xwiki-solr-data/lts 9.11.2 all
xwiki-tomcat7-common/lts 9.11.2 all
xwiki-tomcat7-mysql/lts 9.11.2 all
xwiki-tomcat7-pgsql/lts 9.11.2 all
xwiki-tomcat8-common/lts 9.11.2 all
xwiki-tomcat8-mysql/lts 9.11.2 all
xwiki-tomcat8-pgsql/lts 9.11.2 all

إذا كنت تريد استخدام XWiki مع التبعيات الأكثر شيوعًا ، فيمكنك تثبيت جميع المكونات المطلوبة في أمر واحد على النحو التالي:

sudo apt install xwiki-tomcat8-mysql/lts -y

أثناء عملية التثبيت ، سيُطلب منك إعداد كلمة مرور جديدة لمستخدم MySQL root عدة مرات. فقط اترك حقل كلمة المرور فارغًا واضغط Enterلتخطي هذه الخطوة في الوقت الحالي. سنقوم بمعالجة هذه المشكلة لاحقًا أثناء تأمين تثبيت MySQL.

عند السؤال عما إذا كنت ترغب في ذلك Configure database for xwiki with dbconfig-common?، اختر <Yes>واضغط على ENTER.

عندما يُطلب MySQL application password for xwikiمنك تقديم ، يمكنك إما إدخال كلمة مرور تطبيق MySQL محددة أو ترك حقل كلمة المرور فارغًا. هذا الأخير سيخبر XWiki باستخدام كلمة مرور تطبيق MySQL عشوائية.

بعد تثبيت XWiki وجميع التبعيات المطلوبة ، قم بتثبيت MySQL:

sudo /usr/bin/mysql_secure_installation

خلال العملية ، سيطرح عليك البرنامج بعض الأسئلة. الرد عليها على النحو التالي:

• هل ترغب في إعداد البرنامج المساعد VALIDATE PASSWORD؟ Y
• الرجاء إدخال 0 = منخفض ، 1 = متوسط ​​و 2 = قوي: 2
• كلمة سر جديدة: a-strong-MySQL-root-password
• أعد إدخال كلمة المرور الجديدة: a-strong-MySQL-root-password
• هل ترغب في متابعة كلمة المرور المقدمة؟ Y
• إزالة المستخدمين المجهولين؟ Y
• عدم السماح بتسجيل الدخول إلى الجذر عن بُعد؟ Y
• هل تريد إزالة قاعدة بيانات الاختبار والوصول إليها؟ Y
• إعادة تحميل جداول الامتيازات الآن؟ Y

قم بتحسين أمان XWiki عن طريق تعديل ملف تكوين XWiki.

استخدم المحرر السادس لفتح ملف تكوين XWiki:

sudo vi /etc/xwiki/xwiki.cfg

ابحث عن الخطين الموضحين أدناه:

xwiki.authentication.validationKey=totototototototototototototototo
xwiki.authentication.encryptionKey=titititititititititititititititi

استبدل قيم كلا المعلمتين بسلسلتين عشوائيتين مختلفتين ، وتأكد فقط من أن طول كل سلسلة هو نفس السلسلة الأخرى ، على سبيل المثال:

xwiki.authentication.validationKey=f0130dfa6fc841e920d5e1056184c03e
xwiki.authentication.encryptionKey=z84kf92ko073tgjdnvkdfmms91qa0ke4

احفظ واخرج:

:wq!

الحصة الافتراضية للذاكرة منخفضة جدًا لتشغيل Tomcat 8 و XWiki في الداخل. تحتاج إلى زيادة حصة الذاكرة الافتراضية على النحو التالي قبل أن تتمكن من بدء نسخة XWiki في Tomcat 8 بشكل صحيح.

sudo cp /etc/default/tomcat8 /etc/default/tomcat8.bak
sudo vi /etc/default/tomcat8

ابحث عن الخط:

JAVA_OPTS="-Djava.awt.headless=true -Xmx128m -XX:+UseConcMarkSweepGC"

قم بتعديل الخط كما هو موضح أدناه:

JAVA_OPTS="-Djava.awt.headless=true -Xmx1024m"

ملاحظة: 1024M من الذاكرة ليست سوى الحد الأدنى من الحصة لتشغيل موقع XWiki صغير أو متوسط. قد تحتاج إلى إجراء تعديلات على هذا الخط وفقًا لمتطلباتك المحددة.

احفظ واخرج:

:wq!

أعد تشغيل Tomcat 8 من أجل تنفيذ جميع التعديلات الخاصة بك:

sudo systemctl restart tomcat8.service

تعديل قواعد جدار الحماية UFW للسماح بالوصول إلى الويب على المنفذ 8080:

sudo ufw allow 8080
sudo ufw enable

قم بتهيئة XWiki على Distribution Wizardواجهة الويب

عند هذه النقطة ، قمت بإعداد موقع XWiki فعال لكن فارغ. لملء المحتوى ، تحتاج إلى إنهاء العديد من مهام المتابعة ، بما في ذلك إنشاء مستخدم إداري وتثبيت نكهة وملحقات مطلوبة لهذا الويكي ، على واجهة ويب XWiki الأولية المسماة " Distribution Wizard".

قم بتوجيه متصفح الويب المفضل لديك إلى http://203.0.113.1:8080/xwiki، وسيتم نقلك تلقائيًا إلى Distribution Wizardواجهة الويب "". انقر على Continueزر " " لبدء المعالج.

في Step 1 - Admin userصفحة " " ، تحتاج إلى إدخال بيانات اعتماد المستخدم الإداري ، على سبيل المثال:

FIRST NAME: `John`
LAST NAME: `Doe`
USERNAME (Required): `johndoe`
PASSWORD (Required): `yourpassword`
CONFIRM PASSWORD (Required): `yourpassword`
EMAIL ADDRESS: `[email protected]`

بعد ملء جميع الحقول المطلوبة ، انقر فوق Register and loginالزر " " للمتابعة.

في الصفحة التالية التي تعرض " You are connected with user John Doe." ، انقر فوق Continueالزر " " لإنشاء المستخدم المسؤول John Doeالذي يكون اسم المستخدم الخاص به والمضي johndoeقدمًا.

في Step 2 - Flavorصفحة " " ، انقر فوق منطقة " XWiki Standard Flavor 9.11.2" لتمييز هذه النكهة ، ثم انقر فوق Install this flavorالزر " " للانتقال.

في الصفحة التالية التي تعرض تفاصيل " XWiki Standard Flavor 9.11.2" ، انقر فوق Installالزر " " لإجراء التثبيت.

بعد تثبيت النكهة ، سيتم إدراج جميع الإضافات المطلوبة في الصفحة ، انقر فوق Continueالزر " " لتثبيت كل هذه الإضافات .

بعد تثبيت النكهة وجميع الإضافات المطلوبة ، انقر على Continueزر " " في الزاوية اليمنى السفلية للمضي قدمًا.

في Step 4 - Reportصفحة " " ، يمكنك مراجعة جميع الصفحات التي تم إنشاؤها.

إذا لزم الأمر ، يمكنك حذف أي صفحات غير شعبية بالنقر على Xالزر الأحمر المقابل .

أخيرًا ، انقر فوق Continueالزر " " لإنهاء " Distribution Wizard". سيتم نقلك إلى لوحة معلومات XWiki كمستخدم مشرف قمت بإعداده سابقًا.

(اختياري) اختصر عنوان URL لموقع XWiki

بشكل افتراضي ، بما أن Tomcat يمكن أن يخدم أكثر من تطبيق واحد في نفس الوقت ، فأنت بحاجة إلى الوصول إلى موقع XWiki الخاص بك على عنوان URL http://203.0.113.1:8080/xwiki. ومع ذلك ، إذا كان XWiki هو التطبيق الوحيد الذي يعمل في Tomcat وتريد تقصير عنوان URL لموقع XWiki عن طريق إزالة /xwikiاللاحقة ، فيجب عليك تعديل ثلاثة ملفات تكوين XWiki على النحو التالي.

تعديل الملف 1:

cd /etc/tomcat8/Catalina/localhost/
sudo cp xwiki.xml ROOT.xml
sudo mv xwiki.xml xwiki.xml.bak

تعديل الملف 2:

cd /etc/xwiki
sudo cp xwiki-tomcat8.xml xwiki-tomcat8.xml.bak
sudo vi xwiki-tomcat8.xml

ابحث عن الخط:

<Context path="/xwiki" docBase="/usr/lib/xwiki" privileged="true" crossContext="true">

تعديل قيمة معلمة المسار:

<Context path="/" docBase="/usr/lib/xwiki" privileged="true" crossContext="true">

احفظ واخرج:

:wq!

تعديل الملف 3:

cd /etc/xwiki
sudo cp xwiki.cfg xwiki.cfg.bak
sudo vi xwiki.cfg

ابحث عن الخط:

# xwiki.webapppath=

أزعجها:

xwiki.webapppath=

احفظ واخرج:

:wq!

أخيرًا ، أعد تشغيل Tomcat 8 لتطبيق جميع تعديلاتك:

sudo systemctl restart tomcat8.service

من الآن فصاعدًا ، ستزور موقع XWiki http://203.0.113.1:8080/مباشرة.

(اختياري) قم بإعداد وكيل Nginx عكسي

بشكل افتراضي ، يعمل Tomcat 8 على المنفذ 8080، ويمكنك فقط زيارة موقع XWiki من نفس المنفذ. إذا كنت ترغب في تسهيل وصول الزوار عن طريق إزالة جزء رقم المنفذ ، يمكنك تثبيت Nginx كوكيل عكسي بين XWiki والزوار.

أولاً ، قم بتثبيت Nginx باستخدام apt:

sudo apt install nginx -y

بعد ذلك ، قم بإعداد Nginx كوكيل عكسي عن طريق تعديل تكوينات الموقع الافتراضية:

cd /etc/nginx/sites-available
sudo mv default default.bak
sudo vi default

املأ الملف بما يلي:

server {
listen 0.0.0.0:80;

proxy_request_buffering off;
proxy_buffering off;

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-Host $server_name;
}
}

احفظ واخرج:

:wq!

ابدأ تشغيل خدمة Nginx واضبطها بحيث تبدأ تلقائيًا عند بدء تشغيل النظام:

sudo systemctl restart nginx.service
sudo systemctl enable nginx.service

أخيرًا ، قم بتعديل قواعد جدار الحماية UFW وفقًا لذلك:

sudo ufw allow 80
sudo ufw deny 8080
sudo ufw reload

من الآن فصاعدًا ، لم يعد زوار موقع XWiki بحاجة إلى تحديد رقم المنفذ. يجب عليهم زيارة مباشرة http://203.0.113.1/.