Phần này mô tả cách nâng cấp từ Apigee Edge 4.19.06 hoặc 4.50.00 lên 4.51.00.
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 là người cài đặt Edge ban đầu hoặc người chạy bản cập nhật gốc.
Sau khi bạn cài đặt RPM Edge, 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ả 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 các chế độ cài đặt tài sản
Nếu bạn đã thiết lập bất kỳ thuộc tính nào bằng cách chỉnh sửa tệp .properties
trong /opt/apigee/customer/application
, thì các giá trị này sẽ được bản cập nhật giữ lại.
Yêu cầu nâng cấp lên Postgres 10.17
Bản phát hành Edge này bao gồm bản nâng cấp lên Postgres 10.17. Trong lần nâng cấp đó, tất cả dữ liệu của Postgres sẽ được di chuyển sang Postgres 10.17.
Hầu hết các hệ thống sản xuất Edge đều sử dụng 2 nút Postgres được định cấu hình để sao chép chính cho chế độ chờ. Trong quá trình cập nhật, mặc dù các nút Postgres ngừng hoạt động để cập nhật, nhưng dữ liệu phân tích vẫn được ghi vào các nút Qpid. Sau khi các nút Postgres được cập nhật và trực tuyến trở lại, dữ liệu phân tích sẽ được đẩy đến các nút Postgres.
Cách bạn thực hiện cập nhật Postgres phụ thuộc vào cách bạn định cấu hình bộ nhớ dữ liệu cho các nút Postgres:
- Nếu sử dụng bộ nhớ dữ liệu cục bộ cho nút Postgres, bạn phải cài đặt nút chờ Postgres mới trong suốt quá trình nâng cấp. Sau khi quá trình nâng cấp hoàn tất, bạn có thể gỡ bỏ nút chờ Postgres mới.
Bạn bắt buộc phải có nút chờ Postgres bổ sung nếu phải hoàn nguyên bản cập nhật vì bất kỳ lý do gì. Nếu bạn phải khôi phục bản cập nhật, nút chờ Postgres mới sẽ trở thành nút Postgres chính sau khi khôi phục. Do đó, khi bạn cài đặt nút chế độ chờ Postgres mới, nút đó phải nằm trên một nút đáp ứng tất cả các yêu cầu về phần cứng của máy chủ Postgres, như đã nêu trong bài viết Yêu cầu về việc cài đặt Edge.
Trong cấu hình 1 nút và 2 nút của Edge, các cấu trúc liên kết dùng để tạo nguyên mẫu và kiểm thử, bạn chỉ có một nút Postgres. Bạn có thể cập nhật trực tiếp các nút Postgres này mà không cần tạo một nút Postgres mới.
- Nếu đang sử dụng bộ nhớ mạng cho các nút Postgres, theo khuyến nghị của Apigee, bạn không cần phải cài đặt một nút Postgres mới. Trong các quy trình dưới đây, bạn có thể bỏ qua các bước chỉ định để cài đặt và sau đó gỡ bỏ một nút chế độ chờ Postgres mới.
Trước khi bạn bắt đầu quá trình cập nhật, hãy chụp nhanh mạng của kho dữ liệu mà Postgres sử dụng. Sau đó, nếu có lỗi nào xảy ra trong quá trình cập nhật và bạn buộc phải khôi phục, thì bạn có thể khôi phục nút Postgres từ bản tổng quan nhanh đó.
Cài đặt nút chế độ chờ Postgres mới
Quy trình này tạo một máy chủ chờ Postgres trên một nút mới. Đảm bảo rằng bạn cài đặt máy chủ chờ Postgres mới cho phiên bản Edge hiện có (4.19.06 hoặc 4.50.00), chứ không phải cho phiên bản 4.51.00.
Để cài đặt, hãy sử dụng chính tệp cấu hình mà bạn đã dùng để cài đặt phiên bản Edge hiện tại.
Cách tạo nút chế độ chờ Postgres mới:
- Trên bản chính Postgres hiện tại, hãy chỉnh sửa tệp
/opt/apigee/customer/application/postgresql.properties
để đặt mã thông báo sau. Nếu tệp đó không tồn tại, hãy tạo tệp:conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust
Trong đó existing_standby_ip là địa chỉ IP của máy chủ chờ Postgres hiện tại và new_standby_ip là địa chỉ IP của nút chế độ chờ mới.
- Khởi động lại
apigee-postgresql
trên trang chủ Postgres:/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
- Xác minh nút chế độ chờ mới đã được thêm bằng cách xem tệp
/opt/apigee/apigee-postgresql/conf/pg_hba.conf
trên nút chính. Bạn sẽ thấy các dòng sau trong tệp đó:host replication apigee existing_standby_ip/32 trust host replication apigee new_standby_ip/32 trust
- Cài đặt máy chủ chờ Postgres mới:
- Chỉnh sửa tệp cấu hình bạn đã dùng để cài đặt phiên bản Edge hiện tại để chỉ định các thông tin sau:
# IP address of the current master: PG_MASTER=192.168.56.103 # IP address of the new standby node PG_STANDBY=192.168.56.102
- Tắt SELinux như mô tả trong phần Cài đặt tiện ích thiết lập apigee của Edge.
- Thực hiện một trong những thao tác sau, tuỳ thuộc vào phiên bản Edge mà bạn đang nâng cấp:
- Nếu bạn đang nâng cấp từ Edge 4.19.06, hãy tải tệp Edge bootstrap_4.19.06.sh xuống
/tmp/bootstrap_4.19.06.sh
:curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
Tiếp theo, hãy cài đặt tiện ích và phần phụ thuộc của Edge
apigee-service
:sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord
- Nếu bạn đang nâng cấp từ Edge 4.50.00,
hãy tải tệp Edge bootstrap_4.50.00.sh xuống
/tmp/bootstrap_4.50.00.sh
:curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
Tiếp theo, hãy cài đặt tiện ích và phần phụ thuộc của Edge
apigee-service
:sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
- Nếu bạn đang nâng cấp từ Edge 4.19.06, hãy tải tệp Edge bootstrap_4.19.06.sh xuống
- Dùng
apigee-service
để cài đặt tiện íchapigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Cài đặt Postgres:
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
- Trên nút chế độ chờ mới, hãy chạy lệnh sau:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Xác thực rằng đó là chế độ chờ.
- Chỉnh sửa tệp cấu hình bạn đã dùng để cài đặt phiên bản Edge hiện tại để chỉ định các thông tin sau:
Thực hiện nâng cấp tại chỗ Postgres
Để nâng cấp tại chỗ lên Postgres 10.17, hãy làm theo các bước sau:
- Nâng cấp postgres trên máy chủ lưu trữ chính
/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
- Chạy lệnh thiết lập trên máy chủ lưu trữ chính:
apigee-service apigee-postgresql setup -f /opt/silent.conf
- Chạy lệnh định cấu hình trên máy chủ lưu trữ chính:
apigee-service apigee-postgresql configure
- Khởi động lại máy chủ chính:
apigee-service apigee-postgresql restart
- Định cấu hình làm tài khoản chính:
apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf
- Đảm bảo máy chủ lưu trữ chính đã khởi động:
apigee-service apigee-postgresql wait_for_ready
- Dừng chế độ chờ:
apigee-service apigee-postgresql stop
- Nâng cấp chế độ chờ.
Lưu ý: Nếu bước này bị lỗi/không thành công, bạn có thể bỏ qua bước này.
update.sh
sẽ cố gắng khởi động máy chủ dự phòng bằng cấu hình không chính xác. Miễn là bản cài đặt Postgres được nâng cấp lên 10.17, lỗi này có thể được bỏ qua./opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
- Đảm bảo bạn đã dừng chế độ chờ:
apigee-service apigee-postgresql stop
- Xoá cấu hình chế độ chờ cũ:
rm -rf /opt/apigee/data/apigee-postgresql/
- Thiết lập bản sao trên máy chủ chờ:
apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf
Sau khi bạn hoàn tất quy trình này, chế độ chờ sẽ khởi động thành công.
Đang gỡ bỏ nút Postgres
Sau khi cập nhật xong, hãy gỡ bỏ nút chế độ chờ mới:
- Hãy đảm bảo Postgres đang chạy:
/opt/apigee/apigee-service/bin/apigee-all status
Nếu Postgres không chạy, hãy khởi động ứng dụng này:
/opt/apigee/apigee-service/bin/apigee-all start
- Lấy mã nhận dạng duy nhất (UUID) của nút chế độ chờ mới bằng cách chạy lệnh
curl
sau đây trên nút chế độ chờ mới:curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self
Bạn sẽ thấy UUID của nút ở cuối kết quả, có dạng:
"type" : [ "postgres-server" ], "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
- Dừng nút chế độ chờ mới bằng cách chạy lệnh sau trên nút chế độ chờ mới:
/opt/apigee/apigee-service/bin/apigee-all stop
- Trên nút chính Postgres, hãy chỉnh sửa
/opt/apigee/customer/application/postgresql.properties
để xoá nút chế độ chờ mới khỏiconf_pg_hba_replication.connection
:conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
- Khởi động lại apigee-postgresql trên trang chủ Postgres:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
- Xác minh rằng nút chế độ chờ mới đã bị xoá bằng cách xem tệp
/opt/apigee/apigee-postgresql/conf/pg_hba.conf
trên nút chính. Bạn sẽ chỉ thấy dòng sau trong tệp đó:host replication apigee existing_standby_ip/32 trust
- Xoá mã nhận dạng duy nhất (UUID) của nút chế độ chờ khỏi ZooKeeper bằng cách thực hiện lệnh gọi API Quản lý Edge sau đây trên nút Máy chủ quản lý:
curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid
Cập nhật các điều kiện tiên quyết
Hãy đảm bảo những điều kiện tiên quyết sau đây trước khi nâng cấp Apigee Edge:
- Sao lưu tất cả các nút
Trước khi cập nhật, bạn nên sao lưu đầy đủ tất cả các nút để đảm bảo an toàn. Sử dụng quy trình sao lưu dành cho phiên bản Edge hiện tại của bạn.Điều này 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ề quá trình sao lưu, hãy xem bài viết Sao lưu và khôi phục.
- Đảm bảo Edge đang chạy
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
Giao diện người dùng mới của Edge
Phần này liệt kê các điểm 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 nội dung Giao diện người dùng mới của Edge 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 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 trong đám mây riêng tư.
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 một 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ừ 4.19.06 hoặc 4.50.00 đến 4.51.00 (khi đã cài đặt giao diện người dùng Edge mới): Hãy làm theo hướng dẫn nâng cấp trong phần này cho thành phần
edge-management-ui
.
Cập nhật bằng Apigee mTLS
Để cập nhật Apigee mTLS , hãy làm theo các bước sau:
Khôi phục một bản cập nhật
Trong trường hợp cập nhật không thành công, bạn có thể thử khắc phục vấn đề rồi thực thi lại
update.sh
. Bạn có thể chạy bản cập nhật nhiều lần để tiếp tục quá trình cập nhật từ nơi dừng lại trước đó.
Nếu không thành công đòi hỏi bạn phải khôi phục bản cập nhật về phiên bản trước đó, hãy xem phần Khôi phục 4.51.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 chạy tiện ích update.sh
không có quyền truy cập vào thư mục đó, thì tiện ích đó sẽ ghi nhật ký vào thư mục /tmp
dưới dạng tệp có tên 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ập nhật thời gian không hoạt động
Bản cập nhật với thời gian ngừng hoạt động hoặc bản cập nhật luân phiên cho phép bạn cập nhật chế độ cài đặt Edge mà không cần hạ cấp Edge.
Bạn chỉ có thể cập nhật thời gian ngừng hoạt động với cấu hình 5 nút trở lên.
Điều quan trọng để nâng cấp thời gian ngừng hoạt động là xoá từng Bộ định tuyến khỏi trình cân bằng tải. Sau đó, bạn cập nhật Bộ định tuyến và mọi thành phần khác trên cùng một máy với Bộ định tuyến, rồi thêm Bộ định tuyến trở lại trình cân bằng tải.
- Cập nhật máy theo đúng thứ tự lắp đặt như mô tả Thứ tự cập nhật máy.
- Khi cần cập nhật Bộ định tuyến, hãy chọn một Bộ định tuyến bất kỳ và làm cho Bộ định tuyến không truy cập được, như mô tả trong phần Bật/tắt khả năng kết nối với máy chủ (Bộ xử lý/Bộ định tuyến) của máy chủ.
- Cập nhật Bộ định tuyến đã chọn và tất cả các thành phần khác của Edge trên cùng một máy với Bộ định tuyến. Tất cả các cấu hình Edge đều hiển thị Bộ định tuyến và Bộ xử lý tin nhắn trên cùng một nút.
- Đặt Bộ định tuyến trở lại khả năng truy cập.
- Lặp lại các bước từ 2 đến 4 cho các Bộ định tuyến còn lại.
- Tiếp tục cập nhật cho mọi máy còn lại trong quá trình cài đặt.
Hãy chú ý đến những vấn đề sau đây trước và sau khi cập nhật:
- Trên bộ định tuyến kết hợp và nút Bộ xử lý thư:
- Trước khi cập nhật – hãy thực hiện những việc sau:
- Không thể kết nối với Bộ định tuyến.
- Đặt Bộ xử lý thư không thể truy cập được.
- Sau khi cập nhật – hãy làm như sau:
- Đặt Bộ xử lý thông báo có thể truy cập được.
- Đặt Bộ định tuyến có thể truy cập được.
- Trước khi cập nhật – hãy thực hiện những việc sau:
- Trên các nút Bộ định tuyến đơn:
- Trước khi cập nhật, hãy không kết nối được với Bộ định tuyến.
- Sau khi cập nhật, hãy đặt Bộ định tuyến có thể truy cập được.
- Trên một nút Bộ xử lý thông báo:
- Trước khi cập nhật, hãy không thể kết nối với Bộ xử lý thư.
- Sau khi cập nhật, hãy đặt Trình xử lý tin nhắn có thể truy cập.
Sử dụng tệp cấu hình im lặng
Bạn phải truyền tệp cấu hình im lặng đến lệnh cập nhật. Tệp cấu hình im lặng phải giống với tệp bạn đã dùng để cài đặt Edge 4.19.06 hoặc 4.50.00.
Cập nhật lên phiên bản 4.51.00 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:
- 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. - Đăng nhập vào nút của bạn dưới dạng thư mục gốc để cài đặt RPM Edge.
- Cài đặt
yum-utils
vàyum-plugin-priorities
:sudo yum install yum-utils
sudo yum install yum-plugin-priorities
- Tắt SELinux theo mô tả trong phần Cài đặt tiện ích thiết lập API Edge.
- 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
- Nếu bạn 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
- Tải tệp
bootstrap_4.51.00.sh
Edge 4.51.00 xuống/tmp/bootstrap_4.51.00.sh
:curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
- Cài đặt tiện ích
apigee-service
và các phần phụ thuộc của Edge 4.51.00 bằng cách thực thi lệnh sau:sudo bash /tmp/bootstrap_4.51.00.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 mã này.
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 không, trình cài đặt sẽ cài đặt giúp 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.
- Hãy sử dụng
apigee-service
để cập nhật tiện íchapigee-setup
, như ví dụ sau cho thấy:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- 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
- 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
- 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 làm theo thứ tự như 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ác giá trị có thể bao gồm:
cs
: Cassandraedge
: Tất cả thành phần của 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ủ Postgresldap
: OpenLDAPps
: postgresqlqpid
: đã đặt trướcsso
: Apigee SSO (nếu bạn đã cài đặt SSO)ue
: Giao diện người dùng của Edge mớiui
: Giao diện người dùng của Edge phiên bản cũzk
: Người giữ 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.19.06 hoặc 4.50.00.
Bạn có thể chạy
update.sh
trên tất cả thành phần bằng cách đặt component thành "all", nhưng chỉ khi bạn có hồ sơ cài đặt tất cả trong một (AIO) của Edge. Ví dụ:/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
- component là thành phần Edge cần cập nhật. Các giá trị có thể bao gồm:
- 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 chạy thành phần đó (nếu bạn chưa làm):
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- Kiểm thử bản cập nhật bằng cách chạy tiện ích
apigee-validate
trên Máy chủ quản lý, như mô tả trong phần Kiểm thử bản cài đặt.
Nếu sau đó bạn quyết định khôi phục bản cập nhật, hãy sử dụng quy trình được mô tả trong Khôi phục 4.51.00.
Cập nhật lên 4.51.00 từ một kho lưu trữ cục bộ
Nếu các nút Edge của bạn bị tường lửa hoặc bị cấm truy cập vào kho lưu trữ Apigee qua Internet, thì bạn có thể cập nhật qua kho lưu trữ cục bộ hoặc bản sao của kho lưu trữ Apigee.
Sau khi tạo một kho lưu trữ cục bộ của Edge, bạn có 2 lựa chọn để cập nhật Edge từ kho lưu trữ cục bộ:
- Tạo tệp .tar của kho lưu trữ, sao chép tệp .tar vào một nút, sau đó cập nhật Edge từ tệp .tar.
- Cài đặt máy chủ web trên nút có kho lưu trữ cục bộ để các nút khác có thể truy cập vào nút đó. Apigee cung cấp máy chủ web NGINX cho bạn sử dụng hoặc bạn có thể dùng máy chủ web của riêng mình.
Để cập nhật từ một kho lưu trữ 4.51.00 cục bộ:
- Tạo một bản repo 4.51.00 cục bộ như mô tả trong phần "Tạo kho lưu trữ Apigee cục bộ" tại phần Cài đặt tiện ích thiết lập apigee của Edge.
- Cách cài đặt dịch vụ apigee từ tệp .tar:
- Trên nút có kho lưu trữ cục bộ, hãy dùng lệnh sau để đóng gói kho lưu trữ cục bộ vào một tệp .tar có tên là
/opt/apigee/data/apigee-mirror/apigee-4.51.00.tar.gz
:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- Sao chép tệp .tar vào nút mà bạn muốn cập nhật Edge. Ví dụ: sao chép tệp đó vào thư mục
/tmp
trên nút mới. - Trên nút mới, hãy huỷ lưu trữ tệp vào thư mục
/tmp
:tar -xzf apigee-4.51.00.tar.gz
Lệnh này tạo một thư mục mới, có tên là
repos
, trong thư mục chứa tệp .tar. Ví dụ:/tmp/repos
. - Cài đặt tiện ích
apigee-service
và các phần phụ thuộc của Edge từ/tmp/repos
:sudo bash /tmp/repos/bootstrap_4.51.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Lưu ý rằng bạn cần đưa đường dẫn đến thư mục repos vào lệnh này.
- Trên nút có kho lưu trữ cục bộ, hãy dùng lệnh sau để đóng gói kho lưu trữ cục bộ vào một tệp .tar có tên là
- Cách cài đặt dịch vụ API bằng máy chủ web NGINX:
- Đị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" trong phần Cài đặt tiện ích thiết lập API của Edge.
- Trên nút từ xa, hãy tải tệp Edge
bootstrap_4.51.00.sh
xuống/tmp/bootstrap_4.51.00.sh
:/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
Trong đó uName:pWord là tên người dùng và mật khẩu bạn đã đặt trước đó cho kho lưu trữ, còn remoteRepo là địa chỉ IP hoặc tên DNS của nút kho lưu trữ.
- Trên nút từ xa, hãy cài đặt tiện ích và phần phụ thuộc của Edge
apigee-setup
:sudo bash /tmp/bootstrap_4.51.00.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ữ.
- Hãy sử dụng
apigee-service
để cập nhật tiện íchapigee-setup
, như ví dụ sau cho thấy:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- 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
- 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
- Chạy tiện ích
update
trên các nút theo thứ tự được 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. Bạn thường cập nhật những thành phần sau:
cs
: Cassandraedge
: Tất cả thành phần của Edge ngoại trừ giao diện người dùng Edge: Máy chủ quản lý, Bộ xử lý thông báo, Bộ định tuyến, Máy chủ QPID, Máy chủ Postgresldap
: OpenLDAPps
: postgresqlqpid
: đã đặt trướcsso
: Apigee SSO (nếu bạn đã cài đặt SSO)ue
Giao diện người dùng Edge mớiui
: Giao diện người dùng của Edge phiên bản cũzk
: Người giữ 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.19.06 hoặc 4.50.00.
Bạn có thể chạy
update.sh
trên tất cả thành phần bằng cách đặt component thành "all", nhưng chỉ khi bạn có hồ sơ cài đặt tất cả trong một (AIO) của Edge. Ví dụ:/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
- component là thành phần Edge cần cập nhật. Bạn thường cập nhật những thành phần sau:
- 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ếu bạn chưa làm):
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
- Kiểm thử bản cập nhật bằng cách chạy tiện ích
apigee-validate
trên Máy chủ quản lý, như mô tả trong phần Kiểm thử bản cài đặt.
Nếu sau đó bạn quyết định khôi phục bản cập nhật, hãy sử dụng quy trình được mô tả trong Khôi phục 4.51.00.
Thứ tự cập nhật máy
Thứ tự cập nhật các máy trong một bản cài đặt Edge 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 những máy có nhiều thành phần Edge (Máy chủ quản lý, Bộ xử lý thông báo, Bộ định tuyến, Máy chủ QPID nhưng không phải Máy chủ Postgres), hãy sử dụng tuỳ chọn
-c edge
để cập nhật tất cả các thành phần đó cùng một lúc. - Nếu một bước chỉ định rằng phải được thực hiện trên nhiều máy, hãy thực hiện bước đó theo thứ tự máy đã chỉ định.
- Không có bước riêng biệt nào để cập nhật tính năng Kiếm tiền. Giá trị này sẽ được cập nhật khi bạn chỉ định tuỳ chọn
-c edge
.
Nâng cấp độc lập 1 nút
Cách nâng cấp cấu hình độc lập 1 nút lên 4.51.00:
- Cập nhật tất cả thành phần:
/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
- (Nếu bạn đã cài đặt
apigee-adminapi
) Cập nhật tiện íchapigee-adminapi
:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
Nâng cấp độc lập 2 nút
Cập nhật các thành phần sau đây để cài đặt độc lập 2 nút:
Hãy xem phần Các cấu trúc liên kết đã cài đặt để biết danh sách các cấu trúc liên kết và số nút của Edge.
- Cập nhật Cassandra và ZooKeeper trên máy 1:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Cập nhật Qpid và Postgres trên máy 2:
/opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
- Cập nhật LDAP trên máy 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- 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
- 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
- (Nếu bạn đã cài đặt
apigee-adminapi
) Cập nhật tiện íchapigee-adminapi
trên máy 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Nếu bạn đã cài đặt Apigee SSO) Cập nhật Apigee SSO 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 bạn đã tạo khi cài đặt SSO.
- 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 đây để cài đặt 5 nút:
Hãy xem phần Các cấu trúc liên kết đã cài đặt để biết danh sách các cấu trúc liên kết và số nút của Edge.
- 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
- Cập nhật Qpid và Postgres trên máy 4:
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
- Cập nhật Qpid và Postgres trên máy 5:
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
- Cập nhật LDAP trên máy 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- 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
- Cập nhật giao diện người dùng Edge:
- Giao diện người dùng cũ: 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ư ví dụ dưới đây:/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- Giao diện người dùng mới của Edge: 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 (không phải trên máy 1):/opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
- Giao diện người dùng cũ: 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
- (Nếu bạn đã cài đặt
apigee-adminapi
) Cập nhật tiện íchapigee-adminapi
trên máy 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Nếu bạn đã cài đặt Apigee SSO) Cập nhật Apigee SSO 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 bạn đã tạo khi cài đặt SSO.
- Khởi động lại thành phần giao diện người dùng:
- Giao diện người dùng cũ: 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ư ví dụ dưới đây:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- Giao diện người dùng mới của Edge: 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 (không phải trên máy 1):/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- Giao diện người dùng cũ: 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
Nâng cấp theo cụm 9 nút
Cập nhật các thành phần sau đây để cài đặt theo cụm 9 nút:
Hãy xem phần Các cấu trúc liên kết đã cài đặt để biết danh sách các cấu trúc liên kết và số nút của Edge.
- 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
- Cập nhật Qpid trên máy 6 và 7:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Cập nhật Postgres trên máy 8:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Cập nhật Postgres trên máy 9:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Cập nhật LDAP trên máy 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Cập nhật các thành phần Edge trên máy 6, 7, 8, 9, 1, 4 và 5 theo thứ tự sau:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- 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 1:/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- (Nếu bạn đã cài đặt
apigee-adminapi
) Cập nhật tiện íchapigee-adminapi
trên máy 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Nếu bạn đã cài đặt Apigee SSO) Cập nhật Apigee SSO 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 bạn đã tạo khi cài đặt SSO.
- Khởi động lại thành phần giao diện người dùng:
- Giao diện người dùng cũ: 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ư ví dụ dưới đây:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- Giao diện người dùng mới của Edge: 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 (không phải trên máy 1):/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- Giao diện người dùng cũ: 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
Nâng cấp theo cụm 13 nút
Cập nhật các thành phần sau đây để cài đặt theo cụm 13 nút:
Hãy xem phần Các cấu trúc liên kết đã cài đặt để biết danh sách các cấu trúc liên kết và số nút của Edge.
- 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
- Cập nhật Qpid trên máy 12 và 13:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Cập nhật Postgres trên máy 8:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Cập nhật Postgres trên máy 9:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Cập nhật LDAP trên máy 4 và 5:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Cập nhật các thành phần Edge trên máy 12, 13, 8, 9, 6, 7, 10 và 11 theo thứ tự sau:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- 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
- (Nếu bạn đã cài đặt
apigee-adminapi
) Cập nhật tiện íchapigee-adminapi
trên máy 6 và 7:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (Nếu bạn đã cài đặt Apigee SSO) Cập nhật Apigee SSO 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 bạn đã tạo khi cài đặt SSO.
- Khởi động lại thành phần giao diện người dùng:
- Giao diện người dùng cũ: 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ư ví dụ sau:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- Giao diện người dùng mới của Edge: 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
- Giao diện người dùng cũ: 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
Nâng cấp theo cụm 12 nút
Cập nhật các thành phần sau đây để cài đặt theo cụm 12 nút:
Hãy xem phần Các cấu trúc liên kết đã cài đặt để biết danh sách các cấu trúc liên kết và số nút của Edge.
- Cập nhật Cassandra và ZooKeeper:
- 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
- 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
- Trên máy 1, 2 và 3 trong Trung tâm dữ liệu 1:
- Cập nhật qpidd:
- Máy 4, 5 trong Trung tâm dữ liệu 1
- Cập nhật
qpidd
trên máy 4:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Cập nhật
qpidd
trên máy 5:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Cập nhật
- Máy 10, 11 trong Trung tâm dữ liệu 2
- Cập nhật
qpidd
trên máy 10:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Cập nhật
qpidd
trên máy 11:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Cập nhật
- Máy 4, 5 trong Trung tâm dữ liệu 1
- Cập nhật Postgres:
- Máy 6 trong Trung tâm dữ liệu 1
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Máy 12 trong Trung tâm dữ liệu 2
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Máy 6 trong Trung tâm dữ liệu 1
- Cập nhật LDAP:
- Máy 1 trong Trung tâm dữ liệu 1
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Máy 7 trong Trung tâm dữ liệu 2
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Máy 1 trong Trung tâm dữ liệu 1
- Cập nhật các thành phần Edge:
- 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
- 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
- Máy 4, 5, 6, 1, 2, 3 trong Trung tâm dữ liệu 1
- 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
):- Máy 1 trong Trung tâm dữ liệu 1:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- Máy 7 trong Trung tâm dữ liệu 2:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- Máy 1 trong Trung tâm dữ liệu 1:
- (Nếu bạn đã cài đặt
apigee-adminapi
) Cập nhật tiện íchapigee-adminapi
:- Máy 1 trong Trung tâm dữ liệu 1:
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- Máy 7 trong Trung tâm dữ liệu 2:
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- Máy 1 trong Trung tâm dữ liệu 1:
- (Nếu bạn đã cài đặt tính năng SSO của Apigee) Cập nhật tính năng SSO của Apigee:
- Máy 1 trong Trung tâm dữ liệu 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
- Máy 7 trong Trung tâm dữ liệu 2:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
Trong đó sso_config_file là tệp cấu hình bạn đã tạo khi cài đặt SSO.
- Máy 1 trong Trung tâm dữ liệu 1:
- 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:
- ZooKeeper
- Cassandra
- qpidd, ps
- LDAP
- Edge, có nghĩa là cấu hình "-c Edge" trên tất cả các nút theo thứ tự: nút có máy chủ Qpid, Máy chủ Edge Postgres, Máy chủ quản lý, Bộ xử lý thông báo và Bộ định tuyến.
- Giao diện người dùng Edge (phiên bản cũ hoặc mới)
apigee-adminapi
- Hoạt động đă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 đó.