Cập nhật Apigee Edge 4.51.00 hoặc 4.52.00 hoặc 4.52.01 lên 4.52.02

Apigee hỗ trợ nâng cấp Edge cho Private Cloud trực tiếp từ phiên bản 4.51.00, 4.52.00 hoặc 4.52.01 lên phiên bản 4.52.02. Trang này mô tả cách thực hiện những nâng cấp đó.

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

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

Sau khi bạn cài đặt RPM của cạnh, bất cứ ai 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ả 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ập nhật điều kiện tiên quyết

Đảm bảo 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 để đảm bảo 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 giú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ề 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
    Hãy đảm bảo Edge được thiết lập 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
  • Đảm bảo rằng Chiến lược nén Cassandra là LeveledCompactionStrategy
    Đảm bảo rằng chiến lược nén Cassandra được thiết lập thành LeveledCompactionStrategy, như mô tả trong bài viết Thay đổi chiến lược nén Cassandra.

Những bước đặc biệt cần cân nhắc khi nâng cấp

Để nâng cấp lên Edge cho Private Cloud 4.52.02, hãy cân nhắc chạy các bước cụ thể để nâng cấp một số phần mềm nhất định. Các bước cần thiết phụ thuộc vào phiên bản hiện tại của bạn. Hãy tham khảo bảng dưới đây để biết những phần mềm khác nhau có yêu cầu các bước bổ sung. Các phần sau của trang này cung cấp các nội dung thảo luận chi tiết và các bước chính xác cho từng phần mềm.

Phiên bản hiện tại Phần mềm yêu cầu các bước đặc biệt để nâng cấp lên phiên bản 4.52.02
4.52.01 Cassandra
4.52.00 Cassandra, Người giữ vườn thú, Qpid
4.51.00 Cassandra, người giữ vườn thú, Qpid, Postgres

Tự động áp dụng các 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.

Nâng cấp bắt buộc lên Cassandra 3.11.16

Apigee Edge cho Private Cloud 4.52.02 đã nâng cấp Cassandra lên phiên bản 3.11.16. Cassandra là một thành phần quan trọng của Apigee. Bản nâng cấp này cũng cập nhật phần mềm trình điều khiển trong nhiều thành phần quản lý và thời gian chạy dùng để truy vấn và ghi vào Cassandra.

Vì đây là một bản nâng cấp lớn, nên bạn cần thực hiện một số thay đổi đối với mô hình dữ liệu của Apigee trong Cassandra để đảm bảo hiệu suất tối ưu trong các phiên bản mới. Mặc dù những thay đổi này rất nhỏ, nhưng quá trình nâng cấp sẽ làm gián đoạn một số API quản lý, ảnh hưởng đến cả giao diện người dùng Apigee và cổng thông tin dành cho nhà phát triển. Tài liệu dưới đây nêu rõ các API chính xác sẽ không hoạt động và trình bày các bước trong quá trình nâng cấp khi quá trình gián đoạn bắt đầu và kết thúc. Quan trọng là việc nâng cấp sẽ không làm gián đoạn lưu lượng truy cập trong thời gian chạy.

Khôi phục cấp cao

Áp dụng các bản nâng cấp Cassandra cho từng nút một. Ngay sau khi cập nhật một nút, một số thay đổi giản đồ sẽ có hiệu lực và không thể khôi phục trực tiếp được. Hãy đọc kỹ phần Khôi phục vì có thể sử dụng các kỹ thuật khác nhau tuỳ thuộc vào số lượng cụm đã được nâng cấp.

Nếu cần khôi phục quá trình nâng cấp sau khi nâng cấp toàn bộ cụm Cassandra, bạn chỉ có thể khôi phục bản sao lưu. Bạn có thể chuẩn bị cho việc này và làm quen với tính năng khôi phục bản sao lưu Cassandra. Nếu bạn có thể khôi phục bản tổng quan nhanh ở cấp máy ảo nhanh hơn so với bản sao lưu Apigee, hãy sử dụng bản tổng quan nhanh máy ảo để khôi phục máy ảo Cassandra về trạng thái trước đó.

