Nâng cấp hệ điều hành theo từng nút cho Apigee Edge cho Đám mây riêng tư

Bạn đang xem tài liệu về Apigee Edge.
Truy cập vào tài liệu Apigee X. thông tin

Tài liệu này trình bày một phương pháp thay thế để nâng cấp Hệ điều hành (OS) của các máy chủ trong cụm Apigee Edge cho Đám mây riêng. Thay vì thiết lập một trung tâm dữ liệu song song hoàn toàn mới, phương pháp từng nút này cho phép bạn nâng cấp hệ điều hành tại chỗ, mỗi lần một máy/nút.

Khả năng tương thích

Trước khi bắt đầu nâng cấp hệ điều hành theo từng nút, hãy xác minh rằng phiên bản Apigee Edge cho Đám mây riêng hiện tại của bạn hỗ trợ phiên bản hệ điều hành mục tiêu. Để xác minh, vui lòng tham khảo ma trận tương thích với hệ điều hành.

Điều kiện tiên quyết

Trước khi bắt đầu nâng cấp từng nút, hãy xác nhận rằng bạn đã hoàn tất các việc sau:

Sao lưu tất cả các nút

Trước khi làm theo quy trình này, bạn nên sao lưu toàn bộ tất cả các nút, chẳng hạn như sao lưu ở cấp độ máy ảo, sao lưu ở cấp độ thành phần (hoặc cả hai) vì lý do an toàn. Nhờ đó, bạn có thể có kế hoạch dự phòng trong trường hợp bất kỳ bước nào sau đây không hoạt động đúng cách. Để biết thêm thông tin về tính năng sao lưu ở cấp thành phần, hãy xem phần Sao lưu và khôi phục.

Đảm bảo Edge đang chạy

Đảm bảo Edge đang chạy trong quá trình cập nhật bằng cách sử dụng lệnh:

/opt/apigee/apigee-service/bin/apigee-all status

Thứ tự thay thế nút

Bạn nên nâng cấp các nút theo thứ tự được liệt kê bên dưới, dựa trên loại thành phần:

Trường hợp bổ sung

Khi thực hiện nâng cấp hệ điều hành theo từng nút, nếu có bất kỳ cấu hình nào sau đây trong chế độ thiết lập hiện có, vui lòng cân nhắc các bước bổ sung sau:

  • apigee-mtls – Nếu bạn bật apigee-mtls, thì chế độ nâng cấp hệ điều hành theo từng nút (cập nhật luân phiên) sẽ không được hỗ trợ cho chế độ thiết lập này. Để nâng cấp, vui lòng làm theo Hướng dẫn nâng cấp apigee-mtls.

Cassandra

Khi thay thế Cassandra, hãy cân nhắc việc thay thế các nút không phải là nút khởi động trước, sau đó là các nút khởi động.

Sau đây là các trường hợp đặc biệt cần xem xét đối với Cassandra:

  • Cassandra Native-mTLS – Nếu native-mTLS được bật và thực thi, hãy xoá việc thực thi trên các nút có bật mTLS bằng cách đặt conf_cassandra_client_encryption_optional=true. Để biết thêm thông tin, hãy xem tài liệu về native-mTLS.
  • Đã bật tính năng mã hoá giữa các nút Cassandra – Hãy tham khảo phần Bật tính năng mã hoá giữa các nút Cassandra để đảm bảo rằng các chứng chỉ của các nút Cassandra hiện có được đưa vào truststore của nút mới được thay thế và ngược lại.

