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

Apigee hỗ trợ nâng cấp Edge cho Private Cloud từ phiên bản 4.50.00 hoặc phiên bản 4.51.00 trực tiếp lên phiên bản 4.52.00. Trang này mô tả cách thực hiện một trong hai cách nâng cấp.

Người có thể thực hiện việc 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 dưới quyền quản trị.

Sau khi bạn cài đặt RPM Edge, mọi người đều có thể định cấu hình các RPM đó.

Bạn phải cập nhật thành phần nào

Bạn phải cập nhật tất cả các thành phần của Edge. Edge không hỗ trợ chế độ thiết lập chứa các thành phần từ nhiều phiên bản.

Cập nhật các điều kiện tiên quyết

Đảm bảo các điều kiện tiên quyết sau đây trước khi nâng cấp Apigee Edge:

• Sao lưu tất cả các nút
  Trước khi cập nhật, bạn nên sao lưu toàn bộ các nút vì lý do an toàn. Hãy sử dụng quy trình cho phiên bản Edge hiện tại để sao lưu.

  Điều này giúp bạn có một kế hoạch dự phòng trong trường hợp việc cập nhật lên phiên bản mới không hoạt động đúng cách. Để biết thêm thông tin về tính năng 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 sử dụng lệnh:

  /opt/apigee/apigee-service/bin/apigee-all status

• Đảm bảo rằng Chiến lược nén Cassandra là LeveledCompactionStrategy
  Đảm bảo rằng chiến lược nén Cassandra được đặt thành LeveledCompactionStrategy, như mô tả trong phần Thay đổi chiến lược nén Cassandra.

Tự động truyền tải chế độ cài đặt cơ sở lưu trú

Nếu bạn đã đặt bất kỳ thuộc tính nào bằng cách chỉnh sửa tệp .properties trong /opt/apigee/customer/application, thì các giá trị này sẽ được giữ lại trong bản cập nhật.

Bắt buộc phải nâng cấp lên Zookeeper 3.8.0

Bản phát hành Edge cho đám mây riêng này bao gồm bản nâng cấp lên Zookeeper 3.8.0. Trong quá trình nâng cấp đó, tất cả dữ liệu Zookeeper sẽ được di chuyển sang Zookeeper 3.8.0.

Trước khi nâng cấp Zookeeper, hãy đọc kỹ hướng dẫn bảo trì Zookeeper. Hầu hết các hệ thống Edge chính thức đều sử dụng một cụm các nút Zookeeper trải rộng trên nhiều trung tâm dữ liệu. Một số nút trong số này được định cấu hình là những cử tri tham gia vào cuộc bầu cử lãnh đạo người quản lý vườn thú, các nút còn lại được định cấu hình làm người quan sát. Hãy xem phần Thông tin về người dẫn dắt, người theo dõi, người bỏ phiếu và người quan sát để biết thêm thông tin chi tiết. Các nút bỏ phiếu bầu một trưởng nhóm, sau đó các nút bỏ phiếu tự trở thành trình theo dõi.

Trong quá trình cập nhật, có thể xảy ra độ trễ tạm thời hoặc lỗi ghi vào Zookeeper khi nút trưởng bị tắt. Điều này có thể ảnh hưởng đến các hoạt động Quản lý ghi vào Zookeeper, chẳng hạn như hoạt động triển khai proxy và các thay đổi đối với cơ sở hạ tầng Apigee, chẳng hạn như thêm hoặc xoá trình xử lý tin nhắn, v.v. Không ảnh hưởng đến các API thời gian chạy của Apigee (trừ phi các API quản lý cuộc gọi API thời gian chạy này) trong quá trình nâng cấp Zookeeper trong khi thực hiện quy trình dưới đây.

Nhìn chung, quá trình nâng cấp bao gồm việc sao lưu mỗi nút. Tiếp theo, bạn sẽ nâng cấp tất cả trình quan sát và trình theo dõi, sau đó nâng cấp nút trưởng nhóm.

Sao lưu

Sao lưu tất cả các nút của Zookeeper để sử dụng trong trường hợp cần phải khôi phục. Xin lưu ý rằng thao tác khôi phục sẽ khôi phục Zookeeper về trạng thái khi sao lưu. Lưu ý: Mọi thay đổi về cơ sở hạ tầng hoặc quá trình triển khai trong Apigee kể từ khi bạn sao lưu (thông tin được lưu trữ trong Zookeeper) sẽ bị mất trong quá trình khôi phục.

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup

Nếu bạn đang sử dụng máy ảo và có khả năng, bạn cũng có thể chụp ảnh nhanh hoặc sao lưu máy ảo để khôi phục hoặc khôi phục (nếu cần).

