Cập nhật Apigee Edge 4.16.01/4.16.05 lên 4.17.09

Edge for Private Cloud phiên bản 4.17.09

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

Bạn có thể cập nhật Apigee Edge phiên bản 4.16.01.0x và 4.16.05.x lên 4.17.09 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 rồi cập nhật lên phiên bản 4.17.09.

  • Bạn có thể di chuyển Apigee Edge phiên bản 4.15.07 sang 4.16.01.
  • Nếu đang dùng phiên bản Edge trước phiên bản 4.15.07, thì trước tiên, bạn phải chuyển sang phiên bản 4.15.07 rồi chuyển sang phiên bản 4.16.01.
    • Nếu bạn chuyển từ Edge phiên bản 4.14.04 trở lên: Hãy chuyển trực tiếp sang phiên bản 4.15.07.
    • Nếu di chuyển từ Edge phiên bản 4.14.01: Trước tiên, bạn phải chuyển sang phiên bản 4.14.04 rồi chuyển sang phiên bản 4.15.07.

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.

Hạ cấp Zookeeper nếu cập nhật từ phiên bản 4.16.01

Phiên bản Zookeeper RPM trong Edge dành cho đám mây riêng tư 4.16.01 là apigee-zookeeper-3.4.5-1.0.905.noarch.rpm. Trong các phiên bản tiếp theo của Edge, phiên bản Zookeeper đã được đổi lại thành apigee-zookeeper-3.4.5-0.0.94x. Điều này ngăn yum nâng cấp Zookeeper lên các phiên bản mới hơn từ 4.16.01. Cách khắc phục trường hợp này là chạy yum hạ cấp apigee-zookeeper trước khi cập nhật Zookeeper.

Bạn có thể kiểm tra phiên bản Zookeeper bằng cách dùng lệnh sau:

> rpm -qa |grep apigee-zookeeper

Nếu lệnh này trả về phiên bản Zookeeper:

apigee-zookeeper-3.4.5-1.0.905

Sau đó, bạn phải hạ cấp.

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.

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.17.09 để 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.

Bắt buộc phải nâng cấp lên Java JDK Phiên bản 8

Bản phát hành Edge này yêu cầu bạn phải cài đặt Java JDK phiên bản 8 trên tất cả các nút xử lý Edge. Bạn có thể cài đặt Oracle JDK 8 hoặc OpenJDK 8. Nếu Java JDK 8 chưa được cài đặt, tập lệnh cập nhật có thể cài đặt cho bạn.

Trong bản cập nhật Java 8, một số thuật toán mật mã TLS không còn có trong Oracle JDK 8 nữa. Để biết danh sách đầy đủ, hãy xem phần "Default Disabled Cipher Suite" (Bộ thuật toán mật mã bị vô hiệu hoá mặc định) tại http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.

Bắt buộc để bật kho lưu trữ EPEL

Bạn phải bật Gói bổ sung cho Enterprise Linux (hoặc EPEL) để cài đặt hoặc cập nhật Edge. Lệnh bạn sử dụng phụ thuộc vào phiên bản RedHat/CentOS của bạn:

  • Đối với RedHat/CentOS 7.x:
    > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.vòng/phút; vòng/phút -ivh epel-release-latest-7.noarch.vòng/phút
  • Đối với RedHat/CentOS 6.x:
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.RPM; RPM -ivh epel-release-latest-6.noarch.RPM

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, 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>"

Bắt buộc nếu cập nhật khi sử dụng phương thức xác thực bên ngoài

Bạn có thể tích hợp dịch vụ thư mục bên ngoài vào bản cài đặt đám mây riêng tư Apigee Edge. Tính năng này được thiết kế để hoạt động với mọi dịch vụ thư mục hỗ trợ LDAP, chẳng hạn như Active Directory, OpenLDAP và các dịch vụ khác. Một giải pháp LDAP bên ngoài cho phép quản trị viên hệ thống quản lý thông tin xác thực của người dùng từ một dịch vụ quản lý thư mục tập trung, bên ngoài các hệ thống như Apigee Edge sử dụng các hệ thống đó.