Các bước thay thế nút Cassandra:

  1. Sao lưu nút bằng cách chụp nhanh máy ảo (nếu có thể) và sao lưu Apigee cho Cassandra trên tất cả các nút bằng lệnh sau: 
    apigee-service apigee-cassandra backup
  2. Thu nạp nút mới bằng hệ điều hành đã nâng cấp.
  3. Áp dụng các điều kiện tiên quyết dành riêng cho hệ điều hành.
  4. Tải và chạy tệp Edge để cài đặt tiện ích apigee-service. Khởi động phiên bản Apigee đang dùng, run bootstrap để nhận apigee-service và cài đặt apigee-setup.
  5. Liệt kê các nút gốc: 
    apigee-service apigee-cassandra configure -search conf_cassandra_seeds
  6. Cập nhật tệp cấu hình bằng cách thay đổi IP của nút Cassandra hiện có và thay thế bằng địa chỉ IP của nút mới.

    CASS_HOSTS hiện có

    CASS_HOSTS="$IP1 $IP2 $IP3"

    CASS_HOSTS mới cập nhật

    CASS_HOSTS="$IP1 $IP4 $IP3"
  7. Định cấu hình lại các nút hiện có trên cụm bằng IP nút Cassandra mới đã cập nhật (ngoại trừ nút sẽ được thay thế). Vui lòng sử dụng thông tin tham khảo về tệp cấu hình. 
    /opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile
  8. Dừng và huỷ đăng ký Cassandra trên nút cũ:
    1. Dừng Cassandra trên nút cần thay thế: 
      apigee-service apigee-cassandra stop
    2. Liệt kê UUID của nút Cassandra sẽ ngừng hoạt động (nếu có nhiều trung tâm dữ liệu, hãy cân nhắc cho phù hợp): 
      apigee-adminapi.sh servers list -r dc-1 -p central -t application-datastore --admin AdminEmailID --pwd 'AdminPassword' --host localhost
    3. Huỷ đăng ký các loại kho dữ liệu được liên kết với UUID Cassandra hiện có: 
      curl -u AdminEmailID:'AdminPassword' -X POST http://MS_IP:8080/v1/servers -d "type=cache-datastore&type=user-settings-datastore&type=scheduler-datastore&type=audit-datastore&type=apimodel-datastore&type=application-datastore&type=edgenotification-datastore&type=identityzone-datastore&type=auth-datastore&region=dc-1&pod=central&uuid=old_cassandra_uuid&action=remove"
    4. Xoá máy chủ. 
      curl -u AdminEmailID:AdminPassword -X DELETE http://MS_IP:8080/v1/servers/old_cassandra_uuid
  9. Chuẩn bị một nút mới cho máy chủ lưu trữ apigee-cassandra. Thêm dòng sau vào tệp cassandra.properties trong /opt/apigee/customer/application/cassandra.properties (tạo nếu chưa có) trên nút Cassandra mới: 
    conf_jvm_options_custom_settings=-Dcassandra.replace_address=IPOfOldCassandraNode -Dcassandra.allow_unsafe_replace=true
  10. Xác nhận rằng chủ sở hữu và nhóm được đặt thành apigee:apigee trong tệp cassandra.properties. Nếu cần, hãy dùng lệnh sau để cập nhật chủ sở hữu và nhóm: 
    chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
  11. Cài đặt Cassandra và chạy chương trình thiết lập trên nút mới thêm: 
    apigee-service apigee-cassandra install
     
    apigee-service apigee-cassandra setup -f updatedConfigFile
  12. Sau khi thiết lập nút mới, hãy xoá cấu hình bổ sung đã thêm vào /opt/apigee/customer/application/cassandra.properties rồi khởi động lại apigee-cassandra: 
    conf_jvm_options_custom_settings=-Dcassandra.replace_address=IPOfOldCassandraNode -Dcassandra.allow_unsafe_replace=true
     
    apigee-service apigee-cassandra restart
  13. Kiểm tra trạng thái của nút mới được thay thế: 
    apigee-service apigee-cassandra status
     
    /opt/apigee/apigee-cassandra/bin/nodetool status
  14. Tạo lại nút mới được thêm vào cụm: 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild -dc dc-1
  15. Thiết lập lại các nút hiện có của Router, Message-Processor, Qpid, Postgres và máy chủ Quản lý tương ứng bằng cách cập nhật IP nút Cassandra mới trong tệp cấu hình: 
    /opt/apigee/apigee-setup/bin/setup.sh -p r|mp|qs|ps|ms|mo -f updatedConfigFile
  16. Xoá/gỡ cài đặt Cassandra khỏi nút cũ: 
    apigee-service apigee-cassandra uninstall
  17. Lặp lại cho các nút Cassandra khác trong cụm.

