Edge for Private Cloud phiên bản 4.18.01
Quy trình này mô tả cách nâng cấp Dịch vụ kênh dành cho nhà phát triển Apigee hiện có cài đặt tại chỗ.
Xác định đúng quy trình cập nhật
Quy trình mà bạn sử dụng để cập nhật cổng thông tin dựa trê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, thì hãy sử dụng Nâng cấp cổng thông tin bằng RPM dưới đây.
- Nếu bản cài đặt của bạn sử dụng Apache/MySQL hoặc Apache/MariaDB, hãy xem Chuyển đổi một cổng dựa trên tar sang cổng dựa trên RPM.
Đang xác định loại chế độ 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 sử dụng lệnh sau để xác định nó:
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, các thư mục này không được hiện tại.
/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, lệnh này sẽ trả về trang web 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 dành cho nhà phát triển đã đượ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 này bên dưới để 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 sau của cổng thông tin:
- OPDK-17-01.x
- OPDK-17-05.x
- OPDK-17-09.x
Để xác định phiên bản cổng thông tin của bạn, hãy mở URL sau trong trình duyệt:
http://yourportal.com/buildInfo
Trước khi cập nhật
Đối với các bản cài đặt hiện tại, nếu bạn đã sửa đổi bất kỳ mã nào trong lõi Drupal hoặc trong bất kỳ mã tuỳ chỉnh nào
mô-đun, các nội dung sửa đổi của bạn sẽ bị ghi đè. Điều này bao gồm, cùng với những nội dung khác, bất kỳ thay đổi nào
mà bạn có thể đã gửi đến .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. Một
ngoại lệ của 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, nó sẽ
được duy trì cho bạn.
Trước khi tiếp tục cài đặt, hãy sao lưu toàn bộ thư mục gốc web Drupal thư mục. 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 từ bản sao lưu.
Sử dụng RPM để nâng cấp cổng thông tin
Cách cập nhật RPM của cổng thông tin trên một nút:
- Thay đổi sang thư mục Drupal,
/opt/apigee/apigee-drupal
bằng cách mặc định:cd /opt/apigee/apigee-drupal
- Sao lưu thực thể 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=192.168.56.101 --username=drupaladmin --password --format=c > /tmp/portal.dmp
trong đó:
dbname
chỉ định tên cơ sở dữ liệu như được chỉ định bởi Thuộc tínhPG_NAME
trong tệp cấu hình cài đặt cổng thông tin.host
chỉ định địa chỉ IP của nút cổng thông tin.username
chỉ định tên người dùng Postgres được cổng thông tin sử dụng để truy cập cơ sở dữ liệu như được chỉ định bởi Thuộc tínhDRUPAL_PG_USER
trong tệp cấu hình cài đặt cổng thông tin.- Bạn được nhắc nhập mật khẩu người dùng Postgres như được xác định bởi
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 phải khôi phục từ bản sao lưu, hãy dùng lệnh:
pg_restore --clean --dbname=devportal --host=localhost --username=apigee < /tmp/portal.dmp
- Sao lưu toàn bộ thư mục gốc web Drupal. Vị trí cài đặt mặc định
là
/opt/apigee/apigee-drupal
, nhưng bạn có thể đã thay đổi tên 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 Cấu hình > Nội dung đa phương tiện > Mục nhập 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ư (đối với ). - Sao lưu các tệp trong
/opt/apigee/data/apigee-drupal-devportal/private
. - Thiết lập Drupal ở chế độ bảo trì:
- Chọn Cấu hình trong trình đơn Drupal.
- Trên trang Cấu hình, hãy chọn Bảo trì trong phần Phát triển.
- Chọn hộp Put site to security mode (Đặt trang web vào chế độ bảo trì).
- Nhập thông báo mà người dùng thấy trong quá trình bảo trì.
- Chọn Lưu cấu hình.
- Vô hiệu hoá SELinux như được mô tả trong Cài đặt tiện ích thiết lập apigee của Edge.
- Thay đổi sang thư mục
/opt
:> cd /opt
- Để nâng cấp máy chủ có kết nối Internet:
- Tải tệp
bootstrap_4.18.01.sh
của Edge 4.18.01 xuống/tmp/bootstrap_4.18.01.sh
:curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
- Cài đặt tiện ích và các phần phụ thuộc
apigee-service
của Edge 4.18.01: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 bạn nhận được từ đó Apigee. Nếu bỏ qua pWord, bạn sẽ được nhắc nhập mã đó.
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. Bạn có thể sử dụng "C" để tiếp tục mà không cần cài đặt Java.
- Tải tệp
- Để nâng cấp trên máy chủ không có kết nối Internet:
- 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ộ" vào lúc Cài đặt Edge tiện ích thiết lập apigee.
-
Cách cài đặt apigee-service từ tệp .tar:
- Trên nút có kho lưu trữ cục bộ, sử dụng lệnh sau để đóng gói
lưu trữ vào một tệp .tar 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
vào thư mục
/tmp
trên nút mới. - Trên nút mới, huỷ đánh dấu 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
của 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ộ, sử dụng lệnh sau để đóng gói
lưu trữ vào một tệp .tar có tên
-
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 cách sử dụng Máy chủ web Nginx" lúc Cài đặt Edge tiện ích thiết lập apigee.
- Trên nút điều khiển từ xa, hãy 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 cho kho lưu trữ và remoteRepo là địa chỉ IP hoặc tên DNS của nút kho lưu trữ.
- Trên nút điều khiển từ xa, hãy cài đặt tiện ích Edge
apigee-service
và phần phụ thuộc: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 íchapigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- Chạy tiện ích cập nhật trên nút Postgre:
/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à cấu hình phải có thể truy cập hoặc đọc được bởi API "api" người dùng.
- Cập nhật cơ sở dữ liệu Postgres:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
- 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à tệp cấu hình phải có thể truy cập hoặc đọc được bởi "API" người dùng.
- Chạy tập lệnh
update.php
của Drupal bằng cách mở URL sau trong một cửa sổ trình duyệt:http://portalIP_DNS:8079/update.php
- Tắt Drupal ở chế độ bảo trì:
- Chọn Cấu hình trong trình đơn Drupal.
- Trên trang Cấu hình, hãy chọn Bảo trì trong phần Phát triển.
- Bỏ chọn ô Put site onbảo trì mode (Đặt trang web vào chế độ bảo trì).
- Chọn Lưu cấu hình.
Xin 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.