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

Developer Services Portal 4.16.05 版

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

繼續安裝前，請先備份整個 Drupal 網路根目錄 目錄。預設的安裝位置為 /var/www/html，但您可能已變更此位置 安裝時。完成下列安裝步驟後， 自訂備份設定

1. 取得開發人員管道服務套裝組合

前往 http://community.apigee.com/content/apigee-customer-support 並選取「登入支援入口網站」，要求取得開發人員 Channel Services .tar 檔案 以下其中之一：

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

，瞭解如何調查及移除這項存取權。

2. 確保系統符合系統規範 相關規定

安裝入口網站之前，您的伺服器必須符合下列條件：

1. 請確認您是在支援的 Red Hat Enterprise Linux、CentOS 或 Oracle。請按這裡查看支援的版本清單。
2. 確認已安裝 Yum。
3. (如要在沒有網際網路連線的伺服器上安裝)，您必須 請先將所有必要檔案下載至連上網際網路連線的伺服器 .tar.gz 檔案。然後將 .tar.gz 檔案複製到伺服器上 或執行安裝
   1. 以 Root 身分或超級使用者身分登入伺服器。
   2. 為安裝檔案建立目錄，例如 portal_tar。
   3. 將持續推送軟體更新至新目錄，並下載開發人員 Channel Services DeveloperServices_x.y.z.tar 檔案，其中 x.y.z 代表入口網站的版本號碼。
   4. 使用 指令：
      &gt;tar -xvf <tar file&gt;
   5. 將 CD 複製到 DeveloperServices-4.x.y.z。
   6. 使用下列指令建立入口網站的 .tar.gz 檔案：
      &gt; ./non-networked-install.sh
      
      這個指令會將所有必要檔案下載至一個 .tar.gz 檔案。個人中心 然後將 .tar.gz 檔案複製到沒有網際網路連線的伺服器上，完成 安裝。
4. 執行下列 cURL 指令，測試您與 Edge 管理伺服器的連線 輸入以下指令：
   &gt;curl -u {EMAIL}:{PASSWORD} https://{hostname}:8080/v1/organizations/{ORGNAME}
   
   請將 EMAIL 和 PASSWORD 列為電子郵件 管理員的電子郵件地址和密碼 (ORGNAME)。
   
   請務必指定您安裝 Edge 專用的主機名稱和通訊埠編號。通訊埠 8080 是 Edge 使用的預設通訊埠。如要連結至雲端式機構 那麼要求網址是：
   https://api.enterprise.apigee.com/v1/organizations/{ORGNAME}
   
   如果成功，這個指令會傳回類似下列內容的回應：
   {
   「建立時間」：1348689232699、
   「createdBy」: "USERNAME",
   &quot;displayName&quot;: "cg",
   「環境」: [ "test"、"prod"],
   「last 修改 At」：1348689232699、
   「lastModifiedBy」: "foo@bar.com",
   「名稱」: "cg",
   「properties」: {
   「<屬性>」：[ ]
   },
   「類型」: "試用"
   }

3. 安裝開發人員 使用自動安裝指令碼的 Channel Services

請按照下列步驟使用自動化安裝指令碼安裝入口網站。這個 無論伺服器有無外部網際網路連線，本程序皆適用。

1. 以 root 或超級使用者的身分登入伺服器。
2. 為安裝檔建立目錄，例如 portal。
3. 使用網際網路連線的伺服器：
   1. 持續推送軟體更新至新版入口網站 目錄並下載 Developer Channel Services DeveloperServices_x.y.z.tar 檔案，其中 x.y.z 會對應至入口網站的版本號碼。
      
      您可以透過 Apigee 在瀏覽器中傳送的連結下載檔案，或複製檔案 然後新增至以下 cURL 指令中：
      &gt;curl -kOL <貼上連結 here&gt;
   2. 使用 指令：
      &gt;tar -xvf <tar file&gt;
   3. 將 CD 複製到 DeveloperServices-4.x.y.z。
   4. 使用下列指令執行安裝指令碼：
      &gt; ./networked-install.sh
4. 使用沒有網際網路連線的伺服器：
   1. 複製您在第 2 節中建立的 .tar.gz 檔案。確保系統符合 系統需求。
   2. 使用下列指令擷取 .tar.gz 檔案的內容：
      &gt;tar -xvf <tar file&gt;
   3. 將 CD 複製到 tar 指令建立的目錄。
   4. 設定 install-from-rpm-bundle.sh 指令碼的權限：
      &gt;755 字 install-from-rpm-bundle.sh
   5. 按照以下步驟執行 install-from-rpm-bundle.sh 指令碼： 使用下列指令：
      &gt; ./install-from-rpm-bundle.sh
5. 回答提示問題。
6. 安裝完成後，請在瀏覽器中前往伺服器網址，例如 身分：
   http://localhost.或是如果您有特定 IP 或 DNS 請前往 http://IP_address 或 http://DNS_name。
   
   系統會將您重新導向至 Apigee 設定檔資料庫設定頁面。
   
   注意：一般而言，您已設定並註冊主機名稱 ，因此不需要使用 http://localhost。