Xem Cấu hình xác thực bên ngoài để biết thêm thông tin.

Khi bật tính năng xác thực bên ngoài, hầu hết khách hàng đều sử dụng trường tên tài khoản SAM trong Active Directory làm tên người dùng để xác thực, thay vì địa chỉ email mà máy chủ Edge OpenLDAP sử dụng.

Nếu bạn đã tích hợp với dịch vụ thư mục bên ngoài, hãy thêm dòng sau vào tệp cấu hình khi cập nhật Edge lên 4.17.09:

IS_EXTERNAL_AUTH="true"

Dòng này định cấu hình Edge để hỗ trợ tên tài khoản thay vì địa chỉ email dưới dạng tên người dùng.

Cần nâng cấp lên Qpid 1.35

Bản phát hành này chứa một bản cập nhật bắt buộc cho Qpid 1.35. Trong quá trình cập nhật nút Qpid, bạn phải:

  • Tạm thời ngăn Bộ định tuyến và Bộ xử lý thông báo ghi vào nút Qpid bằng cách chặn cổng 5672 trên nút Qpid. Bạn có thể dùng lệnh sau để chặn cổng này trên nút Qpid:
    > sudo iptables -A input -p tcp --destination-port 5672 ! –s `tên máy chủ` -i eth0 -j THẢO LUẬN
  • Chờ hàng đợi Qpid hết thông báo để đảm bảo rằng nút Qpid đã xử lý tất cả thông báo trước khi cập nhật. Hãy dùng lệnh sau để đảm bảo hàng đợi thông báo Qpid trống:
    > qpid-stat -q
  • Cập nhật nút Qpid.
  • Bỏ chặn cổng 5672 trên nút Qpid để cho phép truy cập từ Bộ định tuyến và Bộ xử lý thông báo. Bạn có thể sử dụng lệnh sau để bỏ chặn cổng này:
    > sudo iptables -F

    Lưu ý rằng nếu đang sử dụng iptables cho các quy tắc khác thì bạn có thể sử dụng tuỳ chọn -D để đảo ngược thay đổi cụ thể:
    > sudo iptables -D input -p tcp --destination-port 5672 ! –s `tên máy chủ` -i eth0 -j THẢO LUẬN

Quá trình này được mô tả chi tiết dưới đây cho từng cấu trúc liên kết Edge.

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

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

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.

Bạn bắt buộc phải 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 Yêu cầu về cài đặt của Edge.

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 hiện có (4.16.01 hoặc 4.16.05), chứ không phải cho phiên bản 4.17.09.

Để 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 để đặt mã thông báo sau. Nếu tệp đó chưa tồn tại, hãy tạo tệp đó:

    conf_pg_hba_replication.connection=host apigee existing_slave_ip/32 trust\ \nhost sao chép apigee existing_slave_ip/32 trust

    trong đó existing_slave_ip là địa chỉ IP của chế độ chờ và chế độ chờ mới là existing_slave_ip là địa chỉ IP chờ hiện tại của máy chủ Post_slave_ip
  2. Khởi động lại apigee-postgresql trên bản chính Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. Xác minh rằng 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 tệp chính. Bạn sẽ thấy các dòng sau trong tệp đó:
    host sao chép apigee existing_slave_ip/32 trust
    host sao chép 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 như sau:

      # địa chỉ IP của bản chính hiện tại:
      PG_MASTER=192.168.56.103
      # địa chỉ IP của nút chế độ chờ mới
      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.16.05.sh xuống /tmp/bootstrap_4.16.05.sh:
      > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh

      Lưu ý.shstrap đang cập nhật tệp Edge: Nếu bạn đang cập nhật tệp Edge/tmp/bootstrap_4.16.05.sh
    4. Cài đặt tiện ích và phần phụ thuộc dịch vụ apigee của Edge:
      > sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
    5. Sử dụng apigee-service để cài đặt tiện ích apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup cài đặt
    6. Cài đặt Postgres:
      > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    7. Trên nút chế độ chờ mới, hãy chạy 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 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 đã sử dụng để cài đặt Edge 4.16.01 hoặc 4.16.05.