Xác định người lãnh đạo, người theo dõi và người quan sát

Lưu ý: Các lệnh mẫu bên dưới sử dụng tiện ích nc để gửi dữ liệu đến Zookeeper. Bạn cũng có thể sử dụng các tiện ích thay thế để gửi dữ liệu đến Zookeeper.

1. Nếu bạn chưa cài đặt trên nút ZooKeeper, hãy cài đặt nc:

     sudo yum install nc

2. Chạy lệnh nc sau đây trên nút, trong đó 2181 là cổng ZooKeeper:

     echo stat | nc localhost 2181

   Bạn sẽ thấy kết quả như sau:

     Zookeeper version: 3.8.0-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC
     Clients:
      /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0)
     
     Latency min/avg/max: 0/0.2518/41
     Received: 647228
     Sent: 647339
     Connections: 4
     Outstanding: 0
     Zxid: 0x400018b15
     Mode: follower
     Node count: 100597

   Trong dòng Mode của đầu ra cho các nút, bạn sẽ thấy trình quan sát, trình điều phối hoặc trình theo dõi (nghĩa là trình bỏ phiếu không phải là trình điều phối) tuỳ thuộc vào cấu hình nút. Lưu ý: Trong quá trình cài đặt Edge độc lập với một nút ZooKeeper duy nhất, Mode sẽ được đặt thành độc lập.

3. Lặp lại bước 1 và 2 trên mỗi nút ZooKeeper.

Nâng cấp Zookeeper trên nút trình quan sát và trình theo dõi

Nâng cấp Zookeeper trên mỗi nút trình quan sát và nút theo dõi như sau:

1. Tải xuống và chạy trình khởi động của Edge for Private Cloud 4.52, như mô tả trong phần Cập nhật lên 4.52.00 trên một nút có kết nối Internet bên ngoài. Quá trình này có thể khác nhau tuỳ thuộc vào việc nút có kết nối Internet bên ngoài hay bạn đang cài đặt ngoại tuyến.
2. Nâng cấp thành phần Zookeeper:

     /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>

   Lưu ý: Nếu các nút này đã cài đặt các thành phần khác (chẳng hạn như Cassandra), thì bạn cũng có thể nâng cấp các thành phần đó ngay bây giờ (chẳng hạn như với hồ sơ cs,zk) hoặc bạn có thể nâng cấp các thành phần khác sau. Apigee recommend that you upgrade Zookeeper only first and ensure your cluster is working properly before upgrading other components.
3. Lặp lại các bước trên trên mỗi nút trình quan sát và trình theo dõi Zookeeper.

Tắt máy chủ đầu tiên

Sau khi tất cả các nút trình quan sát và trình theo dõi đã được nâng cấp, hãy tắt nút trình điều khiển. Trên nút được xác định là nút chính, hãy chạy lệnh dưới đây:

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

Xin lưu ý rằng trong sự kiện này, trước khi một máy chủ điều phối mới được bầu, có thể có độ trễ tạm thời hoặc lỗi ghi trong Zookeeper. Điều này có thể ảnh hưởng đến các thao tác ghi vào Zookeeper, chẳng hạn như thao tác triển khai proxy hoặc thay đổi cơ sở hạ tầng Apigee, chẳng hạn như thêm hoặc xoá trình xử lý thông báo, v.v.

Xác minh rằng người lãnh đạo mới đã được bầu

Sử dụng các bước trong phần Xác định người dẫn đầu, người theo dõi và người quan sát ở trên, hãy xác minh rằng một người dẫn đầu mới đã được bầu từ những người theo dõi sau khi người dẫn đầu hiện tại bị dừng. Xin lưu ý rằng máy chủ đầu tiên có thể được bầu trong một trung tâm dữ liệu khác với máy chủ đầu tiên hiện tại.

Nâng cấp người lãnh đạo

Làm theo các bước tương tự như trong phần Nâng cấp Zookeeper trên nút trình quan sát và trình theo dõi ở trên.

Sau khi nâng cấp xong nút trưởng cũ, hãy xác minh trạng thái của cụm và đảm bảo có một nút trưởng.

Khôi phục

Trong trường hợp cần phải khôi phục:

1. Trước tiên, hãy thực hiện các bước khôi phục đối với trình quan sát và người theo dõi.
2. Tải xuống và thực thi Tự động khởi động của phiên bản bạn đang quay trở lại - 4.50 hoặc 4.51. Quá trình này có thể sẽ khác nhau tuỳ thuộc vào việc nút đó có kết nối Internet bên ngoài hay bạn đang theo dõi quá trình cài đặt ngoại tuyến.
3. Dừng Zookeeper nếu nó đang chạy trên nút:

     /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

