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

Developer Services Portal 4.16.05 版

請按照下列步驟安裝開發人員管道服務入口網站。

繼續安裝前，請先備份整個 Drupal 網頁根目錄。預設安裝位置為 /var/www/html，但您可能在安裝時變更了這個位置。執行下列安裝步驟後，即可從備份還原自訂項目。

1. 取得 Developer Channel Services 套件

前往 http://community.apigee.com/content/apigee-customer-support，然後選取「Login to your Support Portal」，透過下列任一方式索取開發人員入口網站服務 .tar 檔案：

• 要求 Edge for Private Cloud 下載目錄的存取權。
• 索取開發人員管道服務 .tar 檔案的網址。

2. 確認系統符合系統需求

安裝入口網站前，伺服器必須符合下列需求：

1. 請確認您是在 64 位元版本的 Red Hat Enterprise Linux、CentOS 或 Oracle 上執行安裝作業。如要查看支援的版本清單，請按這裡。
2. 確認已安裝 Yum。
3. (在未連上網際網路連線的伺服器上安裝) 您必須先將所有必要檔案下載到已連上網際網路連線的伺服器，並儲存為單一 .tar.gz 檔案。接著，將該 .tar.gz 檔案複製到未連上網際網路連線的伺服器，即可執行安裝作業。
   1. 以 root 或超級使用者身分，登入已連上網際網路的伺服器。
   2. 建立安裝檔案的目錄，例如 portal_tar。
   3. 切換至新目錄，然後下載開發人員管道服務 DeveloperServices_x.y.z.tar 檔案，其中 x.y.z 對應至入口網站版本號碼。
   4. 使用下列指令，解壓縮開發人員管道服務 .tar 檔案的內容：
      > tar -xvf <tar file>
   5. 將目錄變更為 DeveloperServices-4.x.y.z。
   6. 使用下列指令建立入口網站 .tar.gz 檔案：
      > ./non-networked-install.sh
      
      這個指令會下載所有必要檔案，並將這些檔案放入單一 .tar.gz 檔案。接著，將該 .tar.gz 檔案複製到沒有網際網路連線的伺服器，即可完成安裝。
4. 在入口網站伺服器的命令提示字元中執行下列 cURL 指令，測試與 Edge 管理伺服器的連線：
   > curl -u {EMAIL}:{PASSWORD} https://{hostname}:8080/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"
   }

3. 使用自動安裝指令碼安裝開發人員管道服務

請按照下列程序，使用自動安裝指令碼安裝入口網站。無論伺服器是否連上外部網際網路，這項程序都適用。

1. 以 root 或超級使用者身分登入伺服器。
2. 為安裝檔案建立目錄，例如 portal。
3. 在連上網際網路連線的伺服器上：
   1. 切換至新的 portal 目錄，然後下載開發人員管道服務 DeveloperServices_x.y.z.tar 檔案，其中 x.y.z 對應至入口網站版本號碼。
      
      您可以在瀏覽器中，透過 Apigee 傳送給您的連結下載檔案，也可以複製連結，然後將連結新增至下列 cURL 指令：
      > curl -kOL <paste link here>
   2. 使用下列指令，解壓縮開發人員管道服務 .tar 檔案的內容：
      > tar -xvf <tar file>
   3. 將目錄變更為 DeveloperServices-4.x.y.z。
   4. 使用下列指令執行安裝指令碼：
      > ./networked-install.sh
4. 在未連上網際網路連線的伺服器上：
   1. 複製您在第 2 節建立的 .tar.gz 檔案。確認系統符合系統需求。
   2. 使用下列指令解壓縮 .tar.gz 檔案的內容：
      > tar -xvf <tar file>
   3. 使用 cd 指令切換至 tar 指令建立的目錄。
   4. 設定 install-from-rpm-bundle.sh 指令碼的權限：
      > chmod 755 install-from-rpm-bundle.sh
   5. 使用下列指令執行 install-from-rpm-bundle.sh 指令碼：
      > ./install-from-rpm-bundle.sh
5. 回答提示訊息中的問題。
6. 安裝完成後，請在瀏覽器中前往伺服器網址，例如：
   http://localhost。或者，如果您已設定特定 IP 或 DNS，請前往 http://IP_address 或 http://DNS_name。
   
   系統會將您重新導向至 Apigee 設定檔資料庫設定頁面。
   
   注意：一般來說，您應該已經設定主機名稱，並向 DNS 伺服器註冊，因此不必使用 http://localhost。