Nhân viên sở thú

Hãy tham khảo các bước bên dưới để thay thế các nút Zookeeper. Hãy cân nhắc việc thay thế các nút theo dõi trước và các nút chính sau để đảm bảo nhóm duy trì đủ số lượng nút.

  1. Sao lưu nút bằng cách chụp nhanh máy ảo (nếu có thể) và sao lưu Apigee cho Zookeeper trên tất cả các nút.
  2. Dừng và gỡ cài đặt Zookeeper trên nút hiện có: 
    apigee-service apigee-zookeeper stop
     
    apigee-service apigee-zookeeper uninstall
  3. Thu nạp nút mới bằng hệ điều hành đã nâng cấp.
  4. Áp dụng các điều kiện tiên quyết dành riêng cho hệ điều hành.
  5. Tải chương trình khởi động của phiên bản Apigee đang dùng, chạy chương trình khởi động để nhận apigee-service và cài đặt apigee-setup.
  6. Cập nhật tệp cấu hình bằng cách xoá các địa chỉ IP của nút đã bị xoá/không còn hoạt động và thay thế bằng địa chỉ IP của nút mới cho Zookeeper. Để biết thêm thông tin chi tiết, hãy xem tài liệu tham khảo về tệp cấu hình:

    Cấu hình ZK hiện có

    ZK_HOSTS="$IP1 $IP2 $IP3"
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"

    Đã cập nhật cấu hình ZK

    ZK_HOSTS="$IP1 $IP4 $IP3"
ZK_CLIENT_HOSTS="$IP1 $IP4 $IP3"
  7. Cài đặt, thiết lập và khởi động Zookeeper trên nút mới bằng tệp cấu hình đã cập nhật: 
    /opt/apigee/apigee-setup/bin/setup.sh -p zk -f updatedConfigFile
  8. Thực hiện các thay đổi đối với nút Zookeeper hiện có bằng updatedConfigFile: 
    /opt/apigee/apigee-setup/bin/setup.sh -p zk -f updatedConfigFile
  9. Thiết lập lại các nút hiện có của Router, Message-Processor, Qpid, Postgres và Management Server tương ứng bằng cách cập nhật IP nút Zookeeper mới trong tệp cấu hình: 
    /opt/apigee/apigee-setup/bin/setup.sh -p r|mp|qs|ps|ms|mo -f updatedConfigFile
  10. Lặp lại thao tác này cho tất cả các nút Zookeeper.

Postgres

Phần này trình bày phương pháp nâng cấp các nút Postgres mà không có thời gian ngừng hoạt động. Bạn sẽ hoàn tất các bước được nêu. Hướng dẫn chi tiết để hoàn tất từng bước sẽ được cung cấp trong các mục con tiếp theo.

  • Thay thế bất kỳ nút dự phòng hiện có nào bằng hệ điều hành mục tiêu.
  • Quảng bá nút dự phòng mới thành nút chính.
  • Ngừng hoạt động máy chủ chính cũ.
  • Tiếp tục thay thế các nút dự phòng khác.

Trước khi bắt đầu thay thế, bạn nên dừng edge-qpid-server để giảm thiểu mọi khả năng mất thông báo phân tích.

apigee-service edge-qpid-server stop

