開發人員服務入口網站安裝

Edge for Private Cloud 4.17.09 版

安裝前，請先確認下列事項：

• 您必須先安裝 Postgres，再安裝入口網站。您可以在安裝 Edge 時一併安裝 Postgres，也可以單獨安裝 Postgres 供入口網站使用。
  • 如果安裝獨立式 Postgres，可以與入口網站位於同一個節點。
  • 如果您要連線至安裝為 Edge 一部分的 Postgres，且 Postgres 已設為主/待命模式，請指定主 Postgres 伺服器的 IP 位址。
• 您是在 64 位元版本的 Red Hat Enterprise Linux、CentOS 或 Oracle 上執行安裝作業。如需支援的版本清單，請參閱「支援的軟體和版本」。
• 已安裝 Yum。

安裝程式僅包含 Apigee Developer Services 入口網站 (或簡稱入口網站) 所需的 Drupal 貢獻模組。如要瞭解如何安裝其他貢獻模組，請參閱「擴充 Drupal 7」。

安裝總覽

在節點上安裝 Edge apigee-setup 公用程式後，請使用該公用程式在節點上安裝入口網站。apigee-setup 公用程式的格式如下：

> sudo /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

將設定檔傳遞至 apigee-setup 公用程式，其中包含安裝作業的相關資訊。如果設定檔缺少任何必要資訊，apigee-setup 公用程式會提示您在指令列中輸入。

唯一的要求是設定檔必須可供「apigee」使用者存取或讀取。

舉例來說，您可以使用下列指令安裝入口網站：

> sudo /opt/apigee/apigee-setup/bin/setup.sh -p dp -f myConfig

詳情請參閱「安裝 Edge apigee-setup 公用程式」。

建立設定檔

以下是入口網站安裝作業的自動設定檔範例。請視設定需要編輯這個檔案。使用 setup.sh 的 -f 選項加入這個檔案。

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=pWord 
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=pWord 

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

# You must configure the SMTP server used by the portal. 
# 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 

# Use SSL for SMTP: 'y' or 'n' (default). 
SMTPSSL="n" 

# 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=yourEmailPassword

1. 測試與 Apigee Edge 的連線

在入口網站伺服器的命令提示字元中執行下列 cURL 指令，測試與 Edge 管理伺服器的連線：

> curl -u {EMAIL}:{PASSWORD} http://<ms_ip_or_DNS>:8080/v1/organizations/{ORGNAME}

或是：

> curl -u {EMAIL}:{PASSWORD} https://<ms_ip_or_DNS>:TLSPort/v1/organizations/{ORGNAME}

其中 EMAIL 和 PASSWORD 是 ORGNAME 管理員的電子郵件地址和密碼。

請務必指定 Edge 安裝作業的主機名稱和通訊埠編號。通訊埠 8080 是 Edge 使用的預設通訊埠。如果您要連線至雲端中的組織，要求網址為：https://api.enterprise.apigee.com/v1/organizations/{ORGNAME}。

如果成功，這個指令會傳回類似以下的回應：

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

2. 移除 7.0 以下版本的 PHP

安裝指令碼會在開始安裝前，檢查系統上是否有 7.0 之前的 PHP 版本。如果存在 7.0 之前的 PHP 版本，系統會顯示下列警告訊息：

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

使用下列指令移除 PHP 套件：

yum remove <package-name>

3. 安裝 Postgres

您必須先安裝 Postgres，才能安裝入口網站。您可以在安裝 Edge 時一併安裝 Postgres，也可以單獨安裝 Postgres 供入口網站使用。

• 如果您連線至安裝為 Edge 一部分的 Postgres，且 Postgres 設定為主要/待命模式，請指定主要 Postgres 伺服器的 IP 位址。
• 如果安裝獨立式 Postgres，可以與入口網站位於同一個節點。

如要瞭解如何在安裝 Edge 時一併安裝 Postgres，請參閱「在節點上安裝 Edge 元件」。

如要安裝 Postgres 獨立版，請按照下列步驟操作：

1. 使用網際網路或非網際網路程序，在節點上安裝 Edge apigee-setup 公用程式。詳情請參閱「安裝 Edge apigee-setup 公用程式」。
2. 為 Postgres 建立設定檔，如下所示：
   
   # Must resolve to IP 位址 or DNS name of host - not to 127.0.0.1 or localhost.
   HOSTIP=$(hostname -i)
   
   # The pod and region of Postgres. 請使用下方顯示的預設值。
   MP_POD=gateway
   REGION=dc-1
   
   # Set the Postgres password. 預設值為「postgres」。
   PG_PWD=postgres
3. 在命令提示字元執行設定指令碼，安裝 Postgres：
   > /opt/apigee/apigee-setup/bin/setup.sh -p pdb -f configFile
   
   「-p pdb」選項會指定安裝 Postgre。
   
   設定檔必須可供「apigee」使用者存取或讀取。