Quy trình cập nhật lên phiên bản 4.17.09 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 và 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.
  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-utilsyum-plugin-preferred:
    > sudo yum cài đặt yum-utils
    > sudo yum install yum-plugin-Priority
  5. Tắt SELinux như mô tả trong phần Cài đặt tiện ích apigee-setup của Edge.
  6. Bật kho lưu trữ EPEL như mô tả ở trên.
  7. Nếu bạn đang cài đặt trên AWS, hãy chạy lệnh yum-configure-manager sau:
    > sudo yum-config-manager --enable rhướng-REGION-rhel-server-extras rhy-REGION-rhel-server-optional
  8. Tải tệp bootstrap_4.17.09.sh của Edge 4.17.09 xuống /tmp/bootstrap_4.17.09.sh:
    > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
  9. Cài đặt tiện ích và phần phụ thuộc apigee-service của Edge 4.17.09:
    > sudo bash /tmp/bootstrap_4.17.09.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:
    1. Nếu đã cài đặt phiên bản 4.16.01 bằng cách nâng cấp Edge phiên bản 4.15.07.0x, bạn phải cài đặt tiện ích apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup cài đặt

      Lệnh này sẽ cài đặt tiện ích update.shapie trong /optge-setup/apige

      Nếu bạn đã cài đặt tiện ích apigee-setup, hãy cập nhật tiện ích đó:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup cập nhật
    2. Nếu đã cài đặt trực tiếp phiên bản 4.16.01, tức là bạn không nâng cấp từ phiên bản 4.15.07.0x, bạn phải cập nhật tiện ích apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update/bin/apigee-service apigee-setup

      Bản cập nhật này sẽ cài đặt apigee-service. cài đặt apigee-service. sẽ cài đặt apigee-service .
    3. Nếu đã cài đặt trực tiếp phiên bản 4.16.05 hoặc qua bản cập nhật, bạn phải cập nhật tiện ích apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      Bản cập nhật apigee-service này sẽ cài đặt tiện ích update.sh trong /optgee-setup/apigee
  11. Tuỳ thuộc vào phiên bản Edge hiện tại, bạn phải cài đặt hoặc cập nhật tiện ích apigee-validate trên Máy chủ quản lý.
    1. Nếu bạn đang sử dụng Edge 4.16.05: hãy 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
    2. Nếu đang dùng Edge 4.16.01, hãy cài đặt tiện ích apigee-validate trên máy chủ Quản lý:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate




    3. Nếu bạn đang nâng cấp từ phiên bản 4.16.01: Hãy chỉnh sửa tệp cấu hình được chuyển đến tiện ích apigee-validate. Trong bản phát hành Edge 4.16.01, tệp cấu hình mà apigee-validate sử dụng bắt buộc phải có các thuộc tính sau:
      APIGEE_ADMINPW=sysadminPword
      MP_POD=gateway
      REGION=dc-1


      Trong bản phát hành này, tệp cấu hình chỉ yêu cầu thuộc tính APIGEE_ADMINPW. Bạn có thể xoá 2 thuộc tính còn lại khỏi tệp.
  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. Kiểm thử bản cập nhật bằng cách chạy tiện ích xác thực API 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 này theo mô tả ở trên trong phần Huỷ bỏ một nút Postgres.

Để 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.17.09.

