نام (NAME)

mfscli - همتای رابط کاربری گرافیکی (GUI) در حالت متنی (TXT)

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

mfscli [-jpn28] [-H master_host] [-P master_port] [-f 0..3] -S(IN|IG|IM|LI|IC|IL|MF|MU|CS|MB|HD|EX|MD|MS|MO|OF|AL|RP|SC|PA|QU|MC|CC) [-s separator] [-o order_id [-r]] [-m mode_id] [-i id] [-a master_data_count] [-b master_data_desc] [-c chunkserver_data_count] [-d chunkserver_data_desc]

mfscli [-pn28] [-H master_host] [-P master_port] [-f 0..3] -C(RC/ip/port|BW/ip/port|M[01]/ip/port|RS/sessionid|TR/ip/port)

mfscli -h

توضیحات (DESCRIPTION)

دستور mfscli همتای خط فرمانی رابط گرافیکی MooseFS است. تمام اطلاعات موجود در رابط گرافیکی (به‌جز بخش‌های نمودارها و وضعیت) را می‌توان با استفاده از «گزینه‌های پایش» مختلف از طریق خط فرمان به دست آورد؛ داده‌های نمودار را نیز می‌توان به‌صورت متنی دریافت کرد.

گزینه‌ها (OPTIONS)

گزینه‌های عمومی (GENERAL OPTIONS)

-h: چاپ پیام راهنما و خروج
-j: چاپ خروجی در قالب JSON
-p: اجبار به استفاده از قالب متنی ساده (plain text) در دستگاه‌های tty
-n: عدم حل و نام‌گشایی آدرس‌های ip (پیش‌فرض هنگامی که دستگاه خروجی tty نیست)
-s separator: جداکننده فیلدها برای استفاده در قالب متنی ساده روی دستگاه‌های tty (گزینه -p را تحمیل می‌کند)
-2: اجبار به استفاده از کدهای رنگی ترمینال ۲۵۶ رنگی
-8: اجبار به استفاده از کدهای رنگی ترمینال ۸ رنگی
-H master_host: آدرس master (پیش‌فرض: mfsmaster)
-P master_port: پورت کلاینت master (پیش‌فرض: 9421)
-f 0..3: تعیین مجموعه نویسه قاب برای نمایش کادرهای جدول در حالت tty؛

0: قاب‌های ساده اسکی '+'، '-'، '|' (پیش‌فرض)
1: قاب‌های یونیکد ضخیم
2: قاب‌های یونیکد نازک
3: قاب‌های یونیکد دوخطی (به سبک dos)

-o order_id: مرتب‌سازی داده‌ها بر اساس ستونی که با 'order id' مشخص شده است (بسته به مجموعه داده)
-r: معکوس کردن ترتیب مرتب‌سازی
-m mode_id: نمایش داده‌های مشخص‌شده با 'mode id' (بسته به مجموعه داده)
-i id: مقدار sessionid برای -SOF یا inode برای -SAL
-a master_data_count: تعداد مدخل‌های نمودارهای دادهٔ master (-SMC) که باید نمایش داده شوند
-b master_data_desc: تعریف ستون‌های نمودارهای دادهٔ master (-SMC)؛ افزودن پیشوند '+' برای داده‌های خام، (تنها در نسخه pro) افزودن پیشوند 'ip:[port:]' برای انتخاب سرور (به‌طور پیش‌فرض سرور leader master استفاده خواهد شد)؛ استفاده از 'all' به‌عنوان نام نمودار برای همه نمودارهای موجود
-c chunkserver_data_count: تعداد مدخل‌های نمودارهای دادهٔ chunkserver (-SCC) که باید نمایش داده شوند
-d chunkserver_data_desc: تعریف ستون‌های نمودارهای دادهٔ chunkserver (-SCC)؛ افزودن پیشوند '+' برای داده‌های خام، افزودن پیشوند 'ip:[port:]' برای انتخاب سرور (به‌طور پیش‌فرض همه سرورها استفاده خواهند شد)؛ استفاده از 'all' به‌عنوان نام نمودار برای همه نمودارهای موجود.SS "گزینه‌های پایش (MONITORING OPTIONS)"
-SIN: نمایش اطلاعات کامل مستر (شامل: SIG، SIM، SLI، SIC، SIL، SMF، SMU)
-SIG: فقط نمایش خلاصه کلی کلاستر
-SIM: فقط نمایش وضعیت‌های مسترها
-SLI: (فقط pro) فقط نمایش اطلاعات مجوز
-SIC: فقط نمایش اطلاعات چانک‌ها (ماتریس‌های سطح افزونگی هدف/فعلی)
-SIL: فقط نمایش اطلاعات حلقه‌های خودآزمایی (همراه با پیام‌ها)
-SMF: فقط نمایش چانک‌ها/فایل‌های مفقود
-SMU: فقط نمایش میزان مصرف حافظه مستر
-SCS: نمایش چانک‌سرورهای متصل
-SMB: نمایش سرورهای پشتیبان متاداده متصل
-SHD: نمایش داده‌های hdd
-SEX: نمایش اشتراک‌ها (exports)
-SMD: نمایش جزئیات مانت‌ها (شامل: SMS، SMO، SOF، SAL)
-SMS: فقط نمایش مانت‌های فعال
-SMO: فقط نمایش شمارنده‌های عملیات
-SOF: فقط نمایش فایل‌های باز
-SAL: فقط نمایش قفل‌های گرفته‌شده
-SRP: نمایش خط‌مشی افزونگی (شامل: SSC، SPA)
-SSC: نمایش کلاس‌های ذخیره‌سازی
-SPA: نمایش بازنویسی‌های الگو
-SQU: نمایش اطلاعات سهمیه (quota)
-SMC: نمایش داده‌های نمودارهای مستر (استفاده با -a و -b)
-SCC: نمایش داده‌های نمودارهای چانک‌سرور (استفاده با -c و -d)

