Trang này được dịch bởi Cloud Translation API.

Cài đặt cổng

Edge for Private Cloud phiên bản 4.19.01

Trước khi cài đặt cổng Dịch vụ dành cho nhà phát triển Apigee (hoặc đơn giản là cổng), hãy đảm bảo rằng:

Bạn cài đặt Postgres trước khi cài đặt cổng thông tin. Bạn có thể cài đặt Postgres trong quá trình cài đặt Edge hoặc cài đặt Postgres độc lập để cổng thông tin sử dụng.
- Nếu bạn cài đặt Postgres độc lập, thì Postgres có thể nằm trên cùng một nút với cổng thông tin.
- Nếu bạn đang kết nối với Postgres được cài đặt trong Edge và Postgres được định cấu hình ở chế độ chính/chờ, hãy chỉ định địa chỉ IP của máy chủ Postgres chính.
Bạn đang cài đặt phiên bản 64 bit của một phiên bản được hỗ trợ của Red Hat Enterprise Linux, CentOS hoặc Oracle. Xem danh sách các phiên bản được hỗ trợ tại phần Phần mềm và phiên bản được hỗ trợ.
Yum đã được cài đặt.

Trình cài đặt chỉ bao gồm các mô-đun do Drupal đóng góp mà cổng Dịch vụ dành cho nhà phát triển Apigee yêu cầu (hoặc đơn giản là cổng). Để biết thông tin về cách cài đặt các mô-đun đóng góp khác, hãy xem phần Mở rộng Drupal 7.

Tổng quan về quá trình cài đặt

Để cài đặt cổng thông tin, bạn sẽ thực hiện các bước sau. Từng bước này sẽ được mô tả chi tiết hơn trong các phần tiếp theo.

Kiểm tra kết nối
Xoá các phiên bản PHP trước 7.0
Cài đặt Postgres
Cài đặt cổng thông tin
Đảm bảo bạn đã bật Trình quản lý cập nhật
(Không bắt buộc) Định cấu hình Apache Solr
(Không bắt buộc) Cài đặt SmartDocs
(Không bắt buộc) Định cấu hình JQuery

Ngừng sử dụng thuộc tính SMTPSSL

Trong các bản phát hành trước, bạn đã sử dụng thuộc tính SMTPSSL để thiết lập giao thức mà máy chủ SMTP dùng để kết nối với cổng thông tin. Thuộc tính đó không được dùng nữa.

Giờ đây, bạn sử dụng thuộc tính SMTP_PROTOCOL thay vì thuộc tính SMTPSSL để đặt giao thức mà máy chủ SMTP dùng để kết nối với cổng thông tin. Các giá trị hợp lệ là: "standard", "ssl" hoặc "tls".

Tạo tệp cấu hình cổng thông tin

Dưới đây là ví dụ về tệp cấu hình im lặng cho quá trình cài đặt cổng thông tin. Chỉnh sửa tệp này nếu cần cho cấu hình của bạn. Sử dụng tuỳ chọn -f cho setup.sh để đưa tệp này vào.

IP1=IPorDNSnameOfNode

# Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost.
HOSTIP=$(hostname -i)

# Specify the name of the portal database in Postgres.
PG_NAME=devportal

# Specify the Postgres admin credentials.
# The portal connects to Postgres by using the 'apigee' user.
# If you changed the Postgres password from the default of 'postgres'
# then set PG_PWD accordingly.
# If connecting to a Postgres node installed with Edge,
# contact the Edge sys admin to get these credentials.
PG_USER=apigee
PG_PWD=postgres

# The IP address of the Postgres server.
# If it is installed on the same node as the portal, specify that IP.
# If connecting to a remote Postgres server,specify its IP address.
PG_HOST=$IP1

# The Postgres user credentials used by the portal
# to access the Postgres database,
# This account is created if it does not already exist.
DRUPAL_PG_USER=drupaladmin
DRUPAL_PG_PASS=portalSecret