4. Gỡ cài đặt zookeeper hiện có:

     /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall

  /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>

Khôi phục bản sao lưu

Hãy tham khảo bài viết Khôi phục từ bản sao lưu. Xin lưu ý rằng các bản sao lưu của Zookeeper được lấy từ các phiên bản Edge for Private Cloud trước đó như 4.50 và 4.51 phải tương thích với phiên bản Zookeeper trong Edge for Private Cloud 4.52.

Nâng cấp bắt buộc lên Postgres 14

Bản phát hành Edge này bao gồm một bản nâng cấp cho Postgres 14. Trong quá trình nâng cấp đó, tất cả dữ liệu Postgres sẽ được di chuyển sang Postgres 14.

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ế độ chờ chính. Trong quá trình cập nhật, mặc dù các nút Postgres đang 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à kết nối lại với mạng, dữ liệu phân tích sẽ được đẩy đến các nút Postgres.

Cách bạn thực hiện việc 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 các nút Postgres, bạn phải cài đặt một nút dự phòng Postgres mới trong thời gian nâng cấp. Sau khi quá trình nâng cấp hoàn tất, bạn có thể ngừng sử dụng nút dự phòng Postgres mới.

  Bạn cần có thêm nút chế độ chờ Postgres nếu phải khôi phục 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 dự phòng 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 dự phòng Postgres mới, nút này phải nằm trên một nút đáp ứng tất cả yêu cầu phần cứng của máy chủ Postgres, như được xác định trong Yêu cầu cài đặt của Edge.

  Trong cấu hình 1 nút và 2 nút của Edge, các cấu trúc được dùng để tạo nguyên mẫu và thử nghiệm, 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 nút Postgres mới.

• Nếu sử dụng bộ nhớ mạng cho các nút Postgres, như Apigee đề xuất, bạn không cần cài đặt nút Postgres mới. Trong các quy trình bên dưới, bạn có thể bỏ qua các bước chỉ định cài đặt và sau đó ngừng sử dụng một nút dự phòng Postgres mới.

  Trước khi 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 xảy ra trong quá trình cập nhật và bạn buộc phải thực hiện việc khôi phục, bạn có thể khôi phục nút Postgres từ ảnh chụp nhanh đó.

Cài đặt nút chế độ chờ Postgres mới

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. Đảm bảo rằng bạn cài đặt máy chủ dự phòng Postgres mới cho phiên bản Edge hiện có (4.50.00 hoặc 4.51.00), không phải cho phiên bản 4.52.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ờ Postgres mới:

1. Trên trang cái 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ủ dự phòng Postgres hiện tại và new_standby_ip là địa chỉ IP của nút dự phòng mới.

2. Khởi động lại apigee-postgresql trên máy chủ Postgres:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

3. Xác minh rằng bạn đã thêm nút dự phòng mới bằng cách xem tệp /opt/apigee/apigee-postgresql/conf/pg_hba.conf trên máy chủ 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

4. Cài đặt máy chủ chờ Postgres mới:
   1. 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 những 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

   2. Tắt SELinux theo mô tả trong phần Cài đặt tiện ích thiết lập apigee của Edge.

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

      1. Tải tệp Edge bootstrap_4.51.00.sh 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

      2. Cài đặt tiện ích apigee-service và các phần phụ thuộc của Edge:

         sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

      Nếu bạn đang dùng Edge 4.50.00:

      1. 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

      2. Cài đặt tiện ích apigee-service và các phần phụ thuộc của Edge:

         sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord

   4. Sử dụng apigee-service để cài đặt tiện ích apigee-setup:

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

   5. Cài đặt Postgres:

      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile

   6. 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 minh rằng đó là chế độ chờ.

Thực hiện nâng cấp tại chỗ của Postgres

Bước sơ bộ

Trước khi nâng cấp tại chỗ lên Postgres, hãy làm theo các bước sau trên cả máy chủ chính và máy chủ dự phòng để cập nhật tài sản max_locks_per_transaction trên apigee-postgresql:

1. Nếu chưa có, hãy tạo tệp /opt/apigee/customer/application/postgresql.properties.
2. Thay đổi quyền sở hữu của tệp này thành apigee:

   sudo chown apigee:apigee /opt/apigee/customer/application/postgresql.properties

3. Thêm thuộc tính sau vào tệp:

   conf/postgresql.conf+max_locks_per_transaction=30000

4. Định cấu hình apigee-postgresql:

   apigee-service apigee-postgresql configure

5. Khởi động lại apigee-postgresql:

   apigee-service apigee-postgresql restart

Thực hiện nâng cấp tại chỗ

Để nâng cấp tại chỗ lên Postgres 14, hãy làm theo các bước sau:

1. Nâng cấp postgres trên máy chủ chính

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf

