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

Cập nhật Apigee Edge 4.16.01 lên 4.16.05

Edge for Private Cloud phiên bản 4.16.05

Bạn có thể cập nhật phiên bản Edge nào lên 4.16.05

Bạn chỉ có thể cập nhật Apigee Edge phiên bản 4.16.01.x lên 4.16.05.

Nếu đang dùng phiên bản Edge cũ hơn phiên bản 4.16.01.x, thì trước tiên, bạn phải chuyển sang phiên bản 4.16.01.x rồi cập nhật lên 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 bản cập nhật gốc.

Sau khi bạn cài đặt RPM Edge, bất kỳ người dùng nào cũng có thể định cấu hình chúng.

Bắt buộc phải 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 nút xử lý Edge. 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 cho bạn.

Trong bản cập nhật Java 8, một số thuật toán mật mã TLS không còn có trong Oracle JDK 8 nữa. Để biết danh sách đầy đủ, hãy xem phần "Default Disabled Cipher Suite" (Bộ thuật toán mật mã bị tắt mặc định) http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.

Cảnh báo: Bản phát hành Edge này không hỗ trợ JDK 7. Nếu đang sử dụng JDK 7, bạn phải nâng cấp lên JDK 8. Nếu khôi phục bản cài đặt Edge 4.16.05, bạn có thể tuỳ ý định cấu hình lại Edge để sử dụng Java JDK 7.

Hạ cấp nhân viên bảo vệ động vật

Phiên bản Zookeeper RPM trong Edge dành cho đám mây riêng tư 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.948. Điều này ngăn yum nâng cấp Zookeeper lên các phiên bản mới hơn từ 4.16.01. Cách để xử lý trường hợp này là chạy yum hạ cấp 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 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.

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 GBytes dung lượng trống trên ổ đĩa trước khi thực hiện cập nhật.

Tự động truyền các chế độ cài đặt thuộc tính từ phiên bản 4.16.01.x

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ì bản cập nhật sẽ giữ lại các giá trị này.

Cập nhật tiện ích xác thực apigee

Trong phiên bản 4.16.01, bạn cài đặt và chạy tiện ích apigee-validate trên nút Message Processor (Trình xử lý thư). Trong phiên bản 4.16.05, tiện ích apigee-validate đã được cập nhật để chạy trên nút Management Server (Máy chủ quản lý).

Khi cập nhật lên phiên bản 4.16.05, bạn có hai lựa chọn để cập nhật tiện ích apigee-validate:

Nên dùng API – Cài đặt và chạy tiện ích apigee-validate trên nút Máy chủ quản lý.

Bạn có thể tuỳ ý gỡ cài đặt tiện ích apigee-validate từ các nút Bộ xử lý thông báo. Nếu để nguyên trạng thái trên nút Bộ xử lý thông báo, bạn phải cập nhật lên phiên bản 4.16.05.
Ngoài ra, hãy cập nhật tiện ích apigee-validate trên nút Trình xử lý thông báo và chạy tiện ích đó trên nút đó. Tuy nhiên, Apigee bạn nên cài đặt và chạy ứng dụng này qua Máy chủ quản lý.

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 toàn bộ 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 cho phé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
Đảm bảo Edge đã hoạt động và đang chạy trong quá trình cập nhật bằng cách dùng lệnh:

> /<inst_root>/apigee/apigee-service/bin/apigee-all status

Xử lý bản cập nhật không thành công

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 chạy lại update.sh. Bạn có thể chạy quá trình cập nhật nhiều lần và quá trình này sẽ tiếp tục quá trình cập nhật từ nơi dừng lại trước đó.

Nếu lỗi này 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.16.05 để biết thêm thông tin.

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

Theo mặc định, tiện ích update.sh sẽ ghi thông tin nhật ký vào:

/opt/apigee/var/log/apigee-setup/update.log

Nếu người dùng đang chạy tiện ích update.sh không có quyền truy cập vào thư mục đó, thì tiện ích đó sẽ ghi nhật ký vào thư mục update.sh dưới dạng tệp có tên là update.sh.

Nếu người dùng không có quyền truy cập vào /tmp, thì tiện ích update.sh sẽ không hoạt động.

Cập nhật 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ả dưới đây trong phần "Thứ tự 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à 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 tiếp cận của máy chủ (Bộ xử lý/Bộ định tuyến).
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/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:
  1. Không thể kết nối với Bộ định tuyến.
  2. Đặt Bộ xử lý thư không thể truy cập được.
- Sau khi cập nhật – hãy làm như sau:
  1. Đặt Bộ xử lý thông báo có thể truy cập được.
  2. Đặt Bộ định tuyến có thể truy cập được.
Trên một nút Bộ định tuyến:
- Trước khi cập nhật, hãy làm cho Bộ định tuyến không thể kết nối được.
- Sau khi cập nhật, hãy đặt Bộ định tuyến ở chế độ 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 đảm bảo không thể kết nối với Bộ xử lý thư.
- Sau khi cập nhật, hãy cho phép Bộ xử lý tin nhắn truy cập được.

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 là tệp bạn đã sử dụng để cài đặt Edge 4.16.01.

