نحوه نصب XWiki 9.11.x در اوبونتو 16.04 LTS

• پیش نیازها
• بازپرداخت XWiki LTS APT را تنظیم کنید
• همه موارد را در یک بسته XWiki (از جمله XWiki LTS 9.11.2 ، Tomcat 8 ، MySQL 5.7 و موارد دیگر) نصب کنید.
• XWiki را در رابط وب "Wizard Distribution" آغاز کنید
• (اختیاری) URL سایت XWiki را کوتاه کنید
• (اختیاری) یک پروکسی معکوس Nginx را تنظیم کنید

XWiki یک سیستم عامل ویکی منبع باز محبوب در سطح سازمانی است که به زبان جاوا نوشته شده است. با قابلیت توسعه و سهولت استفاده ، XWiki در شرکت های مختلف به عنوان مخزن دانش ، پورتال عمومی و ... مستقر می شود.

در این مقاله ، شما را با روند نصب XWiki 9.11.2 در نمونه سرور Ubuntu 16.04 LTS راهنمایی می کنم. OpenJDK 8 ، Tomcat 8 و MySQL 5.7 به طور خودکار به عنوان وابستگی در طی مراحل نصب نصب می شوند.

پیش نیازها

• نمونه سرور جدید Vultr Ubuntu 16.04 LTS x64 با حداقل 2 GB حافظه ، 4 GB یا بیشتر توصیه می شود. بگویید آدرس IP آن است 203.0.113.1.
• کاربران از sudo .
• نمونه سرور با استفاده از آخرین وضعیت پایدار به روز شده است apt.

بازپرداخت XWiki LTS APT را تنظیم کنید

به عنوان یک کاربر سودو وارد شوید ، و سپس بارگیری مجدد APT XWiki LTS (پشتیبانی طولانی مدت) را در نمونه سرور خود بارگیری و تنظیم کنید:

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 Datum Java Servlet و پایگاه داده کار کند. به عنوان یک پلت فرم ویکی انعطاف پذیر ، XWiki رسما گزینه های مختلف ادغام را ارائه می دهد. می توانید از دستور زیر برای نمایش همه گزینه های موجود در repo XWiki LTS APT استفاده کنید:

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 تنظیم کنید. فقط کافی است قسمت گذرواژه را خالی بگذارید و فشار دهید 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 را بهبود بخشید.

از ویرایشگر vi برای باز کردن پرونده پیکربندی 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 می تواند بیش از یک برنامه را همزمان انجام دهد ، باید به URL XWiki خود در URL دسترسی پیدا کنید http://203.0.113.1:8080/xwiki. اما اگر XWiki تنها برنامه اجرا شده در Tomcat است و می خواهید با حذف /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

از این پس ، http://203.0.113.1:8080/به طور مستقیم از سایت XWiki خود بازدید خواهید کرد .

(اختیاری) یک پروکسی معکوس 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/.