Chế độ chờ

  1. Lấy UUID của các nút edge-postgres-server: 
    curl http://pg_standby_ip:8084/v1/servers/self
  2. Dừng Postgres: 
    apigee-service edge-postgres-server stop
     
    apigee-service apigee-postgresql stop
  3. Xoá chế độ chờ Postgres hiện có khỏi nhóm phân tích bằng cách làm theo các bước sau.
  4. Gỡ cài đặt apigee-postgres và postgres-server: 
    apigee-service edge-postgres-server uninstall
     
    apigee-service apigee-postgresql uninstall
  5. Thu nạp nút mới bằng hệ điều hành đã nâng cấp.
  6. Áp dụng các điều kiện tiên quyết dành riêng cho hệ điều hành.
  7. Tải chương trình khởi động của phiên bản Apigee đang dùng, chạy chương trình khởi động để nhận apigee-service và cài đặt apigee-setup.
  8. Thiết lập quy trình sao chép chính-dự phòng trên máy chủ chính hiện có bằng cách cập nhật tệp cấu hình bằng EXISTING_PG_MASTER_IP và NEW_PG_STANDBY_IP. Để biết thêm thông tin chi tiết, hãy xem tài liệu tham khảo về tệp cấu hình: 
    PG_MASTER=EXISTING_PG_MASTER_IP
     
    PG_STANDBY=NEW_PG_STANDBY_IP
     
    apigee-service apigee-postgresql setup-replication-on-master -f updatedConfigFile
  9. Cài đặt, thiết lập và khởi động Postgres bằng cấu hình chính-dự phòng trên nút dự phòng mới: 
    PG_MASTER=EXISTING_PG_MASTER_IP
     
    PG_STANDBY=NEW_PG_STANDBY_IP
     
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f updatedConfigFile
  10. Xác minh chế độ thiết lập ở chế độ chờ: 
    apigee-service apigee-postgresql postgres-check-standby

Chính

  1. Lấy UUID của nút chính Postgres hiện có: 
    curl http://pg_ip:8084/v1/servers/self
  2. Quảng bá nút dự phòng của hệ điều hành mới được nâng cấp lên nút chính.
  3. Dừng Postgres trên máy chủ chính hiện có: 
    apigee-service apigee-postgresql stop
     
    apigee-service edge-postgres-server stop
  4. Quảng bá nút dự phòng mới thành nút chính: 
    apigee-service apigee-postgresql promote-standby-to-master EXISTING_PG_MASTER_IP
  5. Xoá nút chính cũ khỏi nhóm phân tích và nhóm người tiêu dùng.
  6. Thêm nút chính mới vào nhóm người dùng và nhóm phân tích.
  7. Nếu bạn đang sử dụng tính năng kiếm tiền, hãy cập nhật nút chính Postgres mới và thực hiện các bước sau.
  8. Sau khi thay thế nút chính, bạn có thể khởi động edge-qpid-server bằng cấu hình nút chính mới cập nhật: 
    apigee-service edge-qpid-server start
  9. Nếu bạn đang sử dụng tính năng kiếm tiền, hãy khởi động lại Management Server và Message Processor: 
    apigee-service edge-management-server restart
  10. Dừng và gỡ cài đặt apigee-postgres và postgres-server trên máy chủ chính cũ: 
    apigee-service edge-postgres-server uninstall
     
    apigee-service apigee-postgresql uninstall

Thêm chế độ chờ mới

  1. Thu nạp nút mới bằng hệ điều hành đã nâng cấp.
  2. Áp dụng các điều kiện tiên quyết dành riêng cho hệ điều hành.
  3. Tải chương trình khởi động của phiên bản Apigee đang dùng, chạy chương trình khởi động để nhận apigee-service và cài đặt apigee-setup.
  4. Thiết lập quy trình sao chép chính-dự phòng bằng cách sử dụng IP chính mới và IP nút dự phòng mới trong tệp cấu hình nút chính mới và nút dự phòng mới. Để biết thêm thông tin chi tiết, hãy xem tài liệu tham khảo về tệp cấu hình: 
    apigee-service apigee-postgresql setup-replication-on-master -f updatedConfigFile
  5. Cài đặt và thiết lập trên nút dự phòng mới: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f updatedConfigFile
  6. Thêm chế độ chờ mới vào các nhóm phân tích bằng cách làm theo các bước thiết lập chế độ chờ chính.

LDAP

