Cập nhật Apigee Edge 4.17.0x lên 4.18.01

Edge cho đám mây riêng tư phiên bản 4.18.01

Bạn có thể cập nhật phiên bản Edge nào lên 4.18.01

Bạn có thể cập nhật Apigee Edge phiên bản 4.17.0x bằng quy trình này.

Nếu đang dùng phiên bản Edge trước phiên bản 4.16.01, thì trước tiên, bạn phải chuyển sang phiên bản 4.16.01.x rồi cập nhật lên phiên bản 4.18.01.

Những người có thể thực hiện quá trình cập nhật

Người dùng chạy bản cập nhật phải giống như người dùng cài đặt Edge ban đầu hoặc người dùng chạy bản cập nhật gốc.

Sau khi bạn cài đặt RPM Edge, bất kỳ người dùng nào cũng có thể định cấu hình chúng.

Bạn phải cập nhật những thành phần nào

Bạn phải cập nhật tất cả thành phần Edge. Edge không hỗ trợ chế độ thiết lập chứa các thành phần từ nhiều phiên bản.

Duy trì khả năng tương thích

Khi nâng cấp Apigee Edge cho Đám mây riêng tư lên phiên bản 4.18.01, bạn phải đảm bảo rằng quá trình triển khai kết quả chỉ tham chiếu các thuộc tính được hỗ trợ trong các tệp cấu hình của ứng dụng đó.

Tài sản Vị trí Nội dung mô tả
conf_load_balancing_load.balancing.
  driver.nginx.server.retry		 router.properties Xoá thuộc tính này khỏi tệp router.properties. Để đặt các tuỳ chọn thử lại trong phiên bản 4.18.01, hãy sử dụng các thuộc tính cấu hình máy chủ ảo.

Tự động truyền tải các chế độ cài đặt tài sản

Nếu bạn đã thiết lập bất kỳ thuộc tính nào bằng cách chỉnh sửa tệp .properties trong /opt/apigee/customer/application thì bản cập nhật sẽ giữ lại các giá trị này.

Bắt buộc phải thêm thông số cấu hình SMTPMAILFROM

Edge 4.17.05 đã thêm một tham số bắt buộc mới vào tệp cấu hình được dùng khi bạn bật máy chủ SMTP. Nếu bạn đang cập nhật từ phiên bản 4.17.01, bạn phải đặt SMTPMAILFROM trong tệp cấu hình khi bật máy chủ SMTP.

API BaaS phiên bản 4.17.09 cũng hỗ trợ thêm cho thuộc tính SMTPMAILFROM. Khi cập nhật API BaaS từ phiên bản 4.17.01 hoặc 4.17.05, bạn phải đặt SMTPMAILFROM trong tệp cấu hình.

Thông số này có dạng:

SMTPMAILFROM="My Company <myco@company.com>"

Cần nâng cấp lên Postgres 9.6

Bản phát hành Edge này bao gồm bản nâng cấp lên Postgres 9.6. Trong lần nâng cấp đó, tất cả dữ liệu của Postgres sẽ được chuyển sang Postgres 9.6.

Hầu hết các hệ thống sản xuất Edge đều sử dụng 2 nút Postgres được định cấu hình để sao chép chính cho chế độ chờ. Trong quá trình cập nhật, mặc dù các nút Postgres ngừng hoạt động để cập nhật, nhưng dữ liệu phân tích vẫn được ghi vào các nút Qpid. Sau khi các nút Postgres được cập nhật và trực tuyến trở lại, dữ liệu phân tích sẽ được đẩy đến các nút Postgres.

Cách bạn thực hiện cập nhật Postgres phụ thuộc vào cách bạn định cấu hình bộ nhớ dữ liệu cho các nút Postgres:

  • Nếu sử dụng bộ nhớ dữ liệu cục bộ cho nút Postgres, bạn phải cài đặt nút chờ Postgres mới trong suốt quá trình nâng cấp. Sau khi quá trình nâng cấp hoàn tất, bạn có thể gỡ bỏ nút chờ Postgres mới.

    Bạn cần có nút chờ Postgres bổ sung nếu phải hoàn nguyên bản cập nhật vì bất kỳ lý do gì. Nếu bạn phải khôi phục bản cập nhật, nút chờ Postgres mới sẽ trở thành nút Postgres chính sau khi khôi phục. Do đó, khi bạn cài đặt nút chế độ chờ Postgres mới, nút đó phải nằm trên một nút đáp ứng tất cả các yêu cầu về phần cứng của máy chủ Postgres, như xác định trong Các yêu cầu về việc cài đặt của Edge.

    Trong quá trình cài đặt Edge 1 nút và 2 nút, các cấu trúc liên kết dùng để tạo mẫu và thử nghiệm, bạn chỉ có một nút Postgres duy nhất. Bạn có thể cập nhật trực tiếp các nút Postgres này mà không cần tạo một nút Postgres mới.
  • Nếu đang sử dụng bộ nhớ mạng cho các nút Postgres, theo khuyến nghị của Apigee, bạn không cần phải cài đặt một nút Postgres mới. Trong các quy trình dưới đây, bạn có thể bỏ qua các bước chỉ định để cài đặt và sau đó gỡ bỏ một nút chế độ chờ Postgres mới.

    Trước khi bắt đầu quá trình cập nhật, hãy chụp nhanh mạng của kho dữ liệu mà Postgres sử dụng. Sau đó, nếu có lỗi nào xảy ra trong quá trình cập nhật và bạn buộc phải khôi phục, thì bạn có thể khôi phục nút Postgres từ bản tổng quan nhanh đó.

Cài đặt nút chế độ chờ Postgres mới

Quy trình này tạo một máy chủ chờ Postgres trên một nút mới. Đảm bảo rằng bạn cài đặt máy chủ chờ Postgres mới cho phiên bản Edge (4.17.0x) hiện có, chứ không phải cho phiên bản 4.18.01.

Để cài đặt, hãy sử dụng chính tệp cấu hình mà bạn đã dùng để cài đặt phiên bản Edge hiện tại.