Để biết thêm thông tin chi tiết, hãy tham khảo phần Khôi phục bản cập nhật Cassandra 3.11.16.

Ghi lại API trong cổng thông tin dành cho nhà phát triển

Cổng thông tin dành cho nhà phát triển Apigee Drupal cung cấp nhiều tính năng để lập tài liệu cho các API của bạn. Mặc dù bạn nên ngừng sử dụng cổng thông tin dành cho nhà phát triển dựa trên Drupal 7, nhưng nếu bạn vẫn đang sử dụng và sử dụng tính năng SmartDocs, tài liệu Sử dụng API SmartDocs sẽ áp dụng cho bạn. Nếu bạn đang sử dụng các phiên bản mới hơn của cổng thông tin dành cho nhà phát triển, thì tài liệu về API của bạn sẽ không bị ảnh hưởng trong quá trình nâng cấp này.

Khi bạn nâng cấp Apigee lên phiên bản 4.52.02, mọi mô hình API được tạo bằng tính năng SmartDocs của cổng thông tin dành cho nhà phát triển Drupal 7 sẽ không được tự động di chuyển sang phiên bản mới hơn. Bạn sẽ phải xuất từng mô hình theo cách thủ công qua cổng thông tin dành cho nhà phát triển và nhập lại mô hình đó sau khi hoàn tất quá trình nâng cấp.

Thuật ngữ được sử dụng trong những phần sau

Thời gian chạy: Thời gian chạy bao gồm việc xử lý lưu lượng truy cập proxy thời gian chạy. Lớp này bao gồm tất cả thao tác được thực hiện bởi Bộ định tuyến và Bộ xử lý tin nhắn nhằm xử lý hiệu quả yêu cầu API thời gian chạy cho các proxy hiện có. Tuy nhiên, báo cáo này không bao gồm việc triển khai proxy mới hoặc các bản sửa đổi mới của proxy.

Quản lý: Hoạt động quản lý bao gồm hoạt động quản trị hệ thống Apigee Edge. Điều này bao gồm nhưng không giới hạn ở việc triển khai, sửa đổi ứng dụng, sản phẩm, máy chủ mục tiêu, kho khoá, v.v. Tất cả các API quản lý (và các ứng dụng khách, chẳng hạn như giao diện người dùng Apigee và cổng thông tin dành cho nhà phát triển) đều thuộc phạm vi này.

Trong mỗi bước dưới đây, trạng thái thời gian chạy và hoạt động quản lý được mô tả khi bạn thực hiện các giai đoạn khác nhau của quy trình nâng cấp. Xin lưu ý rằng việc nâng cấp sẽ không ảnh hưởng đến lưu lượng truy cập trong thời gian chạy. Tuy nhiên, một số ít API quản lý và chức năng của cổng thông tin dành cho nhà phát triển sẽ bị gián đoạn.

Bước 0: Trạng thái bắt đầu

  1. Cassandra trong Apigee đang chạy trên phiên bản 2.1.22.
  2. Các thành phần Edge cho Private Cloud 4.52.02:
    • Máy chủ quản lý giao tiếp với Cassandra qua giao thức tiết kiệm cũ.
    • Các máy chủ thời gian chạy (Bộ xử lý thư và bộ định tuyến) giao tiếp với Cassandra thông qua giao thức tiết kiệm cũ.
Trạng thái thời gian chạy ở giai đoạn này Trạng thái quản lý ở giai đoạn này
Thời gian chạy hoạt động đầy đủ Hoạt động quản lý có đầy đủ chức năng

Bước 1: Chuẩn bị nâng cấp

Các bước dưới đây bổ sung cho các tệp tiêu chuẩn mà bạn thường tạo, chẳng hạn như tệp cấu hình chuẩn của Apigee để bật tính năng nâng cấp thành phần.

  1. Thay đổi Cassandra để sử dụng LeveledCompactionStrategy.
  2. Sao lưu Cassandra bằng Apigee.
  3. Chụp ảnh nhanh máy ảo của các nút Cassandra (nếu có thể).
  4. Tạo tệp cấu hình nâng cấp Cassandra trên mỗi nút Cassandra tại /opt/apigee/apigee-cassandra/cass_upgrade.conf với nội dung sau: 
    # IP Address of node
