چگونه تنظیمات Metadata را مدیریت کنیم
معتبر برای نسخههای 76 تا آخرین نسخه
نسخه: 76
آخرین ویرایش: 28 ژانویه 2026
Overview
مدیران WHM میتوانند ساخت Metadata را از طریق رابط Backup Configuration مدیریت کنند:
WHM » Home » Backup » Backup Configuration
بهصورت پیشفرض، هر بار که cPanel & WHM یک بکاپ ایجاد میکند، Metadata مربوط به آن بکاپ نیز ساخته میشود. ممکن است بخواهید ساخت Metadata را برای تست، قبل از ارتقا یا هنگام مشکلات عملکردی غیرفعال کنید.
نکات:
- اسکریپت
backups_create_metadataبرای تمام دایرکتوریهای/home/usernameMetadata ایجاد میکند، بهجز/mailو/.cpanel. - برای نمایش رابطهای زیر، باید حداقل یک بکاپ و Metadata روی دیسک محلی وجود داشته باشد:
- cPanel » Home » Files » File and Directory Restoration
- WHM » Home » Backups » File and Directory Restoration
Metadata Databases
هر بار که بکاپ ایجاد میشود، Metadata آن در یک دیتابیس با نام username.db ذخیره میشود که username نام کاربر cPanel است.
این دیتابیس در دایرکتوری .meta داخل مسیر بکاپ ذخیره میشود. Metadata شامل اطلاعات ایندکسشده است که جستجو و بازیابی را بسیار سریعتر از فایلهای بکاپ حجیم انجام میدهد.
Metadata Database Tables
Metadata شامل جداول زیر است:
- backup_paths — مسیر فایلهای بکاپ
- backups — لیست بکاپهای موجود روی دیسک
- file_changes — تغییرات فایلها در بکاپها
- metadata — نسخهٔ Schema و اطلاعات Metadata
- seen_files — مسیر فایلهای موجود در بکاپ
جدول backup_paths
| Field | Type | Description | Example |
|---|---|---|---|
| backup_path | string | مسیر فایل بکاپ | /backup/2018-04-12/accounts |
| backup_id | integer | شناسه بکاپ | 1 |
جدول backups
| Field | Type | Description | Example |
|---|---|---|---|
| backup_id | integer | شناسه یکتا | 1 |
| timestamp | timestamp | زمان ایجاد بکاپ (UTC) | 1523642274 |
| does_exist | Boolean | وجود فایل بکاپ | 1 |
جدول file_changes
| Field | Type | Description | Example |
|---|---|---|---|
| seen_files_id | integer | شناسه فایل | 1 |
| backup_id | integer | شناسه بکاپ | 1 |
| size | integer | حجم فایل | 660 |
| mtime | integer | زمان آخرین تغییر (UTC) | 1523642274 |
| operation | integer | نوع تغییر (0=ایجاد، 1=تغییر، 2=حذف) | 0 |
| type | integer | نوع فایل (0=فایل، 1=دایرکتوری، 2=Symlink) | 0 |
جدول metadata
| Field | Type | Description | Example |
|---|---|---|---|
| key | string | نوع Schema | schema_version |
| value | string | نسخه Schema | 3.1 |
جدول seen_files
| Field | Type | Description | Example |
|---|---|---|---|
| file_id | integer | شناسه فایل | 1 |
| path | string | مسیر فایل نسبت به /home/username | /public_html/ |
The Master Meta File
فایل .master.meta شامل اطلاعات ثابت دربارهٔ بکاپهای کاربر است. این فایل در دایرکتوری هر حساب در بکاپهای روزانه، هفتگی و ماهانه وجود دارد.
Backup Directory Structure
بکاپها در مسیر /backup در سه فرمت ذخیره میشوند:
| Format | Extension | Example |
|---|---|---|
| Compressed | .tar.gz | username.tar.gz |
| Uncompressed | .tar | username.tar |
| Incremental | None | username |
سیستم بکاپها را با مسیر کامل آنها تشخیص میدهد و Metadata مربوطه در جدول backup_paths ذخیره میشود.
Disable Metadata Creation
میتوانید ساخت Metadata را از طریق WHM یا تنظیمات سیستمی غیرفعال کنید.
وقتی Metadata غیرفعال شود:
- رابط File and Directory Restoration در cPanel غیرفعال میشود.
- رابط File and Directory Restoration در WHM غیرفعال میشود.
- پیامی نمایش داده میشود که دلیل غیرفعال بودن را توضیح میدهد.
همچنین میتوانید از WHM API 1 و تابع backup_config_set برای غیرفعالسازی Metadata استفاده کنید.
Metadata-Related Settings
| Config Setting | Interface Setting | Description | Values |
|---|---|---|---|
| DISABLE_METADATA | None (API only) | فعال/غیرفعال کردن ساخت Metadata | yes / no |
| BACKUPACCTS | Backup Accounts | شامل کردن حسابهای cPanel در بکاپ | yes / no |
| BACKUPENABLE | Backup Status | فعال/غیرفعال کردن بکاپ | yes / no |
| BACKUPMOUNT | Mount Backup Drive as Needed | Mount کردن مسیر بکاپ قبل از اجرا | 1 / 0 |
| KEEPLOCAL | Retain backups in default directory | نگهداشتن بکاپهای محلی | 1 / 0 |
Conclusion
Metadata نقش مهمی در بازیابی سریع فایلها و مدیریت مؤثر بکاپها دارد. با درک نحوهٔ ساخت، ذخیرهسازی و غیرفعالسازی Metadata، میتوانید عملکرد سرور را بهینه کرده و کنترل بیشتری روی فرآیند بکاپ داشته باشید.