Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

Nâng cấp cổng

Edge for Private Cloud phiên bản 4.19.01

Quy trình này mô tả cách nâng cấp cổng Dịch vụ dành cho nhà phát triển Apigee hiện có (hoặc đơn giản là cổng thông tin) tại cơ sở cài đặt.

LƯU Ý: Tất cả các bản cài đặt mới của cổng thông tin từ phiên bản 4.17.01 trở đi đều sử dụng Postgres làm cơ sở dữ liệu và Nginx làm máy chủ web. Tuy nhiên, các bản phát hành trước của cổng thông tin sử dụng MySQL/MariaDB làm cơ sở dữ liệu và máy chủ web Apache. Điều này có nghĩa là cổng thông tin hiện tại của bạn có thể đang sử dụng một trong các cấu hình sau:

Nginx/Postgres cho tất cả các bản cài đặt 4.17.0x, 4.18.0x và 4.19.01 mới
Apache/MySQL 5.0.15 trở lên cho tất cả hệ điều hành 6.x trước phiên bản 4.17.01
Apache/MariaDB 5.1.38 trở lên cho tất cả hệ điều hành 7.x trước phiên bản 4.17.01

Trước khi bắt đầu quá trình cập nhật, bạn phải xác định cấu hình hiện tại rồi thực hiện quy trình cập nhật chính xác.

Xác định quy trình cập nhật chính xác

Quy trình bạn sử dụng để cập nhật cổng thông tin dựa trên bản cài đặt hiện tại của bạn:

Nếu bản cài đặt của bạn sử dụng Nginx/Postgres, hãy sử dụng phần Nâng cấp cổng thông tin bằng RPM bên dưới.
Nếu bản cài đặt của bạn sử dụng Apache/MySQL hoặc Apache/MariaDB, hãy xem phần Chuyển đổi cổng thông tin dựa trên tar thành cổng thông tin dựa trên RPM.

Xác định loại cài đặt hiện tại của bạn

Nếu bạn không chắc chắn về loại cài đặt hiện tại, hãy dùng lệnh sau để xác định:

```
ls /opt
```
Nếu đang sử dụng Nginx/Postgres, bạn sẽ thấy các thư mục sau: /opt/apigee và /opt/nginx.

Nếu bạn đang sử dụng Apache/MySQL hoặc Apache/MariaDB, thì các thư mục này không được xuất hiện.

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

Nếu đang sử dụng Nginx/Postgres, bạn sẽ thấy kết quả sau:

+ apigee-service
apigee-drupal-devportal status
OK: apigee-drupal-devportal is up and running
+ apigee-service apigee-lb status
apigee-service: apigee-lb: OK
+ apigee-service apigee-postgresql status
apigee-service: apigee-postgresql: OK

```
apachectl -S
```
Nếu bạn đang sử dụng Apache/MySQL hoặc Apache/MariaDB, thì lệnh này sẽ trả về thư mục gốc của cổng thông tin, ở dạng:
```
*:80
192.168.56.102 (/etc/httpd/conf/vhosts/devportal.conf:1)
```

Thư mục cài đặt mặc định

Quá trình nâng cấp giả định rằng cổng thông tin đã được cài đặt tại:

4.17.05 trở lên: /opt/apigee/apigee-drupal/wwwroot
Trước phiên bản 4.17.05: /opt/apigee/apigee-drupal (Nginx) hoặc /var/www/html (Apache)

Nếu bạn không cài đặt cổng thông tin trong thư mục mặc định, hãy sửa đổi các đường dẫn trong quy trình dưới đây để sử dụng thư mục cài đặt của bạn.

Các phiên bản nâng cấp được hỗ trợ

Quy trình nâng cấp này được hỗ trợ cho các phiên bản cổng thông tin sau:

OPDK-17-01.x
OPDK-17-05.x
OPDK-17-09.x
OPDK-18-01.x
OPDK-18-05.x