HOSTIP=10.0.0.1

# Username for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_USERNAME=<cassuser>

# Password for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_PASSWORD=<casspass>

# Port for connecting to Cassandra via thrift. Optional. Defaults to 9160 if skipped.
CASS_PORT=9160

# Port for connecting to Cassandra via CQL. Optional. Defaults to 9042 if skipped.
CASS_CQL_PORT=9042

# Directory to be used by Cassandra upgrade scripts. Optional. Defaults to /tmp/cass_upgrade_scripts if skipped.
# Note that if upgrade is successful, this directory is deleted via root user - so provide a directory accordingly.
CASS_TMP_DIR=/tmp/cass_upgrade_scripts
    Nếu không thể tạo tệp tại /opt/apigee/apigee-cassandra/cass_upgrade.conf, hãy tạo tệp /opt/silent.conf có cùng nội dung trên mỗi nút Cassandra.
  • Nếu bạn sử dụng tính năng SmartDocs của cổng thông tin dành cho nhà phát triển Apigee Drupal 7, hãy xuất từng mô hình của bạn bằng cách tải các mô hình đó xuống ở định dạng JSON qua giao diện người dùng cổng thông tin dành cho nhà phát triển. Bạn sẽ cần nhập lại các mô hình này vào Apigee sau khi cập nhật các máy chủ quản lý.
  • Đảm bảo rằng các cổng 9160 và 9042 có thể truy cập được từ tất cả các cạnh của các thành phần Private Cloud 4.52.02 đến các nút Cassandra nếu chưa có. Hãy tham khảo bài viết Các yêu cầu về cổng để biết thêm thông tin.

Bước 2: Nâng cấp tất cả các nút Cassandra

  1. Nâng cấp từng nút Cassandra ở tất cả khu vực. Chạy các lệnh sau trên mỗi nút: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Sau khi cập nhật một nút, hãy chạy lệnh sau trên nút đó để thực hiện một số quy trình xác thực trước khi tiếp tục: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
  3. Kết quả ở trên sẽ cho ra nội dung dọc theo các dòng: 
    Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified
Trạng thái thời gian chạy ở giai đoạn này Trạng thái quản lý ở giai đoạn này
Thời gian chạy hoạt động đầy đủ Sau khi nâng cấp Cassandra, chức năng quản lý sau đây sẽ bị suy giảm:

Bước 3: Nâng cấp tất cả các nút Quản lý

Nâng cấp từng nút Quản lý ở tất cả các khu vực:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Trạng thái thời gian chạy Trạng thái quản lý
Thời gian chạy hoạt động đầy đủ API Quản lý đã xuống cấp:

Bước 3a: [không bắt buộc] Nhập SmartDocs đã được xuất trước đó

Sau khi nâng cấp tất cả máy chủ quản lý, bạn có thể nhập những mô hình SmartDocs mà bạn đã xuất ở Bước 1. Bạn cũng có thể quyết định làm việc này sau.

Trạng thái thời gian chạy Trạng thái quản lý
Thời gian chạy hoạt động đầy đủ Hoạt động quản lý có đầy đủ chức năng

Bước 4: Nâng cấp tất cả các nút Thời gian chạy

Nâng cấp từng bộ định tuyến và nút Trình xử lý thư trong tất cả các khu vực:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Trạng thái thời gian chạy Trạng thái quản lý
Thời gian chạy hoạt động đầy đủ Hoạt động quản lý có đầy đủ chức năng

Bước 5: Nâng cấp tất cả các Edge còn lại cho các thành phần Private Cloud 4.52.02

Nâng cấp từng nút edge-qpid-server và edge-postgres-server còn lại ở tất cả khu vực.