Để thay thế nút LDAP, Máy chủ quản lý sẽ phải dừng và mọi API quản lý sẽ được coi là không hoạt động trong thời gian thay thế nút này.

  1. Dừng Máy chủ quản lý trên tất cả các nút: 
    apigee-service edge-management-server stop
  2. Ngừng sử dụng nút LDAP hiện có:
    1. Tạo bản sao lưu/ảnh chụp nhanh cấp máy ảo của nút LDAP.
    2. Trước khi dừng LDAP, hãy nhớ ghi lại số lượng dữ liệu LDAP. Bạn có thể xác minh số lượng này sau, ví dụ: 
      ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" -D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w Secret123 | wc -l
    3. Đối với chế độ thiết lập chủ động-thụ động:
      1. Chuyển nút thụ động hiện tại sang nút chủ động bằng cách thêm tệp mark_writable.ldif vào nút thụ động có nội dung sau: 
        dn: olcDatabase={2}bdb,cn=config
changetype: modify
replace: olcReadOnly
olcReadOnly: FALSE
      2. Thực thi lệnh sau trên nút thụ động để chuyển nút đó sang trạng thái hoạt động: 
        ldapmodify -a -x -w "$APIGEE_LDAPPW" -D "$CONFIG_BIND_DN" -H "ldap://:10389" -f mark_writable.ldif
      3. Tiếp tục với Bước d) để ngừng hoạt động các nút đang hoạt động.
    4. Trong chế độ thiết lập LDAP đang hoạt động, hãy ngắt quá trình sao chép giữa hai nút LDAP và cập nhật cấu hình. Làm theo các bước được nêu trong tài liệu về việc ngừng cung cấp LDAP.
    5. Dừng và sao lưu dữ liệu LDAP, đồng thời gỡ cài đặt nút LDAP hiện có (bỏ qua bước này đối với chế độ thiết lập đang hoạt động nếu bạn đã thực hiện): 
      apigee-service apigee-openldap stop
       
      apigee-service apigee-openldap backup
       
      apigee-service apigee-openldap uninstall
  3. Thu nạp nút mới bằng hệ điều hành đã nâng cấp.
  4. Áp dụng các điều kiện tiên quyết dành riêng cho hệ điều hành.
  5. Tải chương trình khởi động của phiên bản Apigee đang dùng, chạy chương trình khởi động để nhận apigee-service và cài đặt apigee-setup.
  6. Thiết lập nút LDAP mới:
    1. Cập nhật configFile cho nút mới dựa trên chế độ thiết lập, bạn có thể tham khảo Tài liệu tham khảo về tệp cấu hình Edge, dựa trên chế độ thiết lập chỉ hoạt động hoặc hoạt động-hoạt động:
      • LDAP_TYPE
      • LDAP_PEER
      • LDAP_SID
      • USE_LDAP_REMOTE_HOST=y/n
    2. Thiết lập và khởi động LDAP trên nút mới bằng updatedConfigFile: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ld -f updatedConfigFile
    3. Sao lưu dữ liệu LDAP từ các nút cũ (nếu có thể bỏ qua chế độ thiết lập chủ động-chủ động):
      1. Sao lưu mẫu trên nút mới để tạo thư mục/đường dẫn sao lưu mặc định: 
        apigee-service apigee-openldap backup
      2. Di chuyển dữ liệu đã sao lưu từ nút cũ sang thư mục sao lưu đã tạo.
      3. Dừng apigee-openldap trước khi khôi phục dữ liệu: 
        apigee-service apigee-openldap stop
      4. Khôi phục bản sao lưu được lấy từ nút cũ hơn: 
        apigee-service apigee-openldap restore backup_file

        Ví dụ:

        apigee-service apigee-openldap restore 2026.02.09,10.28.20
  7. Lặp lại cho nút LDAP khác (nếu là chế độ hoạt động-hoạt động).
  8. Thiết lập lại và khởi động Máy chủ quản lý bằng cấu hình máy chủ LDAP đã cập nhật: 
    /opt/apigee/apigee-setup/bin/setup.sh -p mt -f updatedConfigFile
  9. Thiết lập lại và bắt đầu SSO (nếu có): 
    apigee-service apigee-sso setup -f updatedConfigFile
     
    apigee-service apigee-sso restart
  10. (Không bắt buộc) Định cấu hình thư mục hoạt động thứ hai thành chỉ đọc bằng cách làm theo các bước trong tài liệu.