2. Chạy lệnh thiết lập trên máy chủ chính:

   apigee-service apigee-postgresql setup -f /opt/silent.conf

3. Chạy lệnh định cấu hình trên máy chủ chính:

   apigee-service apigee-postgresql configure

4. Khởi động lại máy chủ chính:

   apigee-service apigee-postgresql restart

5. Đị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

6. Đảm bảo máy chủ lưu trữ chính đã bắt đầu:

   apigee-service apigee-postgresql wait_for_ready

7. Dừng chế độ chờ:

   apigee-service apigee-postgresql stop

8. Nâng cấp chế độ chờ.

   Lưu ý: Nếu bước này gặp lỗi/không thành công, bạn có thể bỏ qua bước này. update.sh sẽ cố khởi động máy chủ dự phòng với 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 14, bạn có thể bỏ qua lỗi này.

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf

9. Đảm bảo chế độ chờ đã dừng:

   apigee-service apigee-postgresql stop

10. Xoá cấu hình chế độ chờ cũ:

    rm -rf /opt/apigee/data/apigee-postgresql/

11. Thiết lập tính năng sao chép trên máy chủ dự phòng:

    apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf

12. Xoá dòng conf/postgresql.conf+max_locks_per_transaction=30000 khỏi tệp /opt/apigee/customer/application/postgresql.properties trên cả máy chủ chính và chế độ chờ. Dòng này đã được thêm vào bước sơ bộ.

Sau khi hoàn tất quy trình này, chế độ chờ sẽ bắt đầu thành công.

Ngưng hoạt động một nút Postgres

Sau khi cập nhật xong, hãy huỷ bỏ nút chế độ chờ mới:

1. Đả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:

   /opt/apigee/apigee-service/bin/apigee-all start

2. 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ờ 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ả, ở dạng:

   "type" : [ "postgres-server" ],
   "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"

3. 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

4. Trên nút chính Postgres, hãy chỉnh sửa /opt/apigee/customer/application/postgresql.properties để xoá nút dự phòng mới khỏi conf_pg_hba_replication.connection:

   conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust

5. Khởi động lại apigee-postgresql trên trang chính Postgres:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

6. Xác minh rằng nút chờ mới đã bị xoá bằng cách xem tệp /opt/apigee/apigee-postgresql/conf/pg_hba.conf trên máy chủ. Bạn sẽ chỉ thấy dòng sau trong tệp đó:

   host replication apigee existing_standby_ip/32 trust

7. Xoá 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ác bước sau khi nâng cấp Postgres

Sau khi nâng cấp Postgres lớn, số liệu thống kê nội bộ của Postgres sẽ bị xoá sạch. Những số liệu thống kê này hỗ trợ trình lập kế hoạch truy vấn Postgres trong việc sử dụng các chỉ mục và đường dẫn tối ưu nhất để thực thi truy vấn.

Postgres có thể dần dần tạo lại số liệu thống kê theo thời gian khi các truy vấn được thực thi và khi trình nền tự động hút bụi chạy. Tuy nhiên, cho đến khi số liệu thống kê được tạo lại, các truy vấn của bạn có thể bị chậm.

Để giải quyết vấn đề này, hãy thực thi ANALYZE trên tất cả các bảng trong cơ sở dữ liệu trên nút Postgres chính. Ngoài ra, bạn có thể thực thi ANALYZE cho một vài bảng cùng một lúc.

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

Phần này liệt kê những đ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 phần Giao diện người dùng Edge mới dành cho Đám mây riêng tư.

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

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

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

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

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ừ đó:

• Từ 4.51.00 đến 4.52.00 (đã cài đặt giao diện người dùng Edge mới): Sử dụng 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 mTLS của Apigee

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

• Gỡ cài đặt Apigee mTLS.
• Cài đặt lại mTLS của Apigee.

Quay lại bản cập nhật

Trong trường hợp không cập nhật được, bạn có thể thử khắc phục vấn đề rồi thực thi lại update.sh. Bạn có thể chạy bản cập nhật nhiều lần và bản cập nhật sẽ tiếp tục từ lần cập nhật gần đây nhất.

Nếu lỗi này yêu cầu 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 phiên bản 4.52.00 để biết hướng dẫn chi tiết.

Ghi nhật ký thông tin cập nhật

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 đang chạy tiện ích update.sh không có quyền truy cập vào thư mục đó, thì tiện ích này sẽ ghi nhật ký vào thư mục /tmp dưới dạng tệp có tên update_username.log.

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

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

Bản cập nhật không có thời gian ngừng hoạt động (còn gọi là bản cập nhật lăn) cho phép bạn cập nhật bản cài đặt Edge mà không cần tắt Edge.