Ở giai đoạn này, nếu bạn đang nâng cấp từ các phiên bản cũ hơn Edge cho Private Cloud 4.52.01 và đang thực hiện các bước bổ sung để nâng cấp Qpid hoặc Postgres, hãy làm theo các bước tương ứng để nâng cấp tương tự.

Trạng thái thời gian chạy Trạng thái quản lý
Thời gian chạy hoạt động đầy đủ Hoạt động quản lý có đầy đủ chức năng

Bước 6: Các bước sau khi nâng cấp

Chạy lệnh sau trên từng nút Cassandra sau khi quá trình nâng cấp hoàn tất:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade

Chạy lệnh sau để loại bỏ các bảng cũ không sử dụng khỏi cụm Cassandra. Cho đến khi chạy chương trình này, bạn không thể sử dụng một số tính năng nhất định của Cassandra (như thiết lập xác thực mới - cơ chế xác thực cũ sẽ tiếp tục hoạt động). Chỉ có thể thực thi lệnh này trên 1 nút trong cụm:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile

Hoàn thành bước 3a nếu bạn chưa thực hiện.

Trạng thái thời gian chạy Trạng thái quản lý
Thời gian chạy hoạt động đầy đủ Hoạt động quản lý có đầy đủ chức năng

Nâng cấp bắt buộc lên Zookeeper 3.8.3

Mặc dù Edge cho Cloud Private Cloud 4.52.02 không bao gồm bản nâng cấp cho Zookeeper, nhưng nếu bạn đang nâng cấp từ các phiên bản cũ hơn 4.52.01, bạn cần làm theo các bước để nâng cấp Zookeeper.

  • Nếu bạn đang nâng cấp từ Edge cho các phiên bản Cloud Private Cloud 4.51.00 hoặc 4.52.00, hãy tham khảo các bước trong Cần nâng cấp lên Zookeeper 3.8.3 để nâng cấp Zookeeper.
  • Nếu bạn đang nâng cấp từ Edge cho Cloud Private Cloud phiên bản 4.52.01, bạn đã sử dụng Zookeeper phiên bản 3.8.3 và bạn không cần phải làm theo bất kỳ bước đặc biệt nào để nâng cấp Zookeeper.

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

  • Nếu bạn đang nâng cấp từ Edge cho Private Cloud 4.51.00 lên 4.52.02, bạn phải làm theo các bước để nâng cấp Postgres, mặc dù Edge cho Private Cloud 4.52.02 không bao gồm bản nâng cấp Postgres. Nâng cấp từ Edge cho Private Cloud 4.51.00 lên 4.52.02 yêu cầu thêm các bước nâng cấp Postgres. Vui lòng tham khảo phần Bắt buộc nâng cấp lên Postgres 14.
  • Nếu đang nâng cấp từ Edge cho Private Cloud 4.52.00 hoặc 4.52.01 lên 4.52.02, thì bạn không cần thực hiện thêm bước nâng cấp Postgres nào.

Cần nâng cấp lên Qpid J-Broker

Mặc dù Edge dành cho Private Cloud 4.52.02 không bao gồm bản nâng cấp lên QPID, nhưng nếu bạn đang nâng cấp từ các phiên bản cũ hơn 4.52.01, bạn cần làm theo các bước để nâng cấp QPID.

  • Nếu đang nâng cấp từ Edge cho Private Cloud 4.51.00 hoặc 4.52.00 lên 4.52.02, bạn cần làm theo các bước nâng cấp QPID bổ sung. Vui lòng tham khảo phần Nâng cấp Qpid nếu bạn đang nâng cấp từ phiên bản 4.51.00 hoặc 4.52.00 lên 4.52.02.
  • Nếu bạn đang nâng cấp từ Edge cho Private Cloud 4.52.01 lên 4.52.02, bạn phải sử dụng phiên bản mới nhất của Qpid Broker và không cần thực hiện thêm bước nâng cấp QPID nào.

Giao diện người dùng Edge mới

Phần này liệt kê những điều cần cân nhắc liên quan đến giao diện người dùng Edge. Để biết thêm thông tin, hãy xem phần Giao diện người dùng Edge mới dành cho Đám mây riêng tư.

