نام (NAME)

xrootdfs - دیمن سامانه فایل FUSE برای xrootd

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

xrootdfs [options] parameters

توضیحات (DESCRIPTION)

دیمن xrootdfs با استفاده از FUSE یک نمای سامانه فایل از یک کلاستر xrootd ارائه می‌دهد. خلاصه نحوه استفاده را می‌توان با وارد کردن «xrootdfs -h» مشاهده کرد. مستندات کوتاه در یک فایل README در دایرکتوری سورس src/XrdFfs قابل مشاهده است.

مثال‌ها (EXAMPLES)

با فرض اینکه هدایت‌کننده (redirector) rdr:port باشد

اجرا از خط فرمان همراه با خروجی اشکال‌زدایی

xrootdfs -d -o rdr=root://rdr:port//data,uid=daemon /mnt

استفاده در /etc/fstab

xrootdfs /mnt fuse rdr=root://rdr:port//data,uid=daemon 1 2

استفاده به همراه autofs

1. افزودن یک خط به /etc/auto.master
/- /etc/auto.fuse

2. ایجاد /etc/auto.fuse تنها با همین یک خط
/mnt -fstype=fuse,uid=2,rdr=root://rdr\:port//data :xrootdfs.sh

3. ایجاد اسکریپت /usr/bin/xrootdfs.sh (مطمئن شوید بیت اجرای +x تنظیم شده باشد)
#!/bin/sh
exec /usr/bin/xrootdfs $@ >/dev/null 2>&1

نکات (NOTES)

مستندات مربوط به تمام مؤلفه‌های وابسته به xrootdfs در نشانی زیر در دسترس است: https://xrootd.org/docs.html

دستور xrootdfs به کاربران و مدیران سیستم امکان می‌دهد پارامترهای داخلی را در حین اجرا از طریق ویژگی‌های توسعه‌یافته سامانه فایل (extended attributes) پرس‌وجو کرده و تغییر دهند

getfattr -n attribute_name /mount_point
setfattr -n attribute_name [ -v value ] /mount_point

attribute_name:

xroot.url: پرس‌وجوی نشانی ROOT واقعی فایل (این یک گزینه قدیمی است)
xrootdfs.fs.nworkers: پرس‌وجو یا تغییر تعداد ریسه‌هایی (threads) که به‌صورت موازی روی عملیاتی مانند stat()، unlink()/rmdir()، readdir()، statvfs() و غیره کار می‌کنند.
xrootdfs.fs.dataserverlist: پرس‌وجو یا تازه‌سازی فهرست تمام سرورهای داده شناخته‌شده برای این نمونه از xrootdfs (یا استفاده از «kill -USR1 pid» جهت تازه‌سازی)

امنیت (SECURITY)

به‌طور پیش‌فرض، XrootdFS هویت مجزای کاربران را به سرورهای ذخیره‌سازی Xrootd ارسال نمی‌کند. بنابراین فضای ذخیره‌سازی Xrootd تصور می‌کند تمامی عملیات‌های دریافتی از یک نمونه XrootdFS از سوی کاربری انجام می‌شود که نمونه XrootdFS را اجرا کرده است. هنگامی که ماژول امنیتی «sss» در Xrootd (مخفف Simple Shared Security) هم در XrootdFS و هم در سامانه ذخیره‌سازی Xrootd فعال باشد، XrootdFS اطلاعات هویت مجزای کاربران را به سرورهای ذخیره‌سازی Xrootd ارسال خواهد کرد. از این اطلاعات می‌توان همراه با ACL در Xrootd برای کنترل دسترسی به فایل‌ها/دایرکتوری‌ها استفاده کرد.

برای استفاده از ماژول امنیتی «sss»، هر دو بخش سرورهای داده Xrootd و XrootdFS باید به‌گونه‌ای پیکربندی شوند که از «sss» به روش مشخصی استفاده کنند؛ برای نمونه هر دو طرف باید از یک فایل کلید استفاده کنند که حاوی همان کلید تولید شده توسط برنامه xrdsssadmin به شیوه زیر باشد:

xrdsssadmin -k my_key_name -u anybody -g usrgroup add keyfile

(تنها «my_key_name» و «keyfile» را تغییر دهید). لطفاً برای اطلاعات بیشتر درباره محل keyfile و بیت‌های دسترسی یونیکس آن، به متغیر محیطی «XrdSecsssKT» در «Authentication & Access Control Configuration Reference» مربوط به Xrootd مراجعه کنید. همان سند همچنین فایل پایگاه‌داده ACL در Xrootd را شرح می‌دهد.

جهت فعال‌سازی «sss» به همراه XrootdFS، از گزینه sss=/keyfile در XrootdFS استفاده کنید.

مثال زیر نحوه استفاده از هر دو ماژول امنیتی unix و sss را همراه با سرورهای داده Xrootd نشان می‌دهد.

xrootd.seclib /usr/lib64/libXrdSec.so
sec.protocol /usr/lib64 sss -s /keyfile
sec.protocol /usr/lib64 unix
acc.authdb /your_xrootd_ACL_auth_db_file
acc.authrefresh 300
ofs.authorize

خطاها (DIAGNOSTICS)

خطاها منجر به صدور پیام خطا و یک وضعیت خروج غیرصفر می‌شوند. این برنامه در صورت موفقیت هرگز خارج نمی‌شود. برای پایان دادن به برنامه از دستور umount استفاده کنید.

اطلاعات گزارش‌گیری تکمیلی را می‌توان در syslog (/var/log/messages) یافت

مجوز (LICENSE)

شرایط مجوز را می‌توان با تایپ «xrootd -H» مشاهده کرد.

سطح پشتیبانی (SUPPORT LEVEL)

دیمن xrootdfs توسط تیم همکاری xrootd پشتیبانی می‌شود. اطلاعات تماس در نشانی زیر در دسترس است:
https://xrootd.org/contact.html