14 KiB
راهنمای نصب دستی Inogen برای مشتری
در نمونههای زیر، سرور SQL برابر SQL-SERVER-01، دیتابیس جدید برابر Inogen_CompanyA، دامنهٔ فرانت برابر app.example.com و دامنهٔ API برابر api.example.com است. این مقدارها را با مقدار واقعی خود جایگزین کنید. فرمانها را از ریشهٔ بستهٔ استخراجشده اجرا کنید.
۱. سرور و فایلها را آماده کنید
- روی Windows Server، IIS با قابلیتهای Static Content و Default Document، افزونه URL Rewrite و .NET Hosting Bundle سازگار با API را نصب کنید.
- برای دامنههای فرانت و API رکورد DNS تنظیم کنید. گواهی HTTPS معتبر هر دامنه را روی سرور IIS نصب کنید؛ گواهی CDN بهتنهایی گواهی IIS نیست.
- ZIP را در پوشهای مانند
C:\Inogenاستخراج کنید. پوشههایfrontendوbackendرا کنار هم نگه دارید؛ فرمانهای نصب را از ریشهٔ بسته اجرا کنید.
۲. دیتابیس و حسابها را آماده کنید
- در SQL Server یک دیتابیس خالی با نام واقعی استقرار، مانند
Inogen_CompanyA، ایجاد کنید. - در SSMS به همان نمونهٔ SQL Server که دیتابیس را در آن ساختهاید، با حساب مدیر وصل شوید. از بخش
Security > Loginsحساب SQL به نامinogen_migratorرا بسازید یا وجود آن را بررسی کنید. در یک پنجرهٔ Query همان اتصال، نام دیتابیس را در فرمان زیر جایگزین و آن را اجرا کنید تا کاربر دیتابیس ساخته شود و مجوز اجرای migration بگیرد:
USE [Inogen_CompanyA]; IF USER_ID(N'inogen_migrator') IS NULL CREATE USER [inogen_migrator] FOR LOGIN [inogen_migrator]; IF IS_ROLEMEMBER(N'db_owner', N'inogen_migrator') <> 1 ALTER ROLE [db_owner] ADD MEMBER [inogen_migrator];
حساب جداگانهٔ inogen_runtime را برای API بسازید؛ پس از اجرای migration به آن مجوزهای SELECT، INSERT، UPDATE و DELETE روی schema inogen بدهید. به حساب runtime مجوز تغییر ساختار ندهید.
3. پیش از اجرای migration، یک اتصال جدید در SSMS با SQL Authentication و حساب inogen_migrator به همان نمونهٔ SQL باز کنید. فرمان زیر را با نام دیتابیس واقعی اجرا کنید. مقدارهای IsDbOwner و CanCreateTable باید هر دو 1 باشند. اگر اتصال برقرار نشد یا یکی از مقدارها 1 نبود، نگاشت کاربر، نقش و نام نمونهٔ SQL را با مدیر سرور اصلاح کنید و سپس این بررسی را تکرار کنید:
USE [Inogen_CompanyA]; SELECT @@SERVERNAME AS SqlServer, DB_NAME() AS DatabaseName, ORIGINAL_LOGIN() AS LoginName, USER_NAME() AS DatabaseUser, IS_MEMBER(N'db_owner') AS IsDbOwner, HAS_PERMS_BY_NAME(DB_NAME(), N'DATABASE', N'CREATE TABLE') AS CanCreateTable;
- گواهی TLS سرور SQL را روی سرور برنامه مورد اعتماد قرار دهید. رشتههای اتصال را با
Encrypt=True;TrustServerCertificate=Falseتنظیم کنید.
۳. تنظیمات را ثبت و migration را اجرا کنید
-
در
backend\appsettings.Production.json، مقدارهای نمونهٔAllowedServers،AllowedDatabasesوFrontendOriginsرا با سرور SQL، دیتابیس مقصد و نشانی فرانت واقعی جایگزین کنید. مقدارApplyMigrationsOnStartupراfalseنگه دارید. مقدارTargetDatabaseفقط نمونه است؛ رمزCHANGE_MEرا در فایل به رمز واقعی تبدیل نکنید. رشتهٔ اتصال واقعی را در گام IIS، برای App Pool API ثبت کنید. -
در
frontend\config\runtime-config.jsنشانی API را ثبت کنید:
window.INOGEN_CONFIG = { apiBaseUrl: "https://api.example.com/api/v1" };
فایل را در پوشهٔ frontend نسخهٔ نصبشده روی سرور نیز بررسی کنید؛ مقدار /api/v1 فقط زمانی درست است که API و فرانت روی یک دامنه و از همان مسیر منتشر شده باشند. برای دو دامنهٔ جدا، نشانی کامل HTTPS دامنهٔ API را مانند نمونهٔ بالا بگذارید. در backend\appsettings.Production.json نیز نشانی واقعی دامنهٔ فرانت را در FrontendOrigins ثبت کنید.
- در PowerShell، پس از اصلاح
AllowedServersوAllowedDatabasesدر فایل تنظیمات، فرمان زیر را از ریشهٔ بسته اجرا کنید. نام حساب SQL را جایگزین کنید؛ اسکریپت نام سرور و دیتابیس را از همان فایل میخواند و رمز را جداگانه درخواست میکند:
.\migrate-target.ps1 -SqlUser 'inogen_migrator'
فقط پس از دیدن Target migrations applied. ادامه دهید و همین پنجرهٔ PowerShell را برای ساخت حساب مدیر باز نگه دارید. migration ساختار دیتابیس را ایجاد میکند و دادهٔ قدیمی را منتقل نمیکند. اگر گواهی SQL فقط در محیط تست مورد اعتماد نیست، میتوانید موقتاً -TrustServerCertificate را به انتهای همین فرمان اضافه کنید.
اگر خطای SQL error 262: CREATE TABLE permission denied دیدید، migration را متوقف کنید؛ گام ۲ و ۳ بخش «دیتابیس و حسابها» را روی همان نمونهٔ SQL و همان دیتابیس تکرار کنید. پیام Target guard passed فقط نام مقصد را بررسی میکند و تأیید مجوز SQL نیست. پس از اینکه هر دو مقدار بررسی مجوز 1 شدند، فرمان migration را دوباره اجرا کنید. اگر خطای گواهی نامعتبر دیدید، گواهی SQL را روی سرور برنامه مورد اعتماد قرار دهید؛ گزینهٔ -TrustServerCertificate فقط برای تست داخلی است.
- پس از migration، در SSMS مجوز حساب runtime را روی دیتابیس مقصد ثبت کنید:
USE [Inogen_CompanyA]; IF USER_ID(N'inogen_runtime') IS NULL CREATE USER [inogen_runtime] FOR LOGIN [inogen_runtime]; GRANT SELECT, INSERT, UPDATE, DELETE ON SCHEMA::[inogen] TO [inogen_runtime];
۴. سایتهای IIS را دستی ایجاد کنید
- در IIS Manager دو Application Pool به نام
Inogen-FrontendوInogen-Apiبسازید و.NET CLR Versionرا برای هر دو رویNo Managed Codeبگذارید. - سایت فرانت را به مسیر فیزیکی
C:\Inogen\frontendو Pool اول وصل کنید. سایت API را بهC:\Inogen\backendو Pool دوم وصل کنید. اگر مسیر استخراج متفاوت است، همان مسیر واقعی را وارد کنید. - برای هر سایت binding از نوع
httpsروی پورت443و Host name همان دامنه با SNI بسازید و گواهی همان دامنه را انتخاب کنید. اگر از ابر آروان استفاده میکنید، HTTPS از آروان تا سرور مبدأ را نیز تنظیم کنید. - به
IIS AppPool\Inogen-Apiرویbackend\dataو زیرپوشههای آن مجوز Modify بدهید. - رشتهٔ اتصال حساب runtime را با نام
ConnectionStrings__TargetDatabaseدر متغیرهای محیطی App Pool API ثبت کنید. نمونهٔ مقدار درappsettings.Production.jsonآمده است؛ رمز واقعی را در آن فایل ننویسید. پس از ساخت Pool، در PowerShell مدیر فرمان زیر را اجرا کنید. اسکریپت نام سرور و دیتابیس را از فایل تنظیمات میخواند و رمز را جداگانه میپرسد:
.\set-iis-runtime-connection.ps1 -SqlUser 'inogen_runtime' -AppPoolName 'Inogen-Api'
این مقدار در تنظیمات IIS ذخیره میشود؛ دسترسی مدیران سرور به آن را محدود کنید. اگر نام Pool را تغییر دادهاید، مقدار -AppPoolName را عوض کنید. در محیط تست، اگر گواهی SQL هنوز مورد اعتماد نیست، گزینهٔ -TrustServerCertificate را فقط موقتاً به فرمان اضافه کنید.
- از خود سرور،
https://api.example.com/healthو سپسhttps://api.example.com/api/v1/deployment/profileرا باز کنید. پاسخ اول باید کد200و پاسخ دوم باید یک شیء JSON شاملcompany،brandingوactivationباشد. سپس نشانی فرانت را باز کنید. اگر فرانت پیام «تنظیمات استقرار در دسترس نیست» نشان داد، ابتداfrontend\config\runtime-config.jsرا بررسی کنید و سپس در ابزار Developer Tools مرورگر، وضعیت درخواست/api/v1/deployment/profileرا ببینید. اگر درخواست به دامنهٔ اشتباه میرود، نشانی API را در همان فایل اصلاح و صفحه را با بارگذاری کامل دوباره باز کنید؛ اگر درخواست از دامنهٔ درست خطای شبکه یا CORS دارد، HTTPS دامنهٔ API و مقدارFrontendOriginsرا بررسی کنید.
۵. سامانه را فعال و مدیر را ایجاد کنید
- نشانی فرانت را مانند
https://app.example.com/adminباز کنید. اگر صفحهٔ فعالسازی نمایش داده شد، شناسهٔ ۶۴ کاراکتری سرور را کپی و برای صادرکنندهٔ کد ارسال کنید. کد دریافتی را در همان صفحه ثبت کنید. - در همان نشست PowerShell گام ۳، حساب مدیر را روی همان دیتابیس بسازید. اگر PowerShell را بستهاید، ابتدا اتصال را در نشست جدید با فرمان زیر دوباره آماده کنید؛
-ConfigureOnlymigration را تکرار نمیکند:
.\migrate-target.ps1 -SqlUser 'inogen_migrator' -ConfigureOnly
اگر فقط در محیط تست گواهی SQL هنوز مورد اعتماد نیست، به همین فرمان -TrustServerCertificate را هم اضافه کنید. سپس در همان پنجره حساب مدیر را بسازید:
.\initialize-admin.ps1 -DisplayName 'مدیر سامانه'
رمز مدیر باید حداقل ۱۲ نویسه، حرف بزرگ، حرف کوچک، رقم و نویسهٔ ویژه داشته باشد. نام کاربری خروجی را ثبت کنید و رمز را جداگانه و امن تحویل دهید. حساب مدیر با رمز پیشفرض وجود ندارد.
پس از فعالسازی و ورود مدیر، صفحهٔ تنظیمات استقرار را مستقیم با نشانی مانند https://app.example.com/admin/deployment-settings باز کنید. این صفحه در منوی پنل نمایش داده نمیشود. در بخش واحدهای داشبورد نام واحدها و چیدمان را ثبت کنید و دکمهٔ ذخیره تنظیمات را بزنید. صفحهٔ ورود کد فعالسازی فقط کد را دریافت میکند؛ تنظیمات واحدها در صفحهٔ جداگانه انجام میشود.
اگر ساخت مدیر ناموفق بود، مرحلهٔ اعلامشده در خطای ابزار را بخوانید. برای خطای Identity validation failed، کد خطای سیاست رمز یا نام کاربری را اصلاح و فرمان را دوباره اجرا کنید. اگر نشست PowerShell عوض شده است، ابتدا فرمان migrate-target.ps1 را با -ConfigureOnly در همان نشست اجرا کنید و سپس ساخت مدیر را تکرار کنید. اگر خطا در مرحلهٔ create roles یا assign administrator role رخ داد، مجوز حساب migration را روی دیتابیس مقصد بررسی کنید؛ حساب API را برای این فرمان به کار نبرید.
۶. نصب را بررسی کنید
- نشانی پنل مدیر را با دامنهٔ واقعی فرانت، مانند
https://app.example.com/admin، باز کنید و با حساب مدیری که در گام ۵ ساختهاید وارد شوید. نشانی دامنهٔ API صفحهٔ ورود مدیر ندارد. پاسخ فرانت و API را بررسی کنید. - روی نقطهٔ پایان HTTPS، TLS 1.0 و 1.1 و cipherهای CBC را غیرفعال کنید. برای Windows Server میتوانید
configure-windows-tls.ps1را ابتدا برای پیشنمایش و سپس در بازهٔ نگهداری با-Applyاجرا کنید. تنظیمات ابر آروان را در پنل آن انجام دهید. - متغیرهای موقت نشست نصب را پاک کنید:
Remove-Item Env:INOGEN_TARGET_CONNECTION,Env:INOGEN_TARGET_ALLOWED_SERVER,Env:INOGEN_TARGET_ALLOWED_DATABASE -ErrorAction SilentlyContinue