7. 設定 MySQL 連線。如果 MySQL 位於遠端機器，請展開「Advanced Options」(進階選項) 區段，輸入該機器的連線資訊，然後選取「Save and continue」(儲存並繼續)。
8. 輸入下列資訊，設定與 Apigee 端點的連線，然後選取「Save」(儲存)：
   如要進一步瞭解這些值，請參閱「開發人員服務入口網站需求條件」中的「開始安裝前須提供的資訊」。
   1. 開發人員入口網站組織
   2. 開發人員入口網站端點網址
   3. 端點已驗證使用者
   4. 通過驗證的使用者密碼
9. 系統提示時，請選取「Install Sample SmartDocs WADL」(安裝 SmartDocs WADL 範例) 按鈕，安裝 SmartDocs WADL 範例。如果略過這個步驟，入口網站就不會顯示 SmartDocs API 範例。
   注意：如果入口網站連線至 Apigee Edge for Private Cloud 安裝項目，且該 Edge 安裝項目沒有外部網際網路連線，則必須先對 SmartDocs 模組執行額外設定，才能使用 SmartDocs。如要進一步瞭解 SmartDocs，請參閱 http://apigee.com/docs/developer-services/content/using-smartdocs-document-apis。
10. 設定 SMTP 伺服器設定。Apigee 要求您設定 SMTP 伺服器，才能從入口網站傳送電子郵件訊息。
    詳情請參閱 http://apigee.com/docs/developer-services/content/configuring-email。
11. 輸入下列資訊來設定管理員使用者，然後選取「Save」(儲存)。請注意，Drupal 預設會建立名為「admin」的管理員使用者，因此請勿使用「admin」做為使用者名稱。
    如果略過這個步驟，仍可使用 Drush 建立管理員，詳情請參閱下方第 4 步。建立管理員使用者。
    1. 開發人員姓名
    2. 開發人員入口網站使用者名稱
    3. 密碼
    4. 電子郵件地址
12. 安裝完成後，請設定 settings.php 檔案的權限：
    > chmod 640 /var/www/html/sites/default/settings.php
13. 前往入口網站首頁 http://localhost/ 或入口網站的 DNS 名稱。
14. 使用管理員憑證登入入口網站。

4. 建立管理員使用者

使用 Drush 為安裝的開發人員管道服務建立管理員使用者。根據預設，Drupal 會自動建立名為「admin」的管理員使用者，因此請勿使用「admin」做為使用者名稱。

1. 切換至 drupal_root/sites/default 目錄。Drupal 根目錄的標準位置是 /var/www/html：
   > cd <drupal_root>/sites/default
2. 確認您具備私人 Drupal 檔案的寫入權限：
   > drush vget file_private_path
   
   這個指令會傳回私人 Drupal 檔案的路徑，例如：
   file_private_path: 'sites/default/private'
   
   對應至 /var/www/html/sites/default/private/。使用下列指令，確保擁有者和群組可寫入這個目錄：
   chmod -R g+w dirPathAndName
   chmod -R o+r dirPathAndName
3. 輸入下列指令來建立管理員使用者，並將「< >」中的指令替換成您的值：
   > drush user-create <username> --mail="<email-address>" --password="<password>"
   > drush user-add-role Administrator <username>
4. 使用上述使用者名稱和密碼，以管理員身分登入開發人員入口網站。

5. 設定 MySQL 根密碼

如果您在安裝入口網站時一併安裝 MySQL，安裝指令碼會將 MySQL 根密碼設為預設值 (空白)。

使用下列指令設定根密碼：

> mysqladmin -u root password NEWPASSWORD

如果您先前已設定根密碼，但想變更密碼，請使用下列指令：

> mysqladmin -u root -p'OLDPASSWORD' password NEWPASSWORD

您也必須更新 /var/www/html/sites/default/settings.php 檔案中的密碼。

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

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

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

> drush pm-info update

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

7. 選用 - 部署至正式環境伺服器

如果您要在正式環境伺服器上部署入口網站，請執行其他安全性步驟，包括：

1. 執行下列指令碼，保護 MySQL 安裝：
   > /usr/bin/mysql_secure_installation
   
   這個指令碼會設定根密碼，並提供選項，讓您限制根存取權僅限於 localhost，並移除預設建立的測試資料庫和匿名使用者。強烈建議您在正式環境伺服器上執行這個指令碼。
2. 如果公司政策要求，請啟用並設定 SELinux。

8. 選用 - 設定 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。

9. 選用：安裝 mod_ssl 以支援 HTTPS

Apache HTTP Server 會使用 mod_ssl 模組，透過 HTTPS 提供網頁。如要使用 HTTPS，請使用下列指令安裝 mod_ssl：

> yum install mod_ssl

如要進一步瞭解如何設定入口網站使用 SSL，請參閱 http://apigee.com/docs/developer-services/content/using-ssl-portal。

10. 選用 - 安裝 SmartDocs

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

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

如要進一步瞭解 SmartDocs，請參閱「使用 SmartDocs 記錄 API」。

11. 後續步驟

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

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