Cách tạo nút chế độ chờ Postgres mới:

  1. Trên bản chính Postgres hiện tại, hãy chỉnh sửa tệp /opt/apigee/customer/application/postgresql.properties để thiết lập mã thông báo sau: 
    conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32
trust\ \nhost replication apigee new_slave_ip/32 trust

    Trong đó existing_slave_ip là địa chỉ IP của máy chủ chờ Postgres hiện tại và new_slave_ip là địa chỉ IP của nút chế độ chờ mới.

    Nếu tệp postgresql.properties không tồn tại, hãy tạo tệp và sử dụng chown để cấp cho người dùng apigee quyền truy cập vào tệp đó, như trong ví dụ dưới đây:

    chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
  2. Khởi động lại apigee-postgresql trên trang chủ Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. Xác minh nút chế độ chờ mới đã được thêm bằng cách xem tệp /opt/apigee/apigee-postgresql/conf/pg_hba.conf trên nút chính. Bạn sẽ thấy các dòng sau trong tệp đó: 
    host replication apigee existing_slave_ip/32 trust
host replication apigee new_slave_ip/32 trust
  4. Cài đặt máy chủ chờ Postgres mới:
    1. Chỉnh sửa tệp cấu hình bạn đã dùng để cài đặt phiên bản Edge hiện tại để chỉ định các thông tin sau: 
      # IP address of the current master:
PG_MASTER=192.168.56.103
# IP address of the new standby node
PG_STANDBY=192.168.56.102
    2. Tắt SELinux theo mô tả trong phần Cài đặt tiện ích thiết lập API Edge.
    3. Tải tệp Edge bootstrap_4.17.0x.sh (trong đó 4.17.0x là 4.17.01, 4.17.05 hoặc 4.17.09) xuống /tmp/bootstrap_4.17.0x.sh : 
      curl https://software.apigee.com/bootstrap_4.17.0x.sh -o /tmp/bootstrap_4.17.0x.sh
    4. Cài đặt tiện ích và phần phụ thuộc của Edge apigee-service: 
      sudo bash /tmp/bootstrap_4.17.0x.sh apigeeuser=uName
  apigeepassword=pWord
    5. Dùng apigee-service để cài đặt tiện ích apigee-setup: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    6. Cài đặt Postgres: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    7. Trên máy chủ chờ mới, hãy thực thi lệnh sau: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Xác thực rằng đó là chế độ chờ.

Tạm dừng nút Postgres

Sau khi cập nhật xong, hãy gỡ bỏ nút chế độ chờ mới:

  1. Đảm bảo Postgres đang chạy:
    > /opt/apigee/apigee-service/bin/apigee-all status

    Nếu Postgres không chạy, hãy khởi động:
    > /opt/apigee/apigee-service/bin/apigee-all start
  2. Lấy UUID của nút chế độ chờ mới bằng cách chạy lệnh cURL sau trên nút chế độ chờ mới:
    > curl -u sysadminEmail:password http://<node_IP>:8084/v1/servers/self

    Bạn sẽ thấy loại UUID của nút ở cuối dữ liệu đầu ra, trong biểu mẫu: e5-9e4"e5-id

  3. Dừng nút chế độ chờ mới bằng cách chạy lệnh sau trên nút chế độ chờ mới:
    > /opt/apigee/apigee-service/bin/apigee-all stop
  4. Trên nút chính Postgres, hãy chỉnh sửa /opt/apigee/customer/application/postgresql.properties để xoá nút chế độ chờ mới khỏi /opt/apigee/customer/application/postgresql.properties:
    conf_pg_hba_replication.connection=host apigee existing_slave_ip/32 tin cậy
  5. Khởi động lại apigee-postgresql trên bản chính Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql khởi động lại
  6. Xác minh rằng nút chế độ chờ mới đã được xoá bằng cách xem tệp /opt/apigee/apigee-postgresql/conf/pg_hba.conf trên tệp chính. Bạn sẽ chỉ thấy dòng sau trong tệp đó:
    host sao chép apigee existing_slave_ip/32 tin cậy
  7. Xoá UUID của nút chế độ chờ khỏi ZooKeeper bằng cách thực hiện lệnh gọi API Quản lý Edge sau đây trên nút Máy chủ quản lý:
    > curl -u sysadminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

Cập nhật các điều kiện tiên quyết

Hãy đảm bảo những điều kiện tiên quyết sau đây trước khi nâng cấp Apigee Edge:

  • Sao lưu tất cả các nút
    Trước khi cập nhật, bạn nên sao lưu toàn bộ tất cả các nút để đảm bảo an toàn. Sử dụng quy trình sao lưu dành cho phiên bản Edge hiện tại của bạn.

    Điều này cho phép bạn có một kế hoạch dự phòng trong trường hợp việc cập nhật lên phiên bản mới không hoạt động đúng cách. Để biết thêm thông tin về quá trình sao lưu, hãy xem bài viết Sao lưu và khôi phục.
  • Đảm bảo Edge đang chạy
    Đảm bảo Edge đã hoạt động và chạy trong quá trình cập nhật bằng cách dùng lệnh:

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

Xử lý bản cập nhật không thành công

Trong trường hợp cập nhật không thành công, bạn có thể thử khắc phục vấn đề rồi chạy lại update.sh. Bạn có thể chạy quá trình cập nhật nhiều lần để tiếp tục quá trình cập nhật từ điểm dừng gần đây nhất.

Nếu lỗi này đòi hỏi bạn phải khôi phục bản cập nhật về phiên bản trước đó, hãy xem Quy trình khôi phục 4.18.01 để biết thêm thông tin.

Thông tin cập nhật ghi nhật ký

Theo mặc định, tiện ích update.sh sẽ ghi thông tin nhật ký vào:

/opt/apigee/var/log/apigee-setup/update.log

Nếu người dùng đang chạy tiện ích update.sh không có quyền truy cập vào thư mục đó, thì tiện ích đó sẽ ghi nhật ký vào thư mục /tmp dưới dạng tệp có tên là update_username.log.

