Cách nâng cấp AkaBot Center từ phiên bản 3.0.1.4 lên 3.0.1.9

Hướng dẫn này cung cấp từng bước chi tiết để cập nhật an toàn akaBot Center từ phiên bản 3.0.1.4 lên 3.0.1.9.
Vui lòng thực hiện đúng theo hướng dẫn và sao lưu dữ liệu trước khi tiến hành.

Bước 1: Sao lưu thư mục webapps

• Đi tới đường dẫn:

%APACHE_TOMCAT_HOME%\webapps

Bước 2: Dừng dịch vụ Apache Tomcat

• Dừng dịch vụ Tomcat trước khi thực hiện bất kỳ thay đổi nào.
• 

Bước 3: Xóa nội dung thư mục webapps

• Xóa toàn bộ nội dung hiện có trong thư mục:

Bước 4: Sao chép và đổi tên file WAR

• Đổi tên file đã tải về:

Từ: akaBot-center-3.0.1.9-b.war

Thành: ROOT.war

• Sao chép file ROOT.war vừa đổi tên vào thư mục:

%APACHE_TOMCAT_HOME%/webapps 

Bước 5: Khởi động dịch vụ Apache Tomcat

• Khởi động lại dịch vụ Tomcat và chờ cho đến khi thư mục tự động được giải nén.
• Sau khi giải nén thành công, dừng dịch vụ Tomcat một lần nữa.

Bước 6: So sánh và cập nhật các file cấu hình

⚠️ Lưu ý: Cẩn thận với khoảng trắng và tab khi chỉnh sửa file YAML.
Khuyến nghị sao chép các file cấu hình cũ từ bản 3.0.1.4 và so sánh/cập nhật sang bản 3.0.1.9.

Đi tới đường dẫn:

webapps\ROOT\WEB-INF\classes\config 

Các file cần cập nhật:

application.yml

• ✅ Thêm cấu hình sau:

consumer:

  # CAUTION: Set prefetch-size to a value > 1 will disable the priority queue item feature

  agent-pool:

    # To fix the issue agent pool with only one agent and get transaction item from agent pool queue, set prefetch-size to 1

    prefetch-size: 1000

  trigger:

    prefetch-size: 1

  on-demand:

    prefetch-size: 1000

• Cập nhật giá trị phiên bản: Từ 3.0.1.4 → 3.0.1.9
• ✅ Thêm cấu hình tùy chọn (được comment mặc định):

#enable with cros websocket

#  web-socket:

# allowed-origin-patterns: "*"

# Configuration for duplicated job checks, default is off.

# Schedule to check for duplicated jobs options:

  #1 . Every 5 minutes: 0 */5 * * * *

  #2 . Every 10 minutes: 0 */10 * * * *

  #3 . At midnight: 0 0 0 * * *

#   clear-duplicated-jobs-cron: 0 */5 * * * *

application-dev.yml

• Thay đổi hoặc thêm giá trị cần thiết (thêm “s” nếu có yêu cầu trong bản mới).
• ✅ Thêm cấu hình OAuth2:

oauth2:

  enable: false

  provider: azure

  client:

    # URL login

    feCallback: "#/callback"

    registration:

      azure:

        client-id: ${clientId}

        client-secret: ${secretId}

        scope: openid, profile, email

        authorization-grant-type: authorization_code

        redirect-uri: "{domain}/oauth2/callback/azure"

    provider:

      azure:

        authorization-uri: https://login.microsoftonline.com/${tenantId}/oauth2/v2.0/authorize

        token-uri: https://login.microsoftonline.com/${tenantId}/oauth2/v2.0/token

        user-info-uri: https://graph.microsoft.com/v1.0/me?$select=userPrincipalName,mail,givenName,surname

        sync-user-enable: true

        login-by-email: false

        # use mapping for account

        user-mapping:

          usernameMapping: "userPrincipalName"

          emailMapping: "mail"

          firstNameMapping: "givenName"

          lastNameMapping: "surname"

          ouNameMapping: ""

          # role default for account sync

          roleDefault: "ROLE_USER"

application-prod.yml

• Thực hiện các thay đổi tương tự như trong application-dev.yml.

Bước 7: Khởi động lại dịch vụ Apache Tomcat

• Sau khi cập nhật xong tất cả các file cấu hình, khởi động lại dịch vụ Tomcat.

Bước 8: Kiểm tra truy cập AkaBot Center

• Mở trình duyệt và truy cập địa chỉ AkaBot Center.
• Nếu hệ thống hoạt động bình thường, việc nâng cấp đã thành công.

Xử lý sự cố

Nếu gặp lỗi:

1. Dừng dịch vụ Apache Tomcat.
2. Khôi phục lại thư mục webapps đã sao lưu trước đó.
3. Khởi động lại dịch vụ Apache Tomcat.