Quy trình cập nhật lên phiên bản 4.16.05 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 lệnh 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
Lưu ý: Mặc dù quá trình cài đặt RPM yêu cầu quyền truy cập thư mục gốc, nhưng bạn có thể thực hiện cấu hình Edge mà không cần quyền truy cập thư mục gốc.
Tắt SELinux như mô tả trong phần Cài đặt tiện ích apigee-setup của Edge.
Tải tệp bootstrap_4.16.05.sh của Edge 4.16.05 xuống /tmp/bootstrap_4.16.05.sh:
> curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
Cài đặt tiện ích và phần phụ thuộc apigee-service của Edge 4.16.05:
> 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 từ Apigee. Nếu bỏ qua pWord, bạn sẽ được nhắc nhập từ đó.
Theo mặc định, trình cài đặt sẽ kiểm tra để biết rằng bạn đã cài đặt Java 1.8. Nếu bạn không có, thì Google Play sẽ cài đặt ứng dụng đó cho bạn. Hãy 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 cách này, bạn phải tự cài đặt Java.
Sử dụng apigee-service để cập nhật tiện ích apigee-setup:
1. Nếu đã cài đặt phiên bản 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 apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup cài đặt
  Lệnh này sẽ cài đặt tiện ích update.shapi-setup> trong <inste/setupebin
  
  Nếu bạn đã cài đặt tiện ích apigee-setup, hãy cập nhật tiện ích đó:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup cập nhật
2. Nếu đã cài đặt trực tiếp phiên bản 4.16.01, tức là bạn không nâng cấp từ phiên bản 4.15.07.0x, thì bạn phải cập nhật tiện ích apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setupinsTiện ích apigee-setupe.dirins.Cập nhật để apigee-setupe.dirins.
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 đã cài đặt tiện ích apigee-validate trên nút Trình xử lý thông báo, bạn có thể cập nhật bằng cách sử dụng lệnh sau trên nút đó để cập nhật dịch vụ:
/ apigee-validate
Chỉnh sửa tệp cấu hình được chuyển đến tiện ích apigee-validate. Trong bản phát hành Edge trước, tệp cấu hình mà apigee-validate sử dụng yêu cầu các thuộc tính sau:
APIGEE_ADMINPW=sysAdminPword
APIGEE_ADMINPW=sysAdminPword
APIGEE_ADMINPW=sysAdminPword
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á 2 thuộc tính còn lại khỏi tệp.
Chạy tiện ích cập nhật trên các nút theo thứ tự được mô tả dưới đây trong phần "Thứ tự cập nhật máy":
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
Yêu cầu duy nhất trên tệp cấu hình là tệp cấu hình phải truy cập được hoặc người dùng "apigee" đọc được. Ví dụ: đặt tệp trong thư mục /tmp trên nút.
Sử dụng tuỳ chọn “-c” để chỉ định thành phần cần cập nhật. Danh sách các thành phần có thể dùng bao gồm:
- ldap = OpenLDAP
- cs = Cassandra
- zk = Người giữ thú
- qpid = qpidd
- ps = postgresql
- edge =Tất cả thành phần Edge ngoại trừ giao diện người dùng Edge: Máy chủ quản lý, Bộ xử lý thông báo, Bộ định tuyến, Máy chủ QPID, Máy chủ Postgres
- ui = Giao diện người dùng Edge
- all = cập nhật tất cả thành phần trên máy (chỉ sử dụng cho hồ sơ cài đặt Edge aio hoặc hồ sơ cài đặt API BaaS asa)
- e = Tìm kiếm đàn hồi
- b = Ngăn xếp API BaaS
- p = Cổng API BaaS
- ebp = ElasticSearch, Ngăn xếp API BaaS và Cổng thông tin API BaaS trên cùng một nút
Kiểm thử bản cập nhật bằng cách chạy tiện ích xác thực API trên Máy chủ quản lý, như mô tả trong phần Kiểm thử bản cài đặt.

Để khôi phục bản cập nhật sau này, hãy sử dụng quy trình được mô tả trong Quy trình khôi phục 4.16.05.

Quy trình cập nhật lên phiên bản 4.16.05 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.16.05 cục bộ:

Tạo một bản repo 4.16.05 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.
Lưu ý: Nếu đã có sẵn kho lưu trữ 4.16.01, bạn có thể thêm kho lưu trữ 4.16.05 vào kho lưu trữ đó.
Cách cài đặt dịch vụ apigee từ tệp .tar:
1. Trên nút có kho lưu trữ cục bộ, hãy dùng lệnh sau để đóng gói kho lưu trữ cục bộ vào một tệp .tar duy nhất có tên /opt/apigee/data/apigee-mirror/apigee-4.16.05.tar.gz:
  > /optgee/apigee-service/bin/apigee-service apigee-service