Nếu người dùng không có quyền truy cập vào /tmp, thì tiện ích update.sh sẽ không hoạt động.

Cập nhật thời gian không hoạt động

Bản cập nhật với thời gian ngừng hoạt động hoặc bản cập nhật luân phiên cho phép bạn cập nhật chế độ cài đặt Edge mà không cần hạ cấp Edge.

Bạn chỉ có thể cập nhật thời gian ngừng hoạt động với cấu hình 5 nút trở lên.

Điều quan trọng để nâng cấp thời gian ngừng hoạt động là xoá từng Bộ định tuyến khỏi trình cân bằng tải. Sau đó, bạn cập nhật Bộ định tuyến và mọi thành phần khác trên cùng một máy với Bộ định tuyến, rồi thêm Bộ định tuyến trở lại trình cân bằng tải.

  1. Cập nhật máy theo đúng thứ tự lắp đặt như mô tả dưới đây trong phần "Thứ tự cập nhật máy".
  2. Khi đã đến lúc cập nhật Bộ định tuyến, hãy chọn một Bộ định tuyến bất kỳ và làm cho Bộ định tuyến đó không truy cập được, như mô tả trong phần Bật/tắt khả năng tiếp cận của máy chủ (Bộ xử lý/Bộ định tuyến).
  3. Cập nhật Bộ định tuyến đã chọn và tất cả các thành phần khác của Edge trên cùng một máy với Bộ định tuyến. Tất cả các cấu hình Edge đều hiển thị Bộ định tuyến và Bộ xử lý tin nhắn trên cùng một nút.
  4. Đặt Bộ định tuyến trở lại khả năng truy cập.
  5. Lặp lại các bước từ 2 đến 4 cho các Bộ định tuyến còn lại.
  6. Tiếp tục cập nhật cho mọi máy còn lại trong quá trình cài đặt.

Hãy chú ý đến những vấn đề sau đây trước/sau khi cập nhật:

  • Trên bộ định tuyến kết hợp và nút Bộ xử lý thư:
    • Trước khi cập nhật – hãy thực hiện những việc sau:
      1. Không thể kết nối với Bộ định tuyến.
      2. Đặt Bộ xử lý thư không thể truy cập được.
    • Sau khi cập nhật – hãy làm như sau:
      1. Đặt Bộ xử lý thông báo có thể truy cập được.
      2. Đặt Bộ định tuyến có thể truy cập được.
  • Trên một nút Bộ định tuyến:
    • Trước khi cập nhật, hãy làm cho Bộ định tuyến không thể kết nối được.
    • Sau khi cập nhật, hãy đặt Bộ định tuyến ở chế độ có thể truy cập được.
  • Trên một nút Bộ xử lý thông báo:
    • Trước khi cập nhật, hãy đảm bảo không thể kết nối với Bộ xử lý thư.
    • Sau khi cập nhật, hãy cho phép Bộ xử lý tin nhắn truy cập được.

Sử dụng tệp cấu hình im lặng

Bạn phải truyền tệp cấu hình im lặng đến lệnh cập nhật. Tệp cấu hình im lặng phải là tệp bạn đã dùng để cài đặt Edge 4.17.0x.

Quy trình cập nhật lên phiên bản 4.18.01 trên một nút có kết nối Internet bên ngoài

Sử dụng quy trình sau để cập nhật các thành phần Edge trên một nút:

  1. Nếu bạn đang dùng tính năng sao chép chính chế độ chờ Postgres cho bộ nhớ cục bộ, hãy cài đặt nút chế độ chờ Postgres mới như mô tả ở trên trong phần Cài đặt nút chế độ chờ Postgres mới.

    Nếu đang sử dụng bộ nhớ mạng, bạn không phải cài đặt nút mới. Thay vào đó, hãy chụp nhanh mạng của kho dữ liệu mà Postgres sử dụng. Hãy xem bài viết Bắt buộc nâng cấp lên Postgres 9.6 để biết thêm thông tin.
  2. Nếu có, hãy tắt mọi lệnh CRON được định cấu hình để thực hiện thao tác sửa chữa trên Cassandra cho đến khi quá trình cập nhật hoàn tất.
  3. Đăng nhập vào nút của bạn dưới dạng thư mục gốc để cài đặt RPM Edge.
    Lưu ý: Mặc dù quá trình cài đặt RPM yêu cầu quyền truy cập thư mục gốc, nhưng bạn có thể thực hiện cấu hình Edge mà không cần quyền truy cập thư mục gốc.
  4. Cài đặt yum-utils và yum-plugin-preferred:
    > sudo yum cài đặt yum-utils
    > sudo yum install yum-plugin-Priority
  5. Tắt SELinux theo mô tả trong phần Cài đặt tiện ích thiết lập API Edge.
  6. Nếu bạn đang cài đặt trên Oracle 7.x, hãy chạy lệnh sau:
    > sudo yum-config-manager --enable ol7_optional_latest
  7. Nếu bạn đang cài đặt trên AWS, hãy chạy các lệnh yum-configure-manager sau:
    > yum update rh-Amazon-rhu-client.noarch
    > sudo yum-config-manager --enable rhop-REGION-rhel-server-extras rhyum-REGION-rhel-server-optional
  8. Tải tệp bootstrap_4.18.01.sh của Edge 4.18.01 xuống /tmp/bootstrap_4.18.01.sh:
    > curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
  9. Cài đặt tiện ích và phần phụ thuộc apigee-service Edge 4.18.01:
    > sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

    trong đó uName:pWord là tên người dùng và mật khẩu mà bạn nhận được. Nếu bỏ qua pWord, bạn sẽ được nhắc nhập từ đó.

    Theo mặc định, trình cài đặt sẽ kiểm tra để đảm bảo rằng bạn đã cài đặt Java 1.8. Nếu bạn không có, thì Google Play sẽ cài đặt ứng dụng đó cho bạn. Hãy sử dụng tuỳ chọn JAVA_FIX để chỉ định cách xử lý việc cài đặt Java. JAVA_FIX nhận các giá trị sau:

    I = Cài đặt OpenJDK 1.8 (mặc định)
    C = Tiếp tục mà không cài đặt Java
    Q = Thoát. Đối với cách này, bạn phải tự cài đặt Java.
  10. Sử dụng apigee-service để cập nhật tiện ích apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup cập nhật
  11. Cập nhật tiện ích apigee-validate trên Máy chủ quản lý:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate cập nhật
  12. Cập nhật tiện ích apigee-provide:
    > /opt/apigee/apigee-service/bin/apigee-service apigee- quỹ cập nhật
  13. Chạy tiện ích cập nhật trên các nút theo thứ tự được mô tả bên dưới trong phần "Thứ tự cập nhật máy" dưới đây:
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    Yêu cầu duy nhất đối với tệp cấu hình là người dùng "apigee" phải truy cập được hoặc đọc được tệp cấu hình.

    Sử dụng tuỳ chọn “-c” để chỉ định thành phần cần cập nhật. Danh sách các thành phần có thể có bao gồm:
    ldap = Open LDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge = Tất cả các thành phần Edge = Cài đặt API Balasta và API truy cập Balasta





  14. Hãy kiểm thử bản cập nhật bằng cách chạy tiện ích apigee-validate trên Máy chủ quản lý, như mô tả trong phần Kiểm thử bản cài đặt.
  15. Nếu bạn đã cài đặt một nút chế độ chờ Postgres mới, hãy gỡ bỏ nút đó theo mô tả ở trên trong bài viết Huỷ bỏ một nút Postgres.

    Nếu đang sử dụng bộ nhớ mạng, bạn không phải cài đặt nút mới. Hãy xem bài viết Bắt buộc nâng cấp lên Postgres 9.6 để biết thêm thông tin.

