Developer Services Portal 4.17.09 版
這個程序說明如何升級現有的 Apigee Developer Channel 服務 內部部署安裝。
,瞭解如何調查及移除這項存取權。確定正確的更新程序
更新入口網站的程序取決於目前的安裝程序:
- 如果您的安裝作業會使用 Nginx/Postgres,請參閱下方的使用 RPM 升級入口網站。
- 如果您的安裝作業使用 Apache/MySQL 或 Apache/MariaDB,請參閱 轉換 TAR 型入口網站,至 RPM 型入口網站。
決心 目前的安裝類型
如果不確定目前的安裝類型,請使用以下指令來判斷目前的安裝類型 它:
ls /opt
如果您使用的是 Nginx/Postgres,會看到下列目錄: 《
/opt/apigee
》和《/opt/nginx
》。如果您使用的是 Apache/MySQL 或 Apache/MariaDB,則不應使用這些目錄 。
/opt/apigee/apigee-service/bin/apigee-all status
如果您使用的是 Nginx/Postgres,會看到下列輸出內容:
+ apigee-service apigee-drupal-devportal status OK: apigee-drupal-devportal is up and running + apigee-service apigee-lb status apigee-service: apigee-lb: OK + apigee-service apigee-postgresql status apigee-service: apigee-postgresql: OK
apachectl -S
如果您使用的是 Apache/MySQL 或 Apache/MariaDB,則這個指令應會傳回 入口網站的根目錄,格式如下:
*:80 192.168.56.102 (/etc/httpd/conf/vhosts/devportal.conf:1)
預設安裝目錄
升級程序假設開發人員入口網站已安裝於:
- 4.17.05 以上版本:
/opt/apigee/apigee-drupal/wwwroot
- 4.17.05 之前:
/opt/apigee/apigee-drupal
(Nginx) 或/var/www/html
(Apache)
如果您並非在預設目錄中安裝入口網站,請修改程序中的路徑 使用安裝目錄。
支援的升級版本
下列入口網站版本支援這項升級程序:
- OPDK-17-01.x
- OPDK-17-05.x
如要判斷入口網站版本,請在瀏覽器中開啟以下網址:
http://your_portal.com/buildInfo
更新前的準備
針對現有安裝項目,如果您曾經修改 Drupal Core 或
修改內容就會遭到覆寫包括任何變更
你對.htaccess
的觀察結果。
您應假設 /sites
目錄之外的所有內容為 Drupal 所擁有。一個
此規則的例外狀況是 robots.txt
;該檔案是否存在
因此檔案會保留下來。
繼續安裝前,請先備份整個 Drupal 網路根目錄 目錄。完成下列安裝步驟後, 自訂備份設定
使用 RPM 升級入口網站
如要更新節點上的入口網站 RPM,請按照下列程序操作:
-
切換至 Drupal 目錄。例如
/opt/apigee/apigee-drupal/wwwroot
。cd /opt/apigee/apigee-drupal/wwwroot
如需預設目錄,請參閱預設安裝目錄 和產品版本。
- 備份 Drupal 資料庫執行個體。
pg_dump
指令會建立 資料庫:
pg_dump --dbname=devportal --host=192.168.56.101 --username=drupaladmin --password --format=c > /tmp/portal.dmp
其中:
dbname
會指定PG_NAME
屬性。host
會指定入口網站節點的 IP 位址。username
會指定入口網站用來存取 資料庫中的DRUPAL_PG_USER
屬性指定 入口網站安裝設定檔。- 系統會提示您輸入 Postgres 使用者密碼,
DRUPAL_PG_PASS
屬性。
如果之後需要從備份還原,請使用下列指令:
pg_restore --clean --dbname=devportal --host=localhost --username=apigee < /tmp/portal.dmp
- 備份整個 Drupal 網站根目錄。預設安裝位置
是 /opt/apigee/apigee-drupal,
但或許已變更。
如果您不確定這個目錄的位置,請使用drush status
指令或 設定 >媒體 >「File」項目用於判斷 Drupal 選單中的內容 公開檔案系統的位置以及私人檔案系統路徑 ( 步驟)。 - 備份
/opt/apigee/data/apigee-drupal-devportal/private
中的檔案。 - 將 Drupal 設為維護模式:
- 在 Drupal 選單中選取「Configuration」。
- 在「設定設定」頁面中,選取「維護」 模式底下的 開發中。
- 選取「讓網站進入維護模式」方塊。
- 輸入使用者維護期間看到的訊息。
- 選取「儲存設定」。
- 按照 安裝 Edge apigee-setup 公用程式。
- 切換至
/opt
目錄:cd /opt
-
在具備網際網路連線的伺服器上升級應用程式:
- 下載 Edge 4.17.09
bootstrap_4.17.09.sh
檔案,/tmp/bootstrap_4.17.09.sh
:curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
- 安裝 Edge 4.17.09
apigee-service
公用程式和依附元件:sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord
其中 uName:pWord 是您所收到使用者名稱和密碼 Apigee。如果省略 pWord,系統會提示您輸入。
根據預設,安裝程式會檢查您是否已安裝 Java 1.8。您可以使用 「C」選項,以在不安裝 Java 的情況下繼續操作。
- 下載 Edge 4.17.09
-
在沒有網際網路連線的伺服器上升級應用程式:
- 按照「建立本機 Apigee 存放區」一節的說明,建立本機 4.17.09 存放區於 安裝邊緣 apigee-setup 公用程式。
-
如要從 .tar 檔案安裝 apigee-service:
- 在含有本機存放區的節點上,使用下列指令來封裝本機
複製到名為
/opt/apigee/data/apigee-mirror/apigee-4.17.09.tar.gz
的單一 .tar 檔案:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- 將 .tar 檔案複製到要更新 Edge 的節點。例如,複製 到 /tmp 目錄 新的節點
- 在新節點上,將檔案解壓縮至 /tmp 目錄:
tar -xzf apigee-4.17.09.tar.gz
這個指令會在包含 .tar 的目錄中建立新的目錄 (名稱為存放區) 檔案。例如 /tmp/repos。
- 安裝 Edge
apigee-service
公用程式並 來自/tmp/repos
的依附元件:sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
請注意,您會在這個指令中加入存放區目錄的路徑。
- 在含有本機存放區的節點上,使用下列指令來封裝本機
複製到名為
-
使用 Nginx 網路伺服器安裝 apigee-service:
- 按照「使用 Nginx webserver」「Install the Edge apigee-setup 公用程式。
- 在遠端節點上,將 Edge
bootstrap_4.17.09.sh
檔案下載至/tmp/bootstrap_4.17.09.sh
:/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
其中 uName:pWord 是您在上方設定的使用者名稱和密碼 供存放區使用,remoteRepo 是 IP 位址或 DNS 名稱 存放區節點
- 在遠端節點上安裝 Edge
apigee-service
公用程式並 dependencies:codesudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
其中 uName:pWord 是存放區使用者名稱和密碼。
- 使用
apigee-service
更新apigee-setup
公用程式:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- 在節點上執行更新公用程式,以更新 Postgres 資料庫:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
其中 configFile 是您安裝時使用的設定檔 擷取至 Postgres 資料庫設定檔的唯一要求是 檔案必須可由「apigee」存取或讀取內容。
- 啟動 Postgres:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
- 在節點上執行更新公用程式,以更新入口網站:
/opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile
其中 configFile 是您安裝時使用的設定檔 入口網站。設定檔的唯一要求是設定檔 必須可由「apigee」存取或讀取內容。
- 在瀏覽器視窗中開啟下列網址,執行 Drupal 的
update.php
指令碼:http://portalIP_DNS:8079/update.php
- 停用 Drupal 維護模式:
- 在 Drupal 選單中選取「Configuration」。
- 在「設定設定」頁面中,選取「維護」 模式底下的 開發中。
- 取消選取「將網站設為維護模式」方塊。
- 選取「儲存設定」。
請注意,更新後的根目錄如下:
/opt/apigee/apigee-drupal/wwwroot
升級已完成。