4. 安裝入口網站

如要安裝入口網站，請按照下列步驟操作：

1. 使用網際網路或非網際網路程序，在節點上安裝 Edge apigee-setup 公用程式。詳情請參閱「安裝 Edge apigee-setup 公用程式」。
2. 確認您已安裝 Postgres，無論是獨立安裝 Postgres，或是在安裝 Edge 時一併安裝。
3. 在命令提示字元中執行設定指令碼：
   > /opt/apigee/apigee-setup/bin/setup.sh -p dp -f configFile
   
   「-p dp」選項會指定安裝入口網站。
   
   設定檔必須可供「apigee」使用者存取或讀取。
4. 前往入口網站首頁 http://localhost:8079 或入口網站的 DNS 名稱。
5. 使用您在設定檔中設定的管理員憑證登入入口網站，確保入口網站正常運作。
6. 在 Drupal 選單中，依序選取「Reports」>「Status Report」，確認您可以看到入口網站的目前狀態。

5. 確認已啟用更新管理員模組

如要接收 Drupal 更新通知，請確認已啟用 Drupal 更新管理員模組。在 Drupal 選單中選取「Modules」，然後向下捲動至「Update manager」模組。如果尚未啟用，請啟用。

啟用後，您可以使用「Reports」>「Available Updates」選單項目查看可用的更新。您也可以使用下列 Drush 指令：

> drush pm-info update

您必須從網站的根目錄執行這項指令。根據預設，開發人員入口網站會安裝在 /opt/apigee/apigee-drupal/wwwroot。因此，請先將目錄變更為 /opt/apigee/apigee-drupal/wwwroot，再執行指令。如果您未將入口網站安裝在預設目錄中，請變更為安裝目錄。

依序點選「Reports」>「Available Updates」>「Settings」選單項目，設定模組在有可用更新時傳送電子郵件給您，並設定檢查更新的頻率。

6. 設定 Apache Solr 搜尋引擎 (選用)

根據預設，安裝入口網站時，連線至 Apache Solr 搜尋引擎的 Drupal 模組會停用。大多數入口網站都使用內部 Drupal 搜尋引擎，因此不需要 Drupal Solr 模組。

如果您決定使用 Solr 做為搜尋引擎，則必須在本機伺服器上安裝 Solr，然後在入口網站上啟用及設定 Drupal Solr 模組。

如要啟用 Drupal Solr 模組，請按照下列步驟操作：

1. 以具備管理員或內容創作權限的使用者身分，登入入口網站。
2. 在 Drupal 選單中選取「Modules」。
3. 啟用「Apache Solr Framework」模組和「Apache Solr Search」模組。
4. 儲存變更。
5. 按照 https://drupal.org/node/1999280 的說明設定 Solr。

7. 安裝 SmartDocs (選用)

SmartDocs 可讓您在開發人員服務入口網站中記錄 API，使 API 說明文件完全互動。不過，如要搭配入口網站使用 SmartDocs，您必須先在 Edge 上安裝 SmartDocs。

• 如果您將入口網站連線至 Edge Cloud 安裝，SmartDocs 已安裝，不需要進一步設定。
• 如果您將入口網站連線至 Edge for Private Cloud 安裝，則必須確保 Edge 上已安裝 SmartDocs。如要進一步瞭解如何安裝 Edge 和 SmartDocs，請參閱「安裝 SmartDocs」。

您也必須在入口網站啟用 SmartDocs。如要進一步瞭解 SmartDocs，請參閱「使用 SmartDocs 記錄 API」。

8. 為非網際網路安裝設定 JQuery Update 模組 (選用)

如果您在非網際網路安裝中安裝及使用 JQuery Update 模組，則必須將模組設定為使用本機版本的 JQuery。如果您將模組設為使用 CDN 進行非網際網路安裝，模組會嘗試存取 CDN，導致網頁載入延遲。如要進一步瞭解 JQuery Update 模組，請參閱 https://www.drupal.org/project/jquery_update。

如要將 JQuery Update 模組設為使用本機版本的 JQuery，請按照下列步驟操作：

1. 以具備管理員或內容創作權限的使用者身分，登入入口網站。
2. 在 Drupal 選單中，依序選取「Configuration」>「Development」>「JQuery Update」。
3. 按一下左側導覽列中的「成效」。
4. 在「JQuery and JQuery UI CDN」下拉式選單中，選取「None」。
5. 點按「儲存設定」。

9. 後續步驟

安裝開發人員服務入口網站後，下一步是根據特定需求進行設定和自訂。Apigee 網站上的說明文件包含設定、設定樣式及管理入口網站的所有資訊。請前往 http://apigee.com/docs/developer-services/content/what-developer-portal 參閱說明文件。

下表列出安裝後最常執行的工作，並提供 Apigee 說明文件的連結，方便您查看更多資訊：

/opt/apigee/apigee-drupal-devportal-opdk_version/source/conf/settings.php