5.5 KiB
5.5 KiB
راهنمای نصب دستی و انتقال داده برای تست داخلی Inogen
این راهنما مخصوص بستهٔ داخلی است. بستهٔ مشتری ابزار انتقال داده ندارد. برای هر شرکت، یک دیتابیس مقصد جداگانه انتخاب کنید؛ ساختار دیتابیسهای قدیمی یکسان است، اما نام دیتابیس منبع را برای هر انتقال دقیق وارد کنید.
۱. بستهٔ داخلی را بسازید و نصب پایه را انجام دهید
- در محیط ساخت، کلید امضای موجود را به نشست 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 را فقط وقتی بگذارید که وابستگیهای فرانت از قبل نصب شدهاند.
- بستهٔ ZIP داخلی را روی سرور استخراج کنید و گامهای ۱ تا ۴ راهنمای
INSTALL.pdfرا برای دیتابیس مقصد جدید انجام دهید. برای نمونه، مقصد راSQL-SERVER-01/Inogen_CompanyAبگذارید. ساختار مقصد را باmigrate-target.ps1ایجاد کنید؛ دادهٔ قدیمی هنوز منتقل نشده است. - اگر گواهی SQL در محیط تست مورد اعتماد نیست، ابتدا گواهی را درست نصب کنید. برای عبور موقت در تست، به فرمان
migrate-target.ps1گزینهٔ-TrustServerCertificateرا اضافه کنید و در رشتههای اتصال منبع و مقصد نیز مقدارTrustServerCertificate=Trueبگذارید. این استثنا را به محیط مشتری منتقل نکنید.
۲. منبع و مقصد انتقال را مشخص کنید
- از دیتابیس قدیمی و مقصد نسخهٔ پشتیبان بگیرید. نام دقیق سرور و دیتابیس قدیمی را از SQL Server بخوانید؛ برای نمونه
OLD-SQL-01/Legacy_CompanyA. نام منبع نباید با مقصد یکسان باشد. - روی دیتابیس قدیمی یک حساب فقطخواندنی بسازید. حساب مقصد نیز باید مجوز نوشتن در schema
inogenداشته باشد. از ریشهٔ بسته، فرمان زیر را اجرا کنید؛ اسکریپت نام مقصد را ازbackend\appsettings.Production.jsonمیخواند و هر دو رمز را جداگانه میپرسد:
.\prepare-transfer-connections.ps1 -SourceServer 'OLD-SQL-01' -SourceDatabase 'Legacy_CompanyA' -SourceUser 'legacy_reader' -TargetUser 'inogen_runtime'
- اگر گواهی SQL منبع یا مقصد فقط در محیط تست مورد اعتماد نیست، به فرمان بالا بهترتیب
-TrustSourceCertificateیا-TrustTargetCertificateاضافه کنید. همین پنجرهٔ PowerShell را تا پایان انتقال باز نگه دارید.
۳. انتقال را بررسی و اجرا کنید
- از ریشهٔ بستهٔ داخلی، ابتدا فرمان بررسی منبع و سپس فرمان پیشنمایش را جداگانه اجرا کنید. نام منبع در هر دو باید یکسان باشد:
.\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'
- شمار رکوردها و شناسهٔ snapshot پیشنمایش را با دیتابیس همان شرکت تطبیق دهید. سپس یک شناسهٔ یکتا برای این نوبت انتقال انتخاب کنید و فرمان زیر را اجرا کنید. ابزار برای تأیید، نام دیتابیس قدیمی را دوباره میپرسد:
.\select-internal-transfer.ps1 -Command import-source -SourceServer 'OLD-SQL-01' -SourceDatabase 'Legacy_CompanyA' -IdempotencyKey 'company-a-20261103-01'
- شمار رکوردهای منتقلشده و موارد quarantine را بررسی کنید. اگر شرکت دیگری را منتقل میکنید، دیتابیس مقصد، تنظیمات و هر دو رشتهٔ اتصال را برای آن شرکت تغییر دهید و از ابتدا بررسی کنید. دادهٔ دو شرکت را در یک مقصد وارد نکنید.
۴. نصب را تکمیل کنید
- گامهای فعالسازی و ساخت مدیر در
INSTALL.pdfرا برای همین مقصد انجام دهید. اگر رمز یا نشست PowerShell تغییر کرده است، اتصال migration را دوباره مطابق راهنمای پایه تنظیم کنید. - پس از آزمون، متغیرهای موقت انتقال را پاک کنید:
Remove-Item Env:INOGEN_SOURCE_READONLY_CONNECTION,Env:ConnectionStrings__TargetDatabase -ErrorAction SilentlyContinue
انتقال تصویرهای قدیمی، اگر لازم باشد، مرحلهای جداگانه در ابزار Inogen.DataTransfer است؛ ابتدا انتقال رکوردها را کامل و سپس طبق runbook انتقال تصویر اجرا کنید.