Để khôi phục bản cập nhật sau này, hãy sử dụng quy trình được mô tả trong Quy trình khôi phục 4.18.01.

Quy trình cập nhật lên phiên bản 4.18.01 từ một kho lưu trữ cục bộ

Nếu các nút Edge của bạn bị tường lửa hoặc bị cấm truy cập vào kho lưu trữ Apigee qua Internet, thì bạn có thể cập nhật qua kho lưu trữ cục bộ hoặc bản sao của kho lưu trữ Apigee.

Sau khi tạo một kho lưu trữ cục bộ của Edge, bạn có 2 lựa chọn để cập nhật Edge từ kho lưu trữ cục bộ:

  • Tạo tệp .tar của kho lưu trữ, sao chép tệp .tar vào một nút, sau đó cập nhật Edge từ tệp .tar.
  • Cài đặt máy chủ web trên nút có kho lưu trữ cục bộ để các nút khác có thể truy cập vào nút đó. Apigee cung cấp máy chủ web Nginx cho bạn sử dụng hoặc bạn có thể dùng máy chủ web của riêng mình.

Để cập nhật từ một kho lưu trữ 4.18.01 cục bộ:

  1. Nếu bạn đang dùng tính năng sao chép chính theo chế độ chờ Postgres, hãy cài đặt một nút chế độ chờ Postgres mới như mô tả ở trên trong phần Cài đặt nút chế độ chờ Postgres mới.

    Nếu đang sử dụng bộ nhớ mạng, bạn không phải cài đặt nút mới. Thay vào đó, hãy chụp nhanh mạng của kho dữ liệu mà Postgres sử dụng. Hãy xem bài viết Bắt buộc nâng cấp lên Postgres 9.6 để biết thêm thông tin.
  2. Tạo một bản repo 4.18.01 cục bộ như mô tả trong phần "Tạo kho lưu trữ Apigee cục bộ" tại phần Cài đặt tiện ích apigee-setup của Edge.
    Lưu ý: Nếu đã có một kho lưu trữ 4.17.0x hiện có, bạn có thể thêm kho lưu trữ 4.18.01 vào kho lưu trữ đó theo mô tả trong phần "Cập nhật kho lưu trữ cục bộ Apigee" tại phần Cài đặt tiện ích thiết lập apigee của Edge.
  3. Cách cài đặt dịch vụ apigee từ tệp .tar:
    1. Trên nút có kho lưu trữ cục bộ, hãy dùng lệnh sau để đóng gói kho lưu trữ cục bộ vào một tệp .tar duy nhất có tên /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz:
      > /optgee/apigee-service/bin/apigee-service apigee-service apigee-service
    2. Sao chép tệp .tar vào nút mà bạn muốn cập nhật Edge. Ví dụ: sao chép tệp đó vào thư mục /tmp trên nút mới.
    3. Trên nút mới, hãy huỷ lưu tệp vào thư mục /tmp:
      > tar -xzf apigee-4.18.01.tar.gz

      Lệnh này tạo một thư mục mới có tên repos trong thư mục chứa tệp .tar. Ví dụ: /tmp/repos.
    4. Cài đặt tiện ích apigee-service và phần phụ thuộc của Edge từ /tmp/repos:
      > sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Lưu ý rằng bạn cần thêm đường dẫn đến thư mục repos vào lệnh này.
  4. Cách cài đặt dịch vụ API bằng máy chủ web Nginx:
    1. Định cấu hình máy chủ web Nginx như mô tả trong phần "Cài đặt từ kho lưu trữ bằng máy chủ web Nginx" tại phần Cài đặt tiện ích thiết lập API Edge.
    2. Trên nút điều khiển từ xa, hãy tải tệp Edge bootstrap_4.18.01.sh xuống hoặc đặt tên người dùng là /tmp/bootstrap_4.18.01.sh:
      > /usr/bin/curl http://uName:pWord@remoterepName:3939/bootstrap_4.18.01po1 tên người dùng của nút là Reprap.01.01.18.01.

    3. Trên nút từ xa, hãy cài đặt tiện ích và phần phụ thuộc dịch vụ Edge:
      > sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=

  5. Sử dụng apigee-service để cập nhật tiện ích apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup cập nhật
  6. Cập nhật tiện ích apigee-validate trên Máy chủ quản lý.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate cập nhật
  7. Cập nhật tiện ích apigee-provide:
    > /opt/apigee/apigee-service/bin/apigee-service apigee- quỹ cập nhật
  8. Chạy tiện ích cập nhật trên các nút theo thứ tự được mô tả dưới đây trong phần "Thứ tự cập nhật máy":
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    Yêu cầu duy nhất đối với tệp cấu hình là người dùng "apigee" phải truy cập được hoặc đọc được tệp cấu hình.

    Sử dụng tuỳ chọn “-c” để chỉ định thành phần cần cập nhật. Danh sách các thành phần có thể có bao gồm:
    ldap = Open LDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge = Tất cả các thành phần Edge = Cài đặt API Balasta và API truy cập Balasta





  9. Hãy kiểm thử bản cập nhật bằng cách chạy tiện ích apigee-validate trên Máy chủ quản lý, như mô tả trong phần Kiểm thử bản cài đặt.
  10. Nếu bạn đã cài đặt một nút chế độ chờ Postgres mới, hãy gỡ bỏ nút này theo mô tả ở trên trong bài viết Huỷ bỏ một nút Postgres.

    Nếu đang sử dụng bộ nhớ mạng, bạn không phải cài đặt nút mới. Hãy xem bài viết Bắt buộc nâng cấp lên Postgres 9.6 để biết thêm thông tin.

