| UPSSET.CGI(8) | NUT Manual | UPSSET.CGI(8) |
نام (NAME)
upsset.cgi - برنامه تحت وب CGI برای تغییر متغیرهای یوپیاس در NUT
خلاصه دستور (SYNOPSIS)
upsset.cgi
نکته
به عنوان یک برنامه CGI، این برنامه باید از طریق وبسرور شما فراخوانی شود. اگر آن را از خط فرمان اجرا کنید، همانجا معطل میماند تا زمانی که ورودی شبیه به یک درخواست POST به آن بدهید.
توضیحات (DESCRIPTION)
upsset.cgi یک کلاینت خواندنی/نوشتنی NUT است که به شما امکان میدهد از مرورگر وب خود به بسیاری از عملکردهای مدیریتی درون نرمافزار یوپیاس دسترسی داشته باشید. در صورت در دسترس بودن، میتوانید تنظیمات را تغییر دهید و دستورات آنی را فراخوانی کنید.
برای جزئیات بیشتر درباره پیکربندی برخی از وبسرورهای پرکاربرد جهت اجرای برنامههای CGI در NUT، لطفاً صفحه upsset.conf(5) را ببینید.
تغییر تنظیمات (CHANGING SETTINGS)
برخی از سختافزارهای یوپیاس به شما اجازه میدهند متغیرهای خاصی را به مقادیر دیگری تغییر دهید. برای مشاهده موارد در دسترس، یک یوپیاس را از بخش انتخاب برگزیده و گزینه "settings" را انتخاب کنید، سپس "View" را برای بهروزرسانی صفحه بزنید.
باید فهرستی از موارد را مشاهده کنید که توضیحات در سمت چپ و گزینهها یا فیلدهای ورودی ممکن در سمت راست قرار دارند. پس از ایجاد هر تغییر، حتماً "Save changes" را بزنید تا مقادیر در یوپیاس شما بهروزرسانی شوند.
اگر یوپیاس شما از هیچ متغیر خواندنی/نوشتنی پشتیبانی نکند، در این صفحه کاری برای انجام دادن وجود نخواهد داشت.
تنظیم مقادیر در متغیرهای خواندنی/نوشتنی را میتوان از خط فرمان با upsrw(8) نیز انجام داد.
دستورات آنی (INSTANT COMMANDS)
برخی از سختافزارهای یوپیاس همچنین تمهیداتی برای انجام اقدامات خاص طبق دستور کاربر دارند. این موارد شامل آزمایش باتری، کالیبراسیون باتری، آزمایشهای پنل جلو (بوق!) و موارد دیگر است. برای دسترسی به این بخش، مانند بالا عمل کنید، اما "Commands" را به عنوان عملکرد انتخاب نمایید.
اگر یوپیاس شما از دستورات آنی پشتیبانی کند، آنها در یک ویجت انتخابگر فهرست خواهند شد. موردی را که میخواهید انتخاب کرده و برای اجرا، گزینه "Issue command" را بزنید.
نکته
برخی دستورات خطرناک مانند "Turn off load" ممکن است بلافاصله اجرا نشوند. این یک قابلیت است، نه یک باگ.
درایور apcsmart(8) و برخی درایورهای دیگر نیازمند آن هستند که برای اجرای این دستور، آن را دو بار در یک بازه زمانی کوتاه ارسال کنید. این کار برای جلوگیری از خاموش کردن تصادفی سیستمهای شما بر اثر انتخاب اشتباه است.
برای خاموش کردن واقعی بار (load)، باید دستور را یک بار ارسال کنید، سپس پس از گذشت ۳ ثانیه اما قبل از گذشت ۱۵ ثانیه دوباره آن را بفرستید. اگر خیلی سریع یا خیلی کند این کار را انجام دهید، باید مجدداً دستکم ۳ ثانیه اما نه بیشتر از ۱۵ ثانیه صبر کنید.
همچنین میتوانید دستورات آنی را از طریق خط فرمان با upscmd(8) فراخوانی کنید.
کنترل دسترسی (ACCESS CONTROL)
این برنامه دستورات و تنظیمات را از طریق سرور upsd(8) به درایور شما ارسال میکند که سختافزار را برای شما مدیریت مینماید. شما باید از اعتبارنامههای تعریفشده در فایل upsd.users(5) در آن سرور داده با مجوزهای مناسب استفاده کنید.
برنامه upsset فقط با سرورهای upsd(8) ارتباط برقرار خواهد کرد که در فایل hosts.conf(5) شما تعریف شده باشند. اگر با خطای "Access to that host is not authorized" مواجه شدید، ابتدا فایل hosts.conf خود را بررسی کنید.
امنیت (SECURITY)
برنامه upsset تا زمانی که مطمئن نشود دایرکتوری CGI شما ایمنسازی شده است اجرا نخواهد شد. این امر به دلیل احتمال سوءاستفاده از upsset برای آزمایش ترکیبهای مختلف رمز عبور علیه سرور upsd(8) شما است.
برای اطلاعات بیشتر درباره نحوه انجام این کار، نمونه فایل upsset.conf را ببینید. توضیح کوتاه این است—اگر نمیتوانید آن را ایمن و محدود کنید، برای اجرای آن تلاش نکنید.
فایلها (FILES)
همچنین ببینید (SEE ALSO)
منابع اینترنتی:
صفحه خانگی NUT (Network UPS Tools): https://www.networkupstools.org/historic/v2.8.5
| 06/21/2026 | Network UPS Tools 2.8.5 |