Skip to content

Installation.md

Latest commit

 

History

History
177 lines (143 loc) · 13.4 KB

Installation.md

File metadata and controls

177 lines (143 loc) · 13.4 KB

B7.Orbit სერვისი

  1. წინაპირობები

    1. Windows Server 2019/2022 ან Windows 10/11

    2. SQL Server 2019+

    3. .NET Runtime (ASP.NET Core Hosting Bundle) v9.0+ – დააყენეთ სერვერზე (IIS ჰოსტინგისთვის სავალდებულოა)

    4. უფლება: Command Prompt Run as Administrator

    5. გამართული B7.Pushing სერვისი

  2. B7.Orbit მონაცემთა ბაზის შექნმა

    1. გაუშვით SQL Server Management Studio (SSMS).
    2. დაუკავშირდით SQL Server-ს.
    3. გახსენით ახალი Query ფანჯარა და გაუშვით: 
      CREATE DATABASE [Orbit] COLLATE Latin1_General_100_BIN2;

  3. გაამზადეთ B7.Orbit

    1. გადმოწერეთ B7.Orbit-ის ფაილები

      1. Migration.zip Direct download
      2. Api.zip Direct download
      3. Sync.zip Direct download
      4. SyncB6.zip Direct download
      5. SyncPCard.zip Direct download
      6. SyncGlobalTransfers.zip Direct download
      7. SyncImpExp.zip Direct download
      8. SyncAccountNotifications.zip Direct download

    2. გახსენით Migration.zip ფაილი \B7.Orbit\Migration ფოლდერში

    3. გახსენით Api.zip ფაილი \B7.Orbit\Api ფოლდერში

    4. გახსენით Sync.zip ფაილი \B7.Orbit\Sync ფოლდერში

    5. გახსენით SyncB6.zip ფაილი \B7.Orbit\SyncB6 ფოლდერში

    6. გახსენით SyncPCard.zip ფაილი \B7.Orbit\SyncPCard ფოლდერში

    7. გახსენით SyncGlobalTransfers.zip ფაილი \B7.Orbit\SyncGlobalTransfers ფოლდერში

    8. გახსენით SyncImpExp.zip ფაილი \B7.Orbit\SyncImpExp ფოლდერში

    9. გახსენით SyncAccountNotifications.zip ფაილი \B7.Orbit\SyncAccountNotifications ფოლდერში

    10. შედით Migration ფოლდერში, გახსენით appsettings.json ფაილი ნებისმიერი ტექსტური რედაქტორით და:

      1. Settings სექციაში ჩაწერეთ სასურველი მონაცემები

        თუ არ იყენებთ ჩვენ PCards სისტემას, მაშინ cards სექცია ამოშალეთ.

        თუ არ იყენებთ ჩვენ LMS სისტემას, მაშინ Loans სექცია ამოშალეთ.

        "Settings": {
    "StartYear": 2020, // ეს არის წელი, რომლიდანაც დაიწყება მონაცემების მოიგრაცია.

    "BatchSize": 10000,
    "ParallelProcessCount": 4,

    "Databases": {
        // BANK2000 ბაზის ConnectionString
        "B6": "Server=%SQL_SERVER_B6%;Database=BANK2000;Integrated Security=true;Application Name={ApplicationName};Encrypt=false;TrustServerCertificate=true;",
        // CARDS2011 ბაზის ConnectionString
        "Cards": "Server=%SQL_SERVER_CARDS%;Database=CARDS2011;Integrated Security=true;Application Name={ApplicationName};TrustServerCertificate=true;TrustServerCertificate=true",
        // LMS ბაზის ConnectionString
        "Loans": "Server=%SQL_SERVER_LOANS%;Database=LMS;Integrated Security=true;Application Name={ApplicationName};TrustServerCertificate=true;TrustServerCertificate=true"
    }
},
        • StartYear განსაზღვრავს, რომელი წლიდან დაიწყოს მონაცემების მიგრაცია.

      2. Database სექციაში ჩაწერეთ Orbit მონაცემთა ბაზის ConnectionString

        "Database": {
    "ConnectionString": "Server=%SQL_SERVER%;Database=Orbit;Integrated Security=true;Application Name={ApplicationName};TrustServerCertificate=true;",
}

      3. AppEnvironment სექციაში ჩაწერეთ Testing ან Production

        "AppEnvironment": {
    "Type": "Testing"
}

    11. შედით Api ფოლდერში, გახსენით appsettings.json ფაილი ნებისმიერი ტექსტური რედაქტორით და Authentication სექციაში ჩაწერეთ სასურველი username და password. ეს პარამეტრები გამოიყენება basic authentication-ისათვის.

      "Authentication": {
    "UserName": "ChangeThisUser",
    "Password": "ChangeThisStrongPassword"
}

  4. დაამიგრირეთ არქივული ტრანზაქციები

    1. გახსენით Command Prompt (Admin).

    2. Windows-ის command line-იდან გაუშვით შემდეგი ბრძანება

          _migrate_transaction_arc.bat

      ⚠️ მნიშვნელოვანია

      პროცესის დამთავრებას დასჭირდება ძალიან დიდი ხანი.
      გთხოვთ ლოგი გამოგვიგზავნოთ პერფორმანსის გასაანალიზებლად.

      ⚠️ ძალიან მნიშვნელოვანია

      გახსენით მიგრაციის ლოგი და ნახეთ ხომ არ არის რამე შეცდომა (ERR). ასევე ნახეთ ხომ არ არის გაფრთხილება (WARN). მიგრაციის შემდგომ, ავტომატურად დარდება ანგარიშის ნაშთები B7.Orbit ბაზასა და BANK2000 ბაზას შორის. ნემისმიერი განსხვავება დაილოგება WARN სტატუსით.

  5. დაამიგრირეთ დანარჩენი მონაცემები

    1. დარწმუნდით, რომ წინა პროცესი დასრულდა

    2. შედით Migration ფოლდერში

    3. Windows-ის command line-იდან გაუშვით შემდეგი ბრძანება

          _migrate_final.bat

      ⚠️ მნიშვნელოვანია

      პროცესის დამთავრებას დასჭირდება დიდი ხანი.
      გთხოვთ ლოგი გამოგვიგზავნოთ პერფორმანსის გასაანალიზებლად.

      ⚠️ ძალიან მნიშვნელოვანია

      გახსენით მიგრაციის ლოგი და ნახეთ ხომ არ არის რამე შეცდომა (ERR). ასევე ნახეთ ხომ არ არის გაფრთხილება (WARN). მიგრაციის შემდგომ, ავტომატურად დარდება ანგარიშის ნაშთები B7.Orbit ბაზასა და BANK2000 ბაზას შორის. ნემისმიერი განსხვავება დაილოგება WARN სტატუსით.

  6. გაუშვით B7.Orbit.Api

    1. დააინსტალირეთ ASP.NET Core Hosting Bundle (v9.0+) სერვერზე.
    2. განათავსეთ \Orbit\Api როგორც IIS აპლიკაცია.
    3. დააყენეთ Application Pool: No Managed Code, 64-ბიტი ჩართული.
    4. შეამოწმეთ, რომ ჩართული აქვს read/write უფლებები საკუთარ Log ფოლდერზე.

  7. სერვისების ინსტალაცია – SyncB6 (და სხვა Sync სერვისები)

    ყველა ბრძანება გაუშვით Admin CMD-დან და მიუთითეთ აბსოლუტური ბილიკები. რეკომენდირებულია ავტომატური გაშვება.

    მაგალითი – SyncB6

    1. შედით SyncB6 ფოლდერში
    2. გახსენით appsettings.json ფაილი ნებისმიერი ტექსტური რედაქტორით და შეავსეთ სასურველი მონაცემებით
    3. Windows-ის command line-იდან გაუშვით შემდეგი ბრძანება: 
          sc create B7.Orbit.SyncB6 binPath= "C:\Orbit\SyncB6\B7.Orbit.SyncB6.exe" start= auto
    sc start B7.Orbit.SyncB6

  8. გაუშვით დანარჩენი სერვისები

    1. შედით თითოეულ Sync* ფოლდერში
    2. გახსენით appsettings.json ფაილი ნებისმიერი ტექსტური რედაქტორით და შეავსეთ სასურველი მონაცემებით

    შემდეგ სათითაოდ გაუშვით ყველა სერვისი

    sc create B7.Orbit.Sync binPath= "C:\Orbit\Sync\B7.Orbit.Sync.exe" start= auto