Để khôi phục bản cập nhật sau này, hãy sử dụng quy trình được mô tả trong Quy trình khôi phục 4.18.01.

Thứ tự cập nhật máy

Thứ tự cập nhật các máy trong một lần cài đặt Edge rất quan trọng. Những điểm quan trọng nhất cần cân nhắc đối với một bản cập nhật là:

  • Bạn phải cập nhật tất cả các nút Cassandra và ZooKeeper trước khi cập nhật bất kỳ nút nào khác.
  • Đối với những máy có nhiều thành phần Edge (Máy chủ quản lý, Bộ xử lý thông báo, Bộ định tuyến, Máy chủ QPID nhưng không phải Máy chủ Postgres), hãy sử dụng tuỳ chọn "-c Edge" để cập nhật tất cả các thành phần đó cùng một lúc.
  • Nếu một bước chỉ định rằng phải được thực hiện trên nhiều máy, hãy thực hiện bước đó theo thứ tự máy đã chỉ định.
  • Không có bước riêng biệt nào để cập nhật tính năng Kiếm tiền. Giá trị này sẽ được cập nhật khi bạn chỉ định tuỳ chọn "-c Edge".

Đối với việc cài đặt độc lập với 1 máy chủ

  1. Nếu bạn cập nhật từ phiên bản 4.17.01, hãy đặt SMTPMAILFROM trong tệp cấu hình nếu bạn đã bật SMTP trên Edge. Thông số này có dạng:
    SMTPMAILFROM="Công ty của tôi <myco@company.com>"
  2. Cập nhật Cassandra và ZooKeeper:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Cập nhật Qpid:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Cập nhật LDAP:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Dừng máy chủ Postgres, máy chủ Qpid và PostgreSQL:
    > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server dừng
    > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
    > /opt/apigeebin/apigee-service
  6. Cập nhật postgresql:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  7. Cập nhật cơ sở dữ liệu Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  8. Cập nhật các thành phần còn lại của Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c cạnh -f configFile
  9. Cập nhật giao diện người dùng Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Đối với quá trình cài đặt độc lập với 2 máy chủ

Hãy xem phần Cấu trúc liên kết đã cài đặt để biết danh sách các cấu trúc liên kết và số nút của Edge.

  1. Nếu bạn cập nhật từ phiên bản 4.17.01, hãy đặt SMTPMAILFROM trong tệp cấu hình nếu bạn đã bật SMTP trên Edge. Thông số này có dạng:
    SMTPMAILFROM="Công ty của tôi <myco@company.com>"
  2. Cập nhật Cassandra và ZooKeeper trên máy 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Cập nhật Qpid trên máy 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Cập nhật LDAP trên máy 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Cập nhật các thành phần Edge trên máy 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  6. Cập nhật giao diện người dùng trên máy 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. Cập nhật postgresql trên máy 2:
    1. Dừng máy chủ Postgres, máy chủ Qpid và postgresql:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server dừng
      >service binoptapie-postgee-service
    2. Cập nhật postgresql:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    3. Cập nhật cơ sở dữ liệu Postgres:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    4. Cập nhật các thành phần Edge trên máy 2:
      > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile

Đối với việc cài đặt theo cụm 5 máy chủ

Hãy xem phần Cấu trúc liên kết đã cài đặt để biết danh sách các cấu trúc liên kết và số nút của Edge.

  1. Nếu bạn cập nhật từ phiên bản 4.17.01, hãy đặt SMTPMAILFROM trong tệp cấu hình nếu bạn đã bật SMTP trên Edge. Thông số này có dạng:
    SMTPMAILFROM="Công ty của tôi <myco@company.com>"
  2. Đảm bảo rằng bạn đã cài đặt một nút chế độ chờ Postgres mới như mô tả ở trên trong phần Cài đặt nút chế độ chờ Postgres mới.

    Nếu đang sử dụng bộ nhớ mạng, bạn không phải cài đặt nút mới. Thay vào đó, hãy chụp nhanh mạng của kho dữ liệu mà Postgres sử dụng. Hãy xem bài viết Bắt buộc nâng cấp lên Postgres 9.6 để biết thêm thông tin.
  3. Cập nhật Cassandra và ZooKeeper trên máy 1, 2 và 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Cập nhật Qpid trên máy 4 và 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Cập nhật LDAP trên máy 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Cập nhật các thành phần Edge trên máy 1, 2, 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cạnh -f configFile
  7. Cập nhật giao diện người dùng trên máy 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. ??Cập nhật máy 4 và 5:
    1. Dừng máy chủ Postgres và máy chủ Qpid trên máy 4:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server dừng
    2. Dừng máy chủ Postgres, máy chủ Qpid và postgresql trên máy 5:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server dừng
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
      > /optere/apieapieapieapieapie_service
    3. Nếu đã cài đặt, hãy dừng máy chủ Postgres và postgresql trên nút chờ mới mà bạn đã thêm để khôi phục:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server dừng
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgre
    4. Cập nhật postgresql trên máy 4:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    5. Cập nhật cơ sở dữ liệu Postgres trên máy 4 (chỉ dành cho bản thân Postgres):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    6. Cập nhật postgresql trên máy 5:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. Khởi động máy chủ Postgres và máy chủ Qpid trên máy 4 và 5:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    8. Định cấu hình Postgres làm nút chờ bằng cách chạy các lệnh sau trên máy 5:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql-config-replication
    9. Xác minh trạng thái sao chép bằng cách phát hành các tập lệnh sau trên cả hai máy chủ. Hệ thống phải cho thấy kết quả giống nhau trên cả hai máy chủ để đảm bảo sao chép thành công:

      Trên máy 4, nút chính, chạy:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Xác thực rằng đó là nút chính.

      Trên máy 5, nút chế độ chờ:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Xác thực rằng đó là chế độ chờ.
  9. Cập nhật các thành phần Edge trên máy 4, 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  10. Đảm bảo bạn gỡ bỏ nút chế độ chờ mới bằng cách làm theo quy trình nêu trên trong phần Huỷ hoạt động nút Postgres.

    Nếu đang sử dụng bộ nhớ mạng, bạn không phải cài đặt nút mới. Hãy xem bài viết Bắt buộc nâng cấp lên Postgres 9.6 để biết thêm thông tin.

