50 lines
5.5 KiB
Markdown
50 lines
5.5 KiB
Markdown
# راهنمای نصب Raymand CTI 3.0.0
|
|
|
|
این راهنما برای نصب اولیه و اجرای مجدد جهت بهروزرسانی Raymand CTI است. پیشنیازها از مخازن آنلاین دریافت میشوند؛ بستهٔ برنامه و ایمیج Asterisk همراه نصبکننده هستند.
|
|
|
|
## پیش از شروع
|
|
|
|
- سرور باید Debian نسخهٔ 11، 12 یا 13 و معماری amd64 داشته باشد.
|
|
- سرور هنگام نصب باید به اینترنت وصل باشد تا بستههای لازم دریافت شوند.
|
|
- `openssh-server` در نصب اجباری است تا دسترسی SSH پس از نصب وجود داشته باشد.
|
|
- برای نصب، با حساب مدیر سرور (root) وارد شوید.
|
|
|
|
## نصب
|
|
|
|
1. پوشهٔ کامل `online-installer` را به سرور منتقل کنید. همهٔ فایلهای داخل پوشه، از جمله `install.sh` و پوشهٔ `repo`، باید کنار هم باقی بمانند.
|
|
2. در ترمینال سرور، وارد پوشهٔ منتقلشده شوید. اگر آن را در مسیر `/root/installer/online-installer` قرار دادهاید، این دستور را وارد کنید:
|
|
|
|
```sh
|
|
cd /root/installer/online-installer
|
|
```
|
|
|
|
3. نصب را شروع کنید:
|
|
|
|
```sh
|
|
./install.sh
|
|
```
|
|
|
|
4. نصبکننده پیش از شروع تغییرات هشدار میدهد و تأیید میخواهد. با واردکردن `YES` ادامه دهید. پیش از جایگزینی برنامه، نسخهٔ پشتیبان زماندار از فایلهای برنامه، رابط وب و دیتابیس موجود در مسیر `/var/backups/raymand-cti/` ذخیره میشود. اگر فضای کافی نباشد یا تهیهٔ بکاپ کامل نشود، نصب متوقف خواهد شد. برای ذخیره روی دیسک پشتیبانِ متصلشده، مسیر را هنگام اجرا مشخص کنید:
|
|
|
|
```sh
|
|
RAYMAND_CTI_BACKUP_DIR=/mnt/backup/raymand-cti ./install.sh
|
|
```
|
|
|
|
5. تا پایان نصب، ترمینال را باز بگذارید. صفحه وضعیت مراحل را نشان میدهد. وقتی نصب کامل شد، با مرورگر به نشانی امن سرور بروید: `https://آدرس-سرور`. در نصب پیشفرض از گواهی self-signed استفاده میشود؛ مرورگر دربارهٔ ناشناس بودن صادرکننده هشدار میدهد. پس از اطمینان از نشانی سرور، هشدار را تأیید و ادامه دهید.
|
|
|
|
در هر اجرا، بستهٔ برنامه حتی با همان شمارهٔ نسخه بهاجبار بازنصب میشود. فایلهای برنامه جایگزین میشوند و تطابق فایل JAR نصبشده با بسته از طریق SHA256 بررسی میشود. تنظیمات موجود و فایل لایسنس حفظ میشوند.
|
|
|
|
برای بهروزرسانی، همین پوشه را کامل منتقل و همان دستور نصب را اجرا کنید. سرویس CTI پیش از بکاپ فایلها و دیتابیس متوقف میشود و پس از آمادهشدن Asterisk دوباره اجرا میشود؛ بنابراین نصب باعث وقفهٔ سرویس میشود. بکاپ شامل لایسنس، تنظیمات Asterisk، تنظیمات وب و گواهی HTTPS نیز هست. فایلهای ضبط مکالمه و محلهای NAS در این بکاپ کپی نمیشوند و نصبکننده آنها را حذف نمیکند.
|
|
|
|
اگر بکاپ شکست بخورد، سرویس CTI قبلی دوباره اجرا میشود. اگر نصب بسته یا مراحل بعد از آن شکست بخورد، ممکن است CTI متوقف بماند؛ ابتدا لاگ را بررسی و اشکال را رفع کنید و دوباره نصبکننده را اجرا کنید. بازگردانی خودکار دیتابیس انجام نمیشود.
|
|
|
|
نصبکننده کل سرویس Docker را ریاستارت نمیکند و پردازش اشغالکنندهٔ پورت وب را خودکار متوقف نمیکند. اگر پورتهای تنظیمشدهٔ Nginx در اختیار Apache، کانتینر دیگر یا Nginx خارج از مدیریت systemd باشند، نصب با گزارش پردازش متوقف میشود. پیش از اجرای مجدد باید تداخل پورت رفع شود.
|
|
|
|
اگر سرویسهای رایج وب مانند Apache، lighttpd، Caddy، httpd یا HAProxy روی سیستم فعال یا فعالشده باشند، نصبکننده آنها را متوقف و غیرفعال میکند تا Nginx بتواند پورتهای CTI را بگیرد؛ بستهٔ آنها حذف نمیشود.
|
|
|
|
## اگر نصب با خطا متوقف شد
|
|
|
|
فایل `latest.log` در همان پوشهٔ `online-installer` ذخیره میشود. این فایل را برای پشتیبانی Raymand CTI بفرستید تا علت خطا بررسی شود.
|
|
|
|
مجوز نرمافزار (لایسنس) جداگانه ارائه میشود و همراه فایل نصب نیست. پس از نصب، فعالسازی یک لایسنس معتبر برای باز شدن قابلیتهای CTI الزامی است؛ تا زمان فعالسازی، فقط ورود، تنظیمات شبکه و صفحهٔ فعالسازی لایسنس در دسترس هستند.
|