Để xác định phiên bản cổng thông tin, hãy mở URL sau trong trình duyệt:

http://yourportal.com/buildInfo

LƯU Ý: Nếu vì lý do nào đó mà bạn đã xoá tệp buildInfo, thì bạn có thể xác định phiên bản từ tệp profiles/apigee/apigee.info. Vị trí cài đặt mặc định là /var/www/html/profiles/apigee/apigee.info, nhưng bạn có thể đã thay đổi vị trí này tại thời điểm cài đặt nếu bạn cài đặt cổng thông tin trong một thư mục khác với /var/www/html. Tệp apigee.info chứa một dòng ở dạng bên dưới, trong đó có phiên bản:

version = "OPDK-4.17.05"

Trước khi bạn cập nhật

Đối với các bản cài đặt hiện có, nếu bạn đã sửa đổi bất kỳ mã nào trong lõi Drupal hoặc trong bất kỳ mô-đun không tuỳ chỉnh nào, thì các nội dung sửa đổi của bạn sẽ bị ghi đè. Điều này bao gồm, trong số những thứ khác, mọi thay đổi bạn có thể đã thực hiện đối với .htaccess. Bạn nên giả định rằng mọi nội dung bên ngoài thư mục /sites đều thuộc sở hữu của Drupal. Trường hợp ngoại lệ đối với quy tắc này là robots.txt; nếu tệp này tồn tại trong thư mục gốc của web, thì tệp này sẽ được giữ lại cho bạn.

Trước khi tiến hành cài đặt, hãy sao lưu toàn bộ thư mục gốc của trang web Drupal. Sau khi thực hiện các bước cài đặt được mô tả dưới đây, bạn có thể khôi phục các tuỳ chỉnh của mình từ bản sao lưu.

Nâng cấp cổng thông tin bằng RPM

Cách cập nhật RPM của cổng thông tin trên một nút:

Thay đổi thành thư mục Drupal, mặc định là /opt/apigee/apigee-drupal:
```
cd /opt/apigee/apigee-drupal
```
Sao lưu phiên bản cơ sở dữ liệu Drupal. Lệnh pg_dump tạo một bản sao của cơ sở dữ liệu:
```
pg_dump --dbname=devportal --host=host_IP_address --username=drupaladmin
  --password --format=c > /tmp/portal.dmp
```
Trong trường hợp:
- devportal là tên cơ sở dữ liệu được chỉ định bởi thuộc tính PG_NAME trong tệp cấu hình cài đặt cổng thông tin.
- host_IP_address là địa chỉ IP của nút cổng.
- drupaladmin là tên người dùng Postgres mà cổng thông tin sử dụng để truy cập vào cơ sở dữ liệu theo chỉ định của thuộc tính DRUPAL_PG_USER trong tệp cấu hình cài đặt cổng thông tin.
Bạn sẽ được nhắc nhập mật khẩu người dùng Postgres như được xác định bằng thuộc tính DRUPAL_PG_PASS trong tệp cấu hình cài đặt cổng thông tin.

