آموزش و راهنمای جامع نصب و راهاندازی Net Agent برای مانیتورینگ انواع UPS

مقدمه
این راهنما، یک مرجع گامبهگام و کاملاً عملی برای نصب، پیکربندی و عیبیابی Net Agent (نرمافزار/کارت شبکه مانیتورینگ UPS) است؛ بهصورت vendor-agnostic نوشته شده تا برای اغلب برندها (کارتهای SNMP/Web، Agentهای نرمافزاری و Shutdown Clientها) قابل استفاده باشد. همه مراحل با نکات امنیتی، تنظیمات شبکه، اتوماسیون خاموشسازی امن سرورها و یک چکلیست پایان کار پوشش داده شده است.
فهرست مطالب
- Net Agent چیست و چه سناریوهایی دارد؟
- پیشنیازها و معماری پیشنهادی
- دانلود، نصب و بهروزرسانی نرمافزارها
- راهاندازی کارت Net Agent (SNMP/Web) بر روی UPS
- پیکربندی شبکه و امنیت (فایروال، VLAN، دسترسی)
- کشف و افزودن UPSها به کنسول مانیتورینگ
- تنظیم SNMP/Trap و بارگذاری MIB
- همگامسازی زمان، تست باتری و خودآزمایی
- تعریف هشدارها: ایمیل، پیامرسانها، Syslog
- خاموشسازی امن سرورها با Shutdown Agent (Windows/Linux/Hypervisor)
- گزارشگیری، داشبورد و یکپارچگی با ابزارهای NMS
- عیبیابی حرفهای (Troubleshooting Guide)
- بهترینروشها (Best Practices)
- چکلیست سریع نصب
- FAQ (سؤالات پرتکرار)
- اسکیما مارکآپ JSON-LD (HowTo + FAQ)
1) Net Agent چیست و چه سناریوهایی دارد؟
Net Agent معمولاً به یکی از این دو مفهوم اشاره دارد:
- کارت شبکه SNMP/Web که داخل UPS نصب میشود و از طریق IP قابل مدیریت و مانیتورینگ است (وباینترفیس + SNMP).
- Agent/Service نرمافزاری روی یک سیستم (Windows/Linux) که از طریق USB/Serial به UPS وصل است و رویدادها را مانیتور و به سایر کلاینتها/سرورها اعلان میکند (اغلب همراه با Shutdown Client برای خاموشسازی امن).
سناریوهای رایج:
- کارت SNMP/Web داخل UPS → مانیتورینگ مستقیم از شبکه + Trap + ایمیل.
- Agent نرمافزاری روی یک سرور → ارتباط USB/Serial با UPS + توزیع هشدار/فرمان خاموشی به کلاینتها.
- هیبرید: کارت SNMP + Agent نرمافزاری (برای اتوماسیونهای پیشرفته و سازگاری حداکثری).
2) پیشنیازها و معماری پیشنهادی
پیشنیازهای عمومی
- شبکه پایدار (ترجیحاً VLAN جدا برای تجهیزات زیرساخت).
- IP ثابت برای هر UPS/کارت Net Agent.
- دسترسی ادمین به فایروال/سوئیچ برای باز کردن پورتها.
- ایمیل سازمانی یا SMTP Relay برای ارسال هشدار.
- NTP داخلی یا اینترنتی برای همگامسازی ساعت.
پورتهای رایج که باید در فایروال مجاز شوند (بسته به سازنده ممکن است متغیر باشد):
- SNMP: UDP 161 (Query)، UDP 162 (Trap)
- HTTP/HTTPS: TCP 80 / 443 (ترجیحاً فقط 443)
- NTP: UDP 123
- SMTP: TCP 25 یا 465 یا 587 (بسته به سرور ایمیل)
- Syslog (اختیاری): UDP 514
- SSH (اختیاری): TCP 22 (اگر کارت پشتیبانی میکند و نیاز دارید)
معماری پیشنهادی
- UPSها با IP ثابت در VLAN زیرساخت.
- دسترسی مدیریتی فقط از شبکه مدیریت (Management Subnet).
- ارسال Trap/Email به یک NMS (مثل Zabbix/PRTG/LibreNMS) و یک ایمیل گروهی (NOC/IT).
- نصب Shutdown Agent فقط روی ماشینهایی که باید در شرایط باتری، خاموش شوند.
3) دانلود، نصب و بهروزرسانی نرمافزارها
نام دقیق بستهها/نسخهها بسته به برند UPS متفاوت است. از صفحه رسمی سازندهی UPS یا کارت Net Agent نسخههای متناسب با سیستمعامل (Windows/Linux/macOS) را دریافت کنید.
Windows
- فایل نصاب Net Agent Utility / Center و در صورت نیاز Shutdown Agent/Client را دانلود کنید.
- با دسترسی Administrator اجرا کنید. ترجیحاً مسیر پیشفرض نصب را تغییر ندهید.
- گزینه Run as Service (راهاندازی خودکار با ویندوز) را فعال کنید.
- در Windows Defender Firewall، پورتهای لازم را Allow کنید.
Linux
- پکیجهای وابسته (مثلاً
snmp
,net-snmp-utils
,mailx
) را نصب کنید. - باینری/اسکریپت Agent را در
/opt
یا/usr/local
قرار دهید. - سرویس Systemd بسازید (نمونه):
[Unit]
Description=UPS NetAgent Service
After=network-online.target
[Service]
Type=simple
ExecStart=/opt/netagent/netagent --config /etc/netagent/config.yml
Restart=always
User=netagent
[Install]
WantedBy=multi-user.target
4. systemctl enable –now netagent و لاگها را با journalctl -u netagent -f مانیتور کنید.
بهروزرسانی
قبل از آپدیت، Backup از تنظیمات بگیرید.
Firmware کارت Net Agent و نسخه Agent/Client را همزمان ارتقا دهید تا ناسازگاری رخ ندهد.
4) راهاندازی کارت Net Agent (SNMP/Web) بر روی UPS
اتصال فیزیکی
- کارت را طبق دفترچه راهنما داخل شیار اختصاصی UPS نصب و پیچها را محکم کنید.
- کابل شبکه را به سوئیچ (ترجیحاً پورت VLAN مدیریت) وصل کنید.
بهدست آوردن IP اولیه
- برخی کارتها DHCP میگیرند؛ اجارههای DHCP را بررسی کنید.
- اگر آدرس پیشفرض دارند، از Utility سازنده یا اسکن شبکه (nmap/arp) کمک بگیرید.
- از کنسول سریال/دکمههای پنل UPS (در مدلهایی که دارند) هم میتوان IP را دید/تنظیم کرد.
ورود و تغییرات اولیه
- ورود به وباینترفیس با مرورگر (HTTPS را ترجیح دهید).
- تغییر رمزهای پیشفرض ادمین (اجباری).
- تنظیم IP ثابت، ماسک، Gateway، DNS.
- فعالسازی HTTPS و غیر فعالسازی HTTP (در صورت امکان).
- محدود کردن Access Control به سابنت یا IPهای ادمین.
5) پیکربندی شبکه و امنیت
- VLANبندی: UPSها را در VLAN زیرساخت قرار دهید؛ دسترسی از کاربر نهایی قطع باشد.
- ACL/Firewall: اجازه دسترسی مدیریتی فقط از IPهای ادمین/NMS.
- SNMP v3 (در صورت پشتیبانی): بهجای v2c از v3 با authPriv (SHA/AES) استفاده کنید.
- گواهی SSL: اگر کارت پشتیبانی میکند، گواهی معتبر بارگذاری کنید.
- بهروزرسانی Firmware: مستمر و کنترلشده (با Change Management).
- ثبت وقایع: ارسال Syslog به SIEM/NMS برای Audit.
6) کشف و افزودن UPSها به کنسول مانیتورینگ
با Utility سازنده
اغلب یک ابزار Scan ارائه میشود که رنج IP شما را جستوجو کرده و UPSها را نشان میدهد؛ از همانجا میتوانید IP و رمز را ست کنید.
با ابزارهای عمومی
- Windows:
arp -a
یا ابزارهای اسکن IP. - Linux:
sudo nmap -sn 192.168.1.0/24
- بررسی پورتهای باز:
nmap -sU -p 161,162 -sT -p 80,443 <IP>
- پس از کشف، هر UPS را با نام منطقی اضافه کنید (مثلاً
UPS-DC-Rack3
)، مکان، ظرفیت (VA/W)، مدل و سریال را ثبت کنید.
7) تنظیم SNMP/Trap و بارگذاری MIB
- اگر v2c: یک Community غیرپیشفرض و پیچیده تنظیم کنید (Read-Only و در صورت نیاز Read-Write جدا).
- اگر v3: کاربر، Auth (SHA-256) و Privacy (AES-128/256) را تعریف کنید، دسترسی را به IPهای NMS محدود کنید.
- Trap
- مقصد Trap (IP سرور NMS) و نسخه (v2/v3) را مشخص کنید.
- انواع Trap موردنیاز: قطع/وصل برق شهری، باتری، بارگذاری بیش از حد، دمای بیشینه، اتمام زمان باتری، خطاهای سختافزاری.
تأیید با snmpwalk (Linux/Windows)
snmpwalk -v2c -c 1.3.6.1.2.1.33 # UPS-MIB
اگر پاسخ مناسب گرفتید، اتصال SNMP درست است. برای v3 از پارامترهای کاربر و الگوریتمها استفاده کنید.
MIB
- فایلهای UPS-MIB و Vendor MIB را در NMS خود بارگذاری کنید تا نام پارامترها بهجای OID خام نمایش داده شود.
- پارامترهای کلیدی که پایش میشوند (نامها ممکن است بر اساس برند کمی متفاوت باشند):
- وضعیت منبع ورودی (Line/Battery/Bypass)
- ولتاژ/فرکانس ورودی و خروجی
- درصد بار (Load %)
- زمان باقیمانده باتری (Runtime Remaining)
- دما و سلامت باتری
- رویدادها/لاگها
8) همگامسازی زمان، تست باتری و خودآزمایی
- NTP: سرور NTP را تنظیم کنید تا زمان رویدادها دقیق باشد.
- Self-Test زمانبندیشده: ماهانه یا فصلی تست کنید؛ اعلانها را پیشاپیش به تیمها بدهید.
- کالیبراسیون Runtime: برخی UPSها نیاز به یک دورهی تخلیه/شارژ کنترلشده دارند (طبق دفترچه سازنده انجام دهید).
9) تعریف هشدارها: ایمیل، پیامرسانها، Syslog
ایمیل (SMTP)
- سرور SMTP، پورت، TLS/SSL و احراز هویت را تنظیم کنید.
- آدرس فرستنده (From) را دامنهی معتبر سازمانی قرار دهید.
- گروههای گیرنده: NOC/IT/On-Call.
پیامرسانها / Webhook
- اگر Agent/کنسول شما Webhook دارد، ارسال به Slack/Telegram/Microsoft Teams را با یک Webhook URL پیکربندی کنید (از سمت پیامرسان بات/کانکتور بسازید).
Syslog
- برای یکپارچگی با SIEM، سطح لاگ (Info/Warning/Critical) و مقصد Syslog را تنظیم کنید.
قوانین اعلان (Alert Rules)
مثالها:
- On Battery بیش از X دقیقه → هشدار سطح بالا
- Runtime Remaining کمتر از Y دقیقه → بحرانی
- Load بالاتر از Z% → هشدار
- دمای داخلی بالاتر از حد آستانه → هشدار
10) خاموشسازی امن سرورها با Shutdown Agent
هدف: هنگامی که برق شهر قطع است و Runtime باتری رو به پایان است، سیستمها بهصورت کنترلشده خاموش شوند تا از خرابی دیتابیس/فایلسیستم جلوگیری شود.
مودهای رایج
- Standalone: Agent روی همان سروری که USB/Serial به UPS وصل است، آستانه را مدیریت میکند.
- Network (SNMP/Web): کارت Net Agent وضعیت را به Shutdown Clients روی سرورها اعلام میکند.
Windows
- Shutdown Client/Agent را نصب کنید (وارد استارتاپ/سرویس شود).
- IP کارت Net Agent یا سرور مرکزی را معرفی کنید.
- سیاستها:
- تأخیر آغاز خاموشی (مثلاً وقتی Runtime < 5 دقیقه).
- اجرای اسکریپت قبل از خاموشی (Backup/Stop Services).
- تست: شبیهسازی On Battery (از وباینترفیس یا کشیدن برق با احتیاط و تحت شرایط کنترلشده).
Linux
- سرویس Agent را نصب و کانفیگ کنید؛ اسکریپتهای pre-shutdown و post-shutdown در
/etc/netagent/scripts
قرار دهید. - دستور خاموشی معمول:
shutdown -h now
یاsystemctl poweroff
.
Hypervisorها
VMware ESXi/vCenter:
- نصب Shutdown Client روی vCenter/یک VM مدیریت.
- ترتیب خاموشی: ابتدا VMهای اپلیکیشن و DB، سپس vCenter، نهایتاً Hostها (در محیطهای کوچک).
Hyper-V:
- استفاده از Integration Services برای خاموشی مهمانها یا اسکریپت PowerShell ترتیبدار.
نکته مهم: همیشه سناریوی DRY RUN (بدون قطع واقعی برق) و سپس تست کنترلشده انجام دهید. خروجی لاگها را بررسی کنید.
11) گزارشگیری، داشبورد و یکپارچگی با NMS
- NMSهایی مانند Zabbix/PRTG/LibreNMS بهراحتی از MIBهای UPS پشتیبانی میکنند.
- داشبوردهای کلیدی:
- Runtime Remaining، Load %، Input/Output Voltage، Battery Temp
- Event Timeline برای تشخیص الگوهای قطع برق.
- Export گزارشها به CSV/PDF برای مدیریت و انطباق (Compliance).
- اگر Agent/کارت API دارد، با Grafana/InfluxDB یکپارچهسازی کنید.
12) عیبیابی حرفهای

