inogen/deployment/INSTALL.md
2026-10-18 18:12:59 +03:30

6.7 KiB
Raw Blame History

راه‌اندازی نهایی سامانه Inogen روی Windows Server

این بسته شامل سه پوشه frontend، backend و tools است. اطلاعات آزمایشی یا اطلاعات سامانه قبلی در این فرایند منتقل نمی‌شود. دیتابیس تازه در اولین اجرای موفق بک‌اند به‌صورت خودکار ایجاد و به آخرین نسخه ارتقا داده می‌شود.

۱. پیش‌نیازهای سرور

روی Windows Server موارد زیر نصب شوند:

  • SQL Server در دسترس بک‌اند، یا دسترسی شبکه‌ای به یک SQL Server موجود؛
  • IIS با قابلیت‌های Static Content، Default Document، HTTP Errors، Request Filtering، Static Content Compression و IIS Management Console؛
  • بسته .NET 9 Hosting Bundle؛ پس از نصب آن، IIS را با iisreset بازنشانی کنید؛
  • افزونه Microsoft IIS URL Rewrite Module 2. قانون لازم از قبل در frontend\web.config قرار دارد و تنظیم دستی Rewrite لازم نیست؛
  • گواهی TLS معتبر برای حالت پیشنهادی HTTPS.

حساب اجرای Application Pool بک‌اند باید دسترسی Modify به پوشه backend\data داشته باشد. حساب SQL استفاده‌شده در اولین اجرا باید مجوز ایجاد دیتابیس داشته باشد؛ پس از ایجاد دیتابیس می‌توان سطح دسترسی آن را به مجوزهای لازم روی همان دیتابیس محدود کرد.

۲. کپی بسته

محتوای بسته را برای نمونه در مسیر C:\Sites\Inogen استخراج کنید. پوشه‌های داده و فایل‌های آپلودی در C:\Sites\Inogen\backend\data نگهداری می‌شوند؛ از این پوشه پشتیبان‌گیری منظم انجام دهید.

۳. تنظیم اتصال دیتابیس و نشانی فرانت‌اند

فایل backend\appsettings.Production.json را ویرایش کنید:

  • مقدار ConnectionStrings.TargetDatabase اتصال SQL Server مقصد است؛
  • مقدار دقیق نام/نشانی سرور در TargetDatabaseGuard.AllowedServers و نام دیتابیس در TargetDatabaseGuard.AllowedDatabases نیز تکرار شود؛
  • نشانی فرانت‌اند در FrontendOrigins نوشته شود، مانند https://inogen.company.local یا http://192.168.1.20؛
  • رمز نمونه CHANGE_ME حتماً عوض شود. بهتر است رمز اتصال با متغیر محیطی IIS به نام ConnectionStrings__TargetDatabase تأمین شود و در فایل باقی نماند.

در شروع نخست، migrationهای EF اجرا و دیتابیس مشخص‌شده ایجاد می‌شود. این رفتار با DatabaseInitialization.ApplyMigrationsOnStartup=true فعال است.

۴. ساخت سایت بک‌اند در IIS

یک Application Pool بدون Managed Runtime بسازید و یک IIS Site با Physical Path برابر پوشه backend ایجاد کنید. برای آن یک Binding مستقل تعریف کنید؛ برای نمونه:

  • HTTPS: https://inogen-api.company.local
  • شبکه داخلی با IP و پورت مستقل: http://192.168.1.20:5082

حالت HTTPS توصیه می‌شود. فقط اگر شبکه داخلی واقعاً بدون TLS راه‌اندازی می‌شود، در appsettings.Production.json مقدار Security.AllowInsecureHttp را true کنید. در این حالت نشانی FrontendOrigins و آدرس API نیز باید با http یکسان باشند.

پس از راه‌اندازی، پاسخ backend-address/health باید وضعیت ok برگرداند. اجرای اول ممکن است به دلیل ایجاد دیتابیس کمی بیشتر طول بکشد.

۵. اتصال فرانت‌اند به بک‌اند و ساخت سایت فرانت‌اند

فایل frontend\config\runtime-config.js را بدون نیاز به Build مجدد ویرایش کنید. نمونه دامنه‌ای:

window.INOGEN_CONFIG = { apiBaseUrl: "https://inogen-api.company.local/api/v1" };

نمونه شبکه داخلی مبتنی بر IP:

window.INOGEN_CONFIG = { apiBaseUrl: "http://192.168.1.20:5082/api/v1" };

سپس یک IIS Site با Physical Path برابر پوشه frontend و Binding موردنظر، مانند https://inogen.company.local یا http://192.168.1.20 بسازید. فایل web.config همراه بسته، مسیرهای React مانند /admin را به index.html هدایت می‌کند.

۶. فعال‌سازی سامانه

صفحه ورود را باز کنید و شناسه سرور نمایش‌داده‌شده در فرایند فعال‌سازی را برای شرکت تولیدکننده ارسال کنید. کد فعال‌سازی متناظر را از شرکت تولیدکننده دریافت و در صفحه فعال‌سازی وارد کنید. کد به همان سرور و نسخه پروفایل وابسته است.

۷. ایجاد مدیر اولیه

سامانه رمز پیش‌فرض یا ثابت ندارد. پس از ایجاد دیتابیس، در PowerShell سرور مقادیر زیر را با اطلاعات واقعی تنظیم و ابزار را اجرا کنید:

$env:INOGEN_TARGET_CONNECTION = "Server=SQL-SERVER;Database=Inogen;User Id=INOGEN_USER;Password=STRONG_PASSWORD;Encrypt=True;TrustServerCertificate=True"
$env:INOGEN_TARGET_ALLOWED_SERVER = "SQL-SERVER"
$env:INOGEN_TARGET_ALLOWED_DATABASE = "Inogen"
$env:INOGEN_BOOTSTRAP_ADMIN_USER = "admin"
$env:INOGEN_BOOTSTRAP_ADMIN_PASSWORD = "A-Long-Unique-Password"
$env:INOGEN_BOOTSTRAP_ADMIN_DISPLAY_NAME = "مدیر سامانه"
& ".\tools\Inogen.DataTransfer\Inogen.DataTransfer.exe" provision-admin

پس از اجرا، متغیرهای حاوی رمز را از همان نشست پاک کنید یا پنجره PowerShell را ببندید. رمز در خروجی ثبت نمی‌شود.

۸. بازنشانی رمز فراموش‌شده مدیر

با همان سه متغیر اتصال مرحله قبل، متغیرهای زیر را تنظیم و فرمان بازنشانی را اجرا کنید. این فرمان فقط برای حساب فعال دارای نقش Admin عمل می‌کند:

$env:INOGEN_RESET_ADMIN_USER = "admin"
$env:INOGEN_RESET_ADMIN_PASSWORD = "A-New-Long-Unique-Password"
& ".\tools\Inogen.DataTransfer\Inogen.DataTransfer.exe" reset-admin-password

در پایان سایت فرانت‌اند و بک‌اند را یک‌بار Restart کنید و ورود به /admin و داشبورد را بررسی کنید.