آموزش کامل مهاجرت سرور DirectAdmin

1. آماده‌سازی سرور

برای شروع فرآیند مهاجرت، ابتدا لازم است DirectAdmin روی سرور جدید نصب شود.

• برای نصب، باید یک لایسنس موقت رایگان جهت مهاجرت درخواست کنید. این کلید موقت را روی سرور جدید اعمال کرده و DirectAdmin را نصب کنید.
• پس از پایان فرآیند انتقال، لایسنس اصلی خود را روی سرور جدید اعمال نمایید.

نکته در مورد لایسنس‌های قدیمی (Legacy Licenses)

اگر از لایسنس‌های قدیمی استفاده می‌کنید، امکان دریافت لایسنس موقت وجود ندارد. در این حالت باید یک لایسنس قدیمی دیگر برای مهاجرت استفاده شود. تلاش برای استفاده از کلید جدید منجر به شکست خواهد شد، زیرا نصب جدید اجازه‌ی Downgrade به نسخه‌ی قدیمی را نمی‌دهد.

روش‌های نصب DirectAdmin

سه روش اصلی برای نصب DirectAdmin وجود دارد:

A. (آسان) نصب پیش‌فرض

این روش تنها با یک دستور انجام می‌شود و تمام نسخه‌های پیشنهادی PHP و نرم‌افزارهای لازم به‌صورت خودکار نصب خواهند شد.
این گزینه برای اکثر کاربران مناسب است، مخصوصاً زمانی که نیاز به نسخه‌های سفارشی یا نرم‌افزارهای خاص ندارند.

B. (متوسط) بارگذاری متغیرهای مهم قبل از نصب

در این روش می‌توان برخی متغیرهای کلیدی را قبل از اجرای نصب تعریف کرد. مثال:

export DA_EMAIL=email@example.com
export DA_NS1=ns1.example.com
export DA_NS2=ns2.example.com
export php1_release=8.0
./setup.sh LICENSE_KEY

C. (پیشرفته) بارگذاری options.conf قبل از نصب

• می‌توانید فایل options.conf را قبل از نصب روی سرور جدید کپی کنید.
• همچنین امکان همگام‌سازی کل مسیر /usr/local/directadmin/custombuild/custom/ با سرور جدید وجود دارد. این روش زمانی مفید است که بخواهید سرور مقصد دقیقاً با تنظیمات سرور مبدا مطابقت داشته باشد.

نکته: قبل از نصب بررسی کنید که نسخه‌ی فعلی DirectAdmin از همان نسخه‌های PHP و MySQL/MariaDB که در سرور مبدا استفاده شده، پشتیبانی می‌کند.
اگر نسخه‌ها بسیار قدیمی باشند، نصب کامل نخواهد شد. در این حالت باید مشکل را اصلاح کنید و مجدداً ./setup.sh را اجرا نمایید.

2. موارد مهم قبل از مهاجرت

الف) DNS

DNS مهم‌ترین بخش در زمان برنامه‌ریزی برای مهاجرت است. باید مشخص کنید چه کسی کنترل Zoneهای DNS برای دامنه‌هایی که قصد انتقال دارید را بر عهده دارد.

• بررسی کنید همه‌ی دامنه‌ها روی سرور شما تحت کنترل DNS سرورهای شما هستند. در غیر این صورت کاربران باید به‌صورت دستی DNS خود را به سرور جدید تغییر دهند.
• TTL را قبل از مهاجرت کاهش دهید.
• تغییرات در رجیسترار (Registrar) ممکن است بیش از ۲۴ ساعت طول بکشد. اگر بعد از مهاجرت نیاز به تغییر رکوردهای Glue یا DNS داشته باشید، پیشنهاد می‌شود DNS Zones را هم در سرور مبدا و هم مقصد به‌روز کنید. این روش بسیار مطمئن‌تر از اتکا به APIهای رجیسترار است و باعث می‌شود کاربران بدون مشکل به مقصد هدایت شوند.

ب) فایل تنظیمات (directadmin.conf)

معمولاً امن‌ترین حالت این است که نسخه پیش‌فرض روی سرور جدید باقی بماند.

• تنها مواردی مثل ns1/ns2 و max_username را بررسی و اصلاح کنید.
• اگر تنظیمات شخصی‌سازی شده‌ای در این فایل دارید، می‌توانید آن را کپی کنید.

ج) موارد دیگر

• وظایف بکاپ (Backup Tasks) را مجدداً ذخیره کنید.
• اگر قالب‌ها یا اسکریپت‌های سفارشی دارید
  (/usr/local/directadmin/data/templates/custom و /usr/local/directadmin/scripts/custom)
  ، آن‌ها را بدون بررسی کپی نکنید؛ زیرا ممکن است مربوط به پلاگین‌های نصب‌شده روی سرور مبدا باشند.
