رفع خطای yum-config-manager در DNF با زبان غیرانگلیسی

در سرورهای مبتنی بر AlmaLinux و CloudLinux 8 به بالا، ابزار yum-config-manager برای مدیریت مخازن نرم‌افزاری (repositories) استفاده می‌شود. این ابزار در پس‌زمینه از سیستم DNF به عنوان موتور مدیریت بسته استفاده می‌کند.

علائم و نشانه های خطای yum-config-manager

هنگامی که نیاز به تغییر تنظیمات مخازن سرور باشد (مانند فعال یا غیرفعال کردن یک مخزن)، cPanel از دستور yum-config-manager استفاده می‌کند. در صورتی که مخزن مورد نظر وجود نداشته باشد، سیستم DNF خطایی مشابه زیر را نمایش می‌دهد:

# yum-config-manager --disable test

Error: No matching repo to modify: test.

این خطا از نوع هشدار اطلاعاتی است و نیاز به اقدام اضافی ندارد و معمولاً توسط نرم‌افزار cPanel نادیده گرفته می‌شود.

اما در صورتی که زبان سیستم (locale) روی en_US.UTF-8 تنظیم نشده باشد (مثلاً فارسی یا زبان دیگری باشد)، خروجی این خطا به زبان محلی نمایش داده می‌شود. در این حالت، cPanel نمی‌تواند رشته انتظارشده (No matching repo to modify) را تشخیص دهد و خطا را به اشتباه به عنوان یک مشکل جدی تفسیر می‌کند، که منجر به شکست عملیات می‌شود.

توضیحات فنی و تکمیلی برای این خطا

cPanel به‌طور خاص به دنبال رشته انگلیسی No matching repo to modify در خروجی دستور است تا بفهمد آیا مخزن وجود ندارد یا مشکل دیگری رخ داده است. اگر زبان سیستم تغییر کرده باشد، این رشته به زبان دیگری (مثلاً فارسی) ترجمه می‌شود و cPanel آن را نمی‌شناسد.

این موضوع یک محدودیت شناخته‌شده است و تیم توسعه cPanel یک مورد داخلی با شماره CPANEL-48436 برای بررسی و رفع آن ایجاد کرده است. می‌توانید این مقاله را دنبال کنید تا با انتشار راه‌حل، از طریق ایمیل مطلع شوید.

راه‌حل موقت (Workaround)

برای انجام هر عملیاتی که نیاز به استفاده از yum-config-manager دارد، باید دستورات را از طریق خط فرمان (SSH) و با تنظیم موقت زبان سیستم به انگلیسی اجرا کنید. در ترمینال خود، دستور زیر را اجرا کنید:

export LANG="en_US.UTF-8"

پس از اجرای این دستور، تمام فرامین اجرایی در همین جلسه SSH، با زبان انگلیسی اجرا می‌شوند و cPanel قادر خواهد بود خطاها را به درستی تشخیص دهد.

⚠️ توجه: این تغییر فقط برای جلسه فعلی SSH اعمال می‌شود و پس از بسته شدن ارتباط، بازگشت به تنظیمات قبلی دارد. برای استفاده مجدد، باید دوباره دستور را اجرا کنید. این تغییر هیچ تأثیری بر سایر بخش‌های سرور ندارد.