Quy trình cập nhật lên phiên bản 4.17.09 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.17.09 cục bộ:

  1. Nếu bạn đang dùng tính năng sao chép chính và 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.
  2. Tạo một bản repo 4.17.09 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 thiết lập apigee của Edge.
    Lưu ý: Nếu đã có sẵn một kho lưu trữ 4.16.01 hoặc 4.16.05, bạn có thể thêm kho lưu trữ 4.17.09 vào kho lưu trữ đó như mô tả trong phần "Cập nhật kho lưu trữ Apigee cục bộ" 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.17.09.tar.gz:
      > /optgee/apigee-service/bin/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 giải phóng tệp vào thư mục /tmp:
      > tar -xzf apigee-4.17.09.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.17.09.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.17.09.sh xuống /tmp/bootstrap_4.17.09.sh và đặt tên người dùng ở trên là /tmp/bootstrap_4.17.09.sh:
      > /usr/bin/curl http://uName:pWord@remoterepName:3939/bootstrap_4.17.17.09_rapt.

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

  5. Sử dụng apigee-service để cập nhật tiện ích apigee-setup:
    1. Nếu đã cài đặt phiên bản 4.16.01 bằng cách nâng cấp Edge phiên bản 4.15.07.0x, bạn phải cài đặt tiện ích apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup cài đặt

      Lệnh này sẽ cài đặt tiện ích update.shapie trong /optge-setup/apige

      Nếu bạn đã cài đặt tiện ích apigee-setup, hãy cập nhật tiện ích đó:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup cập nhật
    2. Nếu đã cài đặt trực tiếp phiên bản 4.16.01, tức là bạn không nâng cấp từ phiên bản 4.15.07.0x, bạn phải cập nhật tiện ích apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update/bin/apigee-service apigee-setup

      Bản cập nhật này sẽ cài đặt apigee-service. apigee-service .
    3. Nếu đã cài đặt trực tiếp phiên bản 4.16.05 hoặc qua bản cập nhật, bạn phải cập nhật tiện ích apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      Bản cập nhật này cho apigee-service sẽ cài đặt tiện ích update.sh trong /optgee-setup/apigee
  6. Tuỳ thuộc vào phiên bản Edge hiện tại, bạn phải cài đặt hoặc cập nhật tiện ích apigee-validate trên Máy chủ quản lý.
    1. Nếu bạn đang sử dụng Edge 4.16.05: hãy 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
    2. Nếu bạn đang dùng Edge 4.16.01: hãy cài đặt tiện ích apigee-validate trên Tiện ích apigee-validate trên Máy chủ quản lý:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate




    3. Nếu bạn đang nâng cấp từ phiên bản 4.16.01: Hãy chỉnh sửa tệp cấu hình được chuyển đến tiện ích apigee-validate. Trong bản phát hành Edge 4.16.01, tệp cấu hình mà apigee-validate sử dụng bắt buộc phải có các thuộc tính sau:
      APIGEE_ADMINPW=sysadminPword
      MP_POD=gateway
      REGION=dc-1


      Trong bản phát hành này, tệp cấu hình chỉ yêu cầu thuộc tính APIGEE_ADMINPW. Bạn có thể xoá 2 thuộc tính còn lại khỏi tệp.
  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. Kiểm thử bản cập nhật bằng cách chạy tiện ích xác thực API 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 phần Huỷ bỏ một nút Postgres.