Bạn chỉ có thể cập nhật mà không có thời gian ngừng hoạt động với cấu hình 5 nút trở lên.

Chìa khoá để nâng cấp mà không có thời gian ngừng hoạt động là xoá từng Trình định tuyến khỏi bộ cân bằng tải. Sau đó, bạn cập nhật Trình định tuyến và mọi thành phần khác trên cùng một máy với Trình định tuyến, sau đó thêm Trình định tuyến trở lại trình cân bằng tải.

1. Cập nhật các máy theo đúng thứ tự cài đặt như mô tả trong phần Thứ tự cập nhật máy.
2. Khi đến lúc cập nhật Bộ định tuyến, hãy chọn một Bộ định tuyến bất kỳ và đặt chế độ không thể truy cập vào bộ định tuyến đó, như mô tả trong phần Bật/Tắt khả năng truy cập vào máy chủ (Trình xử lý thông báo/Bộ định tuyến).
3. Cập nhật Trình đị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 Trình định tuyến. Tất cả cấu hình Edge đều hiển thị một Bộ định tuyến và Trình xử lý thông báo trên cùng một nút.
4. Khôi phục khả năng kết nối với Bộ định tuyến.
5. Lặp lại các bước từ 2 đến 4 đối với các Bộ định tuyến còn lại.
6. Tiếp tục cập nhật cho mọi máy còn lại trong quá trình cài đặt.

Hãy lưu ý những điều sau đây trước và sau khi cập nhật:

• Trên nút Bộ định tuyến và Bộ xử lý thông báo kết hợp:
  • Trước khi cập nhật – hãy thực hiện những việc sau:
    1. Làm cho Bộ định tuyến không thể kết nối được.
    2. Không thể kết nối với Trình xử lý thông báo.
  • Sau khi cập nhật – hãy thực hiện những việc sau:
    1. Đảm bảo có thể truy cập vào Trình xử lý thông báo.
    2. Đảm bảo có thể truy cập vào Bộ định tuyến.
• Trên các nút Trình định tuyến đơn:
  • Trước khi cập nhật, hãy đặt Bộ định tuyến ở trạng thái không thể truy cập.
  • Sau khi cập nhật, hãy đảm bảo có thể truy cập vào Bộ định tuyến.
• Trên các nút Bộ xử lý thông báo đơn lẻ:
  • Trước khi cập nhật, hãy đặt Trình xử lý thông báo ở trạng thái không thể truy cập.
  • Sau khi cập nhật, hãy đảm bảo có thể truy cập vào Trình xử lý thông báo.

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 vào lệnh cập nhật. Tệp cấu hình cài đặt âm thầm phải giống với tệp bạn đã dùng để cài đặt Edge 4.50.00 hoặc 4.51.00.

Cập nhật lên 4.52.00 trên một nút có kết nối Internet bên ngoài

Hãy làm theo quy trình sau để cập nhật các thành phần Edge trên một nút:

1. Nếu có, hãy tắt mọi công việc cron đượ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.
2. Đăng nhập vào nút của bạn với tư cách là người dùng gốc để cài đặt RPM Edge.
3. Cài đặt yum-utils và yum-plugin-priorities:

   sudo yum install yum-utils
   sudo yum install yum-plugin-priorities

4. Tắt SELinux theo mô tả trong phần Cài đặt tiện ích thiết lập apigee của Edge.
5. Nếu bạn đang cài đặt trên Oracle 7.x, hãy thực thi lệnh sau:

   sudo yum-config-manager --enable ol7_optional_latest