# Specify 'postgres' as the database.
DEFAULT_DB=postgres

# Specify the Drupal admin account details.
# DO NOT set DEVPORTAL_ADMIN_USERNAME=admin.
# The installer creates this user on the portal.
DEVPORTAL_ADMIN_FIRSTNAME=firstName
DEVPORTAL_ADMIN_LASTNAME=lastName
DEVPORTAL_ADMIN_USERNAME=userName
DEVPORTAL_ADMIN_PWD=PORTAL_ADMIN_PASSWORD
DEVPORTAL_ADMIN_EMAIL=foo@bar.com

# Edge connection details.
# If omitted, you can set them in the portal UI.
# Specify the Edge organization associated with the portal.
EDGE_ORG=edgeOrgName

# Specify the URL of the Edge management API.
# For a Cloud based installation of Edge, the URL is:
# https://api.enterprise.apigee.com/v1
# For a Private Cloud installation, it is in the form:
# http://ms_IP_or_DNS:8080/v1 or
# https://ms_IP_or_DNS:TLSport/v1
MGMT_URL=https://api.enterprise.apigee.com/v1

# The org admin credentials for the Edge organization in the form
# of Edge emailAddress:pword.
# The portal uses this information to connect to Edge.
DEVADMIN_USER=orgAdmin@myCorp.com
DEVADMIN_PWD=ORG_ADMIN_PASSWORD

# The PHP port.
# If omitted, it defaults to 8888.
PHP_FPM_PORT=8888

# Optionally configure the SMTP server used by the portal.
# If you do, the properties SMTPHOST and SMTPPORT are required.
# The others are optional with a default value as notated below.
# SMTP hostname. For example, for the Gmail server, use smtp.gmail.com.
SMTPHOST=smtp.gmail.com

# Set the SMTP protocol as "standard", "ssl", or "tls",
# where "standard" corresponds to HTTP.
# Note that in previous releases, this setting was controlled by the
# SMTPSSL property. That property has been deprecated.
SMTP_PROTOCOL="standard"

# SMTP port (usually 25).
# The value can be different based on the selected encryption protocol.
# For example, for Gmail, the port is 465 when using SSL and 587 for TLS.
SMTPPORT=25

# Username used for SMTP authentication, defaults is blank.
SMTPUSER=your@email.com

# Password used for SMTP authentication, default is blank.
SMTPPASSWORD=YOUR_EMAIL_PASSWORD

1. Kiểm thử kết nối với Apigee Edge

Kiểm thử kết nối giữa máy chủ mà bạn sẽ cài đặt cổng thông tin và máy chủ quản lý Edge bằng cách thực thi lệnh curl sau trên máy chủ cổng thông tin:

curl -u EMAIL:PASSWORD http://ms_IP_or_DNS:8080/v1/organizations/ORGNAME

hoặc:

curl -u EMAIL:PASSWORD https://ms_IP_or_DNS:TLSPort/v1/organizations/ORGNAME

Trong đó, EMAIL và PASSWORD là địa chỉ email và mật khẩu của quản trị viên cho ORGNAME.

Hãy nhớ chỉ định tên máy chủ và số cổng dành riêng cho quá trình cài đặt Edge. Cổng 8080 là cổng mặc định mà Edge sử dụng. Nếu bạn đang kết nối với một tổ chức trên đám mây, thì URL yêu cầu sẽ là: https://api.enterprise.apigee.com/v1/organizations/ORGNAME.

Nếu thành công, curl sẽ trả về một phản hồi tương tự như sau:

{
  "createdAt" : 1348689232699,
  "createdBy" : "USERNAME",
  "displayName" : "cg",
  "environments" : [ "test", "prod" ],
  "lastModifiedAt" : 1348689232699,
  "lastModifiedBy" : "foo@bar.com",
  "name" : "cg",
  "properties" : {
    "property" : [ ]
  },
  "type" : "trial"
}

