Cập nhật Apigee Edge 4.16.09 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.16.09.0x lên 4.17.09 bằng quy trình này.

Nếu có phiên bản Edge trước phiên bản 4.16.01, 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.17.09.

Người có thể thực hiện việc 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 dưới quyền root.

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

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

Bạn phải cập nhật tất cả các thành phần của 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.

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 Trình định tuyến và Trình 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ể sử 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 DROP
  • Chờ hàng đợi Qpid trống để đảm bảo rằng nút Qpid đã xử lý tất cả thông báo trước khi cập nhật. Sử dụng lệnh sau để đảm bảo rằng 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à Trình 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, 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 `hostname` -i eth0 -j DROP

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

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

Bạn phải bật Extra Packages for Enterprise Linux (hoặc EPEL) để cài đặt hoặc cập nhật Edge. Lệnh bạn sử dụng tuỳ thuộc vào phiên bản RedHat/CentOS:

  • Đối với RedHat/CentOS/Oracle 7.x:
    > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm
  • Đối với RedHat/CentOS/Oracle 6.x:
    wget https://dl.fsoraproject.org/pub/epel/epel-release-things-6.noarch.RPM; RPM -ivh epel-release-Latest-6.noarch.RPM

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ừ ngày 4.17.01, thì bạn phải thiết lập 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 bổ sung khả năng hỗ trợ 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.

Tham 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 tính năng 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 một quy trình cài đặt đám mây riêng tư Apigee Edge hiện có. 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. 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 đăng nhập 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 thông tin đăng nhập đó.

Hãy 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 sử dụng trường tên tài khoản Active Directory SAM 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 một 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 phiên bả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 làm tên người dùng.

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 quá trình cập nhật.

Cập nhật các đ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. Hãy sử dụng quy trình cho phiên bản Edge hiện tại để 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ề tính năng 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ý lỗi 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 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 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 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 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 ngừng hoạt động hoặc bản cập nhật định kỳ cho phép bạn cập nhật chế độ cài đặt Edge mà không khiến Edge bị gỡ xuống.

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

Chìa khoá để nâng cấp sao cho không bị gián đoạn 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 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 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 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 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 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. Đảm bảo có thể truy cập vào Trình xử lý thông báo.
      2. Đảm bảo có thể truy cập vào Bộ định tuyến.
  • 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 nút Trình 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 kết nối với Trình xử lý tin nhắn.

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 thầm phải giống với tệp bạn đã dùng để cài đặt Edge 4.16.09.

