~3 min read • Updated Feb 17, 2026
1. مقدمه
هنگامی که قصد دارید cPanel & WHM را به نسخه جدیدتر آپگرید کنید یا روی یک سرور تازه نصب کنید، سیستم قبل از شروع فرایند، مجموعهای از چکهای سازگاری انجام میدهد. اگر مشکلی وجود داشته باشد که مانع آپگرید شود، به آن Upgrade Blocker گفته میشود.
دو نوع چک وجود دارد:
- چکهای استاندارد: همیشه انجام میشوند.
- چکهای خاص نسخه: فقط برای نسخهای که قصد نصب یا آپگرید دارید اعمال میشوند.
اگر بلاکر وجود داشته باشد:
- آپگرید متوقف میشود.
- سرور روی نسخه فعلی باقی میماند.
- لیست مشکلات برای root ایمیل میشود.
- لاگ در
/usr/local/cpanel/logs/error_logثبت میشود.
2. هشدارهای مهم قبل از هر آپگرید
- حداقل ۵ گیگابایت فضای خالی در
/usr/local/cpanelلازم است. - اگر از FTP unmanaged استفاده میکنید، آن را به حالت managed برگردانید:
WHM → FTP Server Configuration → Package Management → Managed- بعد از آپگرید، امکان downgrade وجود ندارد.
3. آپگریدهای چندمرحلهای (Multiple Major Versions)
اگر فاصله نسخه فعلی تا نسخه هدف زیاد باشد، سیستم مرحله به مرحله آپگرید میکند.
مثال:
نسخه فعلی: 80
نسخه هدف: 86
مسیر آپگرید: 80 → 82 → 84 → 86
در هر مرحله چک انجام میشود. اگر یک مرحله بلاکر داشته باشد، آپگرید متوقف میشود.
نکته: اگر نسخه شما خیلی قدیمی است (مثلاً زیر ۹۰)، بهتر است ابتدا دستی به نسخه میانی بروید (با ویرایش /etc/cpupdate.conf) و سپس به نسخه نهایی آپگرید کنید.
4. چکهای استاندارد (همیشه انجام میشوند)
| چک | توضیح | راهحل |
|---|---|---|
| فایل لایسنس معتبر | لایسنس باید معتبر و قابل خواندن باشد. | اجرای /usr/local/cpanel/cpkeyclt یا خرید/تمدید لایسنس. |
| فایلسیستم read-only نبودن | پوشههای مهم نباید read-only باشند. | ریمانت کردن فایلسیستم یا رفع مشکل دیسک. |
| سلامت دیتابیس RPM | در سیستمهای غیر اوبونتو، RPM باید سالم باشد. | اجرای rpm --rebuilddb یا تست yum. |
5. چکهای خاص نسخه (Version-Specific Blockers)
در جدول زیر مهمترین بلاکرهای نسخههای ۱۱۰ تا ۱۳۰ آورده شده است:
| نسخه cPanel | مشکل / سیستمعامل بلاکشده | راهحل |
|---|---|---|
| 134+ | Rocky Linux 8 و 9 | مهاجرت به AlmaLinux 9 یا Rocky 9.5+ |
| 132 | MySQL 5.5 و 5.6 (حتی remote) | آپگرید به MySQL 5.7+ یا MariaDB |
| 132 | AlmaLinux 9 / Rocky 9 / CloudLinux 9 باید 9.5+ باشند | آپدیت سیستمعامل به 9.5+ |
| 120 | Ubuntu 20.04 | مهاجرت به Ubuntu 22.04 LTS |
| 112 | Rocky Linux 8 و 9 | مهاجرت به نسخه جدیدتر یا AlmaLinux |
| 102 | CentOS 8 (EOL) | مهاجرت به AlmaLinux 8 یا Rocky 8 |
| 98–100 | Ubuntu 20.04 (پشتیبانی متوقف شده) | آپگرید به نسخه جدیدتر |
| 88–90 | CentOS 7، CloudLinux 6/7، RHEL 7 | مهاجرت به سیستمعامل جدیدتر |
| 86–88 | Amazon Linux 1، CentOS 6، RHEL 6 | مهاجرت فوری |
| 78 | EasyApache 3 | مهاجرت به EasyApache 4 |
| 68 | LiteSpeed قدیمیتر از 5.2.1 build 2 | آپدیت LiteSpeed |
| 58 | سیستمعاملهای ۳۲-بیت، Amazon Linux 1، CentOS 5 | مهاجرت به سیستمعامل ۶۴-بیت |
| 52 | MySQL 5.1 و قدیمیتر | آپگرید به MySQL 5.5+ یا MariaDB |
6. جمعبندی و توصیههای مهم
- حداقل ۵ گیگ فضای خالی در
/usr/local/cpanelداشته باشید. - قبل از آپگرید، بکاپ کامل بگیرید:
WHM → Backup → Backup Configuration- لایسنس باید معتبر باشد.
- سرویسهای unmanaged مثل FTP را به حالت managed برگردانید.
- اگر چند مرحله آپگرید دارید، سیستم خودش مرحله به مرحله چک میکند.
- اگر بلاکر دیدید، ابتدا آن را رفع کنید و سپس آپگرید را اجرا کنید:
/scripts/upcp --force- اگر نسخه شما خیلی قدیمی است (زیر ۱۰۰)، بهتر است ابتدا به نسخه میانی بروید.
نتیجهگیری
Upgrade Blockerها نقش مهمی در جلوگیری از نصب یا آپگرید ناقص دارند. شناخت این بلاکرها و رفع آنها قبل از آپگرید، باعث میشود فرایند نصب یا ارتقا بدون مشکل انجام شود و سرور در وضعیت پایدار باقی بماند.
Written & researched by Dr. Shahin Siami