7. 設定與 MySQL 的連線。如果 MySQL 位於遠端電腦，請展開 「Advanced Options」區段，然後輸入該機器的連線資訊。 然後選取「儲存並繼續」。
8. 輸入下列資訊，設定與 Apigee 端點的連線。 然後選取「儲存」：
   如要進一步瞭解這些值，請參閱「開始安裝前需要的資訊」 前往開發人員服務入口網站 需求。
   1. 開發人員入口網站機構
   2. 開發人員入口網站端點網址
   3. 端點驗證使用者
   4. 已驗證的使用者密碼
9. 在系統提示時，選取「安裝智慧型文件範例 WADL」按鈕即可安裝 Smart 文件 WADL 範例如果您略過這個步驟，範例 SmartDoc API 不會 。
   注意：如果您的入口網站連接至 Apigee Edge 的私人安裝程序 雲端，而安裝 Edge 時沒有外部網際網路連線，您必須執行 才能使用 SmartDoc 模組。如要 如要瞭解 SmartDoc，請參閱 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. 輸入下列資訊來設定管理員使用者，然後選取 儲存。請注意，Drupal 會建立名為「admin」的管理員使用者因此請勿使用「admin」為 使用者名稱。
    如果略過這個步驟，你仍可按照下列說明使用 Drush 建立管理員 。建立管理員使用者。
    1. 開發人員的姓名
    2. 開發人員入口網站使用者名稱
    3. 密碼
    4. 電子郵件地址
12. 安裝完成後，請在 settings.php 檔案設定權限：
    &gt;Chmod 640 /var/www/html/sites/default/settings.php
13. 前往入口網站首頁 http://localhost/ 或 管理入口網站
14. 使用管理員憑證登入入口網站。

4. 建立管理員使用者

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

1. 將 CD 推送至 drupal_root/sites/預設目錄。Drupal 根的標準位置 目錄為 /var/www/html:
   &gt;cd &lt;drupal_root&gt;/sites/default
2. 確認您具備私人 Drupal 檔案的寫入權限：
   &gt;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. 輸入下列指令來建立管理員使用者，取代 > 簽署」。換成您的值：
   &gt;Drush 使用者建立 <使用者名稱>--mail=&quot;&lt;email-address&gt;&quot;--password=&quot;&lt;password&gt;&quot;
   &gt;Drush 使用者新增角色管理員 <使用者名稱>
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 Update Manager 模組 在 Drupal 選單中選取「Modules」，然後向下捲動至 「Update manager」模組。如果尚未啟用，請加以啟用。

啟用後，您可以前往「報表」>可用 更新選單項目。您也可以使用下列 Drush 指令：

> drush pm-info update

使用「報表」>有可用的更新 >設定選單項目 模組，在有可用的更新時以電子郵件通知您，並且設定檢查 更新。

7. 選用 - 在實際工作環境部署 伺服器

如果您要在實際執行伺服器上部署入口網站，建議執行額外的安全性作業 步驟，包含：

1. 請執行以下指令碼，確保 MySQL 安裝作業安全無虞：
   &gt; /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. 選用 - 安裝 SmartDoc

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

• 如要將入口網站連線至 Edge Cloud 安裝，SmartDoc 已經 安裝，不需要進行其他設定。
• 如要將入口網站連線至 Edge for Private Cloud 安裝作業，您必須確保 安裝在 Edge 上的 SmartDoc如要進一步瞭解如何安裝 Edge 和 SmartDoc，請參閱安裝 SmartDoc。

如要進一步瞭解 SmartDoc，請參閱使用 SmartDoc 建立文件 API

11. 接下來該怎麼做？

安裝開發人員服務入口網站後，接下來要進行 符合您的特定需求Apigee 網站上的說明文件含有 瞭解如何設定、設定入口網站樣式及管理入口網站。如需說明文件，請前往 http://apigee.com/docs/developer-services/content/what-developer-portal。

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

工作	說明
自訂 主題	主題定義了入口網站的外觀，包括顏色、樣式和其他 視覺元素
自訂 外觀	首頁包含主選單、歡迎訊息、頁首、頁尾和標題。
新增及 管理使用者帳戶	註冊程序會決定新開發人員在 入口網站。舉例來說，新的開發人員可以立即存取入口網站，或是 則必須經過管理員驗證這項程序也會控管入口網站 建立新帳戶時，管理員會收到通知。
設定 電子郵件地址	入口網站會為了回應特定事件而傳送電子郵件。舉例來說 開發人員在入口網站上註冊，以及開發人員忘記密碼時。
新增及 管理使用者帳戶	新增條款與開發人員必須先接受條件頁面才能獲準 存取入口網站
新增及 管理使用者帳戶	入口網站實作以角色為基礎的授權模型，允許開發人員 並定義入口網站使用的權限和角色。
新增網誌以及 論壇貼文	入口網站內建網誌和討論串論壇支援。定義權限 能夠檢視、新增、編輯及刪除網誌和論壇文章。
確保執行資料庫備份	確認備份的是 Drupal 資料庫。請注意 安裝方式不同，您必須決定將 資料庫
設定主機名稱	如果您沒有在 DNS 伺服器中設定主機名稱，可隨時透過 伺服器的 IP 位址如要使用主機名稱，可以為 伺服器，這些指令應可在不進行其他基本設定的情況下正常運作。 如果設定了負載平衡器，或是為某些使用者在網站上取得的網址不正確 其他理由，您可以在開發人員入口網站的 settings.php 檔案中設定 $base_url。 預設位於 /var/www/html/sites/default 目錄。