نام (NAME)

innupgrade - ارتقای پرونده‌های پیکربندی INN

خلاصه دستور (SYNOPSIS)

innupgrade directory

innupgrade [-t type] -f file

توضیحات (DESCRIPTION)

دستور innupgrade برای اجرا در هنگام یک ارتقای عمدهٔ INN به‌منظور اصلاح پرونده‌های پیکربندی با تغییرات لازم در نظر گرفته شده است. اگر یک دایرکتوری به آن داده شود، آن دایرکتوری را برای هر پرونده‌ای که به‌روزرسانی‌هایی برای آن تعریف شده باشد پویش می‌کند، تلاش می‌کند آن به‌روزرسانی‌ها را انجام دهد، و در صورتی که اعمال به‌روزرسانی‌ها منجر به هرگونه تغییری شود، پرونده‌ها را با نسخه‌های به‌روزشده جایگزین می‌کند. نسخه‌های قدیمی پرونده‌ها با پسوند ".OLD" ذخیره خواهند شد.

اگر گزینهٔ -f استفاده شود، تنها همان پرونده به‌روزرسانی خواهد شد. اگر نام پرونده با نام استاندارد یک پروندهٔ پیکربندی INN مطابقت نداشته باشد، می‌توان از گزینهٔ اختیاری -t برای تعیین نوع استفاده کرد. برای مثالی از این مورد، به بخش «مثال‌ها (EXAMPLES)» مراجعه کنید.

در حال حاضر، innupgrade می‌داند چگونه به‌روزرسانی‌های زیر را اعمال کند:

incoming.conf

تغییر نام nolist و noresendid به ترتیب به list و resendid. معکوس کردن مقادیر بولی مرتبط (از INN 2.7).
کامنت کردن پارامترهای حذف‌شدهٔ comment و email (از INN 2.7).

inn.conf

قرار دادن مقادیر دارای فاصله در علامت نقل‌قول و کامنت کردن کلیدهای بدون مقدار، که برای تغییر تجزیه‌کننده‌های پیکربندی معرفی‌شده در INN 2.4 لازم است. قالب جدید با تجزیه‌کنندهٔ پیشین سازگار به عقب نیست، زیرا تجزیه‌کنندهٔ پیشین علامت‌های نقل‌قول دوتایی را در مقدار پارامتر لحاظ می‌کند.
افزودن پارامتر hismethod در صورت پیدا نشدن (معرفی‌شده در INN 2.4، با مقدار پیش‌فرض "hisv6").
تغییر نام nntpactsync به incominglogfrequency (از INN 2.5). تغییر نام addnntppostingdate و addnntppostinghost به ترتیب به addinjectiondate و addinjectionpostinghost (از INN 2.6).
حذف پارامترهای refusecybercancels و verifycancels (از INN 2.7).
اگر پروندهٔ overview.fmt وجود داشته باشد، محتوای آن در پارامترهای extraoverviewadvertised و extraoverviewhidden معرفی‌شده در INN 2.5 ادغام می‌شود. سپس پرونده به overview.fmt.OLD تغییر نام می‌یابد.
اگر پروندهٔ sasl.conf وجود داشته باشد، محتوای آن در پارامترهای tlscapath، tlscafile، tlscertfile و tlskeyfile معرفی‌شده در INN 2.5 ادغام می‌شود. سپس پرونده به sasl.conf.OLD تغییر نام می‌یابد.

inn-secrets.conf

•: ایجاد پروندهٔ inn-secrets.conf غیرقابل خواندن برای همگان (non-world-readable) در pathetc در صورتی که از قبل وجود نداشته باشد (جدید در INN 2.7).

newsfeeds

جایگزینی استفاده از startinnfeed با فراخوانی مستقیم مناسبِ innfeed یا imapfeed (startinnfeed در INN 2.5 حذف شد).
جایگزینی استفاده از filechan با buffchan در حالت بدون بافر (unbuffered) (filechan در INN 2.7 حذف شد).

readers.conf

•: تغییر نام require_ssl به require_encryption (از INN 2.7).

چند برنامه یا پروندهٔ پیکربندی منسوخ توسط innupgrade با پسوند ".OLD" تغییر نام می‌یابند. صفحه‌های راهنمای منسوخ مستقیماً حذف می‌شوند.

به‌طور معمول، innupgrade باید حداقل بر روی دایرکتوری pathetc پس از هر ارتقای INN غیر از انتشار وصله (هر ارتقایی که اعداد نگارش اول یا دوم را تغییر می‌دهد) اجرا شود. این کار ممکن است به‌طور خودکار در طول فرایند ارتقا رخ دهد.

گزینه‌ها (OPTIONS)

-f file: تنها روی file عمل کند به‌جای کار روی کل یک دایرکتوری.
-t type: برای پرونده‌ای که با -f مشخص شده است، آن را طوری تجزیه و ارتقا دهد که گویی نام آن type بوده است. برای ارتقای پرونده‌هایی با ساختار نحوی مشابه پرونده‌های پیکربندی معمولی INN اما با نام‌های دیگر استفاده می‌شود. تنها در ترکیب با -f کاربرد دارد.

مثال‌ها (EXAMPLES)

ارتقای تمام پرونده‌های پیکربندی یافت‌شده در pathetc و افزودن پسوند ".OLD" به پرونده‌های منسوخ در pathetc:

innupgrade <pathetc in inn.conf>

ارتقای تنها /news/etc/inn.conf:

innupgrade -f /news/etc/inn.conf

ارتقای پرونده‌ای به نام inn-special.conf که باید ساختار نحوی مشابهی با inn.conf داشته باشد:

innupgrade -t inn.conf -f inn-special.conf

هر قانون ارتقایی که برای inn.conf اعمال شود، بر روی پروندهٔ جایگزین نیز اعمال خواهد شد.

تاریخچه (HISTORY)

نوشته‌شده توسط Russ Allbery <eagle@eyrie.org> برای InterNetNews.

همچنین ببینید (SEE ALSO)

incoming.conf(5), inn.conf(5), inn-secrets.conf(5), newsfeeds(5), readers.conf(5).