2. Xoá các phiên bản PHP trước 7.0

Tập lệnh cài đặt sẽ kiểm tra các phiên bản PHP trước 7.0 trên hệ thống trước khi bắt đầu cài đặt. Nếu có các phiên bản PHP trước 7.0, thông báo cảnh báo sau đây sẽ xuất hiện:

The following packages present on your system conflict with software we are
about to install. You will need to manually remove each one, then re-run this install script.

php
php-cli
php-common
php-gd
php-mbstring
php-mysql
php-pdo
php-pear
php-pecl-apc
php-process
php-xml

Xoá các gói PHP bằng lệnh sau:

yum remove package_name

Nếu bạn không chắc chắn liệu PHP đã được cài đặt trên máy chủ của mình hay chưa, hãy sử dụng lệnh sau:

rpm -qa | grep -i php

Xin lưu ý rằng cổng thông tin này sử dụng PHP phiên bản 4.18.01-0.0.49. Số phiên bản này không phải để khớp với số phiên bản của Apigee Edge cho Private Cloud.

3. Cài đặt Postgres

Bạn cần cài đặt Postgres thì mới có thể cài đặt cổng thông tin. Bạn có thể cài đặt Postgres trong quá trình cài đặt Edge hoặc cài đặt Postgres độc lập để cổng thông tin sử dụng.

Nếu bạn đang kết nối với Postgres được cài đặt trong Edge và Postgres được định cấu hình ở chế độ chính/chờ, hãy chỉ định địa chỉ IP của máy chủ Postgres chính.
Nếu bạn cài đặt Postgres độc lập, thì Postgres có thể nằm trên cùng một nút với cổng thông tin.

Để biết thông tin về cách cài đặt Postgres trong quá trình cài đặt Edge, hãy xem phần Cài đặt các thành phần Edge trên một nút.

Cách cài đặt Postgres độc lập:

Cài đặt tiện ích Edge apigee-setup trên nút bằng cách sử dụng quy trình Internet hoặc không phải Internet. Hãy xem bài viết Cài đặt tiện ích thiết lập apigee của Edge để biết thêm thông tin.

Tạo tệp cấu hình Postgres, như trong ví dụ sau:

# Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost
HOSTIP=$(hostname -i)

# The pod and region of Postgres. Use the default values shown below.
MP_POD=gateway
REGION=dc-1

# Set the Postgres password. The default value is 'postgres'.
PG_PWD=postgres

Tại lời nhắc lệnh, hãy chạy tập lệnh thiết lập để cài đặt Postgres:
```
/opt/apigee/apigee-setup/bin/setup.sh -p pdb -f postgres_config_file
```
Tuỳ chọn -p pdb chỉ định cài đặt Postgre. Người dùng "apigee" phải có thể truy cập hoặc đọc được tệp cấu hình.

4. Cài đặt cổng thông tin

Trước khi có thể cài đặt cổng thông tin, hãy đảm bảo rằng bạn đã thực hiện các bước sau như mô tả trong phần 3. Cài đặt Postgres:

Cài đặt tiện ích apigee-setup của Edge trên nút của cổng thông tin
Cài đặt Postgres, Postgres độc lập hoặc trong quá trình cài đặt Edge

Cách cài đặt cổng thông tin:

Tại lời nhắc lệnh, hãy chạy tập lệnh setup:
```
/opt/apigee/apigee-setup/bin/setup.sh -p dp -f configFile
```
Trong trường hợp:
- configFile là tệp cấu hình cổng thông tin như mô tả trong phần Tạo tệp cấu hình cổng thông tin.
  Người dùng "apigee" phải có thể truy cập hoặc đọc tệp cấu hình.
- -p dp hướng dẫn tập lệnh setup cài đặt cổng thông tin.

Cách xác minh rằng quá trình cài đặt cổng thông tin đã thành công:

