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

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

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

Bạn chỉ có thể cập nhật Apigee Edge phiên bản 4.16.01.x lên 4.16.05.

Nếu có phiên bản Edge cũ hơn phiên bản 4.16.01.x, thì trước tiên, bạn phải di chuyển sang phiên bản 4.16.01.x rồi cập nhật lên phiên bản 4.16.05.

Người có thể thực hiện cập nhật

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

Sau khi bạn cài đặt RPM của Edge, mọi người dùng đều có thể định cấu hình các RPM đó.

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 bạn chưa cài đặt Java JDK 8, tập lệnh cập nhật có thể cài đặt cho bạn.

Trong bản cập nhật lên Java 8, một số mật mã TLS không còn được cung cấp trong Oracle JDK 8. Để xem danh sách đầy đủ, hãy xem phần "Default Disabled Cipher Suites" (Bộ thuật toán mật mã bị tắt theo mặc định) tại http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.

Cảnh báo: Bản phát hành Edge này không hỗ trợ JDK 7. Nếu đang sử dụng JDK 7, bạn phải nâng cấp lên JDK 8. Nếu khôi phục bản cài đặt Edge 4.16.05, bạn có thể tuỳ ý định cấu hình lại Edge để sử dụng Java JDK 7.

Đang hạ cấp Zookeeper

Phiên bản của Zookeeper RPM trong Edge 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 Edge tiếp theo, phiên bản Zookeeper đã được thay đổi trở lại thành apigee-zookeeper-3.4.5-0.0.948. Việc này ngăn yum nâng cấp Zookeeper lên phiên bản mới hơn từ 4.16.01. Cách khắc phục tình trạng này là chạy yum downgrade apigee-zookeeper trước khi cập nhật Zookeeper.

Bạn có thể kiểm tra phiên bản Zookeeper bằ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.

Yêu cầu về dung lượng ổ đĩa để cập nhật

Đảm bảo rằng bạn có ít nhất 1 GB dung lượng ổ đĩa trống trước khi thực hiện cập nhật.

Tự động truyền các chế độ cài đặt thuộc tính từ phiên bản 4.16.01.x

Nếu bạn đã đặt 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ì các giá trị này sẽ được giữ lại trong bản cập nhật.

Cập nhật tiện ích apigee-validate

Trong phiên bản 4.16.01, bạn đã cài đặt và chạy tiện ích apigee-validate trên một nút Trình xử lý thông báo. Trong phiên bản 4.16.05, tiện ích apigee-validate đã được cập nhật để chạy trên nút Máy chủ quản lý.

Khi cập nhật lên phiên bản 4.16.05, bạn có hai lựa chọn về cách cập nhật tiện ích apigee-validate:

  1. Apigee đề xuất – Cài đặt và chạy tiện ích apigee-validate trên nút Máy chủ quản lý.

    Bạn có thể gỡ cài đặt tiện ích apigee-validate khỏi các nút Bộ xử lý thông báo (không bắt buộc). Nếu để tệp này trên nút Bộ xử lý thông báo, bạn phải cập nhật tệp này lên phiên bản 4.16.05.
  2. Ngoài ra, hãy cập nhật tiện ích apigee-validate trên nút Bộ xử lý thông báo rồi chạy tiện ích đó từ đó. Tuy nhiên, Apigee khuyên bạn nên cài đặt và chạy công cụ này từ Máy chủ quản lý.

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

Hãy đảm bảo đáp ứng các đ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 vì lý do an toàn. Sử dụng quy trình cho phiên bản Edge hiện tại của bạn để thực hiện sao lưu.

    Điều này giúp bạn có một kế hoạch dự phòng trong trường hợp bản 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ề tính năng sao lưu, hãy xem phần Sao lưu và khôi phục.
  • Đảm bảo Edge đang chạy
    Đảm bảo rằng Edge đang hoạt động trong quá trình cập nhật bằng cách sử dụng lệnh:

    > /<inst_root>/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 bản cập nhật nhiều lần và bản cập nhật sẽ tiếp tục từ nơi đã dừng.

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