6. Nếu bạn đang cài đặt trên AWS, hãy thực thi các lệnh yum-configure-manager sau:

   yum update rh-amazon-rhui-client.noarch
   sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

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

   1. Tải tệp bootstrap_4.52.00.sh của Edge xuống /tmp/bootstrap_4.52.00.sh:

      curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh

   2. Cài đặt tiện ích và các phần phụ thuộc apigee-service của Edge 4.52.00 bằng cách thực thi lệnh sau:

      sudo bash /tmp/bootstrap_4.52.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.

      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 cho bạn.

      Sử dụng tuỳ chọn JAVA_FIX để chỉ định cách xử lý việc cài đặt Java. JAVA_FIX nhận các giá trị sau:

      • I: Cài đặt OpenJDK 1.8 (mặc định).
      • C: Tiếp tục mà không cài đặt Java.
      • Q: Thoát. Đối với tuỳ chọn này, bạn phải tự cài đặt Java.
   3. Sử dụng apigee-service để cập nhật tiện ích apigee-setup, như trong ví dụ sau:

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

   4. Cập nhật tiện ích apigee-validate trên Máy chủ quản lý, như trong ví dụ sau:

      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

   5. Cập nhật tiện ích apigee-provision trên Máy chủ quản lý, như trong ví dụ sau:

      /opt/apigee/apigee-service/bin/apigee-service apigee-provision update

   6. Chạy tiện ích update trên các nút bằng cách thực thi lệnh sau:

      /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

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

      Trong trường hợp:

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

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

      /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config

   7. Khởi động lại thành phần giao diện người dùng Edge trên tất cả các nút đang chạy thành phần đó, nếu bạn chưa thực hiện:

      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

   8. 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ử quá trình cài đặt.

   Nếu sau này 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 phần Khôi phục phiên bản 4.52.00.

   Cập nhật lên phiên bản 4.52.00 từ kho lưu trữ cục bộ

   Nếu các nút Edge đặt sau tường lửa hoặc bị cấm truy cập vào kho lưu trữ Apigee qua Internet theo một cách nào khác, thì bạn có thể cập nhật từ kho lưu trữ cục bộ hoặc bản sao chép kho lưu trữ Apigee.

   Sau khi tạo kho lưu trữ Edge cục bộ, bạn có hai cách để 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 máy chủ đó. Apigee cung cấp máy chủ web Nginx để bạn sử dụng hoặc bạn có thể sử dụng máy chủ web của riêng mình.

   Cách cập nhật từ kho lưu trữ 4.52.00 cục bộ:

   1. Tạo một kho lưu trữ 4.52.00 cục bộ như mô tả trong phần "Tạo kho lưu trữ Apigee cục bộ" tại Cài đặt tiện ích thiết lập apigee-setup của Edge.
   2. 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ộ vào một tệp .tar duy nhất có tên là /opt/apigee/data/apigee-mirror/apigee-4.52.00.tar.gz:

         /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

      2. Sao chép tệp .tar vào nút mà bạn muốn cập nhật Edge. Ví dụ: sao chép tệp này vào thư mục /tmp trên nút mới.
      3. Trên nút mới, giải nén tệp vào thư mục /tmp:

         tar -xzf apigee-4.52.00.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à các phần phụ thuộc của Edge từ /tmp/repos:

         sudo bash /tmp/repos/bootstrap_4.52.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

   3. Cách cài đặt apigee-service 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 máy chủ web Nginx" tại phần Cài đặt tiện ích thiết lập API Edge.
      2. Trên nút từ xa, hãy tải tệp bootstrap_4.52.00.sh của Edge xuống /tmp/bootstrap_4.52.00.sh:

         /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh

         Trong đó uName:pWord là tên người dùng và mật khẩu mà bạn đã đặt trước đó cho kho lưu trữ và remoteRepo là địa chỉ IP hoặc tên DNS của nút kho lưu trữ.

      3. Trên nút từ xa, hãy cài đặt tiện ích apigee-setup và các phần phụ thuộc của Edge:

         sudo bash /tmp/bootstrap_4.52.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ữ.

   4. Sử dụng apigee-service để cập nhật tiện ích apigee-setup, như trong ví dụ sau:

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update 

   5. Cập nhật tiện ích apigee-validate trên Máy chủ quản lý, như trong ví dụ sau:

      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

   6. Cập nhật tiện ích apigee-provision trên Máy chủ quản lý, như trong ví dụ sau:

      /opt/apigee/apigee-service/bin/apigee-service apigee-provision update

   7. Chạy tiện ích update trên các nút theo thứ tự mô tả trong Thứ tự cập nhật máy:

      /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

      Trong trường hợp:

      • component là thành phần Edge cần cập nhật. Thông thường, bạn sẽ cập nhật các thành phần sau:
        • cs: Cassandra
        • edge: Tất cả thành phần Edge ngoại trừ giao diện người dùng Edge: Máy chủ quản lý, Trình xử lý thông báo, Trình định tuyến, Máy chủ QPID, Máy chủ Postgres
        • ldap: OpenLDAP
        • ps: postgresql
        • qpid: qpidd
        • sso: Apigee SSO (nếu bạn đã cài đặt SSO)
        • ue Giao diện người dùng mới của Edge
        • ui: Giao diện người dùng Edge cổ điển
        • zk: Zookeeper
      • configFile là tệp cấu hình mà bạn đã sử dụng để xác định các thành phần Edge trong quá trình cài đặt phiên bản 4.50.00 hoặc 4.51.00.

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

      /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config

   8. Khởi động lại các thành phần giao diện người dùng trên tất cả các nút đang chạy thành phần đó, nếu bạn chưa thực hiện:

      /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart

   9. Kiểm tra bản cập nhật bằng cách chạy tiện ích apigee-validate trên Máy chủ quản lý, như mô tả trong phần Kiểm thử bản cài đặt.

   Nếu sau này 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 phần Khôi phục phiên bản 4.52.00.

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

   Thứ tự cập nhật máy trong quá trình cài đặt Edge rất quan trọng:

   • Bạn phải cập nhật tất 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 mọi máy có nhiều thành phần Edge (Máy chủ quản lý, Trình xử lý thông báo, Route, 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 bước đó 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 được chỉ định.
   • Không có bước riêng để cập nhật chế độ Kiếm tiền. Giá trị này được cập nhật khi bạn chỉ định tuỳ chọn -c edge.

   Bản 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 phiên bản 4.52.00:

   1. Cập nhật tất cả thành phần:

      /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile

   2. (Nếu bạn đã cài đặt apigee-adminapi) Cập nhật tiện ích apigee-adminapi:

      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

   Bản nâng cấp độc lập 2 nút

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

   Hãy xem phần Xin lỗi khi cài đặt để biết danh sách các cấu trúc liên kết của Edge và số nút.

   1. Cập nhật Cassandra và ZooKeeper trên máy 1:

      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

   2. Cập nhật Qpid và Postgres trên máy 2:

      /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile

   3. Cập nhật LDAP trên máy 1:

      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

   4. Cập nhật các thành phần Edge trên máy 2 và 1:

      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

   5. Cập nhật giao diện người dùng trên máy 1:

      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

   6. (Nếu bạn đã cài đặt apigee-adminapi) Cập nhật tiện ích apigee-adminapi trên máy 1:

      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

   7. (Nếu bạn đã cài đặt dịch vụ SSO của Apigee) Cập nhật dịch vụ SSO của Apigee trên máy 1:

      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

   8. 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 cho một lượt cài đặt 5 nút:

   Hãy xem phần Xin lỗi khi cài đặt để biết danh sách các cấu trúc liên kết của Edge và số nút.

   1. Cập nhật Cassandra và ZooKeeper trên máy 1, 2 và 3:

      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

   2. Cập nhật Qpid và Postgres trên máy 4:

      /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile

   3. Cập nhật Qpid và Postgres trên máy 5:

      /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile

   4. Cập nhật LDAP trên máy 1:

      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

   5. Cập nhật các thành phần Edge trên máy 4, 5, 1, 2, 3:

      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

   6. Cập nhật giao diện người dùng Edge:
      • Giao diện người dùng cổ điển: Nếu bạn đang sử dụng giao diện người dùng cũ, hãy cập nhật thành phần ui trên máy 1, như trong ví dụ sau:

        /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

      • Giao diện người dùng Edge mới: Nếu bạn đã cài đặt giao diện người dùng Edge mới, hãy cập nhật thành phần ue trên máy thích hợp (có thể không phải là máy 1):

        /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf

   7. (Nếu bạn đã cài đặt apigee-adminapi) Cập nhật tiện ích apigee-adminapi trên máy 1:

      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

   8. (Nếu bạn đã cài đặt 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 mà bạn đã tạo khi cài đặt SSO.

   9. Khởi động lại thành phần giao diện người dùng:
      • Giao diện người dùng cổ điển: Nếu bạn đang sử dụng giao diện người dùng cũ, hãy khởi động lại thành phần edge-ui trên máy 1, như trong ví dụ sau:

        /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

      • Giao diện người dùng Edge mới: Nếu bạn đã cài đặt giao diện người dùng Edge mới, hãy khởi động lại thành phần edge-management-ui trên máy thích hợp (có thể không phải là máy 1):

        /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

   Nâng cấp cụm 9 nút

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

   Hãy xem phần Xin lỗi khi cài đặt để biết danh sách các cấu trúc liên kết của Edge và số nút.

   1. Cập nhật Cassandra và ZooKeeper trên máy 1, 2 và 3:

      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

   2. Cập nhật Qpid trên máy 6 và 7:

      /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

   3. Cập nhật Postgres trên máy 8:

      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

   4. Cập nhật Postgres trên máy 9:

      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

   5. Cập nhật LDAP trên máy 1:

      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

   6. Cập nhật các thành phần Edge trên máy 6, 7, 8, 9, 1, 4 và 5 theo thứ tự đó:

      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

   7. Cập nhật giao diện người dùng mới (ue) hoặc giao diện người dùng cổ điển (ui) trên máy 1:

      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

   8. (Nếu bạn đã cài đặt apigee-adminapi) Cập nhật tiện ích apigee-adminapi trên máy 1:

      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

   9. (Nếu bạn đã cài đặt 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 mà bạn đã tạo khi cài đặt SSO.

   10. Khởi động lại thành phần giao diện người dùng:
       • Giao diện người dùng cổ điển: Nếu bạn đang sử dụng giao diện người dùng cũ, hãy khởi động lại thành phần edge-ui trên máy 1, như trong ví dụ sau:

         /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

       • New Edge UI: Nếu bạn đã cài đặt giao diện người dùng Edge mới, hãy khởi động lại thành phần edge-management-ui trên máy thích hợp (có thể không phải là máy 1):

         /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

   Nâng cấp cụm 13 nút

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

   Xem phần Cấu trúc cài đặt để biết danh sách cấu trúc Edge và số nút.

   1. Cập nhật Cassandra và ZooKeeper trên máy 1, 2 và 3:

      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

   2. Cập nhật Qpid trên máy 12 và 13:

      /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

   3. Cập nhật Postgres trên máy 8:

      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

   4. Cập nhật Postgres trên máy 9:

      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

   5. Cập nhật LDAP trên máy 4 và 5:

      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

   6. Cập nhật các thành phần Edge trên máy 12, 13, 8, 9, 6, 7, 10 và 11 theo thứ tự đó:

      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

   7. Cập nhật giao diện người dùng mới (ue) hoặc giao diện người dùng cổ điển (ui) trên máy 6 và 7:

      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

   8. (Nếu bạn đã cài đặt apigee-adminapi) Cập nhật tiện ích apigee-adminapi trên máy 6 và 7:

      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

   9. (Nếu bạn đã cài đặt 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 mà bạn đã tạo khi cài đặt SSO.

   10. Khởi động lại thành phần giao diện người dùng:
       • Giao diện người dùng cổ điển: Nếu bạn đang sử dụng giao diện người dùng cổ điển, 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 Edge mới: 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

   Nâng cấp cụm 12 nút

   Cập nhật các thành phần sau đây cho một cài đặt cụm 12 nút:

   Hãy xem phần Xin lỗi khi cài đặt để biết danh sách các cấu trúc liên kết của Edge và số nút.

   1. Cập nhật Cassandra và ZooKeeper:
      1. Trên các máy 1, 2 và 3 của Trung tâm dữ liệu 1:

         /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

      2. Trên máy 7, 8 và 9 trong Trung tâm dữ liệu 2

         /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

   2. Cập nhật qpidd:
      1. Máy 4, 5 trong Trung tâm dữ liệu 1
         1. Cập nhật qpidd trên máy 4:

            /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

         2. Cập nhật qpidd trên máy 5:

            /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

      2. Máy 10, 11 trong Trung tâm dữ liệu 2
         1. Cập nhật qpidd trên máy 10:

            /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

         2. Cập nhật qpidd trên máy 11:

            /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

   3. Cập nhật Postgres:
      1. Máy 6 trong Trung tâm dữ liệu 1

         /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

      2. Máy 12 trong Trung tâm dữ liệu 2

         /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

   4. Cập nhật LDAP:
      1. Máy 1 trong Trung tâm dữ liệu 1

         /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

      2. Máy 7 trong Trung tâm dữ liệu 2

         /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

   5. Cập nhật các thành phần Edge:
      1. Máy 4, 5, 6, 1, 2, 3 trong Trung tâm dữ liệu 1

         /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

      2. Máy 10, 11, 12, 7, 8, 9 trong Trung tâm dữ liệu 2

         /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

   6. Cập nhật giao diện người dùng mới (ue) hoặc giao diện người dùng cũ (ui):
      1. Máy 1 trong Trung tâm dữ liệu 1:

         /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

      2. Máy 7 trong Trung tâm dữ liệu 2:

         /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

   7. (Nếu bạn đã cài đặt apigee-adminapi) Cập nhật tiện ích apigee-adminapi:
      1. Máy 1 trong Trung tâm dữ liệu 1:

         /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

      2. Máy 7 trong Trung tâm dữ liệu 2:

         /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

   8. (Nếu bạn đã cài đặt Apigee SSO) Cập nhật Apigee SSO:
      1. Máy 1 trong Trung tâm dữ liệu 1:

         /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

      2. Máy 7 trong Trung tâm dữ liệu 2:

         /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

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

      /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

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

   Nếu bạn có cấu hình không chuẩn, hãy cập nhật các thành phần Edge theo thứ tự sau:

   1. ZooKeeper
   2. Cassandra
   3. qpidd, ps
   4. LDAP
   5. Edge, nghĩa là hồ sơ "-c edge" trên tất cả các nút theo thứ tự: các nút có máy chủ Qpid, máy chủ Postgres Edge, máy chủ quản lý, Trình xử lý thông báo và Trình định tuyến.
   6. Giao diện người dùng Edge (cổ điển hoặc mới)
   7. apigee-adminapi
   8. Apigee SSO

   Sau khi 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 đó.