12) عیبیابی حرفهای
ping
,tracert
/traceroute
nmap
برای پورت و Host Discoverysnmpwalk
/snmpget
برای تست SNMP- Syslog/SIEM برای تحلیل رخدادها
13) بهترینروشها (Best Practices)
- الزامی: تغییر رمزهای پیشفرض و فعالسازی فقط HTTPS.
- SNMP v3 را ترجیح دهید؛ در v2c، Community پیچیده و دسترسی محدود.
- VLAN و ACL برای ایزولهسازی UPSها.
- بهروزرسانی Firmware و Backup تنظیمات پس از هر تغییر مهم.
- Monthly Health Check: بررسی Runtime، دما و رویدادها.
- Quarterly Self-Test تحت برنامه و اطلاعرسانی.
- نگهداری قطعات یدکی (باتری/فیوز) و برنامه تعویض باتری.
14) چکلیست سریع نصب
- IP ثابت تنظیم شد و دسترسی وباینترفیس برقرار است (HTTPS فعال).
- رمز ادمین تغییر و دسترسی مدیریتی محدود شد.
- SNMP v3 یا v2c امن تنظیم و تست
snmpwalk
موفق. - Trap به NMS/سیستم اعلان ارسال و دریافت شد.
- NTP و منطقه زمانی درست تنظیم شد.
- آستانههای هشدار تعریف و ایمیل/Webhook تست شد.
- Shutdown Agent روی سرورهای هدف نصب، سیاستها تست شد.
- داشبورد/گزارشها در NMS ساخته شد.
- Backup از تنظیمات و مستندسازی داخلی تکمیل شد.
15) FAQ (سؤالات پرتکرار)
1) تفاوت کارت Net Agent و Agent نرمافزاری چیست؟
کارت داخل UPS مستقل از سیستمعامل کار میکند و از طریق شبکه مانیتور میشود؛ Agent نرمافزاری روی یک سیستم نصب میشود و اغلب برای خاموشسازی امن و مانیتورینگ محلی بهکار میرود. ترکیب هر دو بهترین پوشش را میدهد.
2) کدام نسخه SNMP را استفاده کنم؟
اگر کارت و NMS پشتیبانی کنند، SNMP v3 با authPriv امنترین انتخاب است. در غیر اینصورت v2c با Community قوی و محدودیت دسترسی.
3) بدون SMTP سازمانی میتوان ایمیل هشدار داشت؟
بله، با SMTP Relay داخلی یا سرویسدهنده خارجی؛ اما توصیه میشود از دامنه سازمانی و احراز هویت استفاده کنید.
4) چند UPS را میتوان پایش کرد؟
از نظر SNMP محدودیتی ذاتی ندارید؛ محدودیت واقعی به NMS/سرور شما و توان پردازشی/شبکه برمیگردد.
5) آیا میتوان با VMware/Hyper-V خاموشسازی ترتیبدار داشت؟
بله، با Shutdown Client و اسکریپتها میتوانید ترتیب خاموشی VMها/سرویسها را کنترل کنید.
6) اگر برند UPS من Agent مخصوص خودش را دارد، چه کنم؟
از Agent رسمی همان برند استفاده کنید و در صورت نیاز فقط بخشهای عمومی (SNMP/NTP/SMTP) این راهنما را بهکار بگیرید.
اولین دیدگاه را ثبت کنید