'\" t
.TH "SYSTEMD\-JOURNAL\-UPLOAD\&.SERVICE" "8" "" "systemd 261.2" "systemd-journal-upload.service"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
systemd-journal-upload.service, systemd-journal-upload \- ارسال پیام‌های ژورنال از طریق شبکه
.SH "خلاصه دستور (SYNOPSIS)"
.PP
systemd\-journal\-upload\&.service
.HP \w'\fB/usr/lib/systemd/systemd\-journal\-upload\fR\ 'u
\fB/usr/lib/systemd/systemd\-journal\-upload\fR [OPTIONS...] [\-u/\-\-url=\fIURL\fR] [SOURCES...]
.SH "توضیحات (DESCRIPTION)"
.PP
\fBsystemd\-journal\-upload\fR
ورودی‌های ژورنال را به نشانی وب (URL) مشخص‌شده با
\fB\-\-url=\fR
ارسال می‌کند\&. این برنامه مانند
\fBjournalctl\fR(1)
ورودی‌های ژورنال را از یک یا چند فایل ژورنال می‌خواند\&. مگر اینکه توسط یکی از گزینه‌های مشخص‌شده در زیر محدود شده باشد، تمام ورودی‌های ژورنال که برای کاربری که برنامه با دسترسی او اجرا می‌شود در دسترس هستند، ارسال خواهند شد و سپس برنامه منتظر می‌ماند و ورودی‌های جدید را به محض در‌دسترس قرار گرفتن ارسال می‌کند\&.
.PP
\fBsystemd\-journal\-upload\fR
محتوای خام فایل ژورنال را منتقل می‌کند و از HTTP به عنوان پروتکل انتقال استفاده می‌کند\&.
.PP
systemd\-journal\-upload\&.service
یک سرویس سیستمی است که از
\fBsystemd\-journal\-upload\fR
برای ارسال ورودی‌های ژورنال به یک سرور استفاده می‌کند\&. این سرویس از پیکربندی موجود در
\fBjournal-upload.conf\fR(5)
استفاده می‌کند\&. دست‌کم باید گزینهٔ
\fIURL=\fR
مشخص شده باشد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-u\fR, \fB\-\-url=\fR\fB[https://]\fR\fB\fIURL\fR\fR\fB[:\fR\fB\fIPORT\fR\fR\fB]\fR, \fB\-\-url=\fR\fB[http://]\fR\fB\fIURL\fR\fR\fB[:\fR\fB\fIPORT\fR\fR\fB]\fR
.RS 4
ارسال به نشانی مشخص‌شده\&.
\fIURL\fR
می‌تواند فقط نام میزبان یا هر دو پروتکل و نام میزبان را مشخص کند\&.
\fBhttps\fR
پیش‌فرض است\&. شمارهٔ پورت می‌تواند پس از دو نقطه (":") مشخص شود، در غیر این صورت به‌طور پیش‌فرض از
\fB19532\fR
استفاده خواهد شد\&.
.sp
اضافه‌شده در نسخهٔ 239\&.
.RE
.PP
\fB\-\-system\fR, \fB\-\-user\fR
.RS 4
ورودی‌های ارسالی را به ورودی‌های مربوط به سرویس‌های سیستمی و هسته، یا ورودی‌های سرویس‌های کاربر فعلی محدود می‌کند\&. این گزینه‌ها معنایی مشابه با گزینه‌های
\fB\-\-system\fR
و
\fB\-\-user\fR
در
\fBjournalctl\fR(1)
دارند\&. اگر هیچ‌کدام مشخص نشوند، تمام ورودی‌های دردسترس ارسال می‌شوند\&.
.sp
اضافه‌شده در نسخهٔ 239\&.
.RE
.PP
\fB\-m\fR, \fB\-\-merge\fR
.RS 4
ورودی‌ها را به‌صورت درهم‌آمیخته (interleaved) از تمام ژورنال‌های دردسترس، شامل سایر ماشین‌ها، ارسال می‌کند\&. این گزینه معنایی مشابه با گزینهٔ
\fB\-\-merge\fR
در
\fBjournalctl\fR(1)
دارد\&.
.sp
اضافه‌شده در نسخهٔ 239\&.
.RE
.PP
\fB\-\-namespace=\fR\fB\fINAMESPACE\fR\fR
.RS 4
یک رشتهٔ شناسهٔ فضای‌نام (namespace) ژورنال را به عنوان آرگومان می‌گیرد\&. ورودی‌ها را از فضای‌نام ژورنال مشخص‌شدهٔ
\fINAMESPACE\fR
به جای فضای‌نام پیش‌فرض ارسال می‌کند\&. این گزینه معنایی مشابه با گزینهٔ
\fB\-\-namespace=\fR
در
\fBjournalctl\fR(1)
دارد\&.
.sp
اضافه‌شده در نسخهٔ 254\&.
.RE
.PP
\fB\-D\fR, \fB\-\-directory=\fR\fB\fIDIR\fR\fR
.RS 4
یک مسیر دایرکتوری را به عنوان آرگومان می‌گیرد\&. ورودی‌ها را به جای مسیرهای پیش‌فرض ژورنال سیستمی و زمان اجرا، از دایرکتوری ژورنال مشخص‌شدهٔ
\fIDIR\fR
ارسال می‌کند\&. این گزینه معنایی مشابه با گزینهٔ
\fB\-\-directory=\fR
در
\fBjournalctl\fR(1)
دارد\&.
.sp
اضافه‌شده در نسخهٔ 239\&.
.RE
.PP
\fB\-\-file=\fR\fB\fIGLOB\fR\fR
.RS 4
یک الگوی تطبیق نام فایل (file glob) را به عنوان آرگومان می‌گیرد\&. ورودی‌ها را به جای مسیرهای پیش‌فرض ژورنال سیستمی و زمان اجرا، از فایل‌های ژورنال منطبق با
\fIGLOB\fR
ارسال می‌کند\&. این گزینه می‌تواند چندین بار مشخص شود که در این صورت فایل‌ها به‌صورت مناسبی درهم‌آمیخته خواهند شد\&. این گزینه معنایی مشابه با گزینهٔ
\fB\-\-file=\fR
در
\fBjournalctl\fR(1)
دارد\&.
.sp
اضافه‌شده در نسخهٔ 239\&.
.RE
.PP
\fB\-\-cursor=\fR
.RS 4
ورودی‌ها را از موقعیتی در ژورنال که توسط مکان‌نمای (cursor) ارسال‌شده مشخص شده است ارسال می‌کند\&. این گزینه معنایی مشابه با گزینهٔ
\fB\-\-cursor=\fR
در
\fBjournalctl\fR(1)
دارد\&.
.sp
اضافه‌شده در نسخهٔ 239\&.
.RE
.PP
\fB\-\-after\-cursor=\fR
.RS 4
ورودی‌ها را از موقعیتی در ژورنال که
\fIبعد از\fR
موقعیت مشخص‌شده توسط این مکان‌نما (cursor) قرار دارد، ارسال می‌کند\&. این گزینه معنایی مشابه با گزینهٔ
\fB\-\-after\-cursor=\fR
در
\fBjournalctl\fR(1)
دارد\&.
.sp
اضافه‌شده در نسخهٔ 239\&.
.RE
.PP
\fB\-\-save\-state\fR[=\fIPATH\fR]
.RS 4
ورودی‌ها را از موقعیتی در ژورنال که
\fIبعد از\fR
موقعیت مشخص‌شده توسط مکان‌نمای ذخیره‌شده در فایل در
\fIPATH\fR
(به‌طور پیش‌فرض
/var/lib/systemd/journal\-upload/state)
است، ارسال می‌کند\&. پس از ارسال موفق یک ورودی، این فایل را با مکان‌نمای آن ورودی به‌روزرسانی می‌کند\&.
.sp
اضافه‌شده در نسخهٔ 239\&.
.RE
.PP
\fB\-\-follow\fR[=\fIBOOL\fR]
.RS 4
اگر روی yes تنظیم شود، آنگاه
\fBsystemd\-journal\-upload\fR
منتظر ورودی جدید می‌ماند\&.
.sp
اضافه‌شده در نسخهٔ 239\&.
.RE
.PP
\fB\-\-key=\fR
.RS 4
مسیر یک فایل کلید SSL در قالب PEM، یا
\fB\-\fR
را می‌گیرد\&. اگر
\fB\-\fR
تنظیم شود، بررسی احراز هویت گواهی کلاینت غیرفعال خواهد شد\&. مقدار پیش‌فرض
/etc/ssl/private/journal\-upload\&.pem
است\&.
.sp
اضافه‌شده در نسخهٔ 239\&.
.RE
.PP
\fB\-\-cert=\fR
.RS 4
مسیر یک فایل گواهی SSL در قالب PEM، یا
\fB\-\fR
را می‌گیرد\&. اگر
\fB\-\fR
تنظیم شود، بررسی احراز هویت گواهی کلاینت غیرفعال خواهد شد\&. مقدار پیش‌فرض
/etc/ssl/certs/journal\-upload\&.pem
است\&.
.sp
اضافه‌شده در نسخهٔ 239\&.
.RE
.PP
\fB\-\-trust=\fR
.RS 4
مسیر یک فایل گواهی CA اس‌اس‌ال (SSL) در قالب PEM، یا
\fB\-\fR/\fBall\fR
را می‌گیرد\&. اگر
\fB\-\fR/\fBall\fR
تنظیم شود، بررسی گواهی غیرفعال خواهد شد\&. مقدار پیش‌فرض
/etc/ssl/ca/trusted\&.pem
است\&.
.sp
اضافه‌شده در نسخهٔ 239\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
یک متن راهنمای کوتاه چاپ کرده و خارج می‌شود\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
یک رشتهٔ نسخهٔ کوتاه چاپ کرده و خارج می‌شود\&.
.RE
.SH "وضعیت خروج (EXIT STATUS)"
.PP
در صورت موفقیت، 0 بازگردانده می‌شود؛ در غیر این صورت، یک کد خطای غیر صفر بازگردانده می‌شود\&.
.SH "مثال‌ها (EXAMPLES)"
.PP
\fBمثال\ \&1.\ \&راه‌اندازی گواهی‌ها برای احراز هویت\fR
.PP
گواهی‌های امضاشده توسط یک مرجع معتبر (CA) برای تأیید اینکه سروری که پیام‌ها به آن ارسال می‌شوند معتبر است و برعکس، کلاینت قابل اعتماد است، استفاده می‌شوند\&.
.PP
مجموعه مناسبی از گواهی‌ها را می‌توان با
\fBopenssl\fR
تولید کرد\&. توجه داشته باشید که به دلایل امنیتی، حداقل طول کلید 2048 بیت توصیه می‌شود:
.sp
.if n \{\
.RS 4
.\}
.nf
openssl req \-newkey rsa:2048 \-days 3650 \-x509 \-nodes \e
      \-out ca\&.pem \-keyout ca\&.key \-subj \*(Aq/CN=Certificate authority/\*(Aq

cat >ca\&.conf <<EOF
[ ca ]
default_ca = this

[ this ]
new_certs_dir = \&.
certificate = ca\&.pem
database = \&./index
private_key = ca\&.key
serial = \&./serial
default_days = 3650
default_md = default
policy = policy_anything

[ policy_anything ]
countryName             = optional
stateOrProvinceName     = optional
localityName            = optional
organizationName        = optional
organizationalUnitName  = optional
commonName              = supplied
emailAddress            = optional
EOF

touch index
echo 0001 >serial

SERVER=server
CLIENT=client

openssl req \-newkey rsa:2048 \-nodes \-out $SERVER\&.csr \-keyout $SERVER\&.key \-subj "/CN=$SERVER/"
openssl ca \-batch \-config ca\&.conf \-notext \-in $SERVER\&.csr \-out $SERVER\&.pem

openssl req \-newkey rsa:2048 \-nodes \-out $CLIENT\&.csr \-keyout $CLIENT\&.key \-subj "/CN=$CLIENT/"
openssl ca \-batch \-config ca\&.conf \-notext \-in $CLIENT\&.csr \-out $CLIENT\&.pem
.fi
.if n \{\
.RE
.\}
.PP
فایل‌های تولیدشدهٔ
ca\&.pem،
server\&.pem
و
server\&.key
باید روی سرور نصب شوند، و فایل‌های
ca\&.pem،
client\&.pem
و
client\&.key
روی کلاینت نصب شوند\&. مکان این فایل‌ها را می‌توان به ترتیب با استفاده از
\fITrustedCertificateFile=\fR،
\fIServerCertificateFile=\fR
و
\fIServerKeyFile=\fR
در
/etc/systemd/journal\-remote\&.conf
و
/etc/systemd/journal\-upload\&.conf
مشخص کرد\&. مکان‌های پیش‌فرض را می‌توان با استفاده از
\fBsystemd\-journal\-remote \-\-help\fR
و
\fBsystemd\-journal\-upload \-\-help\fR
استعلام کرد\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBjournal-upload.conf\fR(5), \fBsystemd-journal-remote.service\fR(8), \fBjournalctl\fR(1), \fBsystemd-journald.service\fR(8), \fBsystemd-journal-gatewayd.service\fR(8)