نام (NAME)

journal-remote.conf - فایل پیکربندی دریافت ژورنال از راه دور

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

/etc/systemd/journal-remote.conf

/run/systemd/journal-remote.conf

/usr/local/lib/systemd/journal-remote.conf

/usr/lib/systemd/journal-remote.conf

/etc/systemd/journal-remote.conf.d/*.conf

/run/systemd/journal-remote.conf.d/*.conf

/usr/local/lib/systemd/journal-remote.conf.d/*.conf

/usr/lib/systemd/journal-remote.conf.d/*.conf

توضیحات (DESCRIPTION)

این فایل‌ها پارامترهای مختلف systemd-journal-remote.service(8) را پیکربندی می‌کنند. برای توضیحات کلی درباره ساختار نحوی به systemd.syntax(7) مراجعه کنید.

دایرکتوریهای پیکربندی و اولویتبندی (CONFIGURATION DIRECTORIES AND PRECEDENCE)

پیکربندی پیش‌فرض در زمان کامپایل تعیین می‌شود، بنابراین پیکربندی تنها زمانی مورد نیاز است که لازم باشد از مقادیر پیش‌فرض انحراف ایجاد شود. فایل پیکربندی اصلی از یکی از دایرکتوری‌های فهرست‌شده به ترتیب اولویت بارگذاری می‌شود و تنها از اولین فایل یافت‌شده استفاده می‌گردد: /etc/systemd/، /run/systemd/، /usr/local/lib/systemd/ [1]، /usr/lib/systemd/. نسخه ارائه‌شده توسط توزیع‌کننده (vendor) شامل ورودی‌های کامنت‌شده‌ای است که مقادیر پیش‌فرض را به عنوان راهنمای مدیر سیستم نشان می‌دهد. بازنویسی‌های محلی را نیز می‌توان با ایجاد فایل‌های تکمیلی (drop-in) مطابق توضیحات زیر انجام داد. فایل پیکربندی اصلی را نیز می‌توان برای این منظور ویرایش کرد (یا یک رونوشت در /etc/ اگر در /usr/ عرضه شده باشد)، با این حال استفاده از فایل‌های تکمیلی (drop-in) برای پیکربندی محلی به جای تغییر دادن فایل پیکربندی اصلی توصیه می‌شود.

علاوه بر فایل پیکربندی اصلی، قطعه‌کدهای پیکربندی تکمیلی (drop-in) از دایرکتوری‌های /usr/lib/systemd/*.conf.d/، /usr/local/lib/systemd/*.conf.d/ و /etc/systemd/*.conf.d/ خوانده می‌شوند. این فایل‌های تکمیلی اولویت بالاتری دارند و فایل پیکربندی اصلی را بازنویسی می‌کنند. فایل‌های موجود در زیردایرکتوری‌های پیکربندی *.conf.d/ صرف‌نظر از این‌که در کدام زیردایرکتوری قرار دارند، بر اساس نام فایل خود به ترتیب واژه‌نگاری (lexicographic) مرتب می‌شوند. هنگامی که چندین فایل یک گزینه یکسان را تعیین می‌کنند، برای گزینه‌هایی که فقط یک مقدار واحد را می‌پذیرند، ورودی موجود در فایلی که نام آن در آخرین جایگاه قرار می‌گیرد اولویت دارد، و برای گزینه‌هایی که فهرستی از مقادیر را می‌پذیرند، ورودی‌ها به همان ترتیبی که در فایل‌های مرتب‌شده ظاهر می‌شوند جمع‌آوری می‌گردند.

هنگامی که بسته‌ها نیاز به سفارشی‌سازی پیکربندی دارند، می‌توانند فایل‌های تکمیلی (drop-in) را در /usr/ نصب کنند. فایل‌های موجود در /etc/ برای مدیر سیستم محلی رزرو شده‌اند، که می‌تواند از این منطق برای بازنویسی فایل‌های پیکربندی نصب‌شده توسط بسته‌های توزیع‌کننده استفاده کند. برای بازنویسی قطعات تکمیلی بسته، باید از فایل‌های تکمیلی استفاده شود، زیرا فایل پیکربندی اصلی اولویت پایین‌تری دارد. توصیه می‌شود نام تمام فایل‌ها در این زیردایرکتوری‌ها با یک عدد دو رقمی و یک خط تیره پیشوندگذاری شود تا ترتیب آن‌ها ساده‌تر شود. این کار همچنین مفهوم اولویت‌های تکمیلی را تعریف می‌کند تا به توزیع‌کنندگان سیستم‌عامل اجازه دهد فایل‌های تکمیلی را در محدوده خاصی پایین‌تر از محدوده مورد استفاده کاربران عرضه کنند. این امر خطر بازنویسی تصادفی فایل‌های تکمیلی تعریف‌شده توسط کاربران را توسط فایل‌های تکمیلی بسته‌ها کاهش می‌دهد. توصیه می‌شود از محدوده 10-40 برای فایل‌های تکمیلی در /usr/ و از محدوده 60-90 برای فایل‌های تکمیلی در /etc/ و /run/ استفاده شود، تا اطمینان حاصل گردد که فایل‌های تکمیلی محلی و گذرا بر فایل‌های تکمیلی عرضه‌شده توسط توزیع‌کننده سیستم‌عامل اولویت دارند.

برای غیرفعال کردن یک فایل پیکربندی ارائه‌شده توسط توزیع‌کننده، روش توصیه‌شده قرار دادن یک پیوند نمادین (symlink) به /dev/null در دایرکتوری پیکربندی در /etc/ با همان نام فایل پیکربندی توزیع‌کننده است.

گزینهها (OPTIONS)

تمام گزینه‌ها در بخش [Remote] پیکربندی می‌شوند:

Seal=

به‌طور دوره‌ای داده‌های موجود در ژورنال را با استفاده از آب‌بندی امن رو به جلو (Forward Secure Sealing) امضا می‌کند.

در نگارش 229 اضافه شد.

SplitMode=

یکی از مقادیر "host" یا "none".

در نگارش 220 اضافه شد.

ServerKeyFile=

کلید SSL در قالب PEM.

در نگارش 220 اضافه شد.

ServerCertificateFile=

گواهی SSL در قالب PEM.

در نگارش 220 اضافه شد.

TrustedCertificateFile=

گواهی مرجع صدور گواهی SSL (CA certificate).

در نگارش 220 اضافه شد.

MaxUse=, KeepFree=, MaxFileSize=, MaxFiles=

این گزینه‌ها مشابه با SystemMaxUse=، SystemKeepFree=، SystemMaxFileSize= و SystemMaxFiles= در journald.conf(5) هستند.

MaxUse= کنترل می‌کند که systemd-journal-remote حداکثر تا چه میزان از فضای دیسک را می‌تواند مصرف کند. KeepFree= کنترل می‌کند که systemd-journal-remote چه مقدار از فضای دیسک را باید برای سایر مصارف خالی نگه دارد. systemd-journal-remote هر دو محدودیت را رعایت کرده و از مقدار کوچک‌تر میان این دو مقدار استفاده خواهد کرد.

MaxFiles= کنترل می‌کند که حداکثر چند فایل مجزای ژورنال نگهداری شود. توجه داشته باشید که برای کاهش تعداد فایل‌ها تا رسیدن به این محدودیت، تنها فایل‌های بایگانی‌شده حذف می‌شوند؛ فایل‌های فعال همچنان باقی خواهند ماند. این بدان معناست که در عمل، ممکن است پس از تکمیل عملیات پاک‌سازی (vacuuming)، مجموع فایل‌های ژورنال موجود همچنان بیشتر از این حد باشد.

در نگارش 253 اضافه شد.

Compression=

الگوریتم‌های فشرده‌سازی قابل قبول برای اعلام از طریق هدر HTTP به نام "Accept-Encoding" را پیکربندی می‌کند. این هدر به systemd-journal-upload پیشنهاد می‌دهد که داده‌های ارسالی را فشرده کند. فهرستی از الگوریتم‌های فشرده‌سازی را که با فاصله جدا شده‌اند، یا "no" را می‌پذیرد. الگوریتم‌های پشتیبانی‌شده عبارتند از "zstd"، "xz" یا "lz4". هنگامی که فهرستی از الگوریتم‌ها تعیین شود، هدر "Accept-Encoding" با اولویت‌هایی بر اساس ترتیب الگوریتم‌ها در فهرست ساخته خواهد شد. هنگامی که مقدار "no" تعیین شود، هدر "Accept-Encoding" ارسال نخواهد شد. این گزینه می‌تواند چندین بار مشخص شود. اگر یک رشته خالی به آن اختصاص داده شود، تمام تخصیص‌های قبلی پاک می‌شوند. مقدار پیش‌فرض آن تنظیم‌نشده (unset) است و تمام الگوریتم‌های فشرده‌سازی پشتیبانی‌شده در هدر فهرست خواهند شد.

مثال:

Compression=zstd lz4

در نگارش 258 اضافه شد.

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

journald.conf(5)، systemd(1)، systemd-journal-remote.service(8)، systemd-journald.service(8)

نکات (NOTES)

1.: 💣💥🧨💥💥💣 لطفاً توجه داشته باشید که این فایل‌های پیکربندی باید همیشه در دسترس باشند. اگر /usr/local/ یک پارتیشن جداگانه باشد، ممکن است در مراحل اولیه بوت در دسترس نباشد و نباید برای پیکربندی استفاده شود.