Qpid

Để thay thế một nút Qpid hiện có bằng một nút OS đã nâng cấp, chúng ta cần đảm bảo thực hiện các bước sau:

  1. Ngừng nhận mọi thông báo đến hàng đợi nút hiện có từ các trình xử lý thông báo.
  2. Xoá các thông báo hiện có trong hàng đợi.
  3. Dừng và ngừng hoạt động nút hiện có.

Ngừng hoạt động các nút hiện có. Để đảm bảo không bị mất tin nhắn, bạn có thể thực hiện các biện pháp bổ sung sau:

  1. Dừng Qpid broker: 
    apigee-service apigee-qpidd stop
  2. Chặn lưu lượng truy cập đến trên cổng 5672 từ tất cả Trình xử lý thông báo: 
    iptables -A INPUT -p tcp --dport 5672 -s MP_IP -j DROP
  3. Khởi động lại Qpid broker để xoá các thông báo hiện có: 
    apigee-service apigee-qpidd start
  4. Đảm bảo tất cả các thông báo trong hàng đợi đều được chuyển đến người dùng trước khi bạn bắt đầu ngừng hoạt động.
  5. Lấy UUID của nút edge-qpid-server: 
    curl http://qpid_node_ip:8083/v1/servers/self
  6. Hoàn tất các bước ngừng hoạt động hoặc xoá Qpid khỏi số liệu phân tích cho apigee-qpidd và edge-qpid-server.
  7. Dừng và gỡ cài đặt cả apigee-qpidd và edge-qpid-server: 
    apigee-service apigee-qpidd stop
     
    apigee-service edge-qpid-server stop
     
    apigee-service apigee-qpidd uninstall
     
    apigee-service edge-qpid-server uninstall

Thêm nút mới:

  1. Thu nạp nút mới bằng hệ điều hành đã nâng cấp.
  2. Áp dụng các điều kiện tiên quyết dành riêng cho hệ điều hành.
  3. Tải chương trình khởi động của phiên bản Apigee đang dùng, chạy chương trình khởi động để nhận apigee-service và cài đặt apigee-setup.
  4. Thiết lập và chạy các dịch vụ Qpid trên nút mới, đồng thời thêm các dịch vụ này vào nhóm người dùng, theo các bước sau. Hãy cân nhắc các bước tương tự để thêm các nhóm khác, chẳng hạn như nhóm để kiếm tiền.
  5. Nếu dịch vụ kiếm tiền đang bật, hãy khởi động lại Máy chủ quản lý và Trình xử lý thông báo: 
    apigee-service edge-management-server restart
     
    apigee-service edge-message-processor restart
  6. Lặp lại trên tất cả các nút Qpid.

Message-processor

  1. Lấy mã nhận dạng duy nhất (UUID) của nút edge-message-processor: 
    curl http://mp_ip:8082/v1/servers/self
  2. Ngừng hoạt động và gỡ cài đặt nút Message Processor.
  3. Nếu dịch vụ kiếm tiền đã bật, hãy gỡ cài đặt edge-mint-message-processor.
  4. Gỡ cài đặt Trình xử lý tin nhắn: 
    apigee-service edge-message-processor uninstall
  5. Thu nạp nút mới bằng hệ điều hành đã nâng cấp.
  6. Áp dụng các điều kiện tiên quyết dành riêng cho hệ điều hành.
  7. Tải chương trình khởi động của phiên bản Apigee đang dùng, chạy chương trình khởi động để nhận apigee-service và cài đặt apigee-setup.
  8. Thêm, thiết lập và khởi động Message Processor vào cụm, làm theo các bước.
  9. Nếu bạn bật tính năng kiếm tiền, hãy thiết lập dịch vụ kiếm tiền cùng với Message Processor. Để biết thêm thông tin, hãy tham khảo tài liệu sau.