Quy trình cập nhật lên phiên bản 4.17.09 trên 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 như mô tả trong phần Cài đặt tiện ích thiết lập apigee-setup của Edge.
  5. Bật kho lưu trữ EPEL như mô tả ở trên.
  6. 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
  7. 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
  8. Cài đặt tiện ích apigee-service và các phần phụ thuộc 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 từ đó.

    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ần cài đặt Java
    Q = Thoát. Đối với tuỳ chọn này, bạn phải tự cài đặt Java.
  9. 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 cập nhật
  10. 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
  11. Cập nhật tiện ích apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  12. 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
  13. 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 một 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 bằng repo cục bộ để các nút khác có thể truy cập vào đó. Apigee cung cấp máy chủ web Nginx để bạn sử dụng, hoặc bạn có thể 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ữ 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-setup của Edge.
    Lưu ý: Nếu đã có kho lưu trữ 4.16.09, 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-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 và các phần phụ thuộc Edge apigee-service từ /tmp/repos:
      > sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Lưu ý rằng bạn thêm đường dẫn đến thư mục lưu trữ 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. Trên nút từ xa, hãy tải tệp bootstrap_4.17.09.sh của Edge xuống /tmp/bootstrap_4.17.09.sh:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh

      trong đó uName:pWord là tên người dùng và mật khẩu mà bạn đã đặt ở trên cho kho lưu trữ và 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 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 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 yêu cầu cài đặt độc lập gồm 1 máy chủ lưu trữ

  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. Cập nhật Cassandra và ZooKeeper:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Đặt quy tắc iptables sau:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  4. 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ả thông báo.
  5. Cập nhật qpidd:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Xoá sạch iptables:
    > sudo iptables -F
  7. Cập nhật postgresql:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  8. Khởi động postgresql:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  9. Cập nhật LDAP:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  10. 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
  11. 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ủ

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. 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:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Đặt quy tắc iptables sau trên máy 2:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  4. Kiểm tra hàng đợi tin nhắn 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ả thông báo.
  5. Cập nhật qpidd trên máy 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Xoá sạch iptables trên máy 2:
    > sudo iptables -F
  7. Cập nhật postgresql trên máy 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  8. Khởi động postgresql trên máy 2:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  9. Cập nhật LDAP trên máy 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  10. 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
  11. 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ủ

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. Đặ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. Đặt quy tắc iptables sau trên máy 4:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  4. Kiểm tra hàng đợi tin nhắn 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 Qpid xử lý xong tất cả thông báo.
  5. Cập nhật qpidd trên máy 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Xoá sạch iptables trên máy 4:
    > sudo iptables -F
  7. Lặp lại các bước từ 3 đến 6 trên máy 5.
  8. Cập nhật postgresql trên máy 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  9. Khởi động postgresql trên máy 4:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  10. Lặp lại các bước 8 và 9 trên máy 5.
  11. Cập nhật LDAP trên máy 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  12. 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
  13. 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. Đặ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. Đặt quy tắc iptables sau đây trên máy 6:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  4. Kiểm tra hàng đợi tin nhắn 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ả thông báo.
  5. Cập nhật qpidd trên máy 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Xoá các iptables trên máy 6:
    > sudo iptables -F
  7. Lặp lại các bước từ 3 đến 6 trên máy 7.
  8. Cập nhật postgresql trên máy 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  9. Khởi động postgresql trên máy 6:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  10. Lặp lại bước 8 và bước 9 trên máy 7.
  11. 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
  12. 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
  13. 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. Đặt SMTPMAILFROM trong tệp cấu hình nếu bạn đã bật SMTP trên Edge. Thông số này có dạng:
    SMTPmailFROM="Công ty của tôi <myco@company.com>"
  2. Cập nhật Cassandra và ZooKeeper trên máy 1, 2 và 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Đặt quy tắc iptables sau trên máy 12:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  4. 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 Qpid xử lý xong tất cả thông báo.
  5. Cập nhật qpidd trên máy 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Xoá các iptables trên máy 12:
    > sudo iptables -F
  7. Lặp lại các bước từ 3 đến 6 trên máy 13.
  8. Cập nhật postgresql trên máy 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  9. Khởi động postgresql trên máy 12:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  10. Lặp lại bước 8 và 9 trên máy 13.
  11. Cập nhật LDAP trên máy 4 và 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  12. 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
  13. 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ủ

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. 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:
    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. Đặt quy tắc iptables sau trên máy 4:
        > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
      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á các 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. Đặt quy tắc iptables sau trên máy 10:
        > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
      2. Kiểm tra hàng đợi tin nhắn 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á sạch 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.
  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 start
  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ữ

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

# Specify the from address of generated emails.
SMTPMAILFROM="My Company <myco@company.com>"

Để biết ví dụ đầy đủ về tệp cấu hình, hãy xem phần Cài đặt API BaaS.

Bạn cũng phải đảm bảo cổng 2551 đang mở trên tất cả các nút Stack để truy cập từ tất cả các nút Stack khác.

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. 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 việc cài đặt API BaaS có 10 máy chủ lưu trữ

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

# Specify the from address of generated emails.
SMTPMAILFROM="My Company <myco@company.com>"

Để biết ví dụ đầy đủ về tệp cấu hình, hãy xem phần Cài đặt API BaaS.

Bạn cũng phải đảm bảo cổng 2551 đang mở trên tất cả các nút Stack để truy cập từ tất cả các nút Stack khác.

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. 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 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
  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 trường hợp cài đặt không theo tiêu chuẩn

Nếu bạn có một quá trình cài đặt không 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à cấu hình "-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ý, Bộ xử lý thư 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 hồ sơ "-c edge".
  6. Giao diện người dùng Edge