inogen/deployment/INSTALL-INTERNAL.md

5.5 KiB
Raw Permalink Blame History

راهنمای نصب دستی و انتقال داده برای تست داخلی Inogen

این راهنما مخصوص بستهٔ داخلی است. بستهٔ مشتری ابزار انتقال داده ندارد. برای هر شرکت، یک دیتابیس مقصد جداگانه انتخاب کنید؛ ساختار دیتابیس‌های قدیمی یکسان است، اما نام دیتابیس منبع را برای هر انتقال دقیق وارد کنید.

۱. بستهٔ داخلی را بسازید و نصب پایه را انجام دهید

  1. در محیط ساخت، کلید امضای موجود را به نشست 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 را فقط وقتی بگذارید که وابستگی‌های فرانت از قبل نصب شده‌اند.

  1. بستهٔ ZIP داخلی را روی سرور استخراج کنید و گام‌های ۱ تا ۴ راهنمای INSTALL.pdf را برای دیتابیس مقصد جدید انجام دهید. برای نمونه، مقصد را SQL-SERVER-01/Inogen_CompanyA بگذارید. ساختار مقصد را با migrate-target.ps1 ایجاد کنید؛ دادهٔ قدیمی هنوز منتقل نشده است.
  2. اگر گواهی SQL در محیط تست مورد اعتماد نیست، ابتدا گواهی را درست نصب کنید. برای عبور موقت در تست، به فرمان migrate-target.ps1 گزینهٔ -TrustServerCertificate را اضافه کنید و در رشته‌های اتصال منبع و مقصد نیز مقدار TrustServerCertificate=True بگذارید. این استثنا را به محیط مشتری منتقل نکنید.

۲. منبع و مقصد انتقال را مشخص کنید

  1. از دیتابیس قدیمی و مقصد نسخهٔ پشتیبان بگیرید. نام دقیق سرور و دیتابیس قدیمی را از SQL Server بخوانید؛ برای نمونه OLD-SQL-01/Legacy_CompanyA. نام منبع نباید با مقصد یکسان باشد.
  2. روی دیتابیس قدیمی یک حساب فقط‌خواندنی بسازید. حساب مقصد نیز باید مجوز نوشتن در schema inogen داشته باشد. از ریشهٔ بسته، فرمان زیر را اجرا کنید؛ اسکریپت نام مقصد را از backend\appsettings.Production.json می‌خواند و هر دو رمز را جداگانه می‌پرسد:
.\prepare-transfer-connections.ps1 -SourceServer 'OLD-SQL-01' -SourceDatabase 'Legacy_CompanyA' -SourceUser 'legacy_reader' -TargetUser 'inogen_runtime'
  1. اگر گواهی SQL منبع یا مقصد فقط در محیط تست مورد اعتماد نیست، به فرمان بالا به‌ترتیب -TrustSourceCertificate یا -TrustTargetCertificate اضافه کنید. همین پنجرهٔ PowerShell را تا پایان انتقال باز نگه دارید.

۳. انتقال را بررسی و اجرا کنید

  1. از ریشهٔ بستهٔ داخلی، ابتدا فرمان بررسی منبع و سپس فرمان پیش‌نمایش را جداگانه اجرا کنید. نام منبع در هر دو باید یکسان باشد:
.\select-internal-transfer.ps1 -Command verify-source -SourceServer 'OLD-SQL-01' -SourceDatabase 'Legacy_CompanyA'
.\select-internal-transfer.ps1 -Command preview-source -SourceServer 'OLD-SQL-01' -SourceDatabase 'Legacy_CompanyA'
  1. شمار رکوردها و شناسهٔ snapshot پیش‌نمایش را با دیتابیس همان شرکت تطبیق دهید. سپس یک شناسهٔ یکتا برای این نوبت انتقال انتخاب کنید و فرمان زیر را اجرا کنید. ابزار برای تأیید، نام دیتابیس قدیمی را دوباره می‌پرسد:
.\select-internal-transfer.ps1 -Command import-source -SourceServer 'OLD-SQL-01' -SourceDatabase 'Legacy_CompanyA' -IdempotencyKey 'company-a-20261103-01'
  1. شمار رکوردهای منتقل‌شده و موارد quarantine را بررسی کنید. اگر شرکت دیگری را منتقل می‌کنید، دیتابیس مقصد، تنظیمات و هر دو رشتهٔ اتصال را برای آن شرکت تغییر دهید و از ابتدا بررسی کنید. دادهٔ دو شرکت را در یک مقصد وارد نکنید.

۴. نصب را تکمیل کنید

  1. گام‌های فعال‌سازی و ساخت مدیر در INSTALL.pdf را برای همین مقصد انجام دهید. اگر رمز یا نشست PowerShell تغییر کرده است، اتصال migration را دوباره مطابق راهنمای پایه تنظیم کنید.
  2. پس از آزمون، متغیرهای موقت انتقال را پاک کنید:
Remove-Item Env:INOGEN_SOURCE_READONLY_CONNECTION,Env:ConnectionStrings__TargetDatabase -ErrorAction SilentlyContinue

انتقال تصویرهای قدیمی، اگر لازم باشد، مرحله‌ای جداگانه در ابزار Inogen.DataTransfer است؛ ابتدا انتقال رکوردها را کامل و سپس طبق runbook انتقال تصویر اجرا کنید.