ستون‌های دردسترس داده‌های نمودار مستر (-SMC)

ucpu: میزان مصرف پردازنده در فضای کاربری
scpu: میزان مصرف پردازنده در فضای سیستم
delete,del: تعداد تلاش‌های حذف چانک
replicate,rep,repl: تعداد تلاش‌های تکثیر چانک
statfs: تعداد عملیات statfs
getattr: تعداد عملیات getattr
setattr: تعداد عملیات setattr
lookup: تعداد عملیات lookup
mkdir: تعداد عملیات mkdir
rmdir: تعداد عملیات rmdir
symlink: تعداد عملیات symlink
readlink: تعداد عملیات readlink
mknod: تعداد عملیات mknod
unlink: تعداد عملیات unlink
rename: تعداد عملیات rename
link: تعداد عملیات link
readdir: تعداد عملیات readdir
open: تعداد عملیات open
readchunk: تعداد عملیات chunk_read
writechunk: تعداد عملیات chunk_write
memoryrss,memrss,rmem,mem: میزان مصرف حافظه مقیم (RSS)
prcvd: بسته‌های دریافت‌شده
psent: بسته‌های ارسال‌شده
brcvd: بایت‌های دریافت‌شده
bsent: بایت‌های ارسال‌شده
memoryvirt,memvirt,vmem: میزان مصرف حافظه مجازی
usedspace: میزان مصرف فضای دیسک خام (RAW)
totalspace: کل فضای دیسک خام (RAW) متصل
create: تعداد تلاش‌های ایجاد چانک
change: تعداد تلاش‌های عملیات داخلی چانک
delete_ok: تعداد حذف‌های موفق چانک
delete_err: تعداد حذف‌های ناموفق چانک
replicate_ok: تعداد تکثیرهای موفق چانک
replicate_err: تعداد تکثیرهای ناموفق چانک
create_ok: تعداد ایجادهای موفق چانک
create_err: تعداد ایجادهای ناموفق چانک
change_ok: تعداد عملیات‌های داخلی موفق چانک.TP change_err تعداد عملیات‌های درونی ناموفق چانک
split_ok: تعداد عملیات‌های موفق تقسیم چانک
split_err: تعداد عملیات‌های ناموفق تقسیم چانک
fileobjects: تعداد اشیاء فایل
metaobjects: تعداد اشیاء غیرفایلی (دایرکتوری‌ها، پیوندهای نمادین و غیره)
chunksec8: تعداد کل چانک‌های ذخیره‌شده در قالب EC8
chunksec4: تعداد کل چانک‌های ذخیره‌شده در قالب EC4
chunkscopy: تعداد کل چانک‌های ذخیره‌شده در قالب COPY
chregdanger: تعداد چانک‌های در معرض خطر (بدون احتساب موارد نشانه‌گذاری‌شده برای حذف)
chregunder: تعداد چانک‌های کمتر از هدف (undergoal) (بدون احتساب موارد نشانه‌گذاری‌شده برای حذف)
challdanger: تعداد چانک‌های در معرض خطر (با احتساب موارد نشانه‌گذاری‌شده برای حذف)
challunder: تعداد چانک‌های کمتر از هدف (undergoal) (با احتساب موارد نشانه‌گذاری‌شده برای حذف)
bytesread: میانگین تعداد بایت‌های خوانده‌شده در ثانیه توسط همه کلاینت‌ها
byteswrite: میانگین تعداد بایت‌های نوشته‌شده در ثانیه توسط همه کلاینت‌ها
read: تعداد عملیات‌های خواندن (read)
write: تعداد عملیات‌های نوشتن (write)
fsync: تعداد عملیات‌های fsync
lock: تعداد عملیات‌های قفل‌گذاری (lock)
snapshot: تعداد عملیات‌های snapshot
truncate: تعداد عملیات‌های truncate
getxattr: تعداد عملیات‌های getxattr
setxattr: تعداد عملیات‌های setxattr
getfacl: تعداد عملیات‌های getfacl
setfacl: تعداد عملیات‌های setfacl
fcreate: تعداد عملیات‌های ایجاد فایل
meta: تعداد عملیات‌های فراداده‌ای اضافه (sclass، trashretention، eattr و غیره)
delay: (فقط در نسخه pro) بیشینه تأخیر Master به ثانیه
servers: تعداد کل سرورهای چانک ثبت‌شده (هم متصل و هم قطع‌شده)
mdservers: تعداد سرورهای چانک قطع‌شده که در حالت نگهداری (maintenance) هستند
dservers: تعداد سرورهای چانک قطع‌شده که در حالت نگهداری نیستند
udiff: اختلاف درصد استفاده از فضا میان سرور چانک با بیشترین و کمترین استفاده
cpu: کل میزان استفاده از cpu (مجموع scpu + ucpu).SS "ستون‌های در دسترس داده‌های نمودار CHUNKSERVER (-SCC)"
ucpu: میزان مصرف پردازنده در فضای کاربری
scpu: میزان مصرف پردازنده در فضای سیستمی
masterin: داده‌های دریافت‌شده از master
masterout: داده‌های ارسال‌شده به master
csrepin: داده‌های دریافت‌شده توسط replicator
csrepout: داده‌های ارسال‌شده توسط replicator
csservin: داده‌های دریافت‌شده توسط csserv
csservout: داده‌های ارسال‌شده توسط csserv
hdrbytesr: بایت‌های خوانده‌شده (سرایندها)
hdrbytesw: بایت‌های نوشته‌شده (سرایندها)
hdrllopr: عملیات‌های سطح پایین خواندن (سرایندها)
hdrllopw: عملیات‌های سطح پایین نوشتن (سرایندها)
databytesr: بایت‌های خوانده‌شده (داده‌ها)
databytesw: بایت‌های نوشته‌شده (داده‌ها)
datallopr: عملیات‌های سطح پایین خواندن (داده‌ها)
datallopw: عملیات‌های سطح پایین نوشتن (داده‌ها)
hlopr: عملیات‌های سطح بالای خواندن
hlopw: عملیات‌های سطح بالای نوشتن
rtime: زمان خواندن
wtime: زمان نوشتن
repl: عملیات‌های تکثیر چانک
create: عملیات‌های ایجاد چانک
delete: عملیات‌های حذف چانک
version: عملیات‌های تنظیم نسخه
duplicate: عملیات‌های همتاسازی (duplicate)
truncate: عملیات‌های کوتاه‌سازی (truncate)
duptrunc: عملیات‌های duptrunc (همتاسازی+کوتاه‌سازی)
test: عملیات‌های آزمایش چانک
load: بار کاری سرور
memoryrss,memrss,rmem,mem: میزان حافظهٔ مقیم مصرفی
memoryvirt,memvirt,vmem: میزان حافظهٔ مجازی مصرفی
movels: عملیات‌های جابه‌جایی با سرعت پایین
movehs: عملیات‌های جابه‌جایی با سرعت بالا
split: عملیات‌های تقسیم (split)
usedspace: فضای مصرف‌شدهٔ دیسک سخت بر حسب بایت (به‌جز موارد علامت‌گذاری‌شده برای حذف)
totalspace: کل فضای دیسک سخت بر حسب بایت (به‌جز موارد علامت‌گذاری‌شده برای حذف)
chunkcount: تعداد چانک‌های ذخیره‌شده (به‌جز موارد علامت‌گذاری‌شده برای حذف)
tdusedspace: فضای مصرف‌شدهٔ دیسک سخت بر حسب بایت روی دیسک‌های علامت‌گذاری‌شده برای حذف
tdtotalspace: کل فضای دیسک سخت بر حسب بایت روی دیسک‌های علامت‌گذاری‌شده برای حذف
tdchunkcount: تعداد چانک‌های ذخیره‌شده روی دیسک‌های علامت‌گذاری‌شده برای حذف
copychunks: تعداد چانک‌های ذخیره‌شده در قالب copy (تمامی دیسک‌ها)
ec4chunks: تعداد بخش‌های چانک ذخیره‌شده در قالب EC4 (تمامی دیسک‌ها)
ec8chunks: تعداد بخش‌های چانک ذخیره‌شده در قالب EC8 (تمامی دیسک‌ها)
hddok: تعداد پوشه‌ها (دیسک‌های سخت) معتبر
hddmfr: تعداد پوشه‌ها (دیسک‌های سخت) علامت‌گذاری‌شده برای حذف
hdddmg: تعداد پوشه‌ها (دیسک‌های سخت) علامت‌گذاری‌شده به عنوان آسیب‌دیده
udiff: اختلاف درصد استفاده میان بیشترین و کمترین دیسک مصرف‌شده
cpu: مجموع مصرف پردازنده (scpu + ucpu).SS "دستورها (COMMANDS)"
-CRC/ip/port: حذف chunkserver انتخاب‌شده از فهرست chunkserverهای فعال
-CTR/ip/port: حذف موقت chunkserver انتخاب‌شده از فهرست chunkserverهای فعال (فقط در حالت master elect)
-CBW/ip/port: بازگرداندن chunkserver انتخاب‌شده به وضعیت کاری (از وضعیت grace)
-CM1/ip/port: تغییر وضعیت chunkserver انتخاب‌شده به حالت نگهداری (maintenance)
-CM0/ip/port: تغییر وضعیت chunkserver انتخاب‌شده به حالت استاندارد (از حالت نگهداری)
-CRS/sessionid: حذف نشست (session) انتخاب‌شده

