Cập nhật Apigee Edge 4.17.01/4.17.05 lên 4.17.09

Edge for Private Cloud v. 4.17.09

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

Bạn có thể cập nhật Apigee Edge phiên bản 4.17.01.0x/4.17.05.0x lên 4.17.09 bằng cách làm theo quy trình này.

Nếu 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.17.09.

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 với tài khoản gốc.

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

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.

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

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.

Bắt buộc phải thêm tham 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 đ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 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.

Tham số này có dạng:

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

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

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

    Điều này cho phé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ề 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 đang hoạt động trong quá trình cập nhật bằng cách sử dụng lệnh:

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

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

Trong trường hợp không cập nhật được, 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à tiếp tục cập nhật từ điểm dừng trước đó.

Nếu lỗi này yêu cầu 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.

Ghi nhật ký thông tin cập nhật

Theo mặc định, tiện ích update.sh 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 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 có thời gian ngừng hoạt động

Bản cập nhật không có thời gian ngừng hoạt động (còn gọi là bản cập nhật lăn) 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ó thời gian ngừng hoạt động với cấu hình 5 nút trở lên.

Chìa khoá để nâng cấp mà không có thời gian ngừng hoạt động là xoá từng Trình định tuyến khỏi bộ cân bằng tải. Sau đó, bạn cập nhật Trình định tuyến và mọi thành phần khác trên cùng một máy với Trình định tuyến, sau đó thêm Trình đị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ự cài đặt như mô tả bên dưới 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 chế độ không thể truy cập vào bộ định tuyến đó, như mô tả trong phần Bật/Tắt khả năng truy cập vào máy chủ (Trình xử lý thông báo/Bộ định tuyến).
  3. Cập nhật Trình đị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 Trình định tuyến. Tất cả cấu hình Edge đều hiển thị một Bộ định tuyến và Trình xử lý thông báo trên cùng một nút.
  4. Khôi phục khả năng kết nối với Bộ định tuyến.
  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 kết hợp Bộ định tuyến và Trình xử lý thông báo:
    • Trước khi cập nhật – hãy thực hiện những việc sau:
      1. Làm cho Bộ định tuyến không thể truy cập được.
      2. Không thể kết nối với Trình xử lý thông báo.
    • Sau khi cập nhật, hãy thực hiện những việc sau:
      1. Kết nối với Trình xử lý tin nhắn.
      2. Làm cho Bộ định tuyến có thể kết nối được.
  • Trên một nút Bộ định tuyến:
    • Trước khi cập nhật, hãy khiến Bộ định tuyến không thể truy cập được.
    • Sau khi cập nhật, hãy đảm bảo bạn có thể truy cập vào 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 khiến Trình xử lý thông báo không thể truy cập được.
    • Sau khi cập nhật, hãy đảm bảo có thể truy cập vào Trình xử lý thông báo.

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 vào lệnh cập nhật. Tệp cấu hình cài đặt âm thầm phải giống với tệp bạn đã dùng để cài đặt Edge 4.17.01.

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

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 công việc 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.
  2. Đăng nhập vào nút của bạn làm thư mục gốc để cài đặt RPM cạnh.
    Lưu ý: Mặc dù việc 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.
  3. Cài đặt yum-utils và yum-plugin-priorities:
    > sudo yum install yum-utils
    > sudo yum install yum-plugin-priorities
  4. Tắt SELinux theo mô tả trong phần Cài đặt tiện ích thiết lập Edge apigee.
  5. 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 rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  6. 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
  7. Cài đặt tiện ích và các 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 từ Apigee. Nếu bỏ qua pWord, bạn sẽ được nhắc nhập thông tin này.

    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 không, ứng dụ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 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 tuỳ chọn này, bạn phải tự cài đặt Java.
  8. Dùng apigee-service để cập nhật phần mềm tiện ích apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup
  9. 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 update
  10. Cập nhật tiện ích apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  11. 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":
    > /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 có thể truy cập hoặ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ể 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ý, Trình 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ỉ sử 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
  12. 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ử quá trình 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 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 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 cách nào đó, thì bạn có thể 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 máy chủ đó. 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.17.09 cục bộ:

  1. Tạo một kho lưu trữ cục bộ 4.17.09 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ó kho lưu trữ 4.17.01/4.17.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.
  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 /opt/apigee/data/apigee-mirror/apigee-4.17.09.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 này vào thư mục /tmp trên nút mới.
    3. Trên nút mới, giải nén tệp vào thư mục /tmp:
      > tar -xzf apigee-4.17.09.tar.gz

      Lệnh này sẽ 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 dịch vụ apigee và các 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 phải thêm đường dẫn đến thư mục repos trong 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 thiết lập API Edge.
    2. – Tải tệp Edge bootstrap_4.17.09.sh


    3. Trên nút từ xa, hãy cài đặt tiện ích và phần phụ thuộc dịch vụ apigee của Edge:
      > sudo bash /tmp/bootstrap_4.17.09.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:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. 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
  6. Cập nhật tiện ích apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. 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":
    > /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 có thể truy cập hoặc đọc tệp cấu hình.

    Hãy 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ể 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ý, Trình 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ỉ sử 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ử quá trình 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 Quy trình khôi phục 4.17.09.

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

