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

開發人員服務入口網站 4.16.09 版

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

• 您正在使用支援的 64 位元版本 Red Hat Enterprise Linux、CentOS 或 Oracle 版本執行安裝作業。如要查看支援的版本清單，請按這裡。
• 已安裝 Yum。
• 您要備份現有的安裝項目。如果您在 Drupal 核心或任何非自訂模組中修改任何程式碼，修改內容就會遭到覆寫。這包括您您對 .htaccess 所做的任何變更。您應假設 /sites 目錄以外的任何內容都是由 Drupal 擁有。robots.txt 是例外狀況，如果這個檔案存在於網路根目錄，系統會為您保留該檔案。繼續安裝之前，請先備份整個 Drupal 網路根目錄。預設的安裝位置為 /var/www/html，但您可能在安裝時變更了位置。執行以下安裝步驟後，您就可以從備份還原自訂內容。

請按照下列步驟安裝開發人員 Channel Services 入口網站。

1. 取得開發人員 Channel Services 套裝組合

前往 http://community.apigee.com/content/apigee-customer-support，然後選取「登入支援入口網站」來索取開發人員通路服務 .tar 檔案：

• 要求 Edge for Private Cloud 下載目錄的存取權。
• 要求開發人員 Channel Services .tar 檔案的網址。

2. 測試與 Apigee Edge 的連線

在入口網站伺服器上執行命令提示字元並執行下列 cURL 指令，測試與 Edge 管理伺服器之間的連線：
> curl -u {EMAIL}:{PASSWORD} https://{hostname}:8080/v1/organizations/{ORGNAME}



請務必指定 Edge 安裝專用的主機名稱和通訊埠編號。通訊埠 8080 是 Edge 使用的預設通訊埠。如果您連結至雲端，即 [organizationi n], "

3. 移除 7.0 之前的 PHP 版本

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

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

如果是 CentOS 和 Red Hat Enterprise Linux (RHEL)，請使用下列指令移除 PHP 套件：

yum remove <package-name>

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

請根據您是在是否具備網際網路連線的伺服器上，執行下列其中一項程序來安裝入口網站。

在具有網際網路連線的伺服器上：

如何在連上網際網路的伺服器上安裝開發人員 Channel Services：

1. 以超級使用者或超級使用者身分登入伺服器。
2. 建立安裝檔案的目錄，例如 portal。
3. CD 至新的入口網站目錄，並下載開發人員 Channel Services DeveloperServices_x.y.z.tar 檔案，其中 x.y.z 會對應至入口網站版本號碼。
   
   您可以透過瀏覽器中的 Apigee 傳送給您的連結下載檔案，或是複製檔案並新增至下列 cURL 指令：
   > curl -kOL <paste link here>
4. 使用下列指令擷取 Developer Channel Services .tar 檔案的內容：
   > tar -xvf <tar file>
5. CD 至 DeveloperServices-4.x.y.z。
6. 使用下列指令執行安裝指令碼：
   > ./networked-install.sh
7. 回覆提示訊息。

在沒有網際網路連線的伺服器上：

首先，在有網際網路連線的系統上，建立非網路的安裝指令碼：

1. 以根層級或超級使用者身分登入有網際網路連線的系統。
2. 建立安裝檔案的目錄，例如 portal_tar。
3. CD 至 portal_tar 目錄，並下載開發人員 Channel Services DeveloperServices_x.y.z.tar 檔案，其中 x.y.z 會對應至入口網站版本號碼。
4. 使用下列指令擷取開發人員通路服務 .tar 檔案的內容：
   > tar -xvf <tar file>
5. CD 至 DeveloperServices-4.x.y.z。
6. 使用下列指令建立入口網站 .tar.gz 檔案：
   > ./non-networked-install.sh

系統會建立非網路安裝的新 .tar.gz 檔案。

1. 以超級使用者或超級使用者身分登入伺服器。
2. 建立安裝檔案的目錄，例如 portal。
3. CD 至入口網站目錄。
4. 將您為非網路安裝建立的 .tar.gz 檔案 (在上述程序) 複製到 portal 目錄。
5. 使用下列指令擷取 .tar.gz 檔案的內容：
   > tar -xvf <tar file>
6. CD 儲存至由 tar 指令建立的目錄。
7. 在 install-from-rpm-bundle.sh 指令碼上設定權限：
   > chmod 755 install-from-rpm-bundle.sh
8. 使用下列指令執行 install-from-rpm-bundle.sh 指令碼：
   >./install-from-rpm-bundle.sh
9. 回覆提示訊息。

5. 設定開發人員入口網站

大部分的入口網站設定都不需要您互動即可完成，例如安裝 Drupal 模組、安裝預設內容。系統會提示您設定資料庫、設定 Edge 端點，並建立新的管理員使用者。

如何設定開發人員入口網站：

1. 使用瀏覽器前往伺服器網址，例如：
   http://localhost。如果您已設定特定 IP 或 DNS，請前往 http://IP_address 或 http://DNS_name。
   
   系統會將您重新導向至 Apigee 設定檔資料庫設定頁面。
   
   注意：通常您已設定主機名稱，並向 DNS 伺服器註冊該主機名稱，因此無需使用 http://localhost。
2. 設定與資料庫的連線。如果資料庫位於遠端電腦，請展開「進階選項」部分並輸入與該機器的連線資訊，然後選取「儲存並繼續」。
3. 輸入以下資訊以設定與 Apigee 端點的連線，然後選取「Save」。
   如要進一步瞭解這些值，請參閱「開發人員服務入口網站規定」中的「開始安裝前需要的資訊」。
   1. Management API 機構
   2. Management API 端點網址
   3. 端點驗證使用者
   4. 已驗證使用者的密碼
4. 如要設定管理員使用者，請輸入以下資訊，然後選取「儲存」。請注意，Drupal 建立名為「admin」的管理員使用者，因此請勿使用「admin」做為使用者名稱。
   即使略過這個步驟，你仍可使用 Drush 建立管理員，詳情請參閱下方的第 4 節說明。建立管理員使用者。
   1. 開發人員的姓名
   2. 開發人員的入口網站使用者名稱
   3. 密碼
   4. 電子郵件地址
5. 安裝完成後，請在 settings.php 檔案上設定權限：
   > chmod 640 /var/www/html/sites/default/settings.php
6. 前往入口網站的 http://localhost/ 或入口網站的 DNS 名稱。
7. 使用管理員憑證登入入口網站。

6. 建立管理員使用者 (選用)

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

1. CD 至您的 drupal_root/sites/預設目錄。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 使用者-add-role Admin <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 Update Manager 模組。在 Drupal 選單中選取「Modules」，然後向下捲動至「Update Manager」模組。如果尚未啟用，請啟用。

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

> drush pm-info update

使用「Reports」(報表) >「Available Updates」(可用更新) >「Settings」(設定) 選單項目來設定模組，讓系統在有可用更新時透過電子郵件通知您，以及設定檢查更新的頻率。

> yum install mod_ssl