Cài đặt giao diện người dùng Edge

Sau khi hoàn tất quá trình cài đặt ban đầu, Apigee khuyên bạn nên cài đặt giao diện người dùng Edge. Đây là một giao diện người dùng nâng cao dành cho nhà phát triển và quản trị viên của Apigee Edge cho Private Cloud.

Xin lưu ý rằng giao diện người dùng Edge yêu cầu bạn tắt tính năng Xác thực cơ bản và sử dụng IDP như SAML hoặc LDAP.

Để biết thêm thông tin, hãy xem phần Cài đặt giao diện người dùng Edge mới.

Cập nhật giao diện người dùng Edge

Để cập nhật thành phần giao diện người dùng Edge, hãy xem xét phiên bản Edge cho Đám mây riêng tư mà bạn đang nâng cấp từ đó:

Cập nhật bằng mTLS của Apigee

Để cập nhật Apigee mTLS , hãy làm theo các bước sau:

Đang khôi phục bản cập nhật

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 thực thi lại update.sh. Bạn có thể chạy quá trình 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 Khôi phục 4.52.00 để biết hướng dẫn chi tiết.

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

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 đ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 đó không có quyền truy cập vào /tmp, thì tiện ích update.sh sẽ không hoạt động được.

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

Bản cập nhật không hoạt động thời gian 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 khóa để nâng cấp sao cho không bị gián đoạn hoạt động là xóa 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ự cài đặt của bạn như mô tả 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à không truy cập được, 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ác cấu hình Edge đều hiển thị Bộ định tuyến và Trình xử lý thư 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 đối với các Bộ định tuyến còn lại.
  6. Tiếp tục cập nhật cho các máy còn lại trong bản cài đặt của bạn.

Hãy giải quyết những vấn đề sau trước và sau khi cập nhật:

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

Bạn phải chuyển tệp cấu hình im lặng vào lệnh cập nhật. Tệp cấu hình im lặng phải giống với tệp mà bạn đã dùng để cài đặt Edge 4.50.00 hoặc 4.51.00.

Cập nhật lên phiên bản 4.52.02 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 có, hãy tắt mọi công việc cron đã đị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.
  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 apigee của Edge.
  5. Nếu bạn đang cài đặt trên Oracle 7.x, hãy thực thi lệnh sau: 
    sudo yum-config-manager --enable ol7_optional_latest
  6. Nếu bạn đang cài đặt trên AWS, hãy thực thi các lệnh yum-configure-manager sau: 
    yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

  7. Nếu bạn đang dùng Edge 4.51.00:

    1. Tải tệp bootstrap_4.52.02.sh của Edge xuống /tmp/bootstrap_4.52.02.sh: 
      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
    2. Cài đặt tiện ích và các phần phụ thuộc apigee-service của Edge 4.52.02 bằng cách thực thi lệnh sau: 
      sudo bash /tmp/bootstrap_4.52.02.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ã đó.

      Theo mặc định, trình cài đặt sẽ kiểm tra xem bạn đã cài đặt Java 1.8 hay chưa. Nếu bạn không có, trình cài đặt 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.
    3. Sử dụng apigee-service để cập nhật tiện ích apigee-setup, như trong ví dụ sau: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    4. Cập nhật tiện ích apigee-validate trên Máy chủ quản lý, như trong ví dụ sau: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    5. Cập nhật tiện ích apigee-provision trên Máy chủ quản lý, như trong ví dụ sau: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
    6. Chạy tiện ích update trên các nút bằng cách thực thi lệnh sau: 
      /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

      Hãy thực hiện việc này theo thứ tự mô tả trong phần Thứ tự cập nhật máy.

      Trong trường hợp:

      • component là thành phần Edge cần cập nhật. Có thể là các giá trị sau:
        • cs: Cassandra
        • edge: Tất cả cá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ư, Bộ định tuyến, Máy chủ QPID, Máy chủ Postgres
        • ldap: OpenLDAP
        • ps: postgresql
        • qpid: qpidd
        • sso: SSO của Apigee (nếu bạn đã cài đặt SSO)
        • ue: Giao diện người dùng Edge mới
        • ui: Giao diện người dùng cổ điển Edge
        • zk: Người giữ vườn thú
      • configFile chính là tệp cấu hình mà bạn dùng để xác định các thành phần Edge trong quá trình cài đặt phiên bản 4.50.00 hoặc 4.51.00.

      Bạn có thể chạy update.sh dựa trên tất cả các thành phần bằng cách đặt component thành "all" (tất cả), nhưng chỉ khi bạn có hồ sơ cài đặt AIO (tích hợp đa năng trong một) Edge. Ví dụ:

      /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
    7. Khởi động lại thành phần giao diện người dùng Edge trên tất cả các nút đang chạy thành phần đó, nếu bạn chưa thực hiện việc này: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    8. Kiểm tra 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.