Nếu sau này bạn muốn khôi phục từ bản sao lưu, hãy dùng lệnh sau:
```
pg_restore --clean --dbname=devportal --host=localhost  --username=apigee < /tmp/portal.dmp
```
Sao lưu toàn bộ thư mục gốc của trang web Drupal. Vị trí cài đặt mặc định là /opt/apigee/apigee-drupal, nhưng bạn có thể đã thay đổi vị trí này.
Nếu bạn không chắc chắn về vị trí của thư mục này, hãy sử dụng lệnh drush status hoặc mục Configuration > Media > File (Cấu hình > Nội dung nghe nhìn > Tệp) trong trình đơn Drupal để xác định vị trí của hệ thống tệp công khai và đường dẫn hệ thống tệp riêng tư (cho bước tiếp theo).
MẸO: Trước khi sao lưu, hãy kiểm tra xem mục tiêu sao lưu của bạn có phải là đường liên kết tượng trưng (hoặc đường liên kết tượng trưng) đến các tệp thực tế hay không. Để thực hiện việc này, hãy tìm loại tệp l khi bạn liệt kê nội dung của một thư mục. Trong ví dụ sau, thư mục thứ hai và thứ tư là đường liên kết tượng trưng (loại tệp được chỉ định ở đầu danh sách quyền):
```
ls -l /opt/apigee
drwxr-xr-x. 16 apigee   apigee  195 Jan 29 15:49 edge-qpid-server-4.19.01-0.0.20013
lrwxrwxrwx.  1 apigee   apigee   41 Jan 12 08:18 edge-router -> /opt/apigee/edge-router-4.19.01-0.0.20013
drwxr-xr-x. 15 apigee   apigee  195 Jan 29 15:50 edge-router-4.19.01-0.0.20013
lrwxrwxrwx.  1 apigee   apigee   37 Jan  9 17:13 edge-ui -> /opt/apigee/edge-ui-4.19.01-0.0.20115
```
Nếu mục tiêu bạn muốn sao lưu là một đường liên kết tượng trưng, thì bạn nên huỷ tham chiếu các đường liên kết để sao lưu nội dung thực tế. Cách thực hiện việc này tuỳ thuộc vào công cụ mà bạn dùng để sao lưu. Ví dụ: nếu bạn sử dụng tar, hãy dùng tuỳ chọn -h, như trong ví dụ sau:
```
tar -hcfz /etc/my-drupal-backup.tar.gz /opt/apigee/apigee-drupal
```
Tạo bản sao lưu các tệp trong /opt/apigee/data/apigee-drupal-devportal/private.
Đặt Drupal ở chế độ bảo trì:
1. Chọn Configuration (Cấu hình) trong trình đơn Drupal.
2. Trên trang Configuration (Cấu hình), hãy chọn Maintenance mode (Chế độ bảo trì) trong phần Development (Phát triển).
3. Chọn hộp Chuyển trang web sang chế độ bảo trì.
4. Nhập thông báo mà người dùng sẽ thấy trong thời gian bảo trì.
5. Chọn Lưu cấu hình.
Tắt SELinux như mô tả trong phần Cài đặt tiện ích apigee-setup của Edge.
Chuyển sang thư mục /opt:
```
cd /opt
```
Để nâng cấp trên máy chủ có kết nối Internet:
1. Tải tệp Edge 4.19.01 bootstrap_4.19.01.sh xuống /tmp/bootstrap_4.19.01.sh:
```
curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
```
2. Cài đặt tiện ích và phần phụ thuộc Edge 4.19.01 apigee-service:
```
sudo bash /tmp/bootstrap_4.19.01.sh apigeeuser=uName apigeepassword=pWord
```
  Trong đó uName và pWord là tên người dùng và mật khẩu bạn nhận được từ Apigee. Nếu bỏ qua pWord, bạn sẽ được nhắc nhập thông tin này.
  
  Theo mặc định, trình cài đặt sẽ kiểm tra để đảm bảo bạn đã cài đặt Java 1.8. Bạn có thể sử dụng tuỳ chọn "C" để tiếp tục mà không cần cài đặt Java.
Để nâng cấp trên máy chủ không có kết nối Internet:
1. Tạo một kho lưu trữ 4.19.01 cục bộ như mô tả trong phần Tạo kho lưu trữ Apigee cục bộ.
  NOTE: Nếu đã có kho lưu trữ, bạn có thể thêm kho lưu trữ 4.19.01 vào kho lưu trữ đó như mô tả trong phần "Cập nhật kho lưu trữ Apigee cục bộ" tại Cài đặt tiện ích thiết lập apigee 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ộ thành một tệp .tar có tên là /opt/apigee/data/apigee-mirror/apigee-4.19.01.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 đó 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.19.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.
  4. Cài đặt tiện ích và phần phụ thuộc Edge apigee-service từ /tmp/repos:
