inogen/deployment/INSTALL-INTERNAL.md

59 lines
5.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# راهنمای نصب دستی و انتقال داده برای تست داخلی Inogen
این راهنما مخصوص بستهٔ داخلی است. بستهٔ مشتری ابزار انتقال داده ندارد. برای هر شرکت، یک دیتابیس مقصد جداگانه انتخاب کنید؛ ساختار دیتابیس‌های قدیمی یکسان است، اما نام دیتابیس منبع را برای هر انتقال دقیق وارد کنید.
## ۱. بستهٔ داخلی را بسازید و نصب پایه را انجام دهید
1. در محیط ساخت، کلید امضای موجود را به نشست PowerShell معرفی کنید و بستهٔ داخلی را بسازید. کلید خصوصی را به سرور تست منتقل نکنید:
```powershell
cd 'D:\Work\Inogen\inogen'; $env:INOGEN_RELEASE_SIGNING_KEY = 'D:\Work\Inogen-release-signing-private.pem'; .\deployment\build-package.ps1 -SkipNpmInstall -IncludeInternalTransfer
```
گزینهٔ `-SkipNpmInstall` را فقط وقتی بگذارید که وابستگی‌های فرانت از قبل نصب شده‌اند.
2. بستهٔ ZIP داخلی را روی سرور استخراج کنید و گام‌های ۱ تا ۴ راهنمای `INSTALL.pdf` را برای دیتابیس مقصد جدید انجام دهید. برای نمونه، مقصد را `SQL-SERVER-01/Inogen_CompanyA` بگذارید. ساختار مقصد را با `migrate-target.ps1` ایجاد کنید؛ دادهٔ قدیمی هنوز منتقل نشده است.
3. اگر گواهی SQL در محیط تست مورد اعتماد نیست، ابتدا گواهی را درست نصب کنید. برای عبور موقت در تست، به فرمان `migrate-target.ps1` گزینهٔ `-TrustServerCertificate` را اضافه کنید و در رشته‌های اتصال منبع و مقصد نیز مقدار `TrustServerCertificate=True` بگذارید. این استثنا را به محیط مشتری منتقل نکنید.
## ۲. منبع و مقصد انتقال را مشخص کنید
1. از دیتابیس قدیمی و مقصد نسخهٔ پشتیبان بگیرید. نام دقیق سرور و دیتابیس قدیمی را از SQL Server بخوانید؛ برای نمونه `OLD-SQL-01/Legacy_CompanyA`. نام منبع نباید با مقصد یکسان باشد.
2. روی دیتابیس قدیمی یک حساب فقط‌خواندنی بسازید. حساب مقصد نیز باید مجوز نوشتن در schema `inogen` داشته باشد. از ریشهٔ بسته، فرمان زیر را اجرا کنید؛ اسکریپت نام مقصد را از `backend\appsettings.Production.json` می‌خواند و هر دو رمز را جداگانه می‌پرسد:
```powershell
.\prepare-transfer-connections.ps1 -SourceServer 'OLD-SQL-01' -SourceDatabase 'Legacy_CompanyA' -SourceUser 'legacy_reader' -TargetUser 'inogen_runtime'
```
3. اگر گواهی SQL منبع یا مقصد فقط در محیط تست مورد اعتماد نیست، به فرمان بالا به‌ترتیب `-TrustSourceCertificate` یا `-TrustTargetCertificate` اضافه کنید. همین پنجرهٔ PowerShell را تا پایان انتقال باز نگه دارید.
## ۳. انتقال را بررسی و اجرا کنید
1. از ریشهٔ بستهٔ داخلی، ابتدا فرمان بررسی منبع و سپس فرمان پیش‌نمایش را **جداگانه** اجرا کنید. نام منبع در هر دو باید یکسان باشد:
```powershell
.\select-internal-transfer.ps1 -Command verify-source -SourceServer 'OLD-SQL-01' -SourceDatabase 'Legacy_CompanyA'
```
```powershell
.\select-internal-transfer.ps1 -Command preview-source -SourceServer 'OLD-SQL-01' -SourceDatabase 'Legacy_CompanyA'
```
2. شمار رکوردها و شناسهٔ snapshot پیش‌نمایش را با دیتابیس همان شرکت تطبیق دهید. سپس یک شناسهٔ یکتا برای این نوبت انتقال انتخاب کنید و فرمان زیر را اجرا کنید. ابزار برای تأیید، نام دیتابیس قدیمی را دوباره می‌پرسد:
```powershell
.\select-internal-transfer.ps1 -Command import-source -SourceServer 'OLD-SQL-01' -SourceDatabase 'Legacy_CompanyA' -IdempotencyKey 'company-a-20261103-01'
```
3. شمار رکوردهای منتقل‌شده و موارد quarantine را بررسی کنید. اگر شرکت دیگری را منتقل می‌کنید، دیتابیس مقصد، تنظیمات و هر دو رشتهٔ اتصال را برای آن شرکت تغییر دهید و از ابتدا بررسی کنید. دادهٔ دو شرکت را در یک مقصد وارد نکنید.
## ۴. نصب را تکمیل کنید
1. گام‌های فعال‌سازی و ساخت مدیر در `INSTALL.pdf` را برای همین مقصد انجام دهید. اگر رمز یا نشست PowerShell تغییر کرده است، اتصال migration را دوباره مطابق راهنمای پایه تنظیم کنید.
2. پس از آزمون، متغیرهای موقت انتقال را پاک کنید:
```powershell
Remove-Item Env:INOGEN_SOURCE_READONLY_CONNECTION,Env:ConnectionStrings__TargetDatabase -ErrorAction SilentlyContinue
```
انتقال تصویرهای قدیمی، اگر لازم باشد، مرحله‌ای جداگانه در ابزار `Inogen.DataTransfer` است؛ ابتدا انتقال رکوردها را کامل و سپس طبق runbook انتقال تصویر اجرا کنید.