Thứ tự cập nhật 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.
  • Đối với mọi máy có nhiều thành phần Edge (Máy chủ quản lý, Trình xử lý thông báo, Trình đị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 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 chế độ Kiếm tiền. Giá trị này được cập nhật khi bạn chỉ định tuỳ chọn "-c edge".

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

  1. Nếu bạn cập nhật từ ngày 17 tháng 4 năm 2001, hãy thiết lập SMTPmailFROM trong tệp cấu hình nếu bạn đã bật SMTP trên Edge. Tham số này có dạng:
    SMTPMAILFROM="My Company <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 và Postgres:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. Bắt đầu postgresql:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql bắt đầu
  5. Cập nhật Giao thức truy cập thư mục hạng nhẹ (LDAP):
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Cập nhật các thành phần Edge còn lại:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. 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 chế độ cài đặt độc lập 2 máy chủ

Xem phần Cấu hình cài đặt để biết danh sách cấu hình Edge và số nút.

  1. Nếu bạn cập nhật từ ngày 17 tháng 4 năm 2001, hãy 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. 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 và Postgres trên máy 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. Bắt đầu postgresql trên máy 2:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  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 2 và 1:
    > /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

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

Hãy xem phần Thông tin xin lỗi về việc cài đặt để biết danh sách các cấu trúc liên kết của Edge và số nút.

  1. Nếu bạn cập nhật từ ngày 17 tháng 4 năm 2001, hãy thiết lập SMTPmailFROM trong tệp cấu hình nếu bạn đã bật SMTP trên Edge. Tham số này có dạng:
    SMTPMAILFROM="My Company <myco@company.com>"
  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 Qpid và Postgres trên máy 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. Khởi động postgresql trên máy 4:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. Lặp lại bước 3 và 4 trên máy 5.
  6. Cập nhật Giao thức truy cập thư mục hạng nhẹ (LDAP) trên máy 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  7. 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
  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 cài đặt cụm 9 máy chủ

Xem phần Cấu hình cài đặt để biết danh sách cấu hình Edge và số nút.

  1. Nếu bạn đang 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. Tham số này có dạng:
    SMTPMAILFROM="My Company <myco@company.com>"
  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 Qpid và Postgres trên máy 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. Khởi động postgresql trên máy 6:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. Lặp lại bước 3 và 4 trên máy 7.
  6. Cập nhật LDAP trên máy 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  7. 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ự đó:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  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 quá trình cài đặt theo cụm 13 máy chủ lưu trữ

Hãy xem phần Thông tin xin lỗi về việc cài đặt để biết danh sách các cấu trúc liên kết của Edge và số nút.

  1. Nếu bạn đang 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. Tham số này có dạng:
    SMTPMAILFROM="My Company <myco@company.com>"
  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 Qpid và Postgres trên máy 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. Khởi động postgresql trên máy 12:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. Lặp lại bước 3 và 4 trên máy 13.
  6. Cập nhật LDAP trên máy 4 và 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  7. 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ự đó:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  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 một cài đặt cụm 12 máy chủ

Xem phần Cấu hình cài đặt để biết danh sách cấu hình Edge và số nút.

  1. Nếu bạn đang 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:
    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
  3. 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.
  4. 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
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
    2. Máy 12 trong Trung tâm dữ liệu 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql bắt đầu
  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, 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
  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

Đối với việc cài đặt API BaaS có 7 máy chủ lưu trữ

  1. Đặt SMTPMAILFROM trong tệp cấu hình. Tham số này có dạng:
    SMTPMAILFROM="My Company <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 Cổng thông tin API BaaS trên máy 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Đối với việc cài đặt API BaaS có 10 máy chủ lưu trữ

  1. Hãy đặt SMTPmailFROM trong tệp cấu hình. Tham số này có dạng:
    SMTPMAILFROM="My Company <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 Cổng thông tin API BaaS trên máy 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

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

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. Hãy thiết lập SMTPmailFROM trong các 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ỉ cần chạy bước này một lần trên bất kỳ máy chủ Cassandra nào trong một trong hai trung tâm dữ liệu:

    Lưu ý: Tất cả các lệnh bên dưới đều đặt hệ số sao chép thành "3", cho biết ba nút Cassandra trong cụm. Sửa đổi giá trị này nếu cần cho quá trình cài đặt.
    1. Khởi động tiện ích cqlsh Cassandra:
      > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
    2. Thực thi các lệnh CQL sau tại lời nhắc "cqlsh>" để đặt cấp độ sao chép cho các không gian khoá Cassandra:
      1. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      2. cqlsh> ALTER KEYSPACE "Apigee_Baas" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      3. cqlsh> ALTER KEYSPACE "Apigee_Baas_Locks" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      4. cqlsh> ALTER KEYSPACE "system_traces" CÓ tính năng sao chép = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      5. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH replication = { '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:
        cqlsh> select * from system.schema_keyspaces;
      7. Thoát khỏi cqlsh:
        cqlsh> exit
  3. (Chỉ áp dụng nếu 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ỉ áp dụng nếu 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 Cổng 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 p -f configFile
  10. Cập nhật Cổng 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 p -f configFile
  11. Cập nhật các giá trị không gian khoá BaaS. Bạn phải thiết lập các không gian khoá này để sao chép tại thời điểm cài đặt, nhưng không nhất thiết phải thiết lập tại thời điểm chạy. Việc xoá tính năng sao chép cũng giúp tiết kiệm bộ nhớ Cassandra.

    Bạn chỉ cần chạy bước này một lần trên bất kỳ máy chủ Cassandra nào trong một trong hai trung tâm dữ liệu:
    1. Khởi động tiện ích cqlsh Cassandra:
      > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
    2. Thực thi các lệnh CQL sau đây để đặt mức độ sao chép cho không gian khoá Cassandra:
      1. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3' };
      2. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-2': '3' };
      3. Xem các không gian khoá bằng cách sử dụng lệnh:
        cqlsh> select * from system.schema_keyspaces;
      4. Thoát cqlsh:
        cqlsh> exit

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

Nếu bạn cài đặt không theo 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, nghĩa là hồ sơ "-c edge" trên tất cả các nút theo thứ tự: các nút có máy chủ Qpid, máy chủ Postgres, Máy chủ quản lý, Trình xử lý thông báo và Trình đị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 hồ sơ "-c Edge".
  6. Giao diện người dùng Edge