.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "KEA-ADMIN" "8" "Jul 09, 2026" "3.2.0" "Kea"
.SH "نام (NAME)"
kea\-admin \- اسکریپت شل برای مدیریت پایگاه‌های داده Kea
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBkea\-admin\fP [command] [backend] [\fB\-h\fP database_host]
[\fB\-P\fP database_port] [\fB\-u\fP database_username]
[\fB\-p\fP [database_password]] [\fB\-n\fP database_name] [\fB\-d\fP script_directory]
[\fB\-v\fP] [\fB\-x\fP extra_argument [\fB\-x\fP extra_argument ...]]
[\fB\-4\fP | \fB\-6\fP] [\fB\-i\fP input_file] [\fB\-o\fP output_file] [\fB\-y\fP]
.SH "توضیحات (DESCRIPTION)"
.sp
\fBkea\-admin\fP یک اسکریپت شل است که امکان نگهداری و مدیریت پایگاه داده را فراهم می‌کند. به‌ویژه، این اسکریپت شامل قابلیت‌های مقداردهی اولیه پایگاه داده (initialization)، بررسی نسخه پایگاه داده و ارتقای طرحواره (schema) پایگاه داده است.
.SH "آرگومان‌ها (ARGUMENTS)"
.INDENT 0.0
.TP
.B \fBcommand\fP
دستوری که باید به سرورها صادر شود را مشخص می‌کند. می‌تواند یکی از موارد زیر باشد:
.INDENT 7.0
.TP
.B \fBdb\-init\fP
یک طرحواره (schema) جدید برای پایگاه داده مقداردهی اولیه می‌کند. این دستور هنگام نصب جدید Kea مفید است. پایگاه داده به آخرین نسخه‌ای که توسط نسخه نرم‌افزار در حال نصب پشتیبانی می‌شود، مقداردهی اولیه می‌گردد.
.TP
.B \fBdb\-version\fP
شماره نسخه بک‌اند پایگاه داده را گزارش می‌دهد. این شماره لزوماً با شماره نسخه Kea برابر نیست، زیرا هر بک‌اند طرح نسخه‌گذاری مختص به خود را دارد.
.TP
.B \fBdb\-upgrade\fP
ارتقای طرحواره (schema) پایگاه داده را انجام می‌دهد. این دستور هنگام ارتقای Kea مفید است.
.TP
.B \fBlease\-dump\fP
محتویات پایگاه داده اجاره‌ها (برای بک‌اندهای MySQL یا PostgreSQL) را در یک فایل متنی CSV (مقادیر جداشده با کاما) تخلیه (dump) می‌کند. (پشتیبانی از بک‌اند Cassandra منسوخ شده است.)
سطر اول فایل حاوی نام ستون‌ها است. از این قابلیت می‌توان به عنوان روشی برای مهاجرت از یک بک‌اند پایگاه داده به بک‌اند memfile استفاده کرد.
همچنین می‌تواند به عنوان یک ابزار عیب‌یابی استفاده شود، زیرا شکل قابل حملی از داده‌های اجاره را فراهم می‌آورد. آرگومان‌های اجباری دیگری وجود دارند که باید همراه با این دستور استفاده شوند: باید یکی از گزینه‌های \fB\-4\fP یا \fB\-6\fP مشخص شود، و یکی از گزینه‌های \fB\-o\fP یا \fB\-\-output\fP تعیین گردد.
.TP
.B \fBlease\-upload\fP
اجاره‌ها را از یک فایل متنی CSV (مقادیر جداشده با کاما) در یک پایگاه داده اجاره MySQL یا PostgreSQL بارگذاری می‌کند. فایل CSV باید در قالب memfile باشد.
آرگومان‌های اجباری دیگری وجود دارند که باید همراه با این دستور استفاده شوند: باید یکی از گزینه‌های \fB\-4\fP یا \fB\-6\fP مشخص شود، و یکی از گزینه‌های \fB\-i\fP یا \fB\-\-input\fP تعیین گردد.
.TP
.B \fBstats\-recount\fP
آمار اجاره‌ها را برای یک پایگاه داده MySQL یا PostgreSQL مجدداً شمارش می‌کند.
.UNINDENT
.TP
.B \fBbackend\fP
نوع بک‌اند را مشخص می‌کند. بک‌اندهای مجاز در حال حاضر عبارتند از: memfile، mysql و pgsql؛ گزینه cql منسوخ شده است.
.TP
.B \fB\-h|\-\-host hostname\fP
نام میزبان را هنگام اتصال به پایگاه داده مشخص می‌کند.
مقدار پیش‌فرض \fBlocalhost\fP است.
.TP
.B \fB\-i|\-\-input input_file\fP
فایل متنی CSV (مقادیر جداشده با کاما) حاوی اجاره‌ها برای بارگذاری را مشخص می‌کند؛
برای \fBlease\-upload\fP الزامی است.
.TP
.B \fB\-P|\-\-port port\fP
درگاه (پورت) را هنگام اتصال به پایگاه داده مشخص می‌کند. اگر تعیین نشود،
از مقدار پیش‌فرض انتخاب‌شده توسط کلاینت پایگاه داده استفاده می‌شود.
.TP
.B \fB\-u|\-\-user username\fP
نام کاربری را هنگام اتصال به پایگاه داده مشخص می‌کند.
مقدار پیش‌فرض \fBkeatest\fP است.
.TP
.B \fB\-p|\-\-password password\fP
رمز عبور را هنگام اتصال به پایگاه داده مشخص می‌کند.
اگر فقط \fB\-p\fP یا \fB\-\-password\fP داده شود، از کاربر رمز عبور درخواست می‌شود.
اگر اصلاً مشخص نشود، متغیر محیطی \fBKEA_ADMIN_DB_PASSWORD\fP برای یافتن مقدار بررسی شده و در صورت وجود استفاده می‌شود.
در غیر این صورت از مقدار پیش‌فرض \fB1234\fP استفاده می‌گردد.
.TP
.B \fB\-n|\-\-name database\-name\fP
نام پایگاه داده برای اتصال را مشخص می‌کند.
مقدار پیش‌فرض \fBkeatest\fP است.
.TP
.B \fB\-d|\-\-directory script\-directory\fP
پوشه اسکریپت‌های جایگزین را مشخص می‌کند. این اسکریپت در طول ارتقا، مقداردهی اولیه پایگاه داده و احتمالاً سایر عملیات استفاده می‌شود.
مقدار پیش‌فرض \fB(prefix)/share/kea/scripts/\fP است.
.TP
.B \fB\-o|\-\-output output_file\fP
فایلی را که داده‌های اجاره در آن تخلیه می‌شوند مشخص می‌کند. برای
\fBlease\-dump\fP الزامی است.
.TP
.B \fB\-v|\-\-version\fP
نسخه Kea را نمایش می‌دهد.
.TP
.B \fB\-V\fP
نسخه گسترش‌یافته Kea را نمایش می‌دهد.
.TP
.B \fB\-4\fP
به \fBkea\-admin\fP دستور می‌دهد که داده‌های اجاره DHCPv4 را تخلیه کند. با گزینه \-6 ناسازگار است.
.TP
.B \fB\-6\fP
به \fBkea\-admin\fP دستور می‌دهد که داده‌های اجاره DHCPv6 را تخلیه کند. با گزینه \-4 ناسازگار است.
.TP
.B \fB\-x|\-\-extra\fP
یک آرگومان اضافی را برای ارسال به ابزار خط فرمان پایگاه داده مشخص می‌کند، مثلاً برای فراخوانی \fBmysql\fP با آرگومان \fB\-\-ssl\fP. این گزینه می‌تواند برای ارسال بیش از یک آرگومان تکرار شود. علامت‌های نقل‌قول حفظ نمی‌شوند. از دستورهای حاوی فاصله خودداری کنید.
.TP
.B \fB\-y|\-\-yes\fP
پاسخ مثبت (yes) را هنگام بازنویسی فایل‌های موقت فرض می‌کند.
.UNINDENT
.SH "مستندات (DOCUMENTATION)"
.sp
پروژه Kea همراه با یک «راهنمای مرجع مدیران Kea» جامع ارائه می‌شود که تمامی جنبه‌های اجرای نرم‌افزار Kea \- کامپایل، نصب، پیکربندی، نمونه‌های پیکربندی و موارد بسیار دیگر را پوشش می‌دهد. Kea همچنین دارای یک «راهنمای پیام‌های Kea» است که فهرستی از تمامی پیام‌های احتمالی قابل چاپ توسط Kea را به همراه توضیحی کوتاه برای هر یک ارائه می‌دهد. هر دو سند در قالب‌های مختلف (.txt، .html، .pdf) همراه با توزیع Kea در دسترس هستند. مستندات Kea در نشانی
\%<https://\:kea\:.readthedocs\:.io>\&
در دسترس است.
.sp
کد منبع Kea در «راهنمای توسعه‌دهندگان Kea» (Kea Developer\(aqs Guide) مستند شده است و در نشانی
\%<https://\:reports\:.kea\:.isc\:.org/\:dev_guide/>\&
در دسترس است.
.sp
وب‌سایت پروژه Kea در نشانی
\%<https://\:kea\:.isc\:.org>\&
در دسترس است.
.SH "فهرست‌های پستی و پشتیبانی (MAILING LISTS AND SUPPORT)"
.sp
دو فهرست پستی عمومی برای پروژه Kea در دسترس است:
\fBkea\-users\fP
(kea\-users در lists.isc.org) برای کاربران Kea در نظر گرفته شده است، در حالی که
\fBkea\-dev\fP
(kea\-dev در lists.isc.org) برای توسعه‌دهندگان Kea، مشارکت‌کنندگان آینده و سایر کاربران پیشرفته در نظر گرفته شده است. هر دو فهرست در نشانی
\%<https://\:lists\:.isc\:.org>\&
در دسترس هستند. جامعه کاربری پشتیبانی برمبنای بهترین تلاش (best\-effort) را در هر دو فهرست ارائه می‌دهد.
.sp
مجموعه ISC پشتیبانی حرفه‌ای برای خدمات Kea ارائه می‌کند. برای جزئیات به
\%<https://\:www\:.isc\:.org/\:kea/>
مراجعه کنید.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBkea\-dhcp4(8)\fP, \fBkea\-dhcp6(8)\fP,
\fBkea\-dhcp\-ddns(8)\fP,
\fBkeactrl(8)\fP, \fBperfdhcp(8)\fP, \fBkea\-netconf(8)\fP,
Kea Administrator Reference Manual.
.SH "نویسنده (AUTHOR)"
Internet Systems Consortium
.SH "حق نشر (COPYRIGHT)"
2019-2026, Internet Systems Consortium
.\" End of generated man page.