Để 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.17.09.

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. Thiết lập 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. Nếu cập nhật từ phiên bản 4.16.01, hãy hạ cấp Zookeeper:
    > yum xuống cấp apigee-zookeeper
  3. Cập nhật Cassandra và ZooKeeper:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Thiết lập quy tắc iptables sau:
    > sudo iptables -A input -p tcp --destination-port 5672 ! –s `tên máy chủ` -i eth0 -j THẢO LUẬN
  5. Kiểm tra hàng đợi tin nhắn Qpid:
    > qpid-stat -q

    Tiếp tục kiểm tra hàng đợi cho đến khi số lượng trong cột "msg" là 0. Bạn không thể nâng cấp Qpid cho đến khi ứng dụng này xử lý xong tất cả tin nhắn.
  6. Cập nhật qpidd:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Xoá iptables:
    > sudo iptables -F
  8. Cập nhật LDAP:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  9. 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
  10. Cập nhật postgresql:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  11. Cập nhật cơ sở dữ liệu Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  12. 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
  13. 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. Thiết lập 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. Nếu cập nhật từ phiên bản 4.16.01, hãy hạ cấp Zookeeper trên máy 1:
    > yum hạ cấp apigee-zookeeper
  3. Cập nhật Cassandra và ZooKeeper trên máy 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Thiết lập quy tắc iptables sau trên máy 2:
    > sudo iptables -A input -p tcp --destination-port 5672 ! –s `tên máy chủ` -i eth0 -j THẢO LUẬN
  5. Kiểm tra hàng đợi thông báo Qpid trên máy 2:
    > qpid-stat -q

    Tiếp tục kiểm tra hàng đợi cho đến khi số lượng trong cột "msg" là 0. Bạn không thể nâng cấp Qpid cho đến khi ứng dụng này xử lý xong tất cả tin nhắn.
  6. Cập nhật qpidd trên máy 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Xoá iptables trên máy 2:
    > sudo iptables -F
  8. Cập nhật LDAP trên máy 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  9. 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
  10. 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
  11. 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 và máy 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  12. 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. Thiết lập 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.
  3. Nếu cập nhật từ phiên bản 4.16.01, hãy hạ cấp Zookeeper trên macine 1, 2 và 3:
    > yum hạ cấp apigee-zookeeper
  4. 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
  5. Thiết lập quy tắc iptables sau đây trên máy 4:
    > sudo iptables -A input -p tcp --destination-port 5672 ! –s `tên máy chủ` -i eth0 -j THẢO LUẬN
  6. Kiểm tra hàng đợi thông báo Qpid trên máy 4:
    > qpid-stat -q

    Tiếp tục kiểm tra hàng đợi cho đến khi số lượng trong cột "msg" là 0. Bạn không thể nâng cấp Qpid cho đến khi ứng dụng này xử lý xong tất cả tin nhắn.
  7. Cập nhật qpidd trên máy 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Xoá iptables trên máy 4:
    > sudo iptables -F
  9. Lặp lại các bước từ 5 đến 8 trên máy 5.
  10. Cập nhật LDAP trên máy 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. 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
  12. 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
  13. 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. 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-postgresql dừng
    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ờ.
  14. 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
  15. Hãy đả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 bài viết Huỷ bỏ một nút Postgres.

Đố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. Thiết lập 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.
  3. Nếu cập nhật từ phiên bản 4.16.01, hãy hạ cấp Zookeeper trên macine 1, 2 và 3:
    > yum hạ cấp apigee-zookeeper
  4. 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
  5. Thiết lập quy tắc iptables sau trên máy 6:
    > sudo iptables -A input -p tcp --destination-port 5672 ! –s `tên máy chủ` -i eth0 -j THẢO LUẬN
  6. Kiểm tra hàng đợi thông báo Qpid trên máy 6:
    > qpid-stat -q

    Tiếp tục kiểm tra hàng đợi cho đến khi số lượng trong cột "msg" là 0. Bạn không thể nâng cấp Qpid cho đến khi ứng dụng này xử lý xong tất cả tin nhắn.
  7. Cập nhật qpidd trên máy 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Xoá iptables trên máy 6:
    > sudo iptables -F
  9. Lặp lại các bước từ 5 đến 8 trên máy 7.
  10. Cập nhật LDAP trên máy 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. 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
  12. 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
  13. 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. 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-postgresql dừng
    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ờ.
  14. 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
  15. Hãy đả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 bài viết Huỷ bỏ một nút Postgres.