Đang ghi nhật ký thông tin cập nhật

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 chạy tiện ích update.sh không có quyền truy cập vào thư mục đó, thì tiện ích này sẽ ghi nhật ký vào thư mục /tmp dưới dạng tệp có tên 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 không gián đoạn

Bản cập nhật không gây gián đoạn hoặc bản cập nhật cuốn chiếu cho phép bạn cập nhật bản cài đặt Edge mà không cần tắt Edge.

Bạn chỉ có thể cập nhật mà không cần ngừng hoạt động khi có cấu hình 5 nút trở lên.

Chìa khoá để nâng cấp mà không cần ngừng hoạt động là xoá từng Bộ định tuyến, mỗi lần một bộ, khỏi bộ 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 các máy theo đúng thứ tự cho bản cài đặt của bạn 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à đặt trạng thái không thể kết nối, như mô tả trong phần Bật/Tắt khả năng kết nối của máy chủ (Bộ xử lý thông báo/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 Edge khác trên cùng một máy với Bộ định tuyến. Tất cả cấu hình Edge đều cho thấy Bộ định tuyến và Bộ xử lý thông báo trên cùng một nút.
  4. Làm cho Bộ định tuyến có thể truy cập lại.
  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 lưu ý những điều sau trước/sau khi cập nhật:

  • Trên nút Bộ định tuyến và Bộ xử lý thông báo kết hợp:
    • Trước khi cập nhật – hãy làm như sau:
      1. Làm cho Bộ định tuyến không thể truy cập được.
      2. Làm cho Bộ xử lý thông báo không thể truy cập được.
    • Sau khi cập nhật, hãy làm như sau:
      1. Đảm bảo có thể kết nối với Bộ xử lý thông báo.
      2. Đặt Router ở nơi 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 đảm bảo không thể kết nối với Bộ định tuyến.
    • Sau khi cập nhật, hãy đảm bảo có thể kết nối với Bộ định tuyến.
  • Trên một nút Bộ xử lý thông báo:
    • Trước khi cập nhật, hãy đặt Bộ xử lý thông báo ở trạng thái không kết nối được.
    • Sau khi cập nhật, hãy đảm bảo có thể kết nối với Bộ xử lý thông báo.

Sử dụng tệp cấu hình tự động

Bạn phải truyền tệp cấu hình tự động đến lệnh cập nhật. Tệp cấu hình tự động phải giống với tệp bạn đã dùng để cài đặt Edge 4.16.01.

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

Hãy làm theo quy trình sau để cập nhật các thành phần Edge trên một nút:

  1. Nếu có, hãy tắt mọi dịch vụ chạy ngầm theo thời gian định trước đượ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.
  2. Đăng nhập vào nút của bạn dưới dạng người dùng gốc để cài đặt RPM của Edge
    Lưu ý: Mặc dù quá trình cài đặt RPM yêu cầu quyền truy cập gốc, nhưng bạn có thể định cấu hình Edge mà không cần quyền truy cập gốc.
  3. Tắt SELinux như mô tả trong phần Cài đặt tiện ích apigee-setup của Edge.
  4. Tải tệp bootstrap_4.16.05.sh của Edge 4.16.05 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
  5. Cài đặt tiện ích apigee-service của Edge 4.16.05 và các phần phụ thuộc:
    > sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
    trong đó uName:pWord là tên người dùng và mật khẩu bạn nhận được từ Apigee. Nếu bỏ qua pWord, bạn sẽ được nhắc nhập mật khẩu.
    Theo mặc định, trình cài đặt sẽ kiểm tra để đảm bảo bạn đã cài đặt Java 1.8. Nếu bạn chưa cài đặt, thì hệ thống sẽ cài đặt cho bạn. Sử dụng tuỳ chọn JAVA_FIX để chỉ định cách xử lý việc cài đặt Java. JAVA_FIX sử dụng 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 lựa chọn này, bạn phải tự cài đặt Java.
  6. 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 install
      Lệnh này sẽ cài đặt tiện ích update.sh trong <inst_dir>/apigee/apigee-setup/bin.

      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 update
    2. Nếu bạn 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, thì 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 <inst_dir>/apigee/apigee-setup/bin.
  7. 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 install
    Lưu ý: Nếu đã cài đặt tiện ích apigee-validate trên một nút Trình xử lý thông báo, bạn có thể cập nhật tiện ích này bằng cách sử dụng lệnh sau trên nút đó:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    Tuy nhiên, đối với phiên bản 4.16.05, Apigee khuyên bạn nên cài đặt và chạy tiện ích apigee-validate trên Máy chủ quản lý.
  8. 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 trước, tệp cấu hình mà apigee-validate sử dụng yêu cầu 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á hai thuộc tính còn lại khỏi tệp.
  9. 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" bên dưới:
    > /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 hoặc đọc được tệp cấu hình. Ví dụ: đặt tệp vào thư mục /tmp trên nút.
    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 = OpenLDAP
    • cs = Cassandra
    • zk = Zookeeper
    • qpid = qpidd
    • ps = postgresql
    • edge =Tất cả thành phần Edge ngoại trừ Giao diện người dùng Edge: Máy chủ quản lý, Bộ xử lý thông báo, Bộ định tuyến, Máy chủ QPID, Máy chủ Postgres
    • ui = Giao diện người dùng Edge
    • all = cập nhật tất cả thành phần trên máy (chỉ dùng cho hồ sơ cài đặt Edge aio hoặc hồ sơ cài đặt API BaaS asa)
    • e = ElasticSearch
    • b = API BaaS Stack
    • p = API BaaS Portal
    • ebp = ElasticSearch, API BaaS Stack và API BaaS Portal trên cùng một nút
  10. 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.

Để 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 phần 4.16.05 Quy trình khôi phục.

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

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

Sau khi tạo kho lưu trữ Edge cục bộ, bạn có hai 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 kho lưu trữ đó. Apigee cung cấp máy chủ web Nginx để bạn sử dụng hoặc bạn có thể sử dụng máy chủ web của riêng mình.

Cách cập nhật từ kho lưu trữ 4.16.05 cục bộ:

  1. Tạo kho lưu trữ 4.16.05 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ó kho lưu trữ 4.16.01, bạn có thể thêm kho lưu trữ 4.16.05 vào đó.
  2. Cách cài đặt apigee-service từ tệp .tar:
    1. Trên nút có kho lưu trữ cục bộ, hãy sử 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 là /opt/apigee/data/apigee-mirror/apigee-4.16.05.tar.gz:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    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 nén tệp vào thư mục /tmp:
      > tar -xzf apigee-4.16.05.tar.gz
      Lệnh này tạo một thư mục mới, có tên là repos, trong thư mục chứa tệp .tar. Ví dụ: /tmp/repos.
    4. Cài đặt tiện ích và phần phụ thuộc apigee-service của Edge từ /tmp/repos:
      > sudo bash /tmp/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
      Lưu ý rằng bạn phải đưa đường dẫn đến thư mục repos vào lệnh này.
  3. Cách cài đặt apigee-service 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 apigee-setup của Edge.
    2. Trên nút từ xa, hãy tải tệp bootstrap_4.16.05.sh của Edge xuống /tmp/bootstrap_4.16.05.sh:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
      trong đó uName:pWord là tên người dùng và mật khẩu bạn đặt ở trên cho kho lưu trữ, còn remoteRepo là địa chỉ IP hoặc tên DNS của nút kho lưu trữ.
    3. Trên nút từ xa, hãy cài đặt tiện ích apigee-service của Edge và các phần phụ thuộc:
      > sudo bash /tmp/bootstrap_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
      trong đó uName:pWord là tên người dùng và mật khẩu của kho lưu trữ.
  4. 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 install
      Lệnh này sẽ cài đặt tiện ích update.sh trong <inst_dir>/apigee/apigee-setup/bin.

      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 update
    2. Nếu bạn 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, thì 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 <inst_dir>/apigee/apigee-setup/bin.
  5. Cài đặt tiện ích apigee-validate trên nút Máy chủ quản lý:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
    Lưu ý: Nếu đã cài đặt tiện ích apigee-validate trên một nút Trình xử lý thông báo, bạn có thể cập nhật tiện ích đó bằng cách sử dụng lệnh sau trên nút đó:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    Tuy nhiên, đối với phiên bản 4.16.05, Apigee khuyên bạn nên cài đặt và chạy tiện ích apigee-validate trên Máy chủ quản lý.
  6. 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 trước, tệp cấu hình mà apigee-validate sử dụng yêu cầu 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á hai thuộc tính còn lại khỏi tệp.
  7. 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" bên dưới:
    > /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 hoặc đọc được tệp cấu hình. Ví dụ: đặt tệp vào thư mục /tmp trên nút.
    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 = OpenLDAP
    • cs = Cassandra
    • zk = Zookeeper
    • qpid = qpidd
    • ps = postgresql
    • edge =Tất cả thành phần Edge ngoại trừ Giao diện người dùng Edge: Máy chủ quản lý, Bộ xử lý thông báo, Bộ định tuyến, Máy chủ QPID, Máy chủ Postgres
    • ui = Giao diện người dùng Edge
    • all = cập nhật tất cả thành phần trên máy (chỉ dùng cho hồ sơ cài đặt Edge aio hoặc hồ sơ cài đặt API BaaS asa)
    • e = ElasticSearch
    • b = API BaaS Stack
    • p = API BaaS Portal
    • ebp = ElasticSearch, API BaaS Stack và API BaaS Portal trên cùng một nút
  8. 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.

Để 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 phần 4.16.05 Quy trình khôi phục.

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

Thứ tự cập nhật các máy trong quá trình cài đặt Edge là rất quan trọng. Những điểm quan trọng nhất cần cân nhắc khi cập nhật là:

  • Bạn phải cập nhật tất cả nút Cassandra và ZooKeeper trước khi cập nhật bất kỳ nút nào khác.
  • Bạn phải cập nhật tất cả nút qpidd và postgresql trước khi cập nhật bất kỳ nút Bộ định tuyến và Bộ xử lý thông báo nào.
  • Đối với bất kỳ máy nào 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, 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 bước đó 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 được chỉ định.
  • Không có bước riêng để cập nhật tính năng Kiếm tiền. Tệp này sẽ được cập nhật khi bạn chỉ định tuỳ chọn "-c edge".
  • Sau khi cập nhật nút Bộ định tuyến, bạn phải xoá tất cả tệp khỏi thư mục /opt/nginx/conf.d, sau đó khởi động lại Bộ định tuyến.

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

  1. Hạ cấp Zookeeper:
    > yum downgrade apigee-zookeeper
  2. Cập nhật máy 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  3. Xoá mọi tệp trong /opt/nginx/conf.d:
    > rm -f /opt/nginx/conf.d/*
  4. Khởi động lại Bộ định tuyến Edge:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart

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

Xem Cấu trúc liên kết cài đặt để biết danh sách cấu trúc liên kết Edge và số nút.

  1. Hạ cấp Zookeeper trên máy 1:
    > yum downgrade apigee-zookeeper
  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 qpidd và postgresql trên máy 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -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 2 và máy 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Trên nút 1:
    1. Xoá mọi tệp trong /opt/nginx/conf.d:
      > rm -f /opt/nginx/conf.d/*
    2. Khởi động lại Bộ định tuyến Edge:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
  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

Đối với bản cài đặt theo cụm 5 máy chủ

Xem Cấu trúc liên kết cài đặt để biết danh sách cấu trúc liên kết Edge và số nút.

  1. Hạ cấp Zookeeper trên máy 1, 2 và 3:
    > yum downgrade apigee-zookeeper
  2. 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
  3. Cập nhật qpidd và postgresql trên máy 4 và 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -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 4, 5, 1, 2, 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Trên nút 2 và 3:
    1. Xoá mọi tệp trong /opt/nginx/conf.d:
      > rm -f /opt/nginx/conf.d/*
    2. Khởi động lại Bộ định tuyến Edge:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
  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

Đối với bản cài đặt theo cụm gồm 9 máy chủ lưu trữ

Xem Cấu trúc liên kết cài đặt để biết danh sách cấu trúc liên kết Edge và số nút.

  1. Hạ cấp Zookeeper trên máy 1, 2 và 3:
    > yum downgrade apigee-zookeeper
  2. 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
  3. Cập nhật qpidd trên máy 6 và 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Cập nhật postgresql trên máy 8 và 9:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -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, 8, 9, 1, 4 và 5 theo thứ tự sau:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Trên nút 4 và 5:
    1. Xoá mọi tệp trong /opt/nginx/conf.d:
      > rm -f /opt/nginx/conf.d/*
    2. Khởi động lại Bộ định tuyến Edge:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
  8. 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

Đối với một bản cài đặt theo cụm gồm 13 máy chủ lưu trữ

Xem Cấu trúc liên kết cài đặt để biết danh sách cấu trúc liên kết Edge và số nút.

  1. Hạ cấp Zookeeper trên máy 1, 2 và 3:
    > yum downgrade apigee-zookeeper
  2. 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
  3. Cập nhật qpidd trên máy 12 và 13:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Cập nhật postgresql trên máy 8 và 9:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -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, 8, 9, 6, 7, 10 và 11 theo thứ tự sau:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Trên nút 10 và 11:
    1. Xoá mọi tệp trong /opt/nginx/conf.d:
      > rm -f /opt/nginx/conf.d/*
    2. Khởi động lại Bộ định tuyến Edge:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
  8. 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

Đối với bản cài đặt theo cụm gồm 12 máy chủ lưu trữ

Xem Cấu trúc liên kết cài đặt để biết danh sách cấu trúc liên kết Edge và số nút.

  1. Cập nhật Cassandra và ZooKeeper:
    1. Hạ cấp Zookeeper trên máy 1, 2 và 3 trong Trung tâm dữ liệu 1:
      > yum downgrade 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. Hạ cấp Zookeeper trên máy 7, 8 và 9 trong Trung tâm dữ liệu 2:
      > yum downgrade 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
  2. Cập nhật qpidd:
    1. Máy 4, 5 trong Trung tâm dữ liệu 1
      > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. Máy 10, 11 trong Trung tâm dữ liệu 2
      > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Cập nhật postgresql:
    1. Máy 6 trong Trung tâm dữ liệu 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    2. Máy 12 trong Trung tâm dữ liệu 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. 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
  5. Cập nhật các thành phần của Edge:
    1. Máy 4, 5, 6, 1, 2, 3 trong Trung tâm dữ liệu 1
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. Máy 10, 11, 12, 7, 8, 9 trong Trung tâm dữ liệu 2
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    3. Trên nút 2, 3, 8 và 9:
      1. Xoá mọi tệp trong /opt/nginx/conf.d:
        > rm -f /opt/nginx/conf.d/*
      2. Khởi động lại Bộ định tuyến Edge:
        > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
  6. 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

Đối với bản cài đặt API BaaS 7 máy chủ

Xem Cấu trúc liên kết cài đặt để biết danh sách cấu trúc liên kết Edge và số nút.

  1. Cập nhật Cassandra trên máy 5, 6 và 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. 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
  3. Cập nhật Cổng API BaaS trên máy 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Đối với một bản cài đặt API BaaS 10 máy chủ

Xem Cấu trúc liên kết cài đặt để biết danh sách cấu trúc liên kết Edge và số nút.

  1. Cập nhật Cassandra trên máy 8, 9 và 10:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Cập nhật ElasticSearch trên máy 1, 2 và 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  3. Cập nhật API BaaS Stack trên máy 4, 5 và 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  4. Cập nhật Cổng API BaaS trên máy 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Đối với quy trình cài đặt không theo tiêu chuẩn

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

  1. ZooKeeper
  2. Cassandra
  3. qpidd
  4. postgresql
  5. LDAP
  6. Edge, nghĩa là hồ sơ "-c edge" trên tất cả các nút theo thứ tự: Qpid, Postgres, Management Server, Message Processor, Router.
  7. Trên tất cả các nút Bộ định tuyến:
    1. Xoá mọi tệp trong /opt/nginx/conf.d:
      > rm -f /opt/nginx/conf.d/*
    2. Khởi động lại Bộ định tuyến Edge:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
  8. Giao diện người dùng