به‌روزرسانی و حذف سنسور

سنسور ServerMug معمولاً به هیچ نگه‌داری نیاز ندارد: خودش را به‌روز می‌کند و اگر متوقف شود، مدیر سرویس ویندوز یا systemd دوباره راهش می‌اندازد. این برگه توضیح می‌دهد به‌روزرسانی خودکار چطور کار می‌کند، چطور دستی به‌روز کنید، و چطور سنسور را کامل از یک سرور حذف کنید.

به‌روزرسانی خودکار

1. وقتی نسخهٔ تازه‌ای منتشر شود، سرور ServerMug آن را در پاسخ گزارش بعدی به سنسورهای قدیمی‌تر پیشنهاد می‌کند.
2. سنسور فایل جدید را از همان سرور و با همان اتصال پین‌شده دریافت می‌کند.
3. SHA-256 فایل و امضای ed25519 آن را با کلید عمومی داخل خودش بررسی می‌کند. اگر درست نباشد، نصب نمی‌کند و رویداد «به‌روزرسانی سنسور ناموفق بود» (agent.update_failed) می‌سازد.
4. اگر درست باشد، فایل را جایگزین می‌کند و خارج می‌شود تا مدیر سرویس آن را با نسخهٔ جدید بالا بیاورد. رویداد «سنسور به‌روز شد» (agent.updated) ثبت می‌شود.

تنظیمات و تاریخچهٔ سرور در به‌روزرسانی دست نمی‌خورد و ثبت دوباره لازم نیست. نسخهٔ فعلی هر سرور در بالای صفحهٔ آن، در فیلد «نسخهٔ سنسور»، دیده می‌شود. نسخهٔ منتشرشده و فایل‌ها در صفحهٔ «افزودن سرور» زیر «دریافت مستقیم سنسور» آمده است.

دیدن نسخه روی سرور

# ویندوز
& 'C:\Program Files\ServerMug\servermug-agent.exe' version

# لینوکس
servermug-agent version

به‌روزرسانی دستی

اگر سروری به‌روز نشده (مثلاً دسترسی به سرور ServerMug مدتی قطع بوده)، کافی است اسکریپت نصب را دوباره اجرا کنید. اسکریپت نسخهٔ نصب‌شده را با نسخهٔ منتشرشده مقایسه می‌کند و اگر قدیمی‌تر باشد، فقط فایل را عوض می‌کند و سرویس را دوباره راه می‌اندازد. برای ارتقا توکن لازم نیست، پس این شکل کوتاه کافی است:

# ویندوز (PowerShell با Run as Administrator)
& ([scriptblock]::Create((irm 'https://app.servermug.ir/dl/install.ps1'))) -Dl 'https://app.servermug.ir/dl'

# لینوکس
curl -fsSL 'https://app.servermug.ir/dl/install.sh' | sudo sh -s -- --dl 'https://app.servermug.ir/dl'

اگر سنسور را با GPO پخش کرده‌اید، همان اسکریپت استارتاپ در ریبوت بعدی هر سرور قدیمی را ارتقا می‌دهد.

حذف سنسور از یک سرور

ترتیب پیشنهادی این است که اول سرور را در داشبورد حذف کنید و بعد سنسور را روی سرور. اگر برعکس عمل کنید، تا وقتی سرور را در داشبورد حذف نکرده‌اید، هشدار «سرور از دسترس خارج شد» برایش پیامک می‌شود.

1. در داشبورد: صفحهٔ سرور ← زبانهٔ «تنظیمات» ← «حذف این سرور…». نام سرور را دقیقاً بنویسید و «حذف همیشگی» را بزنید. کلید سنسور باطل و همهٔ داده‌های سرور حذف می‌شود. این کار برگشت‌پذیر نیست.
2. روی سرور ویندوز (PowerShell با Run as Administrator):

   & 'C:\Program Files\ServerMug\servermug-agent.exe' uninstall

3. روی سرور لینوکس:

   sudo servermug-agent uninstall

uninstall این کارها را انجام می‌دهد:

لاگ عمداً می‌ماند تا اگر لازم شد بدانید سنسور تا آخرین لحظه چه کرده است. برای پاک کردن کامل:

# ویندوز
Remove-Item 'C:\Program Files\ServerMug' -Recurse -Force
Remove-Item 'C:\ProgramData\ServerMug' -Recurse -Force

# لینوکس
sudo rm -rf /etc/servermug /var/lib/servermug /var/log/servermug-agent.log

چند وضعیت خاص

• سرور زیر GPO است: اگر GPO نصب هنوز روی آن OU لینک باشد، سنسور در ریبوت بعدی دوباره نصب می‌شود (البته فقط اگر توکن داخل اسکریپت هنوز معتبر باشد). پیش از حذف، سرور را از دامنهٔ GPO بیرون ببرید.
• فقط سرور را در داشبورد حذف کردید: سنسور روی سرور می‌ماند ولی کلیدش باطل شده؛ گزارش‌دادن را متوقف می‌کند، هر ساعت یک بار دوباره امتحان می‌کند و خودبه‌خود دوباره ثبت نمی‌شود. برای پاک کردنش همان uninstall را اجرا کنید.
• نصب دوباره روی همان سرور: اگر سرور را در داشبورد حذف نکرده باشید، نصب دوباره با یک توکن معتبر همان سرور قبلی را با تاریخچه‌اش ادامه می‌دهد. اگر حذف کرده باشید، یک سرور تازه ساخته می‌شود.
• انتقال به سازمان دیگر: uninstall را اجرا کنید و با توکن سازمان جدید دوباره نصب کنید.
• توقف موقت: برای کار برنامه‌ریزی‌شده لازم نیست سنسور را متوقف کنید؛ «حالت نگهداری» را در صفحهٔ سرور روشن کنید تا هشدارها پیامک نشوند. اگر سرویس را دستی متوقف کنید، پس از ۳ دقیقه هشدار قطع ارتباط می‌گیرید.

اگر هنگام حذف یا ارتقا خطایی دیدید، خروجی servermug-agent status و چند خط آخر لاگ را برای پشتیبانی بفرستید. نشانی‌ها و مسیرهای دیگر در نصب روی ویندوز و نصب روی لینوکس آمده است.