Bộ định tuyến

  1. Lấy mã nhận dạng duy nhất (UUID) của nút edge-router: 
    curl http://router_ip:8081/v1/servers/self
  2. Tắt chế độ kết nối và xác minh xem thiết bị có kết nối được hay không: 
    iptables -A INPUT -i eth0 -p tcp --dport 15999 -j REJECT
     
    curl -vvv -X GET http://router_ip:15999/v1/servers/self/reachable
  3. Ngừng hoạt động và gỡ cài đặt nút Bộ định tuyến.
  4. Gỡ cài đặt Bộ định tuyến: 
    apigee-service edge-router uninstall
  5. Thu nạp nút mới bằng hệ điều hành đã nâng cấp.
  6. Áp dụng các điều kiện tiên quyết dành riêng cho hệ điều hành.
  7. Tải chương trình khởi động của phiên bản Apigee đang dùng, chạy chương trình khởi động để nhận apigee-service và cài đặt apigee-setup.
  8. Thêm, thiết lập và khởi động bộ định tuyến vào cụm.

Máy chủ quản lý

Chỉ một máy chủ quản lý

  1. Thu nạp nút mới bằng hệ điều hành đã nâng cấp.
  2. Áp dụng các điều kiện tiên quyết dành riêng cho hệ điều hành.
  3. Tải chương trình khởi động của phiên bản Apigee đang dùng, chạy chương trình khởi động để nhận apigee-service và cài đặt apigee-setup.
  4. Thêm Máy chủ quản lý bằng IP và tệp cấu hình mới cập nhật mà bạn có thể tham khảo tại đây rồi chạy lệnh thiết lập: 
    /opt/apigee/apigee-setup/bin/setup.sh -p mt -f updatedConfigFile
  5. Thiết lập lại và khởi động lại giao diện người dùng bằng cấu hình IP quản lý mới. 
    /opt/apigee/apigee-setup/bin/setup.sh -p ui -f updatedConfigFile
  6. Thiết lập lại SSO bằng cấu hình IP quản lý mới (nếu có): 
    /opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile
  7. Thiết lập lại Giao diện người dùng (UE) mới bằng cấu hình IP quản lý mới (nếu có): 
    /opt/apigee/apigee-setup/bin/setup.sh -p ue -f updatedConfigFile
  8. Nếu bạn đã bật tính năng kiếm tiền:
    1. Thiết lập lại MS kiếm tiền bằng cấu hình IP quản lý mới (nếu có), tham khảo tài liệu về cấu hình kiếm tiền. 
      /opt/apigee/apigee-setup/bin/setup.sh -p mo -f updatedConfigFile
    2. Khởi động lại Máy chủ quản lý: 
      apigee-service edge-management-server restart
  9. Ngừng hoạt động Máy chủ quản lý trên nút hiện có/cũ, làm theo các bước.
  10. Nếu bạn bật tính năng kiếm tiền, hãy xoá UUID của Máy chủ quản lý khỏi các nhóm phân tích. Ví dụ: 
    curl -v -u AdminEmail:AdminPassword -X DELETE "http://localhost:8080/v1/analytics/groups/ax/mint_axgroup/servers?uuid=MS_UUID&type=consumer-server"
  11. Gỡ cài đặt Máy chủ quản lý hoạt động kiếm tiền: 
    apigee-service edge-mint-management-server uninstall