2. Sao chép tệp .tar vào nút mà bạn muốn cập nhật Edge. Ví dụ: sao chép tệp đó vào thư mục /tmp trên nút mới.
3. Trên nút mới, hãy giải nén 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 repos trong thư mục chứa tệp .tar. Ví dụ: /tmp/repos.
4. Cài đặt tiện ích apigee-service và phần phụ thuộc của Edge từ /tmp/repos:
  > sudo bash /tmp/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  Xin lưu ý rằng bạn nên thêm đường dẫn đến thư mục repos vào lệnh này.
Cách cài đặt dịch vụ API bằng máy chủ web Nginx:
1. Định cấu hình máy chủ web Nginx như mô tả trong phần "Cài đặt từ kho lưu trữ bằng cách sử dụng máy chủ web Nginx" tại phần Cài đặt tiện ích thiết lập apigee của Edge.
2. Trên nút từ xa, hãy tải tệp Edge bootstrap_4.16.05.sh vào /tmp/bootstrap_4.16.05.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.05 .
3. Trên nút từ xa, cài đặt phần phụ thuộc và tiện ích apigee-service của Edge:
  > sudo bash /tmp/bootstrap_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=pWord apigeeprotocol=
Sử dụng apigee-service để cập nhật tiện ích apigee-setup:
1. Nếu đã cài đặt phiên bản 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 apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup cài đặt
  Lệnh này sẽ cài đặt tiện ích update.sh trong/.<instgeapie_dir
  
  Nếu bạn đã cài đặt tiện ích apigee-setup, hãy cập nhật tiện ích đó:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup cập nhật
2. Nếu đã cài đặt trực tiếp phiên bản 4.16.01, tức là bạn không nâng cấp từ phiên bản 4.15.07.0x, bạn phải cập nhật tiện ích apigee-setup:
  > /opt/apigee/apigee -service/bin/apigee-service apigee-setupts/
Cài đặt tiện ích apigee-validate trên nút Máy chủ quản lý:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
Lưu ý: Nếu đã cài đặt tiện ích apigee-validate trên nút Trình xử lý thông báo, bạn có thể cập nhật 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, đối với phiên bản 4.16.05, Apigee khuyên bạn nên cài đặt và chạy tiện ích apigee-validate trên Máy chủ quản lý.
Chỉnh sửa tệp cấu hình được chuyển đến tiện ích apigee-validate. Trong bản phát hành Edge trước, tệp cấu hình mà apigee-validate sử dụng yêu cầu các thuộc tính sau:
APIGEE_ADMINPW=sysadminPword
MP_POD=gateway
REGION=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á 2 thuộc tính còn lại khỏi tệp.
Chạy tiện ích cập nhật trên các nút theo thứ tự được mô tả dưới đây trong phần "Thứ tự cập nhật máy":
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
Yêu cầu duy nhất trên tệp cấu hình là tệp cấu hình phải truy cập được hoặc người dùng "apigee" đọc được. Ví dụ: đặt tệp trong thư mục /tmp trên nút.
Sử dụng tuỳ chọn “-c” để chỉ định thành phần cần cập nhật. Danh sách các thành phần có thể dùng bao gồm:
- ldap = OpenLDAP
- cs = Cassandra
- zk = Người giữ thú
- qpid = qpidd
- ps = postgresql
- edge =Tất cả thành phần Edge ngoại trừ giao diện người dùng Edge: Máy chủ quản lý, Bộ xử lý thông báo, Bộ định tuyến, Máy chủ QPID, Máy chủ Postgres
- ui = Giao diện người dùng Edge
- all = cập nhật tất cả thành phần trên máy (chỉ sử dụng cho hồ sơ cài đặt Edge aio hoặc hồ sơ cài đặt API BaaS asa)
- e = Tìm kiếm đàn hồi
- b = Ngăn xếp API BaaS
- p = Cổng API BaaS
- ebp = ElasticSearch, Ngăn xếp API BaaS và Cổng thông tin API BaaS trên cùng một nút
Kiểm thử bản cập nhật bằng cách chạy tiện ích xác thực API trên Máy chủ quản lý, như mô tả trong phần Kiểm thử bản cài đặt.

Để khôi phục bản cập nhật sau này, hãy sử dụng quy trình được mô tả trong Quy trình khôi phục 4.16.05.

Thứ tự cập nhật máy

Thứ tự cập nhật các máy trong một lần cài đặt Edge rất quan trọng. Những điểm quan trọng nhất cần cân nhắc đối với một 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ỳ nút nào 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ỳ nút Bộ định tuyến và Bộ xử lý thông báo nào.
Đố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, 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".
Sau khi cập nhật nút Bộ định tuyến, bạn phải xóa tất cả các tệp khỏi thư mục /opt/nginx/conf.d rồi khởi động lại Bộ định tuyến.