• تنظیمات Multi-Server را مجدداً پیکربندی کنید.
• فایل‌های php.ini برای همه‌ی نسخه‌های PHP را بررسی کنید.

3. روش‌های انتقال (Migration Methods)

سه روش اصلی برای مهاجرت کامل DirectAdmin به DirectAdmin وجود دارد:

• روش اول (آسان): Full Backup
• روش دوم (متوسط): Partial Backup با همگام‌سازی home
• روش سوم (پیشرفته): Partial Backup با همگام‌سازی home و MySQL

هرچه روش پیشرفته‌تر باشد، زمان Downtime کمتر خواهد بود؛ اما در صورت خطا، احتمال از دست دادن داده‌ها بیشتر است.
همچنین می‌توان از تکنیک مهاجرت دو مرحله‌ای (2 Stage Migration) استفاده کرد: ابتدا یک انتقال آزمایشی انجام دهید و در روز نهایی، تنها یک rsync سریع روی داده‌ها اجرا کنید.

در صورت بروز مشکل، می‌توانید از خدمات مشاوران مدیریت سرور کمک بگیرید.

A. (آسان) روش (Full Backup)

این روش برای کاربران تازه‌کار پیشنهاد می‌شود.

مراحل:

1. از تمام کاربران بکاپ بگیرید:
   • مسیر: Admin Tools -> Admin Backup/Transfer
   • تنظیمات:
     • Who: همه‌ی کاربران
     • When: هم‌اکنون
     • Where: /home/admin/admin_backups/
     • What: همه داده‌ها
2. بکاپ را به سرور مقصد منتقل کنید:

rsync -av /home/admin/admin_backups/ root@dest_server_ip:/home/admin/admin_backups/ --delete

3. در سرور مقصد، همان بخش Admin Backup/Transfer را باز کرده و اکانت‌ها را Restore کنید.
4. در Messaging System بررسی کنید که همه‌ی اکانت‌ها به‌درستی بازیابی شده‌اند.

پایان.

B. (متوسط) روش Partial Backup با همگام‌سازی (home)

این روش مراحل بیشتری دارد اما Downtime کمتری ایجاد می‌کند.

مراحل:

1. تمام مراحل روش A را انجام دهید، با یک تفاوت:
   • هنگام گرفتن بکاپ، در بخش What گزینه‌های Domains Directory و E-mail Data را غیرفعال کنید.
2. بکاپ‌ها را Restore کنید و مطمئن شوید همه‌ی کاربران بدون خطا بازگردانی شده‌اند.
3. کل مسیر /home را با دستور زیر همگام‌سازی کنید:

rsync -av --progress --delete /home/ root@dest_server_ip:/home/

⚠️ توجه: این دستور تخریبی است و همه چیز در /home/ سرور مقصد را پاک کرده و از نو کپی می‌کند.

پایان.

C. (پیشرفته) روش Partial Backup با همگام‌سازی (home و MySQL)

این روش نیازمند دانش بیشتر است و در صورت خطا، ممکن است داده‌ها از بین بروند.

مراحل:

1. همانند روش A، بکاپ بگیرید اما در بخش What گزینه‌های زیر را غیرفعال کنید:
   • Domains Directory
   • E-mail Data
   • Database Settings
   • Database Data
2. مطمئن شوید همه‌ی کاربران بدون خطا بازگردانی شده‌اند.
3. مسیر /home را همگام‌سازی کنید (همانند روش B).
4. سرویس MySQL/MariaDB را روی هر دو سرور متوقف کنید:

sed -i -e 's/mysqld=ON/mysqld=OFF/g' /usr/local/directadmin/data/admin/services.status
systemctl stop mysqld

⚠️ حتماً سرویس MySQL روی هر دو سرور خاموش باشد.

5. دیتابیس را با rsync منتقل کنید:

rsync -av --delete --progress /var/lib/mysql/ root@dest_server_ip:/var/lib/mysql_new/

6. دوباره همین دستور را اجرا کنید تا مطمئن شوید چیزی تغییر نکرده است (اگر تغییر کرده، یعنی MySQL خاموش نبوده است).
7. مسیر /var/lib/mysql_new/ را به /var/lib/mysql/ تغییر نام دهید.
8. فایل‌های پیکربندی دیتابیس (my.cnf و mysql.conf) را از سرور مبدا کپی کنید.
9. سرویس MariaDB را راه‌اندازی کرده و سلامت دیتابیس را بررسی کنید. اگر نسخه مقصد جدیدتر است، دستور زیر را اجرا کنید:

mysql_upgrade

10. برای بازسازی دسترسی‌ها، دستور زیر را اجرا کنید:

da build roundcube

پایان.