Đối với việc cài đặt theo cụm 9 máy chủ

Hãy xem phần Cấu trúc liên kết đã cài đặt để biết danh sách các cấu trúc liên kết và số nút của Edge.

  1. Nếu bạn cập nhật từ phiên bản 4.17.01, hãy đặt SMTPMAILFROM trong tệp cấu hình nếu bạn đã bật SMTP trên Edge. Thông số này có dạng:
    SMTPMAILFROM="Công ty của tôi <myco@company.com>"
  2. Đảm bảo rằng bạn đã cài đặt một nút chế độ chờ Postgres mới như mô tả ở trên trong phần Cài đặt nút chế độ chờ Postgres mới.

    Nếu đang sử dụng bộ nhớ mạng, bạn không phải cài đặt nút mới. Thay vào đó, hãy chụp nhanh mạng của kho dữ liệu mà Postgres sử dụng. Hãy xem bài viết Bắt buộc nâng cấp lên Postgres 9.6 để biết thêm thông tin.
  3. Cập nhật Cassandra và ZooKeeper trên máy 1, 2 và 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Cập nhật Qpid trên máy 6 và 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Cập nhật LDAP trên máy 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Cập nhật các thành phần Edge trên máy 6, 7, 1, 4 và 5 theo thứ tự:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  7. Cập nhật giao diện người dùng trên máy 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile?
  8. Cập nhật máy 8 và 9:
    1. Dừng máy chủ Postgres trên máy 8:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server dừng
    2. Dừng máy chủ Postgres và postgresql trên máy 9:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server dừng
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql dừng
    3. Dừng máy chủ Qpid trên máy 6 và 7:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
    4. Nếu đã cài đặt, hãy dừng máy chủ Postgres và postgresql trên nút chờ mới mà bạn đã thêm để khôi phục:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server dừng
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgre
    5. Cập nhật postgresql trên máy 8:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Cập nhật cơ sở dữ liệu Postgres trên máy 8 (chỉ dành cho bản thân Postgres):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Cập nhật postgresql trên máy 9:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Khởi động máy chủ Postgres trên máy 8 và 9:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
    9. Khởi động máy chủ máy chủ Qpid trên máy 6 và 7:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    10. Định cấu hình Postgres làm nút chờ bằng cách chạy các lệnh sau trên máy 9:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql-config-replication
    11. Xác minh trạng thái sao chép bằng cách phát hành các tập lệnh sau trên cả hai máy chủ. Hệ thống phải cho thấy kết quả giống nhau trên cả hai máy chủ để đảm bảo sao chép thành công:
      Trên máy 8, nút chính, hãy chạy:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Xác thực rằng đó là nút chính.

      Trên máy 9, nút chế độ chờ:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Xác thực rằng đó là chế độ chờ.
  9. Cập nhật các thành phần Edge trên máy 8 và 9:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  10. Đảm bảo bạn gỡ bỏ nút chế độ chờ mới bằng cách làm theo quy trình nêu trên trong phần Huỷ hoạt động nút Postgres.

    Nếu đang sử dụng bộ nhớ mạng, bạn không phải cài đặt nút mới. Hãy xem bài viết Bắt buộc nâng cấp lên Postgres 9.6 để biết thêm thông tin.

Đối với việc cài đặt theo nhóm gồm 13 máy chủ

