.\"  Copyright (c) 2006-2012 Red Hat, Inc. <http://www.redhat.com>
.\"  This file is part of GlusterFS.
.\"
.\"  This file is licensed to you under your choice of the GNU Lesser
.\"  General Public License, version 3 or any later version (LGPLv3 or
.\"  later), or the GNU General Public License, version 2 (GPLv2), in all
.\"  cases as published by the Free Software Foundation.
.\"
.\"
.TH Gluster 8 "Gluster command line utility" "07 March 2011" "Gluster Inc."
.SH "نام (NAME)"
gluster \- ابزار مدیریت خط فرمان GlusterFS
.SH "خلاصه دستور (SYNOPSIS)"
.B gluster
.PP
برای اجرای برنامه و نمایش اعلان (prompt) خط فرمان gluster:
.PP
.B gluster [--remote-host=<gluster_node>] [--mode=script] [--xml]
.PP
(یا)
.PP
برای مشخص کردن مستقیم یک دستور:
.PP
.B gluster
.I  [commands] [options] [--remote-host=<gluster_node>] [--mode=script] [--xml]
.SH "توضیحات (DESCRIPTION)"
مدیر کنسول Gluster یک ابزار خط فرمان برای مدیریت حجم‌های منعطف (elastic volume management) است. می‌توانید دستور gluster را روی هر سرور export اجرا کنید. این دستور به مدیران سیستم امکان می‌دهد تا عملیات ابری مانند ساخت، گسترش، کوچک کردن، بازتعادل (rebalancing) و مهاجرت حجم‌ها را بدون نیاز به زمان توقف (downtime) برنامه‌ریزی‌شده سرور انجام دهند.
.SH "دستورات (COMMANDS)"

.SS "دستورات حجم (Volume Commands)"
.PP
.TP