Đố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. Thiết lập 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.
  3. Nếu cập nhật từ phiên bản 4.16.01, hãy hạ cấp Zookeeper trên macine 1, 2 và 3:
    > yum hạ cấp apigee-zookeeper
  4. 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
  5. Thiết lập quy tắc iptables sau trên máy 12:
    > sudo iptables -A input -p tcp --destination-port 5672 ! –s `tên máy chủ` -i eth0 -j THẢO LUẬN
  6. Kiểm tra hàng đợi thông báo Qpid trên máy 12:
    > qpid-stat -q

    Tiếp tục kiểm tra hàng đợi cho đến khi số lượng trong cột "msg" là 0. Bạn không thể nâng cấp Qpid cho đến khi ứng dụng này xử lý xong tất cả tin nhắn.
  7. Cập nhật qpidd trên máy 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Xoá iptables trên máy 12:
    > sudo iptables -F
  9. Lặp lại các bước từ 5 đến 8 trên máy 13.
  10. Cập nhật LDAP trên máy 4 và 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. 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
  12. 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
  13. 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. 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-postgresql dừng
    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ờ.
  14. 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
  15. Hãy đả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 bài viết Huỷ bỏ một nút Postgres.

Đố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. Thiết lập 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.
  3. Cập nhật Cassandra và ZooKeeper:
    1. Nếu cập nhật từ phiên bản 4.16.01, hãy hạ cấp Zookeeper trên macine 1, 2 và 3 trong Data Center 1:
      > yum hạ cấp apigee-zookeeper
    2. 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
    3. Nếu cập nhật từ phiên bản 4.16.01, hãy hạ cấp Zookeeper trên macine 7, 8 và 9 trong Data Center 2:
      > yum hạ cấp apigee-zookeeper
    4. 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. Thiết lập quy tắc iptables sau trên máy 4:
        > sudo iptables -A input -p tcp --destination-port 5672 ! –s `tên máy chủ` -i eth0 -j THẢO LUẬN
      2. Kiểm tra hàng đợi thông báo Qpid trên máy 4:
        > qpid-stat -q

        Tiếp tục kiểm tra hàng đợi cho đến khi số lượng trong cột "msg" là 0. Bạn không thể nâng cấp Qpid cho đến khi ứng dụng này xử lý xong tất cả thông báo.
      3. Cập nhật qpidd trên máy 4:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. Xoá iptables trên máy 4:
        > sudo iptables -F
      5. Lặp lại các bước từ 1 đến 4 trên máy 5.
    2. Máy 10, 11 trong Trung tâm dữ liệu 2
      1. Thiết lập quy tắc iptables sau trên máy 10:
        > sudo iptables -A input -p tcp --destination-port 5672 ! –s `tên máy chủ` -i eth0 -j THẢO LUẬN
      2. Kiểm tra hàng đợi thông báo Qpid trên máy 10:
        > qpid-stat -q

        Tiếp tục kiểm tra hàng đợi cho đến khi số lượng trong cột "msg" là 0. Bạn không thể nâng cấp Qpid cho đến khi ứng dụng này xử lý xong tất cả thông báo.
      3. Cập nhật qpidd trên máy 10:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. Xoá iptables trên máy 10:
        > sudo iptables -F
      5. Lặp lại các bước từ 1 đến 4 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. 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-postgresql dừng
    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. Hãy đả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 bài viết Huỷ bỏ một nút Postgres.

Đối với API gồm 7 máy chủ hoặc 10 máy chủ lưu trữ cần cài đặt BaaS

Đố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. đã đặt tên
  4. LDAP
  5. Edge, có nghĩa là cấu hình "-c Edge" trên tất cả các nút theo thứ tự: nút có máy chủ Qpid nhưng không có 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" trong bước 8.
  6. Giao diện người dùng Edge
  7. postgresql trên bậc thầy Postgres, bao gồm cả việc nâng cấp.
  8. postgresql ở chế độ chờ Postgres.
  9. Edge, nghĩa là cấu hình "-c cạnh" trên tất cả các nút Qpid và Postgres kết hợp, hoặc trên bất kỳ nút Postgres độc lập nào.