Edge for Private Cloud phiên bản 4.18.01
Những phiên bản Edge nào bạn có thể cập nhật lên 4.18.01
Bạn có thể cập nhật Apigee Edge phiên bản 4.16.01.0x và 4.16.05.x lên 4.18.01 bằng cách này quy trình.
Nếu dùng phiên bản Edge trước phiên bản 4.16.01 thì trước tiên, bạn phải chuyển sang phiên bản 4.16.01 và sau đó cập nhật lên phiên bản 4.18.01.
- Bạn có thể di chuyển Apigee Edge phiên bản 4.15.07 sang 4.16.01.
- Nếu dùng phiên bản Edge trước phiên bản 4.15.07 thì trước tiên, bạn phải chuyển sang
phiên bản 4.15.07 và sau đó chuyển sang phiên bản 4.16.01.
- Nếu bạn đang di chuyển từ Edge phiên bản 4.14.04 trở lên: Di chuyển trực tiếp sang phiên bản 4.15.07.
- Nếu bạn đang di chuyển từ Edge phiên bản 4.14.01: Trước tiên, bạn phải di chuyển sang phiên bản 4.14.04, và sau đó chuyển sang phiên bản 4.15.07.
Những người có thể thực hiện quá trình cập nhật
Người dùng chạy bản cập nhật phải giống như người dùng đã cài đặt Edge ban đầu hoặc người dùng chạy dưới dạng thư mục gốc.
Sau khi bạn cài đặt RPM của cạnh, bất kỳ người dùng nào cũng có thể định cấu hình các RPM này.
Bạn phải cập nhật những thành phần nào
Bạn phải cập nhật tất cả các thành phần của Edge. Edge không hỗ trợ chế độ thiết lập có chứa các thành phần từ nhiều phiên bản.
Hạ cấp người quản lý vườn thú nếu cập nhật từ 4.16.01
Phiên bản Zookeeper RPM trong Edge dành cho Private Cloud 4.16.01 là apigee-zookeeper-3.4.5-1.0.905.noarch.rpm. Trong các phiên bản tiếp theo của Edge, phiên bản Zookeeper đã được đổi lại thành apigee-zookeeper-3.4.5-0.0.94x. Điều này ngăn yum nâng cấp Zookeeper lên phiên bản sau này từ 4.16.01. Cách chỉnh sửa tình huống này là để hạ cấp yum apigee-zookeeper trước khi cập nhật Zookeeper.
Bạn có thể kiểm tra phiên bản Zookeeper bằng cách sử dụng lệnh sau:
> rpm -qa |grep apigee-zookeeper
Nếu lệnh này trả về phiên bản Zookeeper:
apigee-zookeeper-3.4.5-1.0.905
Sau đó, bạn phải hạ cấp.
Tự động truyền tài sản cài đặt
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 thuộc tính này các giá trị được cập nhật giữ lại.
Cập nhật điều kiện tiên quyết
Hãy đáp ứng 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 toàn bộ tất cả các nút để đảm bảo an toàn lý do. 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 không cập nhật được phiên bản mới hoạt động đúng cách. Để biết thêm thông tin về sao lưu, hãy xem bài viết Sao lưu và Khôi phục. - Đảm bảo Edge đang chạy
Đảm bảo rằng Edge đang hoạt động trong quá trình cập nhật bằng cách dùng lệnh:
> /opt/apigee/apigee-service/bin/apigee-all trạng thái
Xử lý bản cập nhật không thành công
Trong trường hợp không cập nhật được, bạn có thể thử khắc phục vấn đề rồi chạy update.sh một lần nữa. Bạn có thể chạy bản cập nhật nhiều lần và sẽ tiếp tục cập nhật từ vị trí cuối cùng tắt.
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 Quy trình khôi phục 4.18.01 để biết thêm thông tin.
Thông tin cập nhật ghi nhật ký
Theo mặc định, tệp update.sh tiện ích 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 đó, hệ thống 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, tiện ích update.sh sẽ bị lỗi.
Bắt buộc nâng cấp lên Java JDK phiên bản 8
Bản phát hành Edge này yêu cầu bạn phải cài đặt Java JDK phiên bản 8 trên tất cả các Edge các nút xử lý. Bạn có thể cài đặt Oracle JDK 8 hoặc OpenJDK 8. Nếu Java JDK 8 chưa được cài đặt tập lệnh cập nhật có thể cài đặt nó cho bạn.
Là một phần của bản cập nhật lên Java 8, một số thuật toán mật mã TLS không còn có sẵn trong Oracle JDK 8. Cho danh sách đầy đủ, hãy xem phần "Bộ mật mã bị vô hiệu hoá mặc định" tại http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.
Bắt buộc để bật kho lưu trữ EPEL
Bạn phải bật Gói bổ sung cho Enterprise Linux (hoặc EPEL) để cài đặt hoặc cập nhật Edge. Lệnh bạn sử dụng phụ thuộc trên phiên bản RedHat/CentOS của bạn:
- Đối với RedHat/CentOS 7.x:
> wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; vòng/phút – ivh epel-release-latest-7.noarch.rpm - Đối với RedHat/CentOS 6.x:
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; vòng/phút – ivh epel-release-latest-6.noarch.rpm
Bắt buộc thêm SMTPmailFROM thông số cấu hình
Edge 4.17.05 đã thêm một tham số bắt buộc mới vào tệp cấu hình được dùng khi bạn bật máy chủ SMTP. Nếu đang cập nhật từ phiên bản 4.17.01, bạn phải 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 thiết lập SMTPmailFROM trong tệp cấu hình.
Thông 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 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 Đám mây riêng tư Apigee Edge hiện có cài đặt. 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ợ Giao thức truy cập thư mục hạng nhẹ (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 hệ thống quản trị viên để quản lý thông tin đăng nhập của người dùng từ dịch vụ quản lý thư mục tập trung, cho các hệ thống sử dụng công cụ này như Apigee Edge.
Xem phần Xác thực bên ngoài Cấu hình để biết thêm thông tin.
Khi bạn bật tính năng xác thực bên ngoài, hầu hết khách hàng đều sử dụng tài khoản Active Directory SAM trường name (tên người dùng) làm tên người dùng để xác thực thay vì địa chỉ email được sử dụng bởi Máy chủ OpenLDAP ở cạnh.
Nếu bạn đã tích hợp với 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 của bạn khi cập nhật Edge lên 4.18.01:
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, vì tên người dùng.
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 Bộ định tuyến và Bộ 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ể dùng lệnh sau để chặn cổng này
nút Qpid:
> sudo iptables -A INPUT -p tcp --đích-cổng 5672 ! -s `tên máy chủ` -i eth0 -j DROP - Chờ hàng đợi Qpid hết thông báo để đảm bảo rằng nút Qpid đã xử lý tất cả
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 được
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à Bộ xử lý tin nhắn.
Bạn có thể dùng lệnh sau để bỏ chặn cổng này:
> sudo iptables -F
Lưu ý rằng nếu bạn đang sử dụng iptables cho các quy tắc khác, bạn có thể sử dụng tùy chọn -D để đảo ngược lệnh thay đổi cụ thể:
> sudo iptables -D INPUT -p tcp --đích-cổng 5672 ! -s `tên máy chủ` -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.
Cần nâng cấp lên Postgres 9.6
Bản phát hành Edge này bao gồm bản nâng cấp lên Postgres 9.6. Trong quá trình nâng cấp đó, tất cả Dữ liệu Postgres được di chuyển sang Postgres 9.6.
Trong quá trình cập nhật, trong khi các nút Postgres ngừng hoạt động để cập nhật, 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à hoạt động trở lại, Analytics sau đó, dữ liệu sẽ được đẩy đến các nút Postgres.
Cần có nút chế độ chờ Postgres bổ sung nếu bạn phải khôi phục bản cập nhật cho bất kỳ lý do. Nếu bạn phải khôi phục bản cập nhật, nút chế độ chờ Postgres mới sẽ trở thành nút chính Nút Postgres sau khi khôi phục. Do đó, khi bạn cài đặt nút dự phòng Postgres mới, 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ư được xác định trong Các yêu cầu đối với việc cài đặt Edge.
Cài đặt Postgres mới nút chế độ chờ
Quy trình này sẽ tạo một máy chủ dự phòng Postgres trên một nút mới. Hãy đảm bảo rằng bạn cài đặt một Máy chủ dự phòng Postgres cho phiên bản Edge hiện có (4.16.01 hoặc 4.16.05) của bạn, không dành cho phiên bản 4.18.01.
Để 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 hiện tại của Edge.
Cách tạo nút chờ Postgres mới:
- Trên trang cái Postgres hiện tại, hãy chỉnh sửa thuộc tính /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 API sao chép existing_slave_ip/32 Trust\ \nbản sao máy chủ lưu trữ apigee new_slave_ip/32 Trust
trong đó existing_slave_ip là địa chỉ IP của Postgres hiện tại máy chủ chế độ chờ và new_slave_ip là địa chỉ IP của chế độ chờ mới nút. - Khởi động lại apigee-postgresql
trên trang cái Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql khởi động lại - Xác minh rằng nút chế độ chờ mới đã được thêm vào bằng cách xem /opt/apigee/apigee-postgresql/conf/pg_hba.conf
trên trang cái. Bạn sẽ thấy các dòng sau trong tệp đó:
API sao chép máy chủ lưu trữ độ tin cậy_slave_ip/32 hiện tại
tính năng sao chép máy chủ apigee new_slave_ip/32 Trust - Cài đặt máy chủ dự phòng Postgres mới:
- Chỉnh sửa tệp cấu hình mà bạn đã dùng để cài đặt phiên bản Edge hiện tại để chỉ định
sau đây:
# địa chỉ IP của địa chỉ hiện tại trang cái:
PG_MASTER=192.168.56.103
# địa chỉ IP của nút chế độ chờ mới
PG_STANDBY=192.168.56.102 - Tắt SELinux như mô tả trong bài viết Cài đặt tiện ích thiết lập apigee của Edge.
- Tải tệp Edge bootstrap_4.16.05.sh xuống /tmp/bootstrap_4.16.05.sh:
> cuộn tròn https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
Lưu ý: Nếu bạn đang cập nhật từ phiên bản 4.16.01, hãy tải tệp bootstrap.sh của Edge xuống. - Cài đặt tiện ích apigee-service của Edge và
phần phụ thuộc:
> sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord - Sử dụng apigee-service để
cài đặt trình thiết lập apigee
tiện ích:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup settings - 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- Chế độ chờ
Xác thực rằng đó là chế độ chờ.
- Chỉnh sửa tệp cấu hình mà bạn đã dùng để cài đặt phiên bản Edge hiện tại để chỉ định
sau đây:
Đang gỡ bỏ Postgres nút
Sau khi cập nhật xong, hãy huỷ bỏ nút chế độ chờ mới:
- Đảm bảo Postgres đang chạy:
> /opt/apigee/apigee-service/bin/apigee-all trạng thái
Nếu Postgres không chạy, hãy khởi động:
> /opt/apigee/apigee-service/bin/apigee-all bắt đầu - Lấy UUID của nút chế độ chờ mới bằng cách chạy lệnh cURL sau trên
nút chế độ chờ:
> cuộn tròn sysAdminEmail:password http://<node_IP>:8084/v1/servers/self
Bạn sẽ thấy mã nhận dạng duy nhất (UUID) của nút ở cuối kết quả, có dạng:
"loại" : [ "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 dừng - 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ỏi conf_pg_hba_replication.connection:
conf_pg_hba_replication.connection=host độ tin cậy apigee existing_slave_ip/32 - Khởi động lại apigee-postgresql trên trang chính Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql khởi động lại - Xác minh rằng nút chế độ chờ mới đã bị xoá bằng cách xem /opt/apigee/apigee-postgresql/conf/pg_hba.conf
trên trang cái. Bạn sẽ chỉ thấy dòng sau trong tệp đó:
API sao chép máy chủ lưu trữ existing_slave_ip/32 độ tin cậy - Xoá UUID của nút chế độ chờ khỏi ZooKeeper bằng cách thực hiện quản lý Edge sau
Lệnh gọi API trên nút Máy chủ quản lý:
> cuộn tròn sysAdminEmail:password -X XOÁ http://<ms_IP>:8080/v1/servers/<new_slave_uuid>
Cập nhật khi không có thời gian ngừng hoạt động
Cập nhật ngay tức thì hoặc cập nhật định kỳ cho phép bạn cập nhật bản cài đặt Edge mà không cần đưa Edge 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 mà không lo gián đoạn hoạt động là xóa từng Bộ định tuyến khỏi tải trình cân bằng. Sau đó, bạn cập nhật Bộ định tuyến và bất kỳ thành phần nào khác trên cùng một máy với Bộ định tuyến, sau đó thêm lại Bộ định tuyến vào trình cân bằng tải.
- Cập nhật máy theo đúng thứ tự cho việc cài đặt của bạn như được mô tả dưới đây trong phần "Yêu cầu bản cập nhật máy".
- 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 kết nối được Bộ định tuyến đó, như là được mô tả trong Bật/Tắt máy chủ (Bộ xử lý thông báo/Bộ định tuyến) Phạm vi tiếp cận.
- 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.
- Làm cho Bộ định tuyến có thể truy cập lại.
- 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.
- 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 xử lý những vấn đề sau trước/sau khi cập nhật:
- Trên nút kết hợp Bộ định tuyến và Trình xử lý thông báo:
- Trước khi cập nhật – hãy thực hiện các bước sau:
- Làm cho Bộ định tuyến không thể kết nối được.
- Đặt Trình xử lý tin nhắn ở chế độ không thể kết nối.
- Sau khi cập nhật, hãy thực hiện như sau:
- Kết nối với Trình xử lý tin nhắn.
- Làm cho Bộ định tuyến có thể truy cập được.
- Trước khi cập nhật – hãy thực hiện các bước sau:
- Trên nút Bộ định tuyến đơn:
- Trước khi cập nhật, hãy ngắt kết nối với Bộ định tuyến.
- Sau khi cập nhật, hãy kết nối với 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 đặt Trình xử lý tin nhắn ở chế độ 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 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 sẽ giống với trình bạn đã sử dụng để cài đặt Edge 4.16.01 hoặc 4.16.05.
Quy trình cập nhật lên 4.18.01 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 bạn đang sử dụng tính năng sao chép chế độ chờ chính của Postgres, hãy cài đặt một Postgres mới nút chờ như mô tả ở trên trong phần Cài đặt Postgres mới nút chế độ chờ.
- 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.
- Đă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ù quá trình cài đặt RPM yêu cầu quyền truy cập vào thư mục gốc, nhưng bạn có thể thực hiện thao tác trên Edge mà không có quyền truy cập gốc. - Cài đặt yum-utils và
yum-plugin-priorities:
> sudo yum cài đặt yum-utils
> sudo yum cài đặt các ưu tiên của trình bổ trợ yum - Tắt SELinux như mô tả trong Cài đặt tiện ích thiết lập apigee của Edge.
- Bật kho lưu trữ EPEL như mô tả ở trên.
- Nếu bạn đang cài đặt trên Oracle 7.x, hãy chạy lệnh sau:
> sudo yum-config-manager --enable ol7_optional_entity - Nếu bạn đang cài đặt trên AWS, hãy chạy các lệnh yum-configure-manager sau:
> thông tin cập nhật ngon rh-amazon-rhui-client.noarch
> trình quản lý cấu hình sudo yum --bật rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional - Tải tệp Edge 4.18.01 bootstrap_4.18.01.sh xuống /tmp/bootstrap_4.18.01.sh:
> cuộn tròn https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh - Cài đặt tiện ích apigee-service của Edge 4.18.01 và
phần phụ thuộc:
> sudo bash /tmp/bootstrap_4.18.01.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 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 xem bạn đã cài đặt Java 1.8 hay chưa. Nếu không, cài đặt ứng dụng đó cho bạn. Sử dụng lựa chọn JAVA_FIX để chỉ định cách xử lý Cài đặt Java. JAVA_FIX sẽ lấy 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. - Sử dụng apigee-service để
cập nhật tiện ích thiết lập apigee:
- Nếu bạn đã cài đặt 4.16.01 bằng cách nâng cấp Edge phiên bản 4.15.07.0x, bạn phải cài đặt
tiện ích thiết lập apigee:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
Lệnh này sẽ cài đặt tiện ích update.sh trong /opt/apigee/apigee-setup/bin.
Nếu bạn đã cài đặt tiện ích apigee-setup, hãy cập nhật số điện thoại đó:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup cập nhật - Nếu bạn đã cài đặt trực tiếp 4.16.01, nghĩa là bạn không thực hiện nâng cấp từ
4.15.07.0x, bạn phải cập nhật tiện ích thiết lập apigee:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup cập nhật
Bản cập nhật này cho apigee-service sẽ cài đặt Tiện ích update.sh trong /opt/apigee/apigee-setup/bin. - Nếu đã cài đặt 4.16.05 trực tiếp hoặc bằng bản cập nhật, bạn phải cập nhật
tiện ích thiết lập apigee:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup cập nhật
Bản cập nhật này cho apigee-service sẽ cài đặt Tiện ích update.sh trong /opt/apigee/apigee-setup/bin.
- Nếu bạn đã cài đặt 4.16.01 bằng cách nâng cấp Edge phiên bản 4.15.07.0x, bạn phải cài đặt
tiện ích thiết lập apigee:
- Tuỳ thuộc vào phiên bản Edge hiện tại, bạn phải cài đặt hoặc cập nhật
apigee-validate trên
Máy chủ quản lý.
- Nếu bạn đang sử dụng Edge 4.16.05: hãy 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 cập nhật - Nếu bạn đang sử dụng Edge 4.16.01: hãy cài đặt tiện ích apigee-validate trên
Máy chủ quản lý:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate cài đặt
Lưu ý: Nếu bạn đã cài đặt tiện ích apigee-validate trên một Thông báo Nút bộ xử lý khi cài đặt 4.16.01, bạn có thể cập nhật nó bằng cách sử dụng lệnh sau trên nút đó:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate cập nhật
Tuy nhiên, kể từ phiên bản 4.16.05 trở lên, Apigee khuyên bạn nên cài đặt và chạy tiện ích apigee-validate đang bật Máy chủ quản lý. - Nếu bạn đang nâng cấp từ phiên bản 4.16.01: Hãy chỉnh sửa tệp cấu hình được chuyển vào
tiện ích apigee-validate. Ngang bằng
bản phát hành Edge 4.16.01, tệp cấu hình mà apigee-validate sử dụng đã yêu cầu những điều sau
thuộc tính:
APIGEE_ADMINPW=sysAdminPword
MP_POD=gateway
KHU VỰC=dc-1
Trong bản phát hành này, tệp cấu hình chỉ yêu cầu thuộc tính APIGEE_ADMINPW. Bạn có thể xoá hai thuộc tính còn lại trong tệp.
- Nếu bạn đang sử dụng Edge 4.16.05: hãy cập nhật tiện ích apigee-validate trên
Máy chủ quản lý:
- Cập nhật apigee-provision
tiện ích:
> /opt/apigee/apigee-service/bin/apigee-service apigee- đãi cập nhật - Chạy tiện ích cập nhật trên các nút của bạn theo thứ tự được mô tả dưới đây trong "Thứ tự của máy
cập nhật" bên dưới:
> /opt/apigee/apigee-setup/bin/update.sh -c thành phần -f configFile
Yêu cầu duy nhất đối với tệp cấu hình là tệp cấu hình phải có thể truy cập được hoặc "apigee" có thể đọc được người dùng.
Dùng tuỳ chọn “-c” để chỉ định thành phần cần cập nhật. Danh sách các lựa chọn có thể áp dụng thành phần bao gồm:
ldap = OpenLDAP
cs = Cassandra
zk = Người giữ vườn
qpid = qpidd
ps = postgresql
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
ui = Giao diện người dùng cạnh
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 aio Edge hoặc cài đặt API BaaS asa hồ sơ)
e = Tìm kiếm đàn hồi
b = Ngăn xếp API BaaS
p = Cổng API BaaS
ebp = ElasticSearch, API BaaS Ngăn xếp và API BaaS Portal trên cùng một nút - Kiểm tra bản cập nhật bằng cách chạy tiện ích xác thực apigee trên Máy chủ quản lý, như được mô tả trong Kiểm thử cài đặt.
- Nếu bạn đã cài đặt nút chế độ chờ Postgres mới, hãy huỷ quá trình giải phóng nút này theo mô tả ở trên trong Gỡ bớt Postgres nút.
Để khôi phục bản cập nhật sau này, hãy làm theo quy trình được mô tả trong Quy trình khôi phục 4.18.01.
Thủ tục cập nhật lên 4.18.01 từ cục bộ kho lưu trữ
Nếu các nút Edge của bạn bị tường lửa chặn hoặc bị cấm truy cập theo một cách khác kho lưu trữ Apigee qua Internet, 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 tùy 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ừ .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ủ của riêng mình máy chủ web.
Cách cập nhật từ kho lưu trữ 4.18.01 cục bộ:
- Nếu bạn đang sử dụng tính năng sao chép chế độ chờ chính của Postgres, hãy cài đặt một Postgres mới nút chờ như mô tả ở trên trong phần Cài đặt Postgres mới nút chế độ chờ.
- Tạo một kho lưu trữ cục bộ 4.18.01 như mô tả trong phần "Tạo kho lưu trữ Apigee cục bộ" tại phần Cài đặt tiện ích thiết lập apigee của Edge.
Lưu ý: Nếu đã có kho lưu trữ 4.16.01 hoặc 4.16.05, bạn có thể thêm 4.18.01 kho lưu trữ cho nó như mô tả trong phần "Cập nhật kho lưu trữ Apigee cục bộ" tại phần Cài đặt tiện ích thiết lập apigee của Edge. -
Cách cài đặt apigee-service từ tệp .tar:
- 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.18.01.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 địa chỉ đó vào thư mục /tmp trên nút mới.
- Trên nút mới, hãy khôi phục tệp vào thư mục /tmp:
> tar -xzf apigee-4.18.01.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 và các phần phụ thuộc apigee-service Edge từ /tmp/repos:
> sudo bash /tmp/repos/bootstrap_4.18.01.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.
- 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.18.01.tar.gz:
-
Cách cài đặt dịch vụ apigee 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 qua kho lưu trữ bằng Nginx webserver" lúc Cài đặt Edge tiện ích thiết lập apigee.
- Trên nút điều khiển từ xa, tải tệp Edge bootstrap_4.18.01.sh xuống để
/tmp/bootstrap_4.18.01.sh:
> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
trong đó uName:pWord là tên người dùng và mật khẩu mà bạn đặt ở trên kho lưu trữ và remoteRepo là địa chỉ IP hoặc tên DNS của nút repo. - Trên nút từ xa, hãy cài đặt tiện ích và các phần phụ thuộc dịch vụ apigee của Edge:
> sudo bash /tmp/bootstrap_4.18.01.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ữ.
- Sử dụng apigee-service để
cập nhật tiện ích thiết lập apigee:
- Nếu bạn đã cài đặt 4.16.01 bằng cách nâng cấp Edge phiên bản 4.15.07.0x, bạn phải cài đặt
tiện ích thiết lập apigee:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
Lệnh này sẽ cài đặt tiện ích update.sh trong /opt/apigee/apigee-setup/bin.
Nếu bạn đã cài đặt tiện ích apigee-setup, hãy cập nhật số điện thoại đó:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup cập nhật - Nếu bạn đã cài đặt trực tiếp 4.16.01, nghĩa là bạn không thực hiện nâng cấp từ
4.15.07.0x, bạn phải cập nhật tiện ích thiết lập apigee:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup cập nhật
Bản cập nhật này cho apigee-service sẽ cài đặt Tiện ích update.sh trong /opt/apigee/apigee-setup/bin. - Nếu đã cài đặt 4.16.05 trực tiếp hoặc bằng bản cập nhật, bạn phải cập nhật
Tiện ích thiết lập apigee:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup cập nhật
Bản cập nhật này cho apigee-service sẽ cài đặt Tiện ích update.sh trong /opt/apigee/apigee-setup/bin.
- Nếu bạn đã cài đặt 4.16.01 bằng cách nâng cấp Edge phiên bản 4.15.07.0x, bạn phải cài đặt
tiện ích thiết lập apigee:
- Tuỳ thuộc vào phiên bản Edge hiện tại, bạn phải cài đặt hoặc cập nhật
apigee-validate trên
Máy chủ quản lý.
- Nếu bạn đang sử dụng Edge 4.16.05: hãy 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 cập nhật - Nếu bạn đang sử dụng Edge 4.16.01: hãy cài đặt tính năng xác thực apigee
tiện ích trên Máy chủ quản lý:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate cài đặt
Lưu ý: Nếu bạn đã cài đặt tiện ích apigee-validate trên một Thông báo Nút bộ xử lý khi cài đặt 4.16.01, bạn có thể cập nhật nó bằng cách sử dụng lệnh sau trên nút đó:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate cập nhật
Tuy nhiên, kể từ phiên bản 4.16.05 trở lên, Apigee khuyên bạn nên cài đặt và chạy tiện ích xác thực apigee trên Máy chủ quản lý. - Nếu bạn đang nâng cấp từ phiên bản 4.16.01: Hãy chỉnh sửa tệp cấu hình được chuyển vào
phần mềm tiện ích apigee-validate. Ngang bằng
bản phát hành Edge 4.16.01, tệp cấu hình mà apigee-validate sử dụng đã yêu cầu những điều sau
thuộc tính:
APIGEE_ADMINPW=sysAdminPword
MP_POD=gateway
KHU VỰC=dc-1
Trong bản phát hành này, tệp cấu hình chỉ yêu cầu thuộc tính APIGEE_ADMINPW. Bạn có thể xoá hai thuộc tính còn lại trong tệp.
- Nếu bạn đang sử dụng Edge 4.16.05: hãy cập nhật tiện ích apigee-validate trên
Máy chủ quản lý:
- Cập nhật apigee-provision
tiện ích:
> /opt/apigee/apigee-service/bin/apigee-service apigee-êu cập nhật - Chạy tiện ích cập nhật trên các nút của bạn theo thứ tự mô tả dưới đây trong phần "Thứ tự của máy
cập nhật" bên dưới:
> /opt/apigee/apigee-setup/bin/update.sh -c thành phần -f configFile
Yêu cầu duy nhất đối với tệp cấu hình là tệp cấu hình phải có thể truy cập được hoặc "apigee" có thể đọc được người dùng.
Dùng tuỳ chọn “-c” để chỉ định thành phần cần cập nhật. Danh sách các lựa chọn có thể áp dụng thành phần bao gồm:
ldap = OpenLDAP
cs = Cassandra
zk = Người giữ vườn
qpid = qpidd
ps = postgresql
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
ui = Giao diện người dùng cạnh
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 aio Edge hoặc cài đặt API BaaS asa hồ sơ)
e = Tìm kiếm đàn hồi
b = Ngăn xếp API BaaS
p = Cổng API BaaS
ebp = ElasticSearch, API BaaS Ngăn xếp và API BaaS Portal trên cùng một nút - Kiểm tra bản cập nhật bằng cách chạy tiện ích xác thực apigee trên Máy chủ quản lý, như được mô tả trong Kiểm thử cài đặt.
- Nếu bạn đã cài đặt nút chế độ chờ Postgres mới, hãy huỷ quá trình giải phóng nút này theo mô tả ở trên trong Gỡ bớt Postgres nút.
Để khôi phục bản cập nhật sau này, hãy làm theo quy trình được mô tả trong Quy trình khôi phục 4.18.01.
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. Nhiều nhất những điểm quan trọng cần cân nhắc liên quan đến bản cập nhật là:
- 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ỳ các nút 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 nhưng không phải Máy chủ Postgres), hãy sử dụng "-c Edge" để cập nhật tất cả các quảng cáo tại .
- Nếu một bước chỉ định rằng cần được thực hiện trên nhiều máy, hãy thực hiện bước đó trong đơn đặt hàng máy được chỉ định.
- Bạn không cần thực hiện bước riêng để cập nhật tính năng Kiếm tiền. Trường này được cập nhật khi bạn chỉ định "-c cạnh" .
Đối với sự kiện độc lập gồm 1 người tổ chức cài đặt
- Thiết lập SMTPmailFROM trong
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>" - Nếu cập nhật từ phiên bản 4.16.01, hãy hạ cấp Zookeeper:
> hạ cấp ngon người quản lý apigee - Cập nhật Cassandra và ZooKeeper:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - Đặt quy tắc iptables sau đây:
> sudo iptables -A INPUT -p tcp --đích-cổng 5672 ! -s `tên máy chủ` -i eth0 -j DROP - 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 "thư" là 0. Bạn không thể nâng cấp Qpid cho đến khi hệ thống xử lý xong tất cả thư. - Cập nhật qpidd:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Xoá đối tượng IP:
> sudo iptables -F - Cập nhật LDAP:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - Dừng máy chủ Postgres, máy chủ Qpid và PostgreSQL:
> /opt/apigee/apigee-service/bin/apigee-service cạnh-postgres-server dừng
> /opt/apigee/apigee-service/bin/apigee-service cạnh-qpid-server dừng
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql dừng - Cập nhật postgresql:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Cập nhật cơ sở dữ liệu Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Cập nhật các thành phần còn lại trong Edge:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile - Cập nhật giao diện người dùng Edge:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
Dành cho mô hình độc lập gồm 2 người tổ chức cài đặt
Xem phần Thông tin xin lỗi về việc cài đặt để biết danh sách các Edge cấu trúc liên kết và số nút.
- Thiết lập SMTPmailFROM trong
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>" - Nếu cập nhật từ 4.16.01, hạ cấp Zookeeper trên máy 1:
> hạ cấp ngon người quản lý apigee - Cập nhật Cassandra và ZooKeeper trên máy 1:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - Đặt quy tắc iptables sau đây trên máy 2:
> sudo iptables -A INPUT -p tcp --đích-cổng 5672 ! -s `tên máy chủ` -i eth0 -j DROP - 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 "thư" là 0. Bạn không thể nâng cấp Qpid cho đến khi hệ thống xử lý xong tất cả thư. - Cập nhật qpidd
máy 2:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Xoá các iptables trên máy 2:
> sudo iptables -F - 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 của Edge trên máy 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 - Cập nhật postgresql trên máy 2:
- Dừng máy chủ Postgres, máy chủ Qpid và postgresql:
> /opt/apigee/apigee-service/bin/apigee-service cạnh-postgres-server dừng
> /opt/apigee/apigee-service/bin/apigee-service cạnh-qpid-server dừng
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql dừng - Cập nhật postgresql:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Cập nhật cơ sở dữ liệu Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Cập nhật các thành phần Edge trên máy 2:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
- Dừng máy chủ Postgres, máy chủ Qpid và postgresql:
Đối với 5 máy chủ lưu trữ được phân cụm cài đặt
Xem phần Thông tin xin lỗi về việc cài đặt để biết danh sách các Edge cấu trúc liên kết và số nút.
- Thiết lập SMTPmailFROM trong
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>" - Đảm bảo rằng bạn đã cài đặt nút dự phòng Postgres mới như mô tả ở trên trong phần Cài đặt Postgres mới nút chế độ chờ.
- Nếu cập nhật từ phiên bản 4.16.01, hãy hạ cấp Zookeeper trên máy 1, 2 và 3:
> hạ cấp ngon người quản lý apigee - 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 - Đặt quy tắc iptables sau đây trên máy 4:
> sudo iptables -A INPUT -p tcp --đích-cổng 5672 ! -s `tên máy chủ` -i eth0 -j DROP - 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 "thư" là 0. Bạn không thể nâng cấp Qpid cho đến khi hệ thống xử lý xong tất cả thư. - Cập nhật qpidd
máy 4:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Xoá các iptable trên máy 4:
> sudo iptables -F - Lặp lại các bước từ 5 đến 8 trên máy 5.
- 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 của Edge trên máy 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 trên máy 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile - Cập nhật máy 4 và 5:
- Dừng máy chủ Postgres và máy chủ Qpid trên máy 4:
> /opt/apigee/apigee-service/bin/apigee-service cạnh-postgres-server dừng
> /opt/apigee/apigee-service/bin/apigee-service cạnh-qpid-server dừng - Dừng máy chủ Postgres, máy chủ Qpid và postgresql trên máy 5:
> /opt/apigee/apigee-service/bin/apigee-service cạnh-postgres-server dừng
> /opt/apigee/apigee-service/bin/apigee-service cạnh-qpid-server dừng
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql dừng - Dừng máy chủ Postgres và postgresql trên nút ở chế độ chờ mới mà bạn đã thêm vào
khôi phục:
> /opt/apigee/apigee-service/bin/apigee-service cạnh-postgres-server dừng
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql dừng - Cập nhật postgresql trên máy 4:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Cập nhật cơ sở dữ liệu Postgres trên máy 4 (chỉ dành cho phiên bản chính của Postgres):
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Cập nhật postgresql trên máy 5:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Khởi động máy chủ Postgres và máy chủ Qpid trên máy 4 và 5:
> /opt/apigee/apigee-service/bin/apigee-service cạnh-postgres-server bắt đầu
> /opt/apigee/apigee-service/bin/apigee-service cạnh-qpid-server bắt đầu - Định cấu hình Postgres làm nút chế độ chờ bằng cách chạy các lệnh sau trên máy
5:
> cd /opt/apigee/data/apigee-postgresql/pgdata
> rm -rf *
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replations-on- Chế độ chờ -f configFile - Xác minh trạng thái sao chép bằng cách phát các tập lệnh sau trên cả hai máy chủ. Chiến lược phát hành đĩa đơn
hệ thống phải hiển thị kết quả giống nhau trên cả hai máy chủ để đảm bảo thành công
nhân bản:
Trên máy 4, nút chính, hãy chạy:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
Xác thực rằng đó là nút chính.
Trên máy 5, nút chế độ chờ:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql Postgres-check- Chế độ chờ
Xác thực rằng đó là chế độ chờ.
- Dừng máy chủ Postgres và máy chủ Qpid trên máy 4:
- Cập nhật các thành phần Edge trên máy 4, 5:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile - Đảm bảo rằng bạn ngừng hoạt động nút chờ mới bằng cách sử dụng quy trình ở trên trong phần Gỡ bỏ một Postgres nút.
Dành cho mô hình phân cụm 9 máy chủ cài đặt
Xem phần Thông tin xin lỗi về việc cài đặt để biết danh sách các Edge cấu trúc liên kết và số nút.
- Thiết lập SMTPmailFROM trong
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>" - Đảm bảo rằng bạn đã cài đặt nút dự phòng Postgres mới như mô tả ở trên trong phần Cài đặt Postgres mới nút chế độ chờ.
- Nếu cập nhật từ phiên bản 4.16.01, hãy hạ cấp Zookeeper trên macine 1, 2 và 3:
> hạ cấp ngon người quản lý apigee - 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 - Đặt quy tắc iptables sau đây trên máy 6:
> sudo iptables -A INPUT -p tcp --đích-cổng 5672 ! -s `tên máy chủ` -i eth0 -j DROP - 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 "thư" là 0. Bạn không thể nâng cấp Qpid cho đến khi hệ thống xử lý xong tất cả thư. - Cập nhật qpidd
máy 6:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Xoá iptables trên máy 6:
> sudo iptables -F - Lặp lại các bước từ 5 đến 8 trên máy 7.
- 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 của Edge trên máy 6, 7, 1, 4 và 5 theo thứ tự tương ứng:
> /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 - Cập nhật máy 8 và 9:
- Dừng máy chủ Postgres trên máy 8:
> /opt/apigee/apigee-service/bin/apigee-service cạnh-postgres-server dừng - Dừng máy chủ Postgres và postgresql trên máy 9:
> /opt/apigee/apigee-service/bin/apigee-service cạnh-postgres-server dừng
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql dừng - Dừng máy chủ Qpid trên máy 6 và 7:
> /opt/apigee/apigee-service/bin/apigee-service cạnh-qpid-server dừng - Dừng máy chủ Postgres và postgresql trên nút ở chế độ chờ mới mà bạn đã thêm vào
khôi phục:
> /opt/apigee/apigee-service/bin/apigee-service cạnh-postgres-server dừng
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql dừng - Cập nhật postgresql trên máy 8:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Cập nhật cơ sở dữ liệu Postgres trên máy 8 (chỉ dành cho phiên bản chính của Postgres):
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Cập nhật postgresql trên máy 9:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Khởi động máy chủ Postgres trên máy 8 và 9:
> /opt/apigee/apigee-service/bin/apigee-service cạnh-postgres-server bắt đầu - Khởi động máy chủ Qpid trên máy 6 và 7:
> /opt/apigee/apigee-service/bin/apigee-service cạnh-qpid-server bắt đầu - Định cấu hình Postgres làm nút chế độ chờ bằng cách chạy các lệnh sau trên máy
9:
> cd /opt/apigee/data/apigee-postgresql/pgdata
> rm -rf *
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replations-on- Chế độ chờ -f configFile - Xác minh trạng thái sao chép bằng cách phát các tập lệnh sau trên cả hai máy chủ. Chiến lược phát hành đĩa đơn
hệ thống phải hiển thị kết quả giống nhau trên cả hai máy chủ để đảm bảo thành công
nhân bản:
Trên máy 8, nút chính, hãy chạy:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
Xác thực rằng đó là nút chính.
Trên máy 9, nút chế độ chờ:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql Postgres-check- Chế độ chờ
Xác thực rằng đó là chế độ chờ.
- Dừng máy chủ Postgres trên máy 8:
- Cập nhật các thành phần của Edge trên máy 8 và 9:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile - Đảm bảo rằng bạn ngừng hoạt động nút chờ mới bằng cách sử dụng quy trình ở trên trong phần Gỡ bỏ một Postgres nút.
Dành cho mô hình phân cụm gồm 13 máy chủ cài đặt
Xem phần Thông tin xin lỗi về việc cài đặt để biết danh sách các Edge cấu trúc liên kết và số nút.
- Thiết lập SMTPmailFROM trong
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>" - Đảm bảo rằng bạn đã cài đặt nút dự phòng Postgres mới như mô tả ở trên trong phần Cài đặt Postgres mới nút chế độ chờ.
- Nếu cập nhật từ phiên bản 4.16.01, hãy hạ cấp Zookeeper trên macine 1, 2 và 3:
> hạ cấp ngon người quản lý apigee - 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 - Đặt quy tắc iptables sau đây trên máy 12:
> sudo iptables -A INPUT -p tcp --đích-cổng 5672 ! -s `tên máy chủ` -i eth0 -j DROP - Kiểm tra hàng đợi tin nhắn 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 "thư" là 0. Bạn không thể nâng cấp Qpid cho đến khi hệ thống xử lý xong tất cả thư. - Cập nhật qpidd
máy 12:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Xoá các iptable trên máy 12:
> sudo iptables -F - Lặp lại các bước từ 5 đến 8 trên máy 13.
- 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 của Edge trên máy 12, 13, 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 trên máy 6 và 7:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile - Cập nhật máy 8 và 9:
- Dừng máy chủ Postgres trên máy 8:
> /opt/apigee/apigee-service/bin/apigee-service cạnh-postgres-server dừng - Dừng máy chủ Postgres và postgresql trên máy 9:
> /opt/apigee/apigee-service/bin/apigee-service cạnh-postgres-server dừng
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql dừng - Dừng máy chủ Qpid trên máy 12 và 13:
> /opt/apigee/apigee-service/bin/apigee-service cạnh-qpid-server dừng - Dừng máy chủ Postgres và postgresql trên nút ở chế độ chờ mới mà bạn đã thêm vào
khôi phục:
> /opt/apigee/apigee-service/bin/apigee-service cạnh-postgres-server dừng
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql dừng - Cập nhật postgresql trên máy 8:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Cập nhật cơ sở dữ liệu Postgres trên máy 8 (chỉ dành cho phiên bản chính của Postgres):
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Cập nhật postgresql trên máy 9:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Khởi động máy chủ Postgres trên máy 8 và 9:
> /opt/apigee/apigee-service/bin/apigee-service cạnh-postgres-server bắt đầu - Khởi động máy chủ Qpid trên máy 12 và 13:
> /opt/apigee/apigee-service/bin/apigee-service cạnh-qpid-server bắt đầu - Định cấu hình Postgres làm nút chế độ chờ bằng cách chạy các lệnh sau trên máy
9:
> cd /opt/apigee/data/apigee-postgresql/pgdata
> rm -rf *
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replations-on- Chế độ chờ -f configFile - Xác minh trạng thái sao chép bằng cách phát các tập lệnh sau trên cả hai máy chủ. Chiến lược phát hành đĩa đơn
hệ thống phải hiển thị kết quả giống nhau trên cả hai máy chủ để đảm bảo thành công
nhân bản:
Trên máy 8, nút chính, hãy chạy:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
Xác thực rằng đó là nút chính.
Trên máy 9, nút chế độ chờ:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql Postgres-check- Chế độ chờ
Xác thực rằng đó là chế độ chờ.
- Dừng máy chủ Postgres trên máy 8:
- Cập nhật các thành phần của Edge trên máy 8 và 9:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile - Đảm bảo rằng bạn ngừng hoạt động nút chờ mới bằng cách sử dụng quy trình ở trên trong phần Gỡ bỏ một Postgres nút.
Dành cho mô hình phân cụm gồm 12 máy chủ cài đặt
Xem phần Thông tin xin lỗi về việc cài đặt để biết danh sách các Edge cấu trúc liên kết và số nút.
- Thiết lập SMTPmailFROM trong
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>" - Đảm bảo rằng bạn đã cài đặt nút dự phòng Postgres mới như mô tả ở trên trong phần Cài đặt Postgres mới nút chế độ chờ.
- Cập nhật Cassandra và ZooKeeper:
- Nếu cập nhật từ phiên bản 4.16.01, hãy hạ cấp Zookeeper trên macine 1, 2 và 3 trong
Trung tâm dữ liệu 1:
> ngon hạ cấp apigee-zookeeper - 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 - Nếu cập nhật từ phiên bản 4.16.01, hãy hạ cấp Zookeeper trên macine 7, 8 và 9 trong
Trung tâm dữ liệu 2:
> ngon hạ cấp apigee-zookeeper - 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
- Nếu cập nhật từ phiên bản 4.16.01, hãy hạ cấp Zookeeper trên macine 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
- Đặt quy tắc iptables sau đây trên máy 4:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `tên máy chủ` -i eth0 -j DROP - Kiểm tra hàng đợi tin nhắn Qpid trên máy 4:
> qpid-stat -quý
Tiếp tục kiểm tra hàng đợi cho đến khi số lượng trong "thư" là 0. Bạn không thể nâng cấp Qpid cho đến khi xử lý xong tất cả thông báo. - Cập nhật qpidd trên máy 4:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Xoá các iptable trên máy 4:
> sudo iptables -T - Lặp lại các bước từ 1 đến 4 trên máy 5.
- Đặt quy tắc iptables sau đây trên máy 4:
- Máy 10, 11 trong Trung tâm dữ liệu 2
- Đặt quy tắc iptables sau đây trên máy 10:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `tên máy chủ` -i eth0 -j DROP - Kiểm tra hàng đợi tin nhắn Qpid trên máy 10:
> qpid-stat -quý
Tiếp tục kiểm tra hàng đợi cho đến khi số lượng trong "thư" là 0. Bạn không thể nâng cấp Qpid cho đến khi xử lý xong tất cả thông báo. - Cập nhật qpidd trên máy 10:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Xoá các iptable trên máy 10:
> sudo iptables -T - Lặp lại các bước từ 1 đến 4 trên máy 11.
- Đặt quy tắc iptables sau đây trên máy 10:
- Máy 4, 5 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 của Edge:
- Máy 4, 5, 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, 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, 1, 2, 3 trong Trung tâm dữ liệu 1
- Cập nhật giao diện người dùng:
- Máy 1 trong Trung tâm dữ liệu 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile - Máy 7 trong Trung tâm dữ liệu 2:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- Máy 1 trong Trung tâm dữ liệu 1:
- Cập nhật máy 6 trong Trung tâm dữ liệu 1 và 12 trong Trung tâm dữ liệu 2:
- Dừng máy chủ Postgres trên máy 6:
> /opt/apigee/apigee-service/bin/apigee-service cạnh-postgres-server dừng - Dừng máy chủ Postgres và postgresql trên máy 12:
> /opt/apigee/apigee-service/bin/apigee-service cạnh-postgres-server dừng
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql dừng - Dừng máy chủ Qpid trên máy 4, 5, 10 và 11:
> /opt/apigee/apigee-service/bin/apigee-service cạnh-qpid-server dừng - Dừng máy chủ Postgres và postgresql trên nút ở chế độ chờ mới mà bạn đã thêm vào
khôi phục:
> /opt/apigee/apigee-service/bin/apigee-service cạnh-postgres-server dừng
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql dừng - Cập nhật postgresql trên máy 6:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Cập nhật cơ sở dữ liệu Postgres trên máy 6 (chỉ dành cho phiên bản chính của Postgres):
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Cập nhật postgresql trên máy 12:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Khởi động máy chủ Postgres trên máy 6 và 12:
> /opt/apigee/apigee-service/bin/apigee-service cạnh-postgres-server bắt đầu - Khởi động máy chủ Qpid trên máy 4, 5, 10 và 11:
> /opt/apigee/apigee-service/bin/apigee-service cạnh-qpid-server bắt đầu - Định cấu hình Postgres làm nút chế độ chờ bằng cách chạy các lệnh sau trên máy
12:
> cd /opt/apigee/data/apigee-postgresql/pgdata
> rm -rf *
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replations-on- Chế độ chờ -f configFile - Xác minh trạng thái sao chép bằng cách phát các tập lệnh sau trên cả hai máy chủ. Chiến lược phát hành đĩa đơn
hệ thống phải hiển thị kết quả giống nhau trên cả hai máy chủ để đảm bảo thành công
nhân bản:
Trên máy 6, nút chính, hãy chạy:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
Xác thực rằng đó là nút chính.
Trên máy 12, nút chế độ chờ:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql Postgres-check- Chế độ chờ
Xác thực rằng đó là chế độ chờ.
- Dừng máy chủ Postgres trên máy 6:
- Cập nhật các thành phần của Edge trên máy 6 và 12:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile - Đảm bảo rằng bạn ngừng hoạt động nút chờ mới bằng cách sử dụng quy trình ở trên trong phần Gỡ bỏ một Postgres nút.
Đối với API 7 máy chủ hoặc 10 máy chủ Cài đặt hệ thống BaaS
Đối với quá trình lắp đặt không theo chuẩn
Nếu bạn cài đặt không theo chuẩn, hãy cập nhật các thành phần Edge như sau đơn đặt hàng:
- ZooKeeper
- Cassandra
- qpidd
- LDAP
- Edge, có nghĩa là "cạnh -c" trên tất cả các nút theo thứ tự: các nút có máy chủ Qpid nhưng
chứ không phải 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 "-c cạnh" bước 8 cho hồ sơ. - Giao diện người dùng Edge
- postgresql trên trang cái Postgres, bao gồm cả nâng cấp.
- postgresql trên chế độ chờ Postgres.
- Edge, có nghĩa là "cạnh -c" trên tất cả các nút kết hợp Qpid và Postgres hoặc trên bất kỳ nút Postgres độc lập.