Hãy xem phần Cấu trúc liên kết đã cài đặt để biết danh sách các cấu trúc liên kết và số nút của Edge.

  1. Nếu bạn cập nhật từ phiên bản 4.17.01, hãy đặt SMTPMAILFROM trong tệp cấu hình nếu bạn đã bật SMTP trên Edge. Thông số này có dạng:
    SMTPMAILFROM="Công ty của tôi <myco@company.com>"
  2. Đảm bảo rằng bạn đã cài đặt một nút chế độ chờ Postgres mới như mô tả ở trên trong phần Cài đặt nút chế độ chờ Postgres mới.

    Nếu đang sử dụng bộ nhớ mạng, bạn không phải cài đặt nút mới. Thay vào đó, hãy chụp nhanh mạng của kho dữ liệu mà Postgres sử dụng. Hãy xem bài viết Bắt buộc nâng cấp lên Postgres 9.6 để biết thêm thông tin.
  3. Cập nhật Cassandra và ZooKeeper trên máy 1, 2 và 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Cập nhật Qpid trên máy 12 và 13:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Cập nhật LDAP trên máy 4 và 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Cập nhật các thành phần Edge trên máy 12, 13, 6, 7, 10 và 11 theo thứ tự:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  7. Cập nhật giao diện người dùng trên máy 6 và 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile??
  8. Cập nhật máy 8 và 9:
    1. Dừng máy chủ Postgres trên máy 8:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server dừng
    2. Dừng máy chủ Postgres và postgresql trên máy 9:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server dừng
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql dừng
    3. Dừng máy chủ Qpid trên máy 12 và 13:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server dừng
    4. Nếu đã cài đặt, hãy dừng máy chủ Postgres và postgresql trên nút chờ mới mà bạn đã thêm để khôi phục:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server dừng
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgre
    5. Cập nhật postgresql trên máy 8:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Cập nhật cơ sở dữ liệu Postgres trên máy 8 (chỉ dành cho bản thân Postgres):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Cập nhật postgresql trên máy 9:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Khởi động máy chủ Postgres trên máy 8 và 9:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
    9. Khởi động máy chủ máy chủ Qpid trên máy 12 và 13:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    10. Định cấu hình Postgres làm nút chờ bằng cách chạy các lệnh sau trên máy 9:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql-config-replication
    11. Xác minh trạng thái sao chép bằng cách phát hành các tập lệnh sau trên cả hai máy chủ. Hệ thống phải cho thấy kết quả giống nhau trên cả hai máy chủ để đảm bảo sao chép thành công:
      Trên máy 8, nút chính, hãy chạy:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Xác thực rằng đó là nút chính.

      Trên máy 9, nút chế độ chờ:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Xác thực rằng đó là chế độ chờ.
  9. Cập nhật các thành phần Edge trên máy 8 và 9:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile??
  10. Đảm bảo bạn gỡ bỏ nút chế độ chờ mới bằng cách làm theo quy trình nêu trên trong phần Huỷ hoạt động nút Postgres.

    Nếu đang sử dụng bộ nhớ mạng, bạn không phải cài đặt nút mới. Hãy xem bài viết Bắt buộc nâng cấp lên Postgres 9.6 để biết thêm thông tin.

Đối với việc cài đặt theo nhóm gồm 12 máy chủ

Hãy xem phần Cấu trúc liên kết đã cài đặt để biết danh sách các cấu trúc liên kết và số nút của Edge.

  1. Nếu bạn cập nhật từ phiên bản 4.17.01, hãy đặt SMTPMAILFROM trong tệp cấu hình nếu bạn đã bật SMTP trên Edge. Thông số này có dạng:
    SMTPMAILFROM="Công ty của tôi <myco@company.com>"
  2. Đảm bảo rằng bạn đã cài đặt một nút chế độ chờ Postgres mới như mô tả ở trên trong phần Cài đặt nút chế độ chờ Postgres mới.

    Nếu đang sử dụng bộ nhớ mạng, bạn không phải cài đặt nút mới. Thay vào đó, hãy chụp nhanh mạng của kho dữ liệu mà Postgres sử dụng. Hãy xem bài viết Bắt buộc nâng cấp lên Postgres 9.6 để biết thêm thông tin.
  3. Cập nhật Cassandra và ZooKeeper:
    1. Trên máy 1, 2 và 3 trong Trung tâm dữ liệu 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. Trên máy 7, 8 và 9 trong Trung tâm dữ liệu 2
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Cập nhật qpidd:
    1. Máy 4, 5 trong Trung tâm dữ liệu 1
      1. Cập nhật qpidd trên máy 4:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Lặp lại bước 1 trên máy 5.
    2. Máy 10, 11 trong Trung tâm dữ liệu 2
      1. Cập nhật qpidd trên máy 10:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Lặp lại bước 1 trên máy 11.
  5. Cập nhật LDAP:
    1. Máy 1 trong Trung tâm dữ liệu 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. Máy 7 trong Trung tâm dữ liệu 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Cập nhật các thành phần Edge:
    1. Máy 4, 5, 1, 2, 3 trong Trung tâm dữ liệu 1
      > /opt/apigee/apigee-setup/bin/update.sh -c cạnh -f configFile
    2. Máy 10, 11, 7, 8, 9 trong Trung tâm dữ liệu 2
      > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  7. Cập nhật giao diện người dùng:
    1. Máy 1 trong Trung tâm dữ liệu 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    2. Máy 7 trong Trung tâm dữ liệu 2:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. ?Cập nhật máy 6 trong Trung tâm dữ liệu 1 và 12 trong Trung tâm dữ liệu 2:
    1. Dừng máy chủ Postgres trên máy 6:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server dừng
    2. Dừng máy chủ Postgres và postgresql trên máy 12:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server dừng
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql dừng
    3. Dừng máy chủ Qpid trên các máy 4, 5, 10 và 11:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server dừng
    4. Nếu đã cài đặt, hãy dừng máy chủ Postgres và postgresql trên nút chờ mới mà bạn đã thêm để khôi phục:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server dừng
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgre
    5. Cập nhật postgresql trên máy 6:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Cập nhật cơ sở dữ liệu Postgres trên máy 6 (chỉ dành cho bản thân Postgres):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Cập nhật postgresql trên máy 12:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Khởi động máy chủ Postgres trên máy 6 và 12:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
    9. Khởi động máy chủ máy chủ Qpid trên máy 4, 5, 10 và 11:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    10. Định cấu hình Postgres làm nút chế độ chờ bằng cách chạy các lệnh sau trên máy 12:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgre-config-config-sql-setup-sql,       configFile
    11. Xác minh trạng thái sao chép bằng cách phát hành các tập lệnh sau trên cả hai máy chủ. Hệ thống phải cho thấy kết quả giống nhau trên cả hai máy chủ để đảm bảo sao chép thành công:
      Trên máy 6, nút chính, hãy chạy:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Xác thực rằng đó là nút chính.

      Trên máy 12, nút chế độ chờ:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Xác thực rằng đó là chế độ chờ.
  9. Cập nhật các thành phần Edge trên máy 6 và 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  10. Đảm bảo bạn gỡ bỏ nút chế độ chờ mới bằng cách làm theo quy trình nêu trên trong phần Huỷ hoạt động nút Postgres.

    Nếu đang sử dụng bộ nhớ mạng, bạn không phải cài đặt nút mới. Hãy xem bài viết Bắt buộc nâng cấp lên Postgres 9.6 để biết thêm thông tin.