\fB\ volume info [all|<VOLNAME>] \fR
نمایش اطلاعات درباره تمام حجم‌ها، یا حجم مشخص‌شده.
.TP
\fB\ volume list \fR
فهرست کردن تمام حجم‌های موجود در کلاستر.
.TP
\fB\ volume status [all | <VOLNAME> [nfs|shd|<BRICK>|quotad]] [detail|clients|mem|inode|fd|callpool|tasks|client-list] \fR
نمایش وضعیت تمام یا حجم(ها)/بریک مشخص‌شده.
.TP
\fB\ volume create <NEW-VOLNAME> [stripe <COUNT>] [[replica <COUNT> [arbiter <COUNT>]]|[replica 2 thin-arbiter 1]] [disperse [<COUNT>]] [disperse-data <COUNT>] [redundancy <COUNT>] [transport <tcp|rdma|tcp,rdma>] <NEW-BRICK> ... <TA-BRICK> \fR
ایجاد یک حجم جدید از نوع مشخص‌شده با استفاده از بریک‌ها و نوع انتقال (transport) مشخص‌شده (نوع انتقال پیش‌فرض tcp است).
برای ایجاد یک حجم با هر دو نوع انتقال (tcp و rdma)، گزینه 'transport tcp,rdma' را مشخص کنید.
.TP
\fB\ volume delete <VOLNAME> \fR
حذف حجم مشخص‌شده.
.TP
\fB\ volume start <VOLNAME> \fR
راه‌اندازی حجم مشخص‌شده.
.TP
\fB\ volume stop <VOLNAME> [force] \fR
متوقف کردن حجم مشخص‌شده.
.TP
\fB\ volume set <VOLNAME> <OPTION> <PARAMETER> [<OPTION> <PARAMETER>] ... \fR
تنظیم گزینه‌های حجم.
.TP
\fB\ volume get <VOLNAME/all> <OPTION/all> \fR
دریافت مقدار تمام گزینه‌ها یا گزینه داده‌شده برای حجم <VOLNAME> یا گزینه all. دستور gluster volume get all all برای دریافت تمام گزینه‌های سراسری است.
.TP
\fB\ volume reset <VOLNAME> [option] [force] \fR
بازنشانی تمام گزینه‌های بازپیکربندی‌شده.
.TP
\fB\ volume barrier <VOLNAME> {enable|disable} \fR
فعال‌سازی یا غیرفعال‌سازی سدبندی (barrier/unbarrier) عملیات فایل روی یک حجم.
.TP
\fB\ volume clear-locks <VOLNAME> <path> kind {blocked|granted|all}{inode [range]|entry [basename]|posix [range]} \fR
پاکسازی قفل‌های نگه‌داشته‌شده روی مسیر.
.TP
\fB\ volume help \fR
نمایش راهنما برای دستورات حجم.
.SS "دستورات بریک (Brick Commands)"
.PP
.TP
\fB\ volume add-brick <VOLNAME> <NEW-BRICK> ... \fR
افزودن بریک مشخص‌شده به حجم تعیین‌شده.
.TP
\fB\ volume remove-brick <VOLNAME> <BRICK> ... \fR
حذف بریک مشخص‌شده از حجم تعیین‌شده.
.IP
.B نکته:
اگر بریک را حذف کنید، داده‌های ذخیره‌شده در آن بریک در دسترس نخواهند بود. می‌توانید با استفاده از گزینه
.B replace-brick
داده‌ها را از یک بریک به بریک دیگر مهاجرت دهید.
.TP
\fB\ volume reset-brick <VOLNAME> <SOURCE-BRICK> {{start} | {<NEW-BRICK> commit}} \fR
متوقف کردن یا جایگزین کردن بریک مبدأ مشخص‌شده با بریک جدید.
.TP
\fB\ volume replace-brick <VOLNAME> <SOURCE-BRICK> <NEW-BRICK> commit force \fR
جایگزینی بریک مبدأ مشخص‌شده با یک بریک جدید.
.TP
\fB\ volume rebalance <VOLNAME> start \fR
شروع بازتعادل (rebalancing) حجم مشخص‌شده.
.TP
\fB\ volume rebalance <VOLNAME> stop \fR
توقف بازتعادل حجم مشخص‌شده.
.TP
\fB\ volume rebalance <VOLNAME> status \fR
نمایش وضعیت بازتعادل حجم مشخص‌شده.
.SS "دستورات لاگ و پایش (Log Commands)"
.TP
\fB\ volume log <VOLNAME> rotate [BRICK] \fR
چرخش فایل لاگ برای حجم/بریک مربوطه.
.TP
\fB\ volume profile <VOLNAME> {start|info [peek|incremental [peek]|cumulative|clear]|stop} [nfs] \fR
پروفایل کردن عملیات روی حجم. پس از شروع، دستور volume profile <volname> info آمار تجمیعی از FOPهای انجام‌شده ارائه می‌دهد.
.TP
\fB\ volume top <VOLNAME> {open|read|write|opendir|readdir|clear} [nfs|brick <brick>] [list-cnt <value>] | {read-perf|write-perf} [bs <size> count <count>] [brick <brick>] [list-cnt <value>] \fR
تولید پروفایل از یک حجم که عملکرد و گلوگاه‌ها/نقاط داغ (hotspots) هر بریک را نمایش می‌دهد.
.TP
\fB\ volume statedump <VOLNAME> [[nfs|quotad] [all|mem|iobuf|callpool|priv|fd|inode|history]... | [client <hostname:process-id>]] \fR
تخلیه وضعیت حافظه (in memory state) پردازش مشخص‌شده یا بریک‌های حجم.
.TP
\fB\ volume sync <HOSTNAME> [all|<VOLNAME>] \fR
همگام‌سازی اطلاعات حجم از یک همتا (peer).
.SS "دستورات همتا (Peer Commands)"
.TP
\fB\ peer probe <HOSTNAME> \fR
کاوش (probe) همتای مشخص‌شده. در صورتی که <HOSTNAME> داده‌شده متعلق به همتایی باشد که قبلاً کاوش شده، دستور peer probe در صورت نیاز نام میزبان را به همتا اضافه خواهد کرد.
.TP
\fB\ peer detach <HOSTNAME> \fR
جدا کردن همتای مشخص‌شده.
.TP
\fB\ peer status \fR
نمایش وضعیت همتاها.
.TP
\fB\ pool list \fR
فهرست کردن تمام گره‌ها در استخر (شامل localhost).
.TP
\fB\ peer help \fR
نمایش راهنما برای دستورات همتا.
.SS "دستورات سهمیه‌بندی (Quota Commands)"
.TP
\fB\ volume quota <VOLNAME> enable \fR
فعال‌سازی سهمیه‌بندی (quota) روی حجم مشخص‌شده. این کار باعث می‌شود تمام دایرکتوری‌ها در سلسله‌مراتب سیستم فایل محاسبه شده و پس از آن در هر عملیات در سیستم فایل به‌روزرسانی شوند. برای آغاز این محاسبه، یک پیمایش (crawl) روی سلسله‌مراتب با یک کلاینت کمکی انجام می‌شود.
.TP
\fB\ volume quota <VOLNAME> disable \fR
غیرفعال‌سازی سهمیه‌بندی روی حجم. این کار اعمال محدودیت و محاسبه را در سیستم فایل غیرفعال می‌کند. تمام محدودیت‌های پیکربندی‌شده از دست خواهند رفت.
.TP
\fB\ volume quota <VOLNAME> limit-usage <PATH> <SIZE> [<PERCENT>] \fR
تنظیم محدودیت استفاده روی مسیر داده‌شده. هر محدودیت از پیش تنظیم‌شده با مقدار جدید بازنویسی می‌شود. حد نرم (soft limit) را می‌توان به‌صورت اختیاری مشخص کرد (به‌صورت درصدی از حد سخت). اگر درصد حد نرم ارائه نشود، مقدار پیش‌فرض حد نرم حجم برای تعیین حد نرم استفاده می‌شود.
.TP
\fB\ volume quota <VOLNAME> limit-objects <PATH> <SIZE> [<PERCENT>] \fR
تنظیم محدودیت inode روی مسیر داده‌شده. هر محدودیت از پیش تنظیم‌شده با مقدار جدید بازنویسی می‌شود. حد نرم را می‌توان به‌صورت اختیاری مشخص کرد (به‌صورت درصدی از حد سخت). اگر درصد حد نرم ارائه نشود، مقدار پیش‌فرض حد نرم حجم برای تعیین حد نرم استفاده می‌شود.
.TP
نکته: واحدهای معتبر SIZE عبارتند از: B، KB، MB، GB، TB، PB. اگر هیچ واحدی مشخص نشود، واحد پیش‌فرض بایت (bytes) خواهد بود.
.TP
\fB\ volume quota <VOLNAME> remove <PATH> \fR
حذف هرگونه محدودیت استفاده پیکربندی‌شده روی دایرکتوری مشخص‌شده. توجه داشته باشید که اگر هرگونه محدودیتی روی اجداد این دایرکتوری (دایرکتوری‌های قبلی در طول مسیر) پیکربندی شده باشد، همچنان معتبر بوده و اعمال می‌شوند.
.TP
\fB\ volume quota <VOLNAME> remove-objects <PATH> \fR
حذف هرگونه محدودیت inode پیکربندی‌شده روی دایرکتوری مشخص‌شده. توجه داشته باشید که اگر هرگونه محدودیتی روی اجداد این دایرکتوری (دایرکتوری‌های قبلی در طول مسیر) پیکربندی شده باشد، همچنان معتبر بوده و اعمال می‌شوند.
.TP
\fB\ volume quota <VOLNAME> list <PATH> \fR
فهرست کردن میزان استفاده و محدودیت‌های پیکربندی‌شده روی دایرکتوری(ها). اگر مسیری داده شود، فقط محدودیتی که روی آن دایرکتوری پیکربندی شده (در صورت وجود) همراه با میزان استفاده دایرکتوری نمایش داده می‌شود. اگر مسیری داده نشود، میزان استفاده و محدودیت‌ها برای تمام دایرکتوری‌هایی که دارای محدودیت پیکربندی‌شده هستند نمایش داده می‌شود.
.TP
\fB\ volume quota <VOLNAME> list-objects <PATH> \fR
فهرست کردن میزان استفاده inode و محدودیت‌های inode پیکربندی‌شده روی دایرکتوری(ها). اگر مسیری داده شود، فقط محدودیتی که روی دایرکتوری پیکربندی شده (در صورت وجود) همراه با میزان استفاده inode آن دایرکتوری نمایش داده می‌شود. اگر مسیری داده نشود، استفاده و محدودیت‌ها برای تمام دایرکتوری‌هایی که دارای محدودیت پیکربندی‌شده هستند نمایش داده می‌شود.
.TP
\fB\ volume quota <VOLNAME> default-soft-limit <PERCENT> \fR
تنظیم مقدار درصدی برای حد نرم پیش‌فرض حجم.
.TP
\fB\ volume quota <VOLNAME> soft-timeout <TIME> \fR
تنظیم مهلت نرم (soft timeout) برای حجم. بازه زمانی که در آن محدودیت‌ها پیش از نقض حد نرم دوباره آزمایش می‌شوند.
.TP
\fB\ volume quota <VOLNAME> hard-timeout <TIME> \fR
تنظیم مهلت سخت (hard timeout) برای حجم. بازه زمانی که در آن محدودیت‌ها پس از نقض حد نرم دوباره آزمایش می‌شوند.
.TP
\fB\ volume quota <VOLNAME> alert-time <TIME> \fR
تنظیم بسامد ثبت پیام‌های هشدار (در لاگ‌های بریک) پس از نقض حد نرم.
.TP
\fB\ volume inode-quota <VOLNAME> enable/disable \fR
فعال‌سازی یا غیرفعال‌سازی inode-quota برای <VOLNAME>.
.TP
\fB\ volume quota help \fR
نمایش راهنما برای دستورات سهمیه‌بندی حجم.
.TP
نکته: واحدهای معتبر زمان و نمادهای آنها عبارتند از: hours(h/hr)، minutes(m/min)، seconds(s/sec)، weeks(w/wk)، Days(d/days).
.SS "دستورات همانندسازی جغرافیایی (Geo-replication Commands)"
.TP
\fIنکته\fR: ارتباط ssh بدون گذرواژه از گره اصلی (جایی که این دستورات اجرا می‌شوند) به گره ثانویه <SECONDARY_HOST> پیش‌نیاز دستورات geo-replication است.
.TP
\fB\ system:: execute gsec_create\fR
تولید کلیدهای pem که برای push-pem مورد نیاز هستند.
.TP
\fB\ volume geo-replication <PRIMARY_VOL> <SECONDARY_HOST>::<SECONDARY_VOL> create [[ssh-port n][[no-verify]|[push-pem]]] [force]\fR
ایجاد یک نشست همانندسازی جغرافیایی (geo-replication) جدید از <PRIMARY_VOL> به ماشین میزبان <SECONDARY_HOST> دارای <SECONDARY_VOL>.
در صورتی که در گره‌های ثانویه پورت سفارشی SSH پیکربندی شده باشد، از ssh-port n استفاده کنید.
در صورتی که کلیدهای rsa گره‌ها در حجم اصلی از طریق یک عامل خارجی به گره‌های ثانویه توزیع شده است، از no-verify استفاده کنید.
از push-pem برای ارسال خودکار کلیدها استفاده کنید.
.TP
\fB\ volume geo-replication <PRIMARY_VOL> <SECONDARY_HOST>::<SECONDARY_VOL> {start|stop} [force] \fR
شروع یا توقف نشست همانندسازی جغرافیایی از <PRIMARY_VOL> به ماشین میزبان <SECONDARY_HOST> دارای <SECONDARY_VOL>.
.TP
\fB\ volume geo-replication [<PRIMARY_VOL> [<SECONDARY_HOST>::<SECONDARY_VOL>]] status [detail] \fR
استعلام وضعیت نشست همانندسازی جغرافیایی از <PRIMARY_VOL> به ماشین میزبان <SECONDARY_HOST> دارای <SECONDARY_VOL>.
.TP
\fB\ volume geo-replication <PRIMARY_VOL> <SECONDARY_HOST>::<SECONDARY_VOL> {pause|resume} [force] \fR
مکث یا ازسرگیری نشست همانندسازی جغرافیایی از <PRIMARY_VOL> به ماشین میزبان <SECONDARY_HOST> دارای <SECONDARY_VOL>.
.TP
\fB\ volume geo-replication <PRIMARY_VOL> <SECONDARY_HOST>::<SECONDARY_VOL> delete [reset-sync-time]\fR
حذف نشست همانندسازی جغرافیایی از <PRIMARY_VOL> به ماشین میزبان <SECONDARY_HOST> دارای <SECONDARY_VOL>.
به‌صورت اختیاری می‌توانید زمان همگام‌سازی را نیز بازنشانی کنید تا در صورت ایجاد مجدد نشست، کل حجم دوباره همگام‌سازی شود.
.TP
\fB\ volume geo-replication <PRIMARY_VOL> <SECONDARY_HOST>::<SECONDARY_VOL> config [[!]<options> [<value>]] \fR
مشاهده (در صورت عدم ارائه گزینه) یا تنظیم پیکربندی برای این نشست همانندسازی جغرافیایی.
از "!<OPTION>" برای بازنشانی گزینه <OPTION> به مقدار پیش‌فرض استفاده کنید.
.SS "دستورات روت بیت (Bitrot Commands)"
.TP
\fB\ volume bitrot <VOLNAME> {enable|disable} \fR
فعال‌سازی یا غیرفعال‌سازی bitrot برای حجم <VOLNAME>.
.TP
\fB\ volume bitrot <VOLNAME> signing-time <time-in-secs> \fR
زمان انتظار برای یک شیء پس از بسته شدن آخرین fd جهت آغاز فرآیند امضا.
.TP
\fB\ volume bitrot <VOLNAME> signer-threads <count> \fR
تعداد رشته‌های فرآیند امضا (signer threads). معمولاً روی تعداد هسته‌های موجود تنظیم می‌شود.
.TP
\fB\ volume bitrot <VOLNAME> scrub-throttle {lazy|normal|aggressive} \fR
مقدار scrub-throttle معیاری است برای سرعت پیمایش و بررسی (scrub) سیستم فایل توسط اسکرابر برای حجم <VOLNAME>.
.TP
\fB\ volume bitrot <VOLNAME> scrub-frequency {hourly|daily|weekly|biweekly|monthly} \fR
بسامد بررسی و پاکسازی (scrub frequency) برای حجم <VOLNAME>.
.TP
\fB\ volume bitrot <VOLNAME> scrub {pause|resume|status|ondemand} \fR
مکث یا ازسرگیری پاکسازی (scrub). پس از ازسرگیری، اسکرابر از همان‌جایی که متوقف شده ادامه می‌دهد. گزینه status آمار اسکرابر را نمایش می‌دهد. گزینه ondemand در صورتی که اسکرابر متوقف نباشد یا در حال اجرا نباشد، بلافاصله پاکسازی را آغاز می‌کند.
.TP
\fB\ volume bitrot help \fR
نمایش راهنما برای دستورات bitrot حجم.
.SS "دستورات تصویر لحظه‌ای (Snapshot Commands)"
.TP
\fB\ snapshot create <snapname> <volname> [no-timestamp] [description <description>] [force] \fR
یک تصویر لحظه‌ای (snapshot) از یک حجم GlusterFS ایجاد می‌کند. کاربر می‌تواند یک نام تصویر لحظه‌ای (snap-name) و یک شرح برای شناسایی آن ارائه دهد. تصویر لحظه‌ای با افزودن برچسب زمانی به وقت گرینویچ (GMT) ایجاد خواهد شد. کاربر می‌تواند با استفاده از گزینه "no-timestamp" این رفتار را لغو کند. شرح نمی‌تواند بیشتر از ۱۰۲۴ کاراکتر باشد. برای امکان گرفتن تصویر لحظه‌ای، حجم باید موجود و در وضعیت راه‌اندازی‌شده (started) باشد.
.TP
\fB\ snapshot restore <snapname> \fR
یک تصویر لحظه‌ای قبلاً گرفته‌شده از حجم GlusterFS را بازیابی می‌کند. بازیابی تصویر لحظه‌ای یک فعالیت آفلاین است، بنابراین اگر حجم آنلاین باشد (در وضعیت started)، عملیات بازیابی با شکست مواجه خواهد شد. پس از بازیابی تصویر لحظه‌ای، دیگر در فهرست تصاویر لحظه‌ای در دسترس نخواهد بود.
.TP
\fB\ snapshot clone <clonename> <snapname> \fR
یک کلون از حجم تصویر لحظه‌ای ایجاد می‌کند؛ حجم حاصل یک حجم GlusterFS خواهد بود. کاربر می‌تواند یک نام برای کلون ارائه دهد. برای امکان گرفتن کلون، تصویر لحظه‌ای باید موجود و در وضعیت فعال‌شده (activated) باشد.
.TP
\fB\ snapshot delete ( all | <snapname> | volume <volname> ) \fR
اگر snapname مشخص شود، تصویر لحظه‌ای ذکرشده حذف می‌شود. اگر volname مشخص شود، تمام تصاویر لحظه‌ای متعلق به آن حجم خاص حذف می‌شوند. اگر کلمه کلیدی *all* استفاده شود، تمام تصاویر لحظه‌ای موجود در سیستم حذف می‌شوند.
.TP
\fB\ snapshot list [volname] \fR
فهرست کردن تمام تصاویر لحظه‌ای گرفته‌شده. اگر volname ارائه شود، تنها تصاویر لحظه‌ای متعلق به آن حجم خاص فهرست می‌شوند.
.TP
\fB\ snapshot info [snapname | (volume <volname>)] \fR
این دستور اطلاعاتی مانند نام تصویر لحظه‌ای، شناسه یکتای (UUID) تصویر لحظه‌ای، زمان ایجاد آن را ارائه داده و نام حجم تصویر لحظه‌ای، تعداد تصاویر لحظه‌ای گرفته‌شده و تعداد تصاویر لحظه‌ای هنوز در دسترس برای آن حجم خاص و وضعیت تصویر لحظه‌ای را فهرست می‌کند. اگر snapname مشخص شود، اطلاعات تصویر لحظه‌ای ذکرشده نمایش داده می‌شود. اگر volname مشخص شود، اطلاعات تمام تصاویر لحظه‌ای متعلق به آن حجم نمایش داده می‌شود. اگر هیچ‌کدام از snapname و volname مشخص نشوند، اطلاعات تمام تصاویر لحظه‌ای موجود در سیستم نمایش داده می‌شود.
.TP
\fB\ snapshot status [snapname | (volume <volname>)] \fR
این دستور وضعیت تصویر لحظه‌ای را ارائه می‌دهد. جزئیات ارائه‌شده شامل مسیر بریک تصویر لحظه‌ای، گروه حجم (جزئیات LVM)، وضعیت بریک‌های تصویر لحظه‌ای، شناسه فرآیند (PID) بریک‌ها، درصد داده پرشده برای آن گروه حجم خاص که تصویر لحظه‌ای متعلق به آن است و اندازه کل حجم منطقی است.
.PP
اگر snapname مشخص شود، وضعیت تصویر لحظه‌ای ذکرشده نمایش داده می‌شود. اگر volname مشخص شود، وضعیت تمام تصاویر لحظه‌ای متعلق به آن حجم نمایش داده می‌شود. اگر هیچ‌کدام از snapname و volname مشخص نشوند، وضعیت تمام تصاویر لحظه‌ای موجود در سیستم نمایش داده می‌شود.
.TP
\fB\ snapshot config [volname] ([snap-max-hard-limit <count>] [snap-max-soft-limit <percent>]) | ([auto-delete <enable|disable>]) | ([activate-on-create <enable|disable>])
مقادیر پیکربندی تصویر لحظه‌ای را نمایش داده و تنظیم می‌کند.
.PP
دستور snapshot config بدون هیچ کلمه کلیدی، مقادیر پیکربندی تصویر لحظه‌ای تمام حجم‌های سیستم را نمایش می‌دهد. اگر volname ارائه شود، مقادیر پیکربندی تصویر لحظه‌ای آن حجم نمایش داده می‌شود.
.PP
دستور snapshot config همراه با کلمات کلیدی می‌تواند برای تغییر مقادیر پیکربندی موجود استفاده شود. اگر volname ارائه شود، مقدار پیکربندی آن حجم تغییر می‌کند، در غیر این صورت محدودیت سیستم را تنظیم/تغییر می‌دهد.
.PP
گزینه‌های snap-max-soft-limit و auto-delete گزینه‌های سراسری هستند که توسط تمام حجم‌های سیستم به ارث برده می‌شوند و نمی‌توان آنها را برای تک‌تک حجم‌ها تنظیم کرد.
.PP
گزینه snap-max-hard-limit را می‌توان به‌صورت سراسری و همچنین برای هر حجم تنظیم کرد. کمترین حد میان محدودیت سراسری سیستم و محدودیت خاص حجم، تبدیل به "Effective snap-max-hard-limit" برای یک حجم می‌شود.
.PP
گزینه snap-max-soft-limit یک مقدار درصدی است که روی "Effective snap-max-hard-limit" اعمال می‌شود تا "Effective snap-max-soft-limit" به دست آید.
.PP
هنگامی که قابلیت auto-delete فعال باشد، پس از رسیدن به "Effective snap-max-soft-limit"، با هر ایجاد موفق تصویر لحظه‌ای، قدیمی‌ترین تصویر لحظه‌ای حذف خواهد شد.
.PP
هنگامی که قابلیت auto-delete غیرفعال باشد، پس از رسیدن به "Effective snap-max-soft-limit"، کاربر با هر ایجاد موفق تصویر لحظه‌ای یک هشدار دریافت می‌کند.
.PP
هنگامی که قابلیت auto-delete غیرفعال باشد، پس از رسیدن به "Effective snap-max-hard-limit"، ایجاد تصاویر لحظه‌ای بعدی مجاز نخواهد بود.
.PP
گزینه activate-on-create به‌طور پیش‌فرض غیرفعال است. اگر activate-on-create را فعال کنید، تصاویر لحظه‌ای بعدی در زمان ایجاد فعال خواهند شد.
.TP
\fB\ snapshot activate <snapname> \fR
تصویر لحظه‌ای ذکرشده را فعال می‌کند.
.PP
نکته: به‌طور پیش‌فرض تصویر لحظه‌ای در هنگام ایجاد فعال می‌شود.
.TP
\fB\ snapshot deactivate <snapname> \fR
تصویر لحظه‌ای ذکرشده را غیرفعال می‌کند.
.TP
\fB\ snapshot help \fR
نمایش راهنما برای دستورات تصویر لحظه‌ای.
.SS "دستورات خودترمیم (Self-heal Commands)"
.TP
\fB\ volume heal <VOLNAME>\fR
شروع خودترمیم نمایه‌سازی (index self heal) را برای فایل‌هایی که نیاز به ترمیم دارند فعال می‌کند.
.TP
\fB\ volume heal  <VOLNAME> [enable | disable]\fR
فعال‌سازی یا غیرفعال‌سازی دیمن خودترمیم (self-heal-daemon) برای حجم <VOLNAME>.
.TP
\fB\ volume heal <VOLNAME> full\fR
شروع خودترمیم را روی تمام فایل‌ها فعال می‌کند.
.TP
\fB\ volume heal <VOLNAME> info \fR
فهرست کردن فایل‌هایی که نیاز به ترمیم دارند.
.TP
\fB\ volume heal <VOLNAME> info split-brain \fR
فهرست کردن فایل‌هایی که در وضعیت مغز دوپاره (split-brain) قرار دارند.
.TP
\fB\ volume heal <VOLNAME> statistics \fR
فهرست کردن آمار پیمایش (crawl statistics).
.TP
\fB\ volume heal <VOLNAME> statistics heal-count \fR
نمایش تعداد فایل‌هایی که باید ترمیم شوند.
.TP
\fB\ volume heal <VOLNAME> statistics heal-count replica <HOSTNAME:BRICKNAME> \fR
نمایش تعداد فایل‌هایی که باید از یک زیرحجم replica خاص که بریک <HOSTNAME:BRICKNAME> به آن تعلق دارد، ترمیم شوند.
.TP
\fB\ volume heal <VOLNAME> split-brain bigger-file <FILE> \fR
ترمیم فایل <FILE> که در وضعیت split-brain قرار دارد را با انتخاب فایل بزرگتر در نسخه رونوشت (replica) به‌عنوان مبدأ انجام می‌دهد.
.TP
\fB\ volume heal <VOLNAME> split-brain source-brick <HOSTNAME:BRICKNAME> \fR
بریک <HOSTNAME:BRICKNAME> را به‌عنوان مبدأ برای تمام فایل‌هایی که در آن نسخه رونوشت در وضعیت split-brain قرار دارند انتخاب کرده و آنها را ترمیم می‌کند.
.TP
\fB\ volume heal <VOLNAME> split-brain source-brick <HOSTNAME:BRICKNAME> <FILE> \fR
فایل دچار split-brain با نام <FILE> موجود در <HOSTNAME:BRICKNAME> را به‌عنوان مبدأ انتخاب کرده و ترمیم را کامل می‌کند.
.SS "سایر دستورات (Other Commands)"
.TP
\fB\ get-state [<daemon>] [[odir </path/to/output/dir/>] [file <filename>]] [detail|volumeoptions] \fR
دریافت نمایش وضعیت محلی دیمن ذکرشده و ذخیره داده‌ها در اطلاعات مسیر ارائه‌شده.
.TP
\fB\ help \fR
نمایش گزینه‌های دستور.
.TP
\fB\ quit \fR
خروج از واسط خط فرمان gluster.
.SH "فایل‌ها (FILES)"
/var/lib/glusterd/*
.SH "همچنین ببینید (SEE ALSO)"
.nf
\fBfusermount\fR(1), \fBmount.glusterfs\fR(8), \fBglusterfs\fR(8), \fBglusterd\fR(8)
.fi
.SH "حق نشر (COPYRIGHT)"
.nf
Copyright(c) 2006-2011  Gluster, Inc.  <http://www.gluster.com>
.fi