Trang này được dịch bởi Cloud Translation API.

Cập nhật Apigee Edge 4.16.05.x lên bản phát hành 4.16.05 mới nhất

Edge for Private Cloud phiên bản 4.16.05

Tài liệu này có chứa quy trình mà bạn sử dụng để cập nhật cài đặt 4.16.05 hiện có của mình để sử dụng RPM mới nhất và các tệp hỗ trợ từ Apigee. Quy trình này sử dụng tiện ích update.sh để thực hiện cập nhật.

Những phiên bản Edge nào bạn có thể cập nhật lên bản phát hành 4.16.05 mới nhất

Bạn chỉ có thể cài đặt ứng dụng Apigee Edge phiên bản 4.16.05.x hiện có lên phiên bản mới nhất Bản phát hành 4.16.05.

Nếu đang chạy phiên bản Edge 4.16.01.0x trở xuống, thì trước tiên bạn phải chuyển sang 4.16.05. Xem bài viết Cập nhật Apigee Edge 4.16.01 lên 4.16.05 để biết thông tin về cách chuyển sang phiên bản 4.16.05.

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.

Yêu cầu về dung lượng ổ đĩa để cập nhật

Đảm bảo rằng bạn có ít nhất 1 GByte dung lượng ổ đĩa trống trước khi thực hiện cập nhật.

Tự động truyền tài sản cài đặt từ 4.16.05.x

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:

> /<inst_root>/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 phần Quy trình khôi phục 4.16.05.

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 không thành công.

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 phần tiếp theo "Không thể kết nối với Bộ định tuyến và Trình xử lý thư".
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.

Chế tạo một chiếc máy phay gỗ và Không thể kết nối với Trình xử lý tin nhắn

Trong quá trình thiết lập sản xuất, bạn sẽ có nhiều Bộ định tuyến và Bộ xử lý thư cần đạt được hiệu suất tối ưu và bạn phải bật/tắt khả năng tiếp cận của những Bộ định tuyến và Thông báo này Bộ xử lý trước/sau khi cập nhật.

Lệnh gọi API sau đây định cấu hình một nút là có thể truy cập hoặc không truy cập được:

> curl -u adminEmail:pWord -X POST "http://<ms_IP>:8080/v1/servers/UUID" -d "reachable=true|false"

trong đó UUID là UUID của Bộ xử lý thông báo hoặc Bộ định tuyến và có thể truy cập được đặt thành true hoặc false.

Nếu bạn cần xác định UUID của Bộ định tuyến, hãy sử dụng lệnh cURL sau:

> curl http://<routerIP>:8081/v1/servers/self

Nếu bạn cần xác định UUID của Trình xử lý thư, hãy sử dụng cURL sau :

> curl http://<mpIP>:8082/v1/servers/self

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:
  1. Làm cho Bộ định tuyến không kết nối được bằng cách sử dụng lệnh gọi API hiển thị ở trên.
  2. Đặ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:
  1. Kết nối với Trình xử lý tin nhắn.
  2. Làm cho Bộ định tuyến có thể truy cập được.
Trên nút Bộ định tuyến đơn:
- Trước khi cập nhật, hãy làm cho Bộ định tuyến có thể truy cập được.
- 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 như cách bạn đã sử dụng để cài đặt Edge 4.16.05.