مثال‌ها (EXAMPLES)

mfscli -SIC -2: نمایش جدول ماتریس وضعیت چانک (تعداد چانک‌ها برای هر ترکیبی از نسخه‌های معتبر و goal تعیین‌شده توسط کاربر) با استفاده از رنگ‌های گسترش‌یافته ترمینال (۲۵۶ رنگی)
mfscli -SCS -f 1: نمایش جدول تمام chunkserverها با استفاده از کادرهای ضخیم یونیکد
mfscli -SMS -p -s ',': نمایش نشست‌های (mountها) جاری با استفاده از قالب متن ساده و کاما به عنوان جداکننده
mfscli -SOF -i 123: نمایش فایل‌های باز شده توسط فرایندهایی که از نشست (mount) با شناسه ۱۲۳ استفاده می‌کنند
mfscli -SMC -a 10 -b cpu,memoryrss,delete,replicate: نمایش میزان مصرف cpu مستر، مقدار حافظه مقیم (resident) مصرفی مستر، تعداد چانک‌های حذف‌شده و تعداد چانک‌های تکثیرشده در طول ده دقیقه گذشته
mfscli -SCC -c 15 -d 192.168.1.10:9422:cpu,192.168.1.11:9422:cpu: نمایش مصرف cpu چانک‌سرورهای مستقر در ماشین‌هایی با IP 192.168.1.10 و 192.168.1.11 در طول پانزده دقیقه گذشته
mfscli -SCC -d $(mfscli -SCS -p -s ',' | grep '^chunk' | awk -F ',' 'BEGIN {s=""} {printf "%s%s:%s:mem",s,$2,$3 ; s=","}'): نمایش میزان مصرف حافظه مقیم تمام chunkserverهای متصل (در نسخه قدیمی mfscli - پیش از نگارش 4.32.2)
mfscli -SCC -d mem: نمایش میزان مصرف حافظه مقیم تمام chunkserverهای متصل (در نسخه کنونی mfscli)
mfscli -SIN -j: چاپ اطلاعات پایه در قالب JSON

گزارش باگ‌ها (BUGS)

گزارش باگ‌ها به <bugs@moosefs.com>.

کپی‌رایت و تکثیر (COPYRIGHT)

حق نشر (C) ۲۰۲۶ Jakub Kruszona-Zawadzki, Saglabs SA

این فایل بخشی از MooseFS است.

نرم‌افزار MooseFS یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «پروانه عمومی همگانی گنو» (GNU General Public License) طبق آنچه بنیاد نرم‌افزارهای آزاد منتشر کرده است، نسخه ۲ (صرفاً)، بازتوزیع کنید یا تغییر دهید.

نرم‌افزار MooseFS با این امید توزیع شده است که مفید باشد، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت فروش یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به پروانه عمومی همگانی گنو مراجعه کنید.

شما باید به همراه این برنامه یک نسخه از پروانه عمومی همگانی گنو را دریافت کرده باشید؛ در غیر این صورت، به https://www.gnu.org/licenses مراجعه کنید.

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

mfsmaster(8)