Chuyển đến trang chủ của cổng thông tin tại http://localhost:8079 hoặc đến tên DNS của cổng thông tin.
Đăng nhập vào cổng thông tin bằng thông tin xác thực của quản trị viên mà bạn đã đặt trong tệp cấu hình của cổng thông tin.
Chọn Reports > Status Report (Báo cáo > Báo cáo trạng thái) trong trình đơn Drupal để đảm bảo rằng bạn có thể xem trạng thái hiện tại của cổng thông tin.
Đảm bảo rằng đã kết nối thành công với Máy chủ quản lý. Nếu không:
1. Chuyển đến trang Cấu hình kết nối của cổng thông tin (ví dụ: http://portal_IP:8079/admin/config/devconnect).
2. Nhấp vào nút Test Connection (Kiểm tra kết nối). Nếu kết nối thành công, bạn đã hoàn tất. Nếu không kết nối được, hãy tiếp tục.
3. Kiểm tra chế độ cài đặt điểm cuối và xác thực:
  - URL điểm cuối của API quản lý: Kiểm tra để đảm bảo giao thức (HTTP hoặc HTTPS), tên IP hoặc DNS và số cổng là chính xác; ví dụ:
```
http://10.10.10.10:8080/v1
```
  - Người dùng đã xác thực điểm cuối: Tên người dùng của quản trị viên tổ chức.
  - Mật khẩu của người dùng đã xác thực: Mật khẩu của quản trị viên tổ chức.
  Các giá trị mặc định phản ánh chế độ cài đặt trong tệp cấu hình cổng thông tin mà bạn đã tạo trong quá trình cài đặt.
  
  Các giá trị này phải khớp với giá trị ms_IP_or_DNS, email và password mà bạn đã sử dụng trong bước 1: Kiểm tra kết nối với Apigee Edge. Tên người dùng và mật khẩu cũng phải khớp với giá trị của các thuộc tính USER_NAME và USER_PWD trong tệp cấu hình làm quen hoặc thông tin xác thực của bất kỳ người dùng nào có vai trò là Quản trị viên tổ chức.
4. Sau khi bạn kết nối thành công với Máy chủ quản lý, hãy nhấp vào nút Lưu cấu hình ở cuối trang để lưu các thay đổi.

5. Đảm bảo rằng mô-đun Trình quản lý cập nhật đã được bật

Để 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 tính năng này.

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ó. Bạn cũng có thể sử dụng lệnh Drush sau:

drush pm-info update

Bạn phải chạy lệnh này từ thư mục gốc của trang web. Theo mặc định, cổng thông tin được cài đặt tại /opt/apigee/apigee-drupal/wwwroot. Do đó, trước tiên, bạn nên thay đổi thư mục thành /opt/apigee/apigee-drupal/wwwroot trước khi chạy lệnh. Nếu bạn không cài đặt cổng thông tin trong thư mục mặc định, hãy thay đổi thành thư mục cài đặt.

Sử dụng mục trình đơn Reports > Available Updates > Settings (Báo cáo > Bản cập nhật có sẵn > 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.

6. Định cấu hình công cụ tìm kiếm Apache Solr (Không bắt buộc)

Theo mặc định, các mô-đun Drupal kết nối với công cụ tìm kiếm Apache Solr sẽ bị tắt khi bạn cài đặt cổng thông tin. Hầu hết các cổng thông tin đều sử dụng công cụ tìm kiếm Drupal nội bộ, do đó không yêu cầu các mô-đun Drupal Solr.

Nếu quyết định sử dụng Solr làm công cụ tìm kiếm, bạn phải cài đặt Solr cục bộ trên máy chủ của mình, sau đó bật và định cấu hình các mô-đun Drupal Solr trên cổng thông tin.

Cách bật các mô-đun Drupal Solr:

Đăng nhập vào cổng thông tin của bạn với tư cách là người dùng có đặc quyền quản trị hoặc tạo nội dung.
Chọn Modules (Mô-đun) trong trình đơn Drupal.
Bật mô-đun Apache Solr Framework và mô-đun Apache Solr Search.
Lưu các thay đổi.
Định cấu hình Solr như mô tả tại https://drupal.org/node/1999280.

7. Cài đặt SmartDocs (Không bắt buộc)

SmartDocs cho phép bạn ghi lại các API của mình trên cổng thông tin theo cách giúp tài liệu API có thể tương tác đầy đủ. Tuy nhiên, để sử dụng SmartDocs với cổng thông tin, trước tiên, bạn phải cài đặt SmartDocs trên Edge.

Nếu bạn đang kết nối cổng thông tin với một bản cài đặt Edge Cloud, thì SmartDocs đã được cài đặt và bạn không cần định cấu hình thêm.
Nếu đang kết nối cổng thông tin với một bản cài đặt Edge for Private Cloud, bạn phải đảm bảo rằng SmartDocs đã được cài đặt trên Edge. Để biết thêm về cách cài đặt Edge và SmartDocs, hãy xem phần Cài đặt SmartDocs.

Bạn cũng phải bật SmartDocs trên cổng thông tin. Để biết thêm thông tin về SmartDocs, hãy xem phần Sử dụng SmartDocs để tạo tài liệu API.

8. Định cấu hình mô-đun Cập nhật JQuery cho các lượt cài đặt không qua Internet (Không bắt buộc)

Nếu cài đặt và sử dụng mô-đun JQuery Update trong một quá trình cài đặt không qua Internet, bạn cần định cấu hình mô-đun để sử dụng phiên bản JQuery cục bộ. Nếu bạn định cấu hình mô-đun để sử dụng CDN cho quá trình cài đặt không phải qua Internet, thì mô-đun sẽ cố gắng truy cập vào CDN và gây chậm trễ cho quá trình tải trang. Để biết thêm thông tin về mô-đun Cập nhật JQuery, hãy xem https://www.drupal.org/project/jquery_update.

Cách định cấu hình mô-đun Cập nhật JQuery để sử dụng phiên bản JQuery cục bộ:

Đăng nhập vào cổng thông tin của bạn với tư cách là người dùng có đặc quyền quản trị hoặc tạo nội dung.
Chọn Configuration > Development > JQuery Update (Cấu hình > Phát triển > Cập nhật JQuery) trong trình đơn Drupal.
Nhấp vào Hiệu suất trong bảng điều hướng bên trái.
Trong trình đơn thả xuống JQuery và JQuery UI CDN, hãy chọn None (Không).
Nhấp vào Lưu cấu hình.

9. Các bước tiếp theo

Bảng sau đây liệt kê một số nhiệm vụ phổ biến nhất mà bạn thực hiện sau khi cài đặt, đồng thời bao gồm các đường liên kết đến tài liệu về Apigee để bạn có thể tìm hiểu thêm thông tin:

Việc cần làm	Mô tả
Tuỳ chỉnh giao diện	Giao diện xác định giao diện của cổng thông tin, bao gồm cả màu sắc, kiểu và các khía cạnh hình ảnh khác.
Tuỳ chỉnh giao diện	Trang chủ bao gồm trình đơn chính, thông điệp chào mừng, tiêu đề, chân trang và tiêu đề.
Thêm và quản lý tài khoản người dùng	Quy trình đăng ký kiểm soát cách nhà phát triển mới đăng ký tài khoản trên trang web. Ví dụ: nhà phát triển mới có được quyền truy cập ngay vào cổng thông tin hay họ phải được quản trị viên xác minh. Quy trình này cũng kiểm soát cách quản trị viên của cổng thông tin được thông báo khi có tài khoản mới được tạo.
Định cấu hình email	Cổng thông tin sẽ gửi email để phản hồi một số sự kiện nhất định. Ví dụ: khi một nhà phát triển mới đăng ký trên cổng thông tin và khi một nhà phát triển mất mật khẩu.
Thêm và quản lý tài khoản người dùng	Thêm trang Điều khoản và điều kiện mà nhà phát triển phải chấp nhận trước khi được phép truy cập vào cổng thông tin.
Thêm và quản lý tài khoản người dùng	Cổng thông tin triển khai mô hình uỷ quyền dựa trên vai trò. Trước khi cho phép nhà phát triển đăng ký, hãy xác định các quyền và vai trò mà cổng thông tin sử dụng.
Thêm bài đăng trên blog và diễn đàn	Cổng thông tin này được tích hợp sẵn tính năng hỗ trợ cho blog và diễn đàn theo chuỗi tin nhắn. Xác định các quyền cần thiết để xem, thêm, chỉnh sửa và xoá bài đăng trên blog và diễn đàn.
Đảm bảo bạn đang sao lưu cơ sở dữ liệu	Đảm bảo rằng bạn đang sao lưu cơ sở dữ liệu Drupal. Xin lưu ý rằng vì mỗi quá trình cài đặt đều khác nhau, nên bạn có thể tự xác định cách tốt nhất để sao lưu cơ sở dữ liệu. Lưu ý: Mô-đun Sao lưu và di chuyển không tương thích với cơ sở dữ liệu Postgres. Xem thêm bài viết Cách sao lưu.
Thiết lập tên máy chủ	Nếu không thiết lập tên máy chủ trong máy chủ DNS, bạn luôn có thể truy cập vào trang web thông qua địa chỉ IP của máy chủ. Nếu muốn sử dụng tên máy chủ, bạn có thể định cấu hình DNS cho máy chủ. DNS sẽ hoạt động chính xác mà không cần bất kỳ cấu hình nào khác trong chế độ thiết lập cơ bản. Nếu thiết lập bộ cân bằng tải hoặc nhận được URL không chính xác trên trang web vì một lý do nào đó, bạn có thể thiết lập `$base_url` cho Drupal bằng cách làm theo các bước sau: Tạo thư mục `/opt/apigee/data/apigee-drupal-devportal/sites/default/includes` nếu chưa có. Tạo một tệp có tên `settings.php` trong thư mục đó. Thêm nội dung sau vào tệp `settings.php`: /** * Base URL (optional). * * If Drupal is generating incorrect URLs on your site, which could * be in HTML headers (links to CSS and JS files) or visible links * on pages (such as in menus), uncomment the Base URL statement * below (remove the leading hash sign) and fill in the absolute URL * to your Drupal installation. * * You might also want to force users to use a given domain. * See the .htaccess file for more information. * * Examples: * $base_url = 'http://www.example.com'; * $base_url = 'http://www.example.com:8888'; * $base_url = 'http://www.example.com/drupal'; * $base_url = 'https://www.example.com:8888/drupal'; * * It is not allowed to have a trailing slash; Drupal will add it * for you. */ # $base_url = 'http://www.example.com/'; // NO trailing slash! $base_url = ‘http://www.example.com’; Thay đổi dòng `$base_url` cuối cùng thành tên máy chủ của trang web. Lưu tệp. Xin lưu ý rằng bạn có thể đặt mọi chế độ cài đặt khác từ `/opt/apigee/data/apigee-drupal-devportal/ sites/default/default.settings.php` vào tệp này. Để biết thêm thông tin về thuộc tính `$base_url`, hãy xem các phần dưới đây: https://codeburst.io/security-for-drupal-and-related-server-software-3c979b041595 https://www.drupal.org/node/1992030
Phát triển tuỳ chỉnh	Bạn cũng có thể mở rộng chức năng của cổng thông tin bằng mã tuỳ chỉnh bên ngoài giao diện. Để thực hiện việc này, hãy tạo mô-đun Drupal của riêng bạn như mô tả trong các chủ đề về phát triển mô-đun của Drupal và đặt mô-đun đó vào thư mục `/sites/all/modules`.