Nhiều máy chủ quản lý

  1. Ngừng hoạt động một trong các Máy chủ quản lý bằng cách sử dụng máy chủ còn lại trên nút hiện có, làm theo các bước.
  2. Dừng và gỡ cài đặt Management Server: 
    apigee-service edge-management-server stop
     
    apigee-service edge-management-server uninstall
  3. Thu nạp nút mới bằng hệ điều hành đã nâng cấp.
  4. Áp dụng các điều kiện tiên quyết dành riêng cho hệ điều hành.
  5. Tải chương trình khởi động của phiên bản Apigee đang dùng, chạy chương trình khởi động để nhận apigee-service và cài đặt apigee-setup.
  6. Thêm Máy chủ quản lý bằng IP và tệp cấu hình mới cập nhật mà bạn có thể tham khảo tại đây rồi chạy lệnh thiết lập: 
    /opt/apigee/apigee-setup/bin/setup.sh -p mt -f updatedConfigFile
  7. Thiết lập lại và khởi động lại giao diện người dùng bằng cấu hình IP quản lý mới cập nhật: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ui -f updatedConfigFile
  8. (Chỉ khi bạn bật SSO) Thiết lập lại và khởi động lại SSO bằng cấu hình IP quản lý mới cập nhật: 
    /opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile
  9. (Chỉ khi bạn bật Giao diện người dùng mới) Thiết lập lại và khởi động lại Giao diện người dùng mới bằng cấu hình IP quản lý đã cập nhật: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ue -f updatedConfigFile
  10. Lặp lại đối với Máy chủ quản lý khác.

Giao diện người dùng/Người dùng

  1. Tạo bản sao lưu/ảnh chụp nhanh máy ảo của nút giao diện người dùng.
  2. Giao diện người dùng để dừng và gỡ cài đặt: 
    apigee-service edge-ui stop
     
    apigee-service edge-ui uninstall
  3. (Chỉ khi sử dụng Giao diện người dùng mới) Dừng và gỡ cài đặt Giao diện người dùng mới: 
    apigee-service edge-management-ui stop
     
    apigee-service edge-management-ui uninstall
  4. Thu nạp nút mới bằng hệ điều hành đã nâng cấp.
  5. Áp dụng các điều kiện tiên quyết dành riêng cho hệ điều hành.
  6. Tải chương trình khởi động của phiên bản Apigee đang dùng, chạy chương trình khởi động để nhận apigee-service và cài đặt apigee-setup.
  7. Thiết lập và chạy edge-ui trên nút mới, với cấu hình IP đã cập nhật: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ui -f updatedConfigFile
  8. (Chỉ khi bật SSO) Thiết lập lại và chạy SSO với cấu hình IP nút mới của giao diện người dùng (nếu có): 
    /opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile
  9. (Chỉ khi bạn bật Giao diện người dùng mới) Thiết lập và chạy Giao diện người dùng mới trên nút mới, với cấu hình IP đã cập nhật: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ue -f updatedConfigFile
     
    apigee-service edge-management-ui configure-sso -f updatedConfigFile
     
    apigee-service edge-ui configure-sso -f updatedConfigFile

SSO

  1. Tạo bản sao lưu/ảnh chụp nhanh máy ảo của nút giao diện người dùng.
  2. Dừng và gỡ cài đặt tính năng SSO: 
    apigee-service apigee-sso stop
     
    apigee-service apigee-sso uninstall
  3. Thu nạp nút mới bằng hệ điều hành đã nâng cấp.
  4. Áp dụng các điều kiện tiên quyết dành riêng cho hệ điều hành.
  5. Tải chương trình khởi động của phiên bản Apigee đang dùng, chạy chương trình khởi động để nhận apigee-service và cài đặt apigee-setup.
  6. Thêm cấu hình và khoá cho tính năng Đăng nhập một lần (SSO) theo hướng dẫn, có tính đến IP nút mới.
  7. Thiết lập và bắt đầu sử dụng tính năng Đăng nhập một lần (SSO): 
    /opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile
  8. Cập nhật cấu hình bằng IP nút SSO mới và định cấu hình lại SSO cho giao diện người dùng: 
    apigee-service edge-ui configure-sso -f updatedConfigFile
  9. (Nếu sử dụng Giao diện người dùng mới) Chạy configure-sso trên nút Giao diện người dùng mới, tham khảo tài liệu: 
    apigee-service edge-management-ui configure-sso -f updatedConfigFile
     
    apigee-service edge-ui configure-sso -f updatedConfigFile