Nếu sau đó bạn quyết định khôi phục bản cập nhật, hãy làm theo quy trình được mô tả trong phần Khôi phục 4.52.02.

Cập nhật lên 4.52.02 từ một kho lưu trữ cục bộ

Nếu các nút Edge đặt 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 khác, thì bạn có thể cập nhật từ kho lưu trữ cục bộ hoặc bản sao lưu 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 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.52.02 cục bộ:

  1. Tạo một kho lưu trữ cục bộ 4.52.02 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.
  2. 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 sử dụng lệnh sau để đóng gói kho lưu trữ cục bộ thành một tệp .tar duy nhất có tên /opt/apigee/data/apigee-mirror/apigee-4.52.02.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, hãy huỷ đánh dấu tệp vào thư mục /tmp: 
      tar -xzf apigee-4.52.02.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 apigee-service Edge từ /tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Lưu ý rằng bạn bao gồm đường dẫn đến thư mục repos trong lệnh này.

  3. Cách cài đặt dịch vụ apigee 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 qua 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 apigee của Edge.
    2. Trên nút từ xa, hãy tải tệp bootstrap_4.52.02.sh của Edge xuống /tmp/bootstrap_4.52.02.sh: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh

      Trong đó uName:pWord là tên người dùng và mật khẩu mà bạn đã đặt trước đó 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à các phần phụ thuộc apigee-setup của Edge: 
      sudo bash /tmp/bootstrap_4.52.02.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 kho lưu trữ.

  4. Sử dụng apigee-service để cập nhật tiện ích apigee-setup, như trong ví dụ sau: 
    /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ý, như trong ví dụ sau: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. Cập nhật tiện ích apigee-provision trên Máy chủ quản lý, như trong ví dụ sau: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. Chạy tiện ích update trên các nút theo thứ tự mô tả trong phần Thứ tự cập nhật máy: 
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    Trong trường hợp:

    • component là thành phần Edge cần cập nhật. Thông thường, bạn sẽ cập nhật các thành phần sau:
      • cs: Cassandra
      • edge: Tất cả cá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ư, Bộ định tuyến, Máy chủ QPID, Máy chủ Postgres
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: SSO của Apigee (nếu bạn đã cài đặt SSO)
      • Giao diện người dùng Edge mới của ue
      • ui: Giao diện người dùng cổ điển Edge
      • zk: Người giữ vườn thú
    • configFile chính là tệp cấu hình mà bạn dùng để xác định các thành phần Edge trong quá trình cài đặt phiên bản 4.50.00 hoặc 4.51.00.

    Bạn có thể chạy update.sh dựa trên tất cả các thành phần bằng cách đặt component thành "all" (tất cả), nhưng chỉ khi bạn có hồ sơ cài đặt AIO (tích hợp đa năng trong một) Edge. Ví dụ:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
  8. Khởi động lại các thành phần giao diện người dùng trên tất cả các nút đang chạy thành phần này, nếu bạn chưa thực hiện việc này: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. Kiểm tra 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.

