Developer Services Portal v. 4.16.09
Quy trình này mô tả cách nâng cấp một bản cài đặt Dịch vụ kênh dành cho nhà phát triển Apigee hiện có tại chỗ.
Thư mục cài đặt mặc định
Quy trình nâng cấp giả định rằng bạn đã cài đặt Cổng thông tin dành cho nhà phát triển tại /var/www/html. 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 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 đó như mô tả trong phần Các lệnh Drush thường dùng.
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 sau:
- 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
Để 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ài đặ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 nào không phải là mô-đun tuỳ chỉnh, thì các nội dung sửa đổi của bạn sẽ bị ghi đè. Trong đó 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 thứ bên ngoài thư mục /sites đều thuộc quyền sở hữu của Drupal. robots.txt là trường hợp ngoại lệ đối với quy tắc này; nếu tệp này tồn tại trong thư mục gốc của trang web, thì tệp này sẽ được giữ lại 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. Vị trí cài đặt mặc định là /var/www/html, nhưng bạn có thể đã thay đổi vị trí này tại thời điểm cài đặt. Sau khi thực hiện các bước cài đặt được mô tả bên dưới, 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 Dịch vụ kênh dành cho nhà phát triển Apigee lên một bản phát hành mới
- Sao lưu phiên bản Drupal MySQL.
Để biết thêm thông tin, hãy xem 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 tạo một bản sao của cơ sở dữ liệu. Từ thư mục Drupal, /var/www/html theo mặc định, hãy chạy lệnh:
> drush sql-dump > /path/to/backup_dir/database-backup.sql
Sử dụng drush help sql-dump để biết thêm thông tin. - Cách 2: Sử dụng MySQLdump
Sử dụng lệnh mysqldump để tạo bản sao cơ sở dữ liệu:
mysqldump -u USERNAME -p'PASSWORD' 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. Bạn phải đặt dấu ngoặc kép đơn 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 cài đặt cổng thông tin. Theo mặc định, cả hai đều là devportal.
- Cách 1: Sử dụng Drush
- 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à /var/www/html, nhưng bạn có thể đã thay đổi vị trí này khi cài đặt.
- Tải tệp DeveloperServices_x.y.z.tar của Dịch vụ kênh dành cho nhà phát triển, trong đó x.y.z tương ứng với số phiên bản của cổng thông tin.
Bạn có thể tải tệp xuống từ đườ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 thêm vào lệnh cURL sau:
> curl -kOL <paste link 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, hãy thực hiện bước này trên một máy chủ có quyền truy cập.
Truy cập vào http://community.apigee.com/content/apigee-customer-support rồi chọn Đăng nhập vào Cổng thông tin hỗ trợ để yêu cầu tệp .tar nâng cấp Dịch vụ kênh dành cho nhà phát triển. 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 Bạn đang vội? Gửi phiếu yêu cầu hỗ trợ tại đây. -
Để nâng cấp máy chủ có kết nối Internet:
- Giải nén tệp nâng cấp cổng thông tin:
> tar -xvf <tệp tar>
Thao tác giải nén 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 thư mục DeveloperServices-4.x.y.z.
- Tải phiên bản Drupal mới nhất xuống bằng lệnh sau:
> drush dl drupal
Lệnh này sẽ tạo một thư mục có tên drupal-x.y, trong đó x.y tương ứng với phiên bản hiện tại của 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 lệnh này với tư cách là quản trị viên. - Để nhận thông báo về các bản cập nhật Drupal, hãy đảm bảo rằng bạn đã bật mô-đun Trình quản lý cập nhật Drupal. Trên trình đơn Drupal, hãy chọn Modules (Mô-đun) rồi di chuyển xuống mô-đun Update manager (Trình quản lý cập nhật). Nếu chưa bật, hãy bật.
Sau khi bật, bạn có thể xem các bản cập nhật hiện có bằng cách sử dụng mục trình đơn Báo cáo > Bản cập nhật hiện có.
Sử dụng mục trong trình đơn Báo cáo > Bản cập nhật hiện có > Cài đặt để đị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 kiểm tra bản cập nhật.
- Giải nén 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ủ mà bạn đã tải tệp DeveloperServices_x.y.z.tar của Dịch vụ kênh dành cho nhà phát triển xuống, hãy giải nén tệp nâng cấp cổng thông tin:
> tar -xvf <tệp tar>
Thao tác giải nén 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 thư mục DeveloperServices-4.x.y.z.
- 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 lệnh này với tư cách là quản trị viên.
Lệnh này tải tất 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 rồi ghi tệp đó vào vị trí bạn chọn. - Sao chép devportal-update.tgz vào máy chủ đích, máy chủ chạy cổng thông tin.
Lưu ý: Không sao chép devportal-update.tgz vào thư mục gốc của web trên máy chủ mục tiêu. - Chuyển tệp devportal-update.tgz vào 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 lời nhắc.
- Trên máy chủ mà bạn đã tải tệp DeveloperServices_x.y.z.tar của Dịch vụ kênh dành cho nhà phát triển xuống, hãy giải nén tệp nâng cấp cổng thông tin:
Quá trình nâng cấp đã hoàn tất.