```
sudo bash /tmp/repos/bootstrap_4.19.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
    Lưu ý rằng bạn cần đưa đường dẫn đến thư mục repos vào lệnh này.
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 Cài đặt tiện ích apigee-setup của Edge.
  2. Trên nút từ xa, hãy tải tệp Edge bootstrap_4.19.01.sh xuống /tmp/bootstrap_4.19.01.sh:
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.01.sh
  -o /tmp/bootstrap_4.19.01.sh
```
    Trong đó, uName và pWord là tên người dùng và mật khẩu mà bạn đặt ở trên cho kho lưu trữ, còn remoteRepo là địa chỉ IP hoặc tên DNS của nút kho lưu trữ.
  3. Trên nút từ xa, hãy cài đặt tiện ích Edge apigee-service và các phần phụ thuộc:
```
sudo bash /tmp/bootstrap_4.19.01.sh apigeerepohost=remoteRepo:3939
  apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
```
    Trong đó uName và pWord là tên người dùng và mật khẩu của kho lưu trữ.
Sử dụng apigee-service để cập nhật tiện ích apigee-setup:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
```
Chạy tiện ích cập nhật trên nút Postgres:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
Trong đó, configFile là tệp cấu hình mà bạn đã dùng để cài đặt cơ sở dữ liệu Postgres. 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 truy cập được hoặc người dùng "apigee" có thể đọc được.
Chạy tiện ích cập nhật trên nút của bạn để cập nhật cổng thông tin:
```
/opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile
```
Trong đó, configFile là tệp cấu hình mà bạn đã dùng để cài đặt cổng thông tin. Yêu cầu duy nhất đối với tệp cấu hình là người dùng "apigee" phải truy cập hoặc đọc được tệp cấu hình.
Chạy tập lệnh update.php của Drupal bằng cách mở URL sau trong cửa sổ trình duyệt:
```
http://portal_IP_DNS:8079/update.php
```
Tắt chế độ bảo trì:
1. Chọn Configuration (Cấu hình) trong trình đơn Drupal.
2. Trên trang Configuration (Cấu hình), hãy chọn Maintenance mode (Chế độ bảo trì) trong phần Development (Phát triển).
3. Bỏ chọn hộp Đặt trang web ở chế độ bảo trì.
4. Chọn Lưu cấu hình.

Lưu ý rằng thư mục gốc sau khi cập nhật là:

/opt/apigee/apigee-drupal/wwwroot

Quá trình nâng cấp hiện đã hoàn tất. Nếu tiện ích cập nhật Apigee hạ cấp phiên bản Drupal của bạn, bạn có thể cần chạy lại tiện ích nâng cấp Drupal. Để biết thêm thông tin, hãy xem phần Chạy lại bản nâng cấp Drupal.

Chạy lại bản nâng cấp Drupal

Nếu việc chạy tiện ích cập nhật Apigee để nâng cấp Edge cho đám mây riêng tư thực sự dẫn đến việc hạ cấp phiên bản Drupal, hãy cài đặt lại bản nâng cấp Drupal. Điều này có thể xảy ra nếu bạn chỉ nâng cấp Drupal giữa các bản cập nhật Đám mây riêng tư.

Ví dụ:

Bạn đang chạy phiên bản 4.18.05 của Edge cho đám mây riêng tư, trong đó có Drupal 7.59.
Bạn đã nâng cấp Drupal lên phiên bản 7.64 do có bản cập nhật bảo mật bắt buộc.
Bạn hiện đang nâng cấp Private Cloud lên phiên bản 4.19.01, trong đó có Drupal 7.61.

Như trường hợp này minh hoạ, phiên bản Drupal mà tiện ích cập nhật Apigee sử dụng có thể không tham chiếu đến bản nâng cấp Drupal mới nhất. Do đó, giờ đây, bạn phải chạy lại bản nâng cấp Drupal để đưa bản cài đặt Drupal về phiên bản mới hơn.