Nếu sau đó bạn quyết định khôi phục bản cập nhật, hãy làm theo quy trình được mô tả trong phần Khôi phục 4.52.02.

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:

  • 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 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ư, Bộ định tuyến, Máy chủ QPID chứ 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 lúc.
  • Nếu một bước chỉ định rằng cần 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.
  • Bạn cần thực hiện một bước riêng để cập nhật tính năng Kiếm tiền. Thuộc tính này được cập nhật khi bạn chỉ định tuỳ chọn -c edge.

Nâng cấp riêng lẻ với 1 nút

Cách nâng cấp cấu hình độc lập 1 nút lên phiên bản 4.52.02:

  1. Cập nhật tất cả thành phần: 
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (Nếu bạn đã cài đặt apigee-adminapi) Cập nhật tiện ích apigee-adminapi: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

Nâng cấp riêng lẻ 2 nút

Cập nhật các thành phần sau để cài đặt độc lập 2 nút:

Hãy xem phần Xin lỗi khi 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. Cập nhật Cassandra và ZooKeeper trên máy 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Cập nhật Postgres trên máy 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Cập nhật LDAP trên máy 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. 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
  5. Cập nhật Qpid trên Máy 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Cập nhật giao diện người dùng trên máy 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (Nếu bạn đã cài đặt apigee-adminapi) Cập nhật tiện ích apigee-adminapi trên máy 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Nếu bạn đã cài đặt dịch vụ SSO của Apigee) Cập nhật dịch vụ SSO của Apigee trên máy 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Trong đó sso_config_file là tệp cấu hình mà bạn đã tạo khi cài đặt SSO.

  9. Khởi động lại thành phần giao diện người dùng Edge trên máy 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Nâng cấp 5 nút

Cập nhật các thành phần sau để cài đặt 5 nút:

