Cổng dịch vụ cho nhà phát triển phiên bản 4.17.05
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 Apache/MySQL hoặc Apache/MariaDB từ một hệ thống cập nhật lên 4.17.01, rồi sử dụng Nâng cấp bằng tệp .tar.
- Nếu bản cài đặt của bạn sử dụng Nginx/Postgres từ phiên bản 4.17.01 mới cài đặt, sau đó sử dụng Nâng cấp cổng khi dùng chỉ số 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
trạng thái
Nếu sử dụng Nginx/Postgres, bạn sẽ thấy kết quả sau:
+ dịch vụ apigee trạng thái apigee-drupal-devportal
Được rồi: apigee-drupal-devportal đã thiết lập rồi
+ trạng thái apigee-service apigee-lb
apigee-service: apigee-lb: OK
+ trạng thái apigee-service apigee-postgresql
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, dưới 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:
- /opt/apigee/apigee-drupal (Nginx)
- /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.
Nếu không biết thư mục cài đặt, bạn có thể xác định thư mục đó theo mô tả trong Các lệnh Drush thường dùng.
Mới thư mục cài đặt mặc định sau khi cập nhật Nginx/Postgres từ phiên bản 4.17.01 mới cài đặt
Sau khi cập nhật bản cài đặt mới 4.17.01 sử dụng Nginx/Postgres, thư mục gốc đã thay đổi từ:
/opt/apigee/apigee-drupal
đến:
/opt/apigee/apigee-drupal/wwwroot
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:
- pantheon-14.02.x
- pantheon-14.03.x
- pantheon-14.04.x
- pantheon-14.07.x
- pantheon-15-01.x
- OPDK-15-04.x
- OPDK-15-07.x
- OPDK-16-01.x
- OPDK-16-05.x
- OPDK-16-09.x
- OPDK-17-01.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ể đã tạo đố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 do Drupal sở hữu. 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 trên web gốc, nó sẽ được giữ nguyên 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.
Nâng cấp cổng thông tin bằng tệp .tar
- Sao lưu bản sao Drupal MySQL/MariaDB của bạn.
Để biết thêm thông tin, hãy truy cập http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/- Cách 1: Sử dụng Drush
Lệnh Drush sql-dump sẽ tạo một bản sao của cơ sở dữ liệu. Trong thư mục Drupal của bạn, /var/www/html theo mặc định, hãy chạy lệnh Command:
> drush sql-dump > /path/to/backup_dir/database-backup.sql
Sử dụng drush trợ giúp sql-dump cho biết thêm thông tin. - Cách 2: Sử dụng MySQLdump
Dùng lệnh mysqldump để tạo bản sao của cơ sở dữ liệu:
mysqldump -u USERNAME -p' MẬT KHẨU' DATABASENAME> /path/to/backup_dir/database-backup.sql
Không được có khoảng trắng giữa tuỳ chọn -p và mật khẩu. Một bắt buộc phải có dấu ngoặc kép xung quanh mật khẩu nếu mật khẩu chứa ký tự đặc biệt.
Bạn đặt USERNAME và DATABASENAME khi bạn cài đặt cổng thông tin. Theo mặc định, cả hai đều là cổng thông tin cho nhà phát triển.
- Cách 1: Sử dụng Drush
- Sao lưu toàn bộ thư mục gốc web Drupal. Vị trí cài đặt mặc định là /var/www/html, nhưng bạn có thể đã thay đổi mật khẩu lúc cài đặt.
- Tải DeveloperServices_x.y.z.tar xuống trong Dịch vụ kênh dành cho nhà phát triển
tệp từ ftp.apigee.com, trong đó x.y.z
tương ứng với số phiên bản của cổng thông tin. Khi được nhắc, hãy nhập thông tin xác thực mà bạn nhận được
của Apigee.
Bạn có thể tải tệp xuống qua đường liên kết mà Apigee gửi cho bạn trong trình duyệt hoặc bằng cách sao chép tệp đó rồi sau đó thêm vào lệnh cURL sau:
> curl -kOL <dán đường liên kết here>
Lưu ý: Nếu cổng thông tin của bạn nằm trên một máy chủ không có kết nối Internet bên ngoài, thực hiện bước này trên máy chủ có quyền truy cập.
Chuyển đến trang Apigee Edge Support và chọn Đăng nhập vào Cổng hỗ trợ của bạn để yêu cầu Kênh nhà phát triển Tệp nâng cấp dịch vụ .tar. Nếu bạn không có tài khoản trên Cổng hỗ trợ, hãy chọn Đăng nhập vào Cổng hỗ trợ của bạn, sau đó trên trang đăng nhập, hãy chọn Trong nhanh ư? Yêu cầu hỗ trợ tại đây. -
Để nâng cấp máy chủ có kết nối Internet:
- Trích xuất tệp nâng cấp cổng thông tin:
> tar -xvf <tar file>
Thao tác trích xuất lệnh này sẽ tạo một thư mục mới có tên là DeveloperServices-4.x.y.z. - Thay đổi thành DeveloperServices-4.x.y.z thư mục.
- Hãy tải phiên bản Drupal mới nhất xuống bằng cách sử dụng lệnh sau:
> drush dl drupal
Lệnh này tạo một thư mục có tên drupal-x.y, trong đó x.y tương ứng với giá trị hiện tại phiên bản Drupal. - Chạy tập lệnh networked-update.sh:
> ./networked-update.sh
Tuỳ thuộc vào quyền đối với tệp, bạn có thể phải sử dụng sudo để chạy lệnh này hoặc chạy dưới dạng một quản trị viên. - Để nhận thông báo về các bản cập nhật của Drupal, hãy đảm bảo rằng trình quản lý Cập nhật Drupal
được bật. Trên trình đơn Drupal, hãy chọn Modules (Mô-đun) rồi di chuyển xuống
mô-đun Cập nhật trình quản lý. Nếu chưa bật, hãy bật.
Khi đã bật, bạn có thể xem các bản cập nhật có sẵn bằng cách sử dụng Báo cáo > Có sẵn Mục trong trình đơn Cập nhật.
Sử dụng trang Báo cáo > Bản cập nhật hiện có > Mục trong trình đơn Cài đặt thành định cấu hình mô-đun để gửi email cho bạn khi có bản cập nhật và để đặt tần suất cho đang kiểm tra bản cập nhật.
- Trích xuất tệp nâng cấp cổng thông tin:
-
Để nâng cấp trên máy chủ không có kết nối Internet:
- Trên máy chủ nơi bạn đã tải tệp DeveloperServices_x.y.z.tar xuống trong Dịch vụ kênh dành cho nhà phát triển,
trích xuất tệp nâng cấp cổng thông tin:
> tar -xvf <tar file>
Thao tác trích xuất lệnh này sẽ tạo một thư mục mới có tên là DeveloperServices-4.x.y.z. - Thay đổi thành DeveloperServices-4.x.y.z thư mục.
- Chạy tập lệnh non-networked-update.sh:
> ./non-networked-update.sh
Tuỳ thuộc vào quyền đối với tệp, bạn có thể phải sử dụng sudo để chạy lệnh này hoặc chạy dưới dạng một quản trị viên.
Lệnh này tải tất cả các tệp cập nhật cần thiết xuống và đóng gói chúng vào một tệp duy nhất có tên devportal-update.tgz và ghi tệp vào vị trí bạn chọn. - Sao chép devportal-update.tgz vào mục tiêu
máy chủ vận hành cổng thông tin.
Lưu ý: Không sao chép devportal-update.tgz vào thư mục gốc web của máy chủ mục tiêu. - Khôi phục tệp devportal-update.tgz vào tệp
thư mục hiện tại:
> tar -xzf /path/to/devportal-update.tgz - Chuyển sang thư mục developer-update.
- Chạy lệnh sau để cài đặt bản cập nhật:
> ./install-update.sh - Trả lời câu lệnh.
- Trên máy chủ nơi bạn đã tải tệp DeveloperServices_x.y.z.tar xuống trong Dịch vụ kênh dành cho nhà phát triển,
trích xuất tệp nâng cấp cổng thông tin:
Quá trình nâng cấp hiện đã hoàn tất.
Sử dụng RPM để nâng cấp cổng thông tin
Sử dụng quy trình sau để cập nhật RPM 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ính PG_NAME trong cổng tệp cấu hình cài đặt.
- host chỉ định IP địa chỉ 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ính DRUPAL_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 --làm sạch --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 nó.
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 lệnh 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.
- Tắt SELinux như mô tả trong Cài đặt tiện ích thiết lập apigee của Edge.
-
Để nâng cấp máy chủ có kết nối Internet:
- Tải tệp Edge 4.17.05 bootstrap_4.17.05.sh xuống
/tmp/bootstrap_4.17.05.sh:
> cuộn tròn https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh - Cài đặt tiện ích apigee-service cạnh 4.17.05 và
phần phụ thuộc:
> sudo bash /tmp/bootstrap_4.17.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ừ đó.
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 Edge 4.17.05 bootstrap_4.17.05.sh xuống
/tmp/bootstrap_4.17.05.sh:
-
Để 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.17.05 như mô tả trong phần "Tạo kho lưu trữ Apigee cục bộ" vào lúc
Cài đặt trình thiết lập apigee của Edge
tiện ích.
Lưu ý: Nếu đã có kho lưu trữ 4.17.01, bạn có thể thêm 4.17.05 kho lưu trữ cho nó như mô tả trong phần "Cập nhật 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. -
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 duy nhất có tên /opt/apigee/data/apigee-mirror/apigee-4.17.05.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, hãy khôi phục tệp vào thư mục /tmp:
> tar -xzf apigee-4.17.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. - Cài đặt tiện ích apigee-service của Edge và
phần phụ thuộc từ /tmp/repos:
> sudo bash /tmp/repos/bootstrap_4.17.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.
- 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 duy nhất có tên /opt/apigee/data/apigee-mirror/apigee-4.17.05.tar.gz:
-
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, tải tệp Edge bootstrap_4.17.05.sh xuống để
/tmp/bootstrap_4.17.05.sh:
> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.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 từ xa, cài đặt tiện ích apigee-service cạnh và
phần phụ thuộc:
> sudo bash /tmp/bootstrap_4.17.05.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ữ.
- Tạo một kho lưu trữ cục bộ 4.17.05 như mô tả trong phần "Tạo kho lưu trữ Apigee cục bộ" vào lúc
Cài đặt trình thiết lập apigee của Edge
tiện ích.
- Sử dụng apigee-service để
cập nhật chế độ thiết lập apigee
tiện ích:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update - Chạy tiện ích cập nhật trên nút của bạn để cập nhật cơ sở dữ liệu 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à cấu hình phải có thể truy cập hoặc đọc được bởi API "api" người dùng. - Bắt đầu Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql bắt đầu - 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.
Xin lưu ý rằng thư mục gốc của sau khi cập nhật hiện là:
/opt/apigee/apigee-drupal/wwwroot
Quá trình nâng cấp hiện đã hoàn tất.