sc create B7.Orbit.SyncPCard binPath= "C:\Orbit\SyncPCard\B7.Orbit.SyncPCard.exe" start= auto
sc create B7.Orbit.SyncGlobalTransfers binPath= "C:\Orbit\SyncGlobalTransfers\B7.Orbit.SyncGlobalTransfers.exe" start= auto
sc create B7.Orbit.SyncImpExp binPath= "C:\Orbit\SyncImpExp\B7.Orbit.SyncImpExp.exe" start= auto
sc create B7.Orbit.SyncAccountNotifications binPath= "C:\Orbit\SyncAccountNotifications\B7.Orbit.SyncAccountNotifications.exe" start= auto

sc start B7.Orbit.Sync
sc start B7.Orbit.SyncPCard
sc start B7.Orbit.SyncGlobalTransfers
sc start B7.Orbit.SyncImpExp
sc start B7.Orbit.SyncAccountNotifications

  9. შეამოწმეთ, რომ ყველაფერი მუშაობს

  10. შემოწმება

    1. IIS-ში გახსენით B7.Orbit.Api და გადაამოწმეთ, რომ Web სერვისი მუშაობს შეცდომების გარეშე (მაგ. /health endpoint-ზე).
    2. გადაამოწმეთ Windows სერვისების სტატუსი: 
      sc query B7.Orbit.SyncB6
sc query B7.Orbit.Sync
sc query B7.Orbit.SyncPCard
sc query B7.Orbit.SyncGlobalTransfers
sc query B7.Orbit.SyncImpExp
sc query B7.Orbit.SyncAccountNotifications
    3. დარწმუნდით, რომ ყველა სერვისი გაშვებულია და სტატუსი არის RUNNING.
    4. გადაამოწმეთ ლოგ ფაილები (Logs საქაღალდეებში), რომ არ არის კრიტიკული შეცდომები.
    5. შეამოწმეთ, რომ Orbit მონაცემები სინქრონიზდება და API პასუხობს მოთხოვნებზე.