90 lines
6.7 KiB
Markdown
90 lines
6.7 KiB
Markdown
# راهاندازی نهایی سامانه 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 مجدد ویرایش کنید. نمونه دامنهای:
|
||
|
||
```javascript
|
||
window.INOGEN_CONFIG = { apiBaseUrl: "https://inogen-api.company.local/api/v1" };
|
||
```
|
||
|
||
نمونه شبکه داخلی مبتنی بر IP:
|
||
|
||
```javascript
|
||
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 سرور مقادیر زیر را با اطلاعات واقعی تنظیم و ابزار را اجرا کنید:
|
||
|
||
```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 عمل میکند:
|
||
|
||
```powershell
|
||
$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` و داشبورد را بررسی کنید.
|