تعریف اشیاء برای ریستور (Defining Objects for Restoration)

تعاریف کلیدی

• Source Backup File (فایل بکاپ منبع): فایلی که داده‌های موردنظر برای ریستور از آن خوانده می‌شود. می‌تواند یک فایل متادیتا (.xml) یا آرشیو بکاپ (.zip) باشد.
• Restoration Level (سطح بازیابی): محدوده یا سطحی از داده‌ها که باید بازیابی شوند (مثل کل سرور، ریسلرها، مشتری‌ها یا دامنه‌ها).
• Filter (فیلتر): روشی برای انتخاب دقیق‌تر اشیاء در یک سطح خاص (مثلاً فقط چند دامنه یا چند کاربر مشخص).
• License Keys (کلیدهای لایسنس): مجوزهای Plesk که به صورت پیش‌فرض در هنگام ریستور کامل سرور بازگردانی نمی‌شوند مگر با آپشن مخصوص.

وقتی می‌خواهید از ابزار pleskrestore استفاده کنید، باید تعیین کنید:

1. کدام فایل بکاپ منبع است؟
2. سطح بازیابی چه باشد؟ (سرور، ریسلر، مشتری یا سابسکریپشن)
3. آیا می‌خواهید روی سطح انتخاب‌شده فیلتر اعمال کنید یا خیر؟

1️⃣ مشخص کردن فایل بکاپ منبع

دو نوع فایل برای ریستور وجود دارد:

• <info>.xml → متادیتا بکاپ
  زمانی که بکاپ در فضای ذخیره‌سازی Plesk (Backup Storage) نگهداری شده باشد.
• <backup>.zip → فایل بکاپ آرشیو شده
  زمانی که بکاپ قبلاً Export شده و به صورت فایل فشرده ZIP ذخیره شده باشد.

📌 مثال‌ها:

• ریستور کامل سرور: <backup storage root>\<server>.xml
• ریستور یک مشتری از زیرمجموعه یک ریسلر :

: <backup storage root>\resellers\<reseller ID>\clients\<customer ID>\<customer>.xml

2️⃣ تعریف سطح بازیابی (Level of Restored Objects)

سطح ریستور با آپشن -level تعیین می‌شود. این پارامتر اجباری است.

📌 مثال‌ها:

• ریستور کل سرور:

pleskrestore --restore <backup storage root>\<server>.xml -level server

🔹 نکته: لایسنس‌ها به طور پیش‌فرض ریستور نمی‌شوند.

• ریستور کل سرور به همراه لایسنس:

pleskrestore --restore <backup storage root>\<server>.xml -level server -license

• ریستور همه دامنه‌ها (سابسکریپشن‌ها) متعلق به یک ریسلر:

pleskrestore --restore <backup storage root>\resellers\<reseller ID>\<reseller>.xml -level domains

• ریستور همه ریسلرها:

pleskrestore --restore <backup storage root>\<server>.xml -level resellers

3️⃣ اعمال فیلتر روی سطح انتخاب‌شده (Applying Filter)

اگر بخواهید فقط بخشی از اشیاء را در یک سطح خاص بازیابی کنید، از -filter استفاده می‌کنید.

دو روش برای اعمال فیلتر وجود دارد:

✅ الف) تعریف مستقیم در خط فرمان (Command Line Specification)

• استفاده از قالب list:<item1>,<item2>,...

📌 مثال ریستور دو ریسلر خاص از بکاپ سرور:

pleskrestore --restore <backup storage root>\<server>.xml -level resellers -filter list:JohnDoe,JaneDoe

📌 مثال ریستور دو دامنه خاص متعلق به ادمین:

pleskrestore --restore <backup storage root>\<server>.xml -level domains -filter list:example.com,sample.org

✅ ب) تعریف در فایل متنی (File Specification)

• آیتم‌ها (مثل دامنه‌ها یا کاربران) در یک فایل متنی ساده ذخیره می‌شوند (هر خط یک آیتم).
• مسیر فایل به عنوان مقدار -filter داده می‌شود.

📌 مثال ریستور چند دامنه متعلق به یک مشتری از فایل restore-subscriptions.txt:

pleskrestore --restore <backup storage root>\resellers\SandyLee\clients\JaneDow\<customer>.xml -level domains -filter <path to the file>\restore-subscriptions.txt

📊 جدول خلاصه (سطوح ریستور و فیلترپذیری)

⚠️ نکات مهم

1. سطح ریستور باید همیشه مشخص شود حتی اگر کل بکاپ همان سطح را پوشش دهد.
2. لایسنس‌ها در ریستور سرور به طور پیش‌فرض بازگردانی نمی‌شوند مگر با آپشن -license.
3. فیلترگذاری امکان کنترل دقیق‌تر ریستور را می‌دهد و برای ریستور انتخابی (Selective Restore) بسیار مهم است.
4. بکاپ‌های XML فقط متادیتا هستند و به محتوای اصلی (Content) در فایل ZIP لینک دارند.

کیان پور