Hãy xem phần Xin lỗi khi 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. 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
  2. Cập nhật Postgres trên máy 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Cập nhật Postgres trên máy 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c 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. Cập nhật Qpid trên máy 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Cập nhật Qpid trên máy 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Cập nhật giao diện người dùng Edge:
    • Giao diện người dùng cổ điển: Nếu bạn đang sử dụng giao diện người dùng cũ, hãy cập nhật thành phần ui trên máy 1, như trong ví dụ sau: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    • New Edge UI: Nếu bạn đã cài đặt giao diện người dùng Edge mới, hãy cập nhật thành phần ue trên máy thích hợp (có thể không phải là máy 1): 
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  9. (Nếu bạn đã cài đặt apigee-adminapi) Cập nhật tiện ích apigee-adminapi trên máy 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (Nếu bạn đã cài đặt dịch vụ SSO của Apigee) Cập nhật dịch vụ SSO của Apigee trên máy 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Trong đó sso_config_file là tệp cấu hình mà bạn đã tạo khi cài đặt SSO.

  11. Khởi động lại thành phần giao diện người dùng:
    • Giao diện người dùng cổ điển: Nếu bạn đang sử dụng giao diện người dùng cũ, hãy khởi động lại thành phần edge-ui trên máy 1, như trong ví dụ sau: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • New Edge UI: Nếu bạn đã cài đặt giao diện người dùng Edge mới, hãy khởi động lại thành phần edge-management-ui trên máy thích hợp (có thể không phải là máy 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Bản nâng cấp theo cụm 9 nút

Cập nhật các thành phần sau để cài đặt theo cụm 9 nút:

Hãy xem phần Xin lỗi khi 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. 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
  2. Cập nhật Postgres trên máy 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Cập nhật Postgres trên máy 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c 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 6, 7, 8, 9, 1, 4 và 5 theo thứ tự đó: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Cập nhật Qpid trên máy 6 và 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Cập nhật giao diện người dùng mới (ue) hoặc giao diện người dùng cổ điển (ui) trên máy 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (Nếu bạn đã cài đặt apigee-adminapi) Cập nhật tiện ích apigee-adminapi trên máy 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (Nếu bạn đã cài đặt dịch vụ SSO của Apigee) Cập nhật dịch vụ SSO của Apigee trên máy 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Trong đó sso_config_file là tệp cấu hình mà bạn đã tạo khi cài đặt SSO.

  10. Khởi động lại thành phần giao diện người dùng:
    • Giao diện người dùng cổ điển: Nếu bạn đang sử dụng giao diện người dùng cũ, hãy khởi động lại thành phần edge-ui trên máy 1, như trong ví dụ sau: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • New Edge UI: Nếu bạn đã cài đặt giao diện người dùng Edge mới, hãy khởi động lại thành phần edge-management-ui trên máy thích hợp (có thể không phải là máy 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Bản nâng cấp theo cụm 13 nút

Cập nhật các thành phần sau để cài đặt theo cụm 13 nút:

Hãy xem phần Xin lỗi khi 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. 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
  2. Cập nhật Postgres trên máy 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Cập nhật Postgres trên máy 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Cập nhật LDAP trên máy 4 và 5: 
    /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 12, 13, 8, 9, 6, 7, 10 và 11 theo thứ tự đó: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Cập nhật Qpid trên máy 12 và 13: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Cập nhật giao diện người dùng mới (ue) hoặc giao diện người dùng cũ (ui) trên máy 6 và 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (Nếu bạn đã cài đặt apigee-adminapi) Cập nhật tiện ích apigee-adminapi trên máy 6 và 7: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (Nếu bạn đã cài đặt dịch vụ SSO của Apigee) Cập nhật dịch vụ SSO của Apigee trên máy 6 và 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Trong đó sso_config_file là tệp cấu hình mà bạn đã tạo khi cài đặt SSO.

  10. Khởi động lại thành phần giao diện người dùng:
    • Giao diện người dùng cổ điển: Nếu bạn đang sử dụng giao diện người dùng cũ, hãy khởi động lại thành phần edge-ui trên máy 6 và 7, như trong ví dụ sau: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • New Edge UI: Nếu bạn đã cài đặt giao diện người dùng Edge mới, hãy khởi động lại thành phần edge-management-ui trên máy 6 và 7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Bản nâng cấp theo cụm 12 nút

Cập nhật các thành phần sau để cài đặt theo cụm 12 nút:

Hãy xem phần Xin lỗi khi 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. Cập nhật Cassandra và ZooKeeper:
    1. Trên máy 1, 2 và 3 của Trung tâm dữ liệu 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. Trên các 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 Postgres:
    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
  3. Cập nhật Giao thức truy cập thư mục hạng nhẹ (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
  4. 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
  5. 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. Cập nhật qpidd trên máy 5: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    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. Cập nhật qpidd trên máy 11: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Cập nhật giao diện người dùng mới (ue) hoặc giao diện người dùng cũ (ui):
    1. Máy 1 trong Trung tâm dữ liệu 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
    2. Máy 7 trong Trung tâm dữ liệu 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  7. (Nếu bạn đã cài đặt apigee-adminapi) Cập nhật tiện ích apigee-adminapi:
    1. Máy 1 trong Trung tâm dữ liệu 1: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
    2. Máy 7 trong Trung tâm dữ liệu 2: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Nếu bạn đã cài đặt dịch vụ SSO của Apigee) Cập nhật dịch vụ SSO của Apigee:
    1. Máy 1 trong Trung tâm dữ liệu 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    2. Máy 7 trong Trung tâm dữ liệu 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

      3. Trong đó sso_config_file là tệp cấu hình mà bạn đã tạo khi cài đặt SSO.

  9. Khởi động lại thành phần giao diện người dùng Edge mới (edge-management-ui) hoặc giao diện người dùng Edge cũ (edge-ui) trên máy 1 và 7: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

Đối với cấu hình không chuẩn

Nếu bạn có cấu hình 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. 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ủ Edge Postgres, Máy chủ quản lý, Bộ xử lý tin nhắn và Bộ định tuyến.
  6. Qpidd
  7. Giao diện người dùng Edge (cũ hoặc mới)
  8. apigee-adminapi
  9. Đăng nhập một lần (SSO) của Apigee

Sau khi bạn cập nhật xong, hãy nhớ khởi động lại thành phần giao diện người dùng Edge trên tất cả các máy đang chạy thành phần đó.