Quy trình cập nhật 4.16.05 trên 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 đã đị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.
Tắt SELinux như mô tả trong phần Cài đặt thiết lập apigee của Edge tiện ích.
Xoá tất cả bộ nhớ đệm của Yum:
> sudo yum dọn dẹp tất cả
Tải tệp Edge bootstrap_4.16.05.sh mới nhất 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
Cập nhật phần phụ thuộc và tiện ích dịch vụ apigee của Edge:
> sudo bash /tmp/bootstrap_4.16.05.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ừ đó.
Dùng dịch vụ apigee để 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 apigee-service sẽ cài đặt tiện ích update.sh trong /<inst_dir>/apigee/apigee-setup/bin.
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 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. Ví dụ: đặt tệp trong thư mục /tmp trên nút.

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 = Cassandr
- zk = Người giữ vườn thú
- qpid = qpidd
- ps = postgresql
- cạnh =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
- giao diện người dùng = Giao diện người dùng cạnh
- tất cả = cập nhật tất cả các thành phần trên máy (chỉ sử dụng cho cấu hình cài đặt aio của Edge hoặc hồ sơ cài đặt API BaaS asa)
- e = Tìm kiếm đàn hồi
- b = Ngăn xếp API BaaS
- p = Cổng API BaaS
- ebp = ElasticSearch, API BaaS Stack 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 apigee-validate, Kiểm tra lượt cài đặt.

Thủ tục cập nhật 4.16.05 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.16.05 cục bộ:

Đảm bảo bạn có kho lưu trữ 4.16.05 cục bộ như mô tả trong phần Cài đặt các thành phần Edge trên nút.
Cập nhật kho lưu trữ cục bộ:
1. Tải tệp Edge bootstrap_4.16.05.sh mới nhất 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
2. Thực hiện đồng bộ hoá:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-phản chiếu đồng bộ hoá --only-new-rpms
Cách cài đặt apigee-service từ tệp .tar:
1. Trên nút có kho lưu trữ cục bộ, hãy sử dụng lệnh sau để đóng gói kho lưu trữ cục bộ thành một tệp .tar duy nhất có tên /opt/apigee/data/apigee-mirror/apigee-4.16.05.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 địa chỉ đó vào thư mục /tmp trên nút mới.
3. Trên nút mới, hãy khôi phục tệp vào thư mục /tmp:
  tar -xzf apigee-4.16.05.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.
4. Đă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.
5. Tắt SELinux như mô tả trong phần Cài đặt Edge tiện ích thiết lập apigee.
6. 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.16.05.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.
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 Nginx webserver" lúc Cài đặt Các thành phần cạnh trên một nút.
2. Trên nút điều khiển từ xa, tải tệp Edge bootstrap_4.16.05.sh xuống /tmp/bootstrap_4.16.05.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.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.
3. Đă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.
4. Tắt SELinux như mô tả trong phần Cài đặt Edge tiện ích thiết lập apigee.
5. 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.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uNamea Pigeepassword=pWord apigeeprotocol=http://
  
  trong đó uName:pWord là tên người dùng và mật khẩu kho lưu trữ.
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.
Dùng dịch vụ apigee để 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 apigee-service này sẽ cài đặt tiện ích update.sh trong <inst_dir>/apigee/apigee-setup/bin.
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 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. Ví dụ: đặt tệp trong thư mục /tmp trên nút.

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 = Cassandr
- zk = Người giữ vườn thú
- qpid = qpidd
- ps = postgresql
- cạnh =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
- giao diện người dùng = Giao diện người dùng cạnh
- tất cả = cập nhật tất cả các thành phần trên máy (chỉ sử dụng cho cấu hình cài đặt aio của Edge hoặc hồ sơ cài đặt API BaaS asa)
- e = Tìm kiếm đàn hồi
- b = Ngăn xếp API BaaS
- p = Cổng API BaaS
- ebp = ElasticSearch, API BaaS Stack 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 apigee-validate, Kiểm tra lượt cài đặt.

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.
Bạn phải cập nhật tất cả các nút qpidd và postgresql trước khi cập nhật bất kỳ Các nút Bộ định tuyến và Trình xử lý thông báo.
Đố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, máy chủ Postgres), sử dụng "-c Edge" cập nhật tất cả các mã này cùng một lúc bất cứ lúc nào.
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 cần thực hiện một 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" .
Sau khi cập nhật nút Bộ định tuyến, bạn phải xóa tất cả tệp khỏi thư mục /opt/nginx/conf.d, sau đó khởi động lại Bộ định tuyến.