Đối với việc cài đặt API BaaS với 7 máy chủ

  1. Thiết lập SMTPMAILFROM trong tệp cấu hình. Thông số này có dạng:
    SMTPMAILFROM="Công ty của tôi <myco@company.com>"
  2. Cập nhật Cassandra trên máy 5, 6 và 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

  3. Cập nhật ElasticSearch và API BaaS Stack trên máy 1, 2 và 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile

  4. Cập nhật API BaaS Cổng trên máy 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Đối với lượt cài đặt API BaaS gồm 10 máy chủ

  1. Thiết lập SMTPMAILFROM trong tệp cấu hình. Thông số này có dạng:
    SMTPMAILFROM="Công ty của tôi <myco@company.com>"
  2. Cập nhật Cassandra trên máy 8, 9 và 10:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  3. Cập nhật ElasticSearch trên máy 1, 2 và 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  4. Cập nhật ngăn xếp API BaaS trên máy 4, 5 và 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  5. Cập nhật API BaaS Cổng trên máy 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Đối với việc cài đặt API Baas cho hai trung tâm dữ liệu

Quy trình này yêu cầu bạn cập nhật các nút Cassandra trong cả hai trung tâm dữ liệu. Nếu đang chia sẻ các nút Cassandra đó với Edge, thì bạn thường cập nhật các nút đó trong quá trình cập nhật Edge.

  1. Thiết lập SMTPMAILFROM trong tệp cấu hình. Thông số này có dạng:
    SMTPMAILFROM="Công ty của tôi <myco@company.com>"
  2. Cập nhật không gian khoá Cassandra bằng hệ số sao chép chính xác cho hai trung tâm dữ liệu. Bạn chỉ phải chạy bước này một lần trên bất kỳ máy chủ Cassandra nào trong trung tâm dữ liệu:

    Lưu ý: Tất cả các lệnh bên dưới đều đặt hệ số nhân bản thành "3", cho biết có 3 nút Cassandra trong cụm. Hãy sửa đổi giá trị này nếu cần cho chế độ cài đặt của bạn.
    1. Khởi động tiện ích Cassandra cassah:
      > /opt/apigee/apigee-cassandra/bin/làm việc cassandraIP
    2. Thực thi các lệnh CQL sau đây tại lời nhắc "cpclsh>" để đặt mức sao chép cho không gian phím Cassandra:
      1. cqualsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH copytion = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      2. cClsh> ALTER KEYSPACE "Apigee_Baas" WITH sao chép = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      3. cClsh> ALTER KEYSPACE "Apigee_Baas_Locks" WITH copytion = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      4. cpclsh> ALTER KEYSPACE "system_traces" WITH sao chép = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      5. cqualsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH copytion = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      6. Xem các không gian phím bằng cách dùng lệnh:
        cpclsh> select * from system.schema_keyspaces;
      7. Thoát cquash:
        cqualsh> thoát
  3. (Chỉ khi bạn không cập nhật Cassandra trong quá trình cập nhật Edge) Cập nhật các nút Cassandra trong trung tâm dữ liệu 1, mỗi lần một máy:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  4. (Chỉ khi bạn không cập nhật Cassandra trong quá trình cập nhật Edge) Cập nhật các nút Cassandra trong trung tâm dữ liệu 2, mỗi lần một máy:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  5. Cập nhật ElasticSearch trên các máy trong trung tâm dữ liệu 1, mỗi lần một máy:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  6. Cập nhật ElasticSearch trên các máy trong trung tâm dữ liệu 2, mỗi lần một máy:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  7. Cập nhật ngăn xếp API BaaS trên các máy trong trung tâm dữ liệu 1, mỗi lần một máy:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  8. Cập nhật ngăn xếp API BaaS trên các máy trong trung tâm dữ liệu 2, mỗi lần một máy:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  9. Cập nhật API BaaS Cổng trên các máy trong trung tâm dữ liệu 1, mỗi lần một máy:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
  10. Cập nhật API BaaS Cổng trên các máy trong trung tâm dữ liệu 2, mỗi lần một máy:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
  11. Cập nhật giá trị không gian khoá BaaS. Bạn phải thiết lập những không gian khoá này để nhân bản tại thời điểm cài đặt, nhưng không nhất thiết phải vào thời gian chạy. Việc xoá bản sao cũng giúp tiết kiệm bộ nhớ Cassandra.

    Bạn chỉ phải chạy bước này một lần trên mọi máy chủ Cassandra trong trung tâm dữ liệu:
    1. Khởi động phần mềm tiện ích Cassandra cpclsh:
      > /opt/apigee/apigee-cassandra/bin/cpclsh cassandraIP
    2. Thực thi các lệnh CQL sau đây để đặt cấp sao chép cho không gian phím Cassandra:
      1. cClsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH copytion = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3' };
      2. cquash> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH copytion = { 'class': 'NetworkTopologyStrategy', 'dc-2': '3' };
      3. Xem các không gian phím bằng cách dùng lệnh:
        dư cuộc gọi để chọn * từ hệ thống.schema_keyspaces;
      4. Thoát cqualsh:
        pClsh> exit

Đối với trường hợp lắp đặt không theo tiêu chuẩn

Nếu bạn cài đặt không theo tiêu chuẩn, hãy cập nhật các thành phần Edge theo thứ tự sau:

  1. ZooKeeper
  2. Cassandra
  3. qpidd, ps
  4. LDAP
  5. Edge, có nghĩa là cấu hình "-c cạnh" trên tất cả các nút theo thứ tự: nút có máy chủ Qpid, máy chủ Postgres, Máy chủ quản lý, Bộ xử lý thông báo và Bộ định tuyến.
    Lưu ý: Nếu nút đã cài đặt cả máy chủ Qpid và máy chủ Postgres, hãy chạy bước cấu hình "-c Edge".
  6. Giao diện người dùng Edge
Cập nhật Apigee Edge 4.17.01/4.17.05 lên 4.17.09