私有雲 v4.18.05 的邊緣
Apigee Developer Services 入口網站 4.18.05 版本 (或簡稱為入口網站) 無法讓您更新前一個 tar 版本的入口網站。您只能將入口網站的 RPM 版本直接更新為 4.18.05。
不過,您可以將以 tar 為基礎的入口網站轉換為以 4.18.05 RPM 為基礎的入口網站執行個體。在這個過程中,您會將現有入口網站的 MySQL/MariaDB 遷移至 Postgres 資料庫。完成轉換後,入口網站仍會維持採用 RPM 架構的入口網站。
您可以將許多舊版 tar 入口網站遷移至採用 RPM 的入口網站。這個入口網站包括 4.16.09 和 4.17.01 版 (不只是 4.17.05 版)。唯一的條件是入口網站執行的是 Drupal 7 以上版本。如要查看您的 Drupal 版本,請在 Drupal 選單中依序選取「報表」>「狀態報告」。Drupal 版本會顯示在輸出內容的第一列。
從 tar 型入口網站遷移至 RPM 入口網站的概要步驟如下:
- 在新節點上安裝 RPM 的 4.18.05 版本入口網站。
- 透過 RPM 入口網站建立新的 Postgres 資料庫。
- 從 tar 型入口網站遷移入口網站資料庫。
- 將從 tar 型入口網站複製的所有配件檔案複製到 RPM 入口網站。
- 將 DNS 項目更新為指向新版 RPM 入口網站。
請注意,以 RPM 為基礎的入口網站預設使用通訊埠 8079,而 tar 型版本則使用通訊埠 80。確認你在 DNS 項目中使用正確的通訊埠號碼。如要瞭解如何使用其他通訊埠,請參閱「設定入口網站使用的 HTTP 通訊埠」。
轉換後的新預設安裝目錄
在更新使用 Nginx/Postgres 的安裝作業之後,根目錄已從:
/opt/apigee/apigee-drupal
更新為:
/opt/apigee/apigee-drupal/wwwroot
入口網站轉換程序
如何將入口網站轉換為以 RPM 為基礎的安裝:
- 在與 tar 型入口網站不同的節點上,安裝以 RPM 為基礎的 4.18.05 版本入口網站。
- 在 RPM 入口網站上,建立新的 Postgres 資料庫。稍後,您會將資料庫從 tar 型入口網站遷移至這個新資料庫:
- 登入 psql:
psql -h localhost -p 5432 -U apigee
按照入口網站設定檔中 PG_PWD 屬性定義的 Postgres 密碼。
- 建立新的 Postgred 資料庫:
CREATE DATABASE newportaldb;
- 結束 psql:
\q
- 登入 psql:
-
在 tar 型入口網站中,移除不再使用的舊模組:
cd /var/www/html
drush sql-query --db-prefix "DELETE from {system} where name = 'apigee_account' AND type = 'module';"
drush sql-query --db-prefix "DELETE from {system} where name = 'apigee_checklist' AND type = 'module';"
drush sql-query --db-prefix "DELETE from {system} where name = 'apigee_sso_ui' AND type = 'module';"
- 在 tar 型入口網站中,安裝並設定 Migrator Drupal 模組:
-
cd /tmp
-
wget https://ftp.drupal.org/files/projects/dbtng_migrator-7.x-1.4.tar.gz
-
gunzip /tmp/dbtng_migrator-7.x-1.4.tar.gz
-
tar -xvf /tmp/dbtng_migrator-7.x-1.4.tar --directory /var/www/html/sites/all/modules
- 以管理員身分登入入口網站。
- 在「Drupal」選單中選取「Modules」。
- 啟用「DBTNG Migrator」模組。
- 儲存設定。
-
- 在 tar 型入口網站上編輯
/var/www/html/sites/default/settings.php
,以新增第二個資料庫設定,指向在 RPM 入口網站上建立的資料庫。目前的資料庫設定名稱為「default」。將新設定命名為「custom」,如以下範例所示:$databases = array ( 'default' => array ( 'default' => array ( 'database' => 'devportal', 'username' => 'devportal', 'password' => 'devportal', 'host' => 'localhost', 'port' => '', 'driver' => 'mysql', 'prefix' => '', ), ), 'custom' => array ( 'default' => array ( 'database' => 'newportaldb', 'username' => 'apigee', 'password' => 'postgres', 'host' => '192.168.168.100', 'port' => '5432', 'driver' => 'pgsql', 'prefix' => '', ) ) );
其中
host
和port
指定 Postgres 伺服器的 IP 位址和通訊埠。Postgres 使用通訊埠 5432 建立連線。 -
在 tar 型入口網站中,安裝 Postgres 驅動程式:
- 使用 Yum 安裝驅動程式:
yum install php-pdo_pgsql
- 編輯
/etc/php.ini
,在檔案中的任何位置新增下列程式碼:extension=pgsql.so
- 重新啟動 Apache:
service httpd restart
- 使用 Yum 安裝驅動程式:
- 在 tar 型入口網站上,將入口網站資料庫遷移至 RPM 入口網站:
- 以管理員身分登入入口網站。
- 在「Drupal」選單中依序選取「Structure」->「Migrator」。
- 根據上方顯示的
settings.php
檔案,在 tar 型入口網站default
和目的地資料庫custom
中選擇來源資料庫。 - 按一下「遷移」。tar 型資料庫會遷移至以 RPM 為基礎的資料庫。
- 將
sites
目錄從 tar 型伺服器複製到 RPM 伺服器。以下步驟顯示的路徑以預設路徑為依據。視需要修改安裝內容。- 在 tar 型入口網站中,封裝
/var/www/html/sites
目錄:cd /var/www/html/sites
tar -cvzf /tmp/sites.tar.gz .
- 在採用 RPM 的伺服器上,將
/tmp/sites.tar.gz
複製到/opt/apigee/apigee-drupal/wwwroot/sites
。 - 取消網站組合目錄,但不覆寫重要檔案。
- 備份
settings.php
檔案:sudo cp /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.php /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.bak.php
- 備份現有的
files
目錄:sudo mv /opt/apigee/apigee-drupal/wwwroot/sites/default/files /opt/apigee/apigee-drupal/wwwroot/sites/default/files_old
- 備份現有的
sites
目錄:tar -cvzf /tmp/sites_old.tar.gz /opt/apigee/apigee-drupal/wwwroot/sites
- 從 tar 型伺服器解壓縮並解壓縮
sites
目錄:gunzip /opt/apigee/apigee-drupal/wwwroot/sites/sites.tar.gz
tar -xvf /opt/apigee/apigee-drupal/wwwroot/sites/sites.tar
- 請確定複製的檔案具備適當的擁有權:
chown -R apigee:apigee /opt/apigee/apigee-drupal/wwwroot/sites/
- 還原
settings.php
檔案:sudo cp /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.bak.php /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.php
- 將私人檔案移至新位置:
cp -r /opt/apigee/apigee-drupal/wwwroot/sites/default/files/private/* /opt/apigee/data/apigee-drupal-devportal/private
rm -rf /opt/apigee/apigee-drupal/wwwroot/sites/default/files/private
chown -R apigee:apigee /opt/apigee/data/apigee-sap-drupal-devportal/private
- 備份
- 在 tar 型入口網站中,封裝
- 在 tar 型入口網站上,只有當您變更了 /var/www/html 的預設路徑,變更 tar 型入口網站上網站根目錄的路徑:執行
drush status
,然後查看files
路徑和private files
路徑:cd /var/www/html
drush status
如果檔案/私人檔案不在
sites
目錄下,請將其複製到以 RPM 為基礎的伺服器,如上所示。 - 在 RPM 入口網站上,更新
/opt/apigee/apigee-drupal/wwwroot/sites/default/settings.php
以設定預設資料庫的屬性:vi /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.php
在 settings.php 中設定預設資料庫說明:
$databases = array ( 'default' => array ( 'default' => array ( 'database' => 'newportaldb', 'username' => 'apigee', 'password' => 'postgres', 'host' => 'localhost', 'port' => '5432', 'driver' => 'pgsql', 'prefix' => '', ) ) );
其中
database
會指定您建立的新資料庫,並在 tar 型入口網站上為自訂資料庫定義username
和password
,而prefix
為空白。 - 在 RPM 入口網站上,採用 RPM 架構的入口網站與 tar 版本相較,採用的 Drupal 模組較少。遷移至 RPM 入口網站後,請務必檢查是否有任何缺少的模組,並視需要安裝。
- 安裝用於偵測缺少模組的 Drupal
missing_module
:cd /opt/apigee/apigee-drupal/wwwroot
drush dl missing_module
drush en missing_module
- 以管理員的身分登入 RPM 入口網站。
- 在 Drupal 選單中選取「報告」>「狀態報告」,然後檢查是否有任何遺漏的模組。
- 請使用報表安裝任何缺少的模組,或使用下列指令:
cd /opt/apigee/apigee-drupal/wwwroot
drush dl <moduleA> <moduleB> ...
drush en <moduleA> <moduleB> ...
- 啟用所有模組後,請確認檔案屬於 Apigee 使用者:
chown -LR apigee:apigee /opt/apigee/apigee-drupal/wwwroot
如要進一步瞭解檔案權限,請參閱 https://www.drupal.org/node/244924。
- 安裝用於偵測缺少模組的 Drupal
- 在 RPM 入口網站上,在瀏覽器中執行 update.php,移除缺少模組的任何錯誤:
- 以管理員的身分登入 RPM 入口網站。
- 在瀏覽器中前往下列網址:
http://portal_IP_or_DNS:8079/update.php
其中 portal_IP_or_DNS 是 RPM 入口網站的 IP 位址或網域名稱。
- 請按照畫面上的提示操作。
- 更新 DNS 項目以指向新的 RPM 入口網站。
請注意,以 RPM 為基礎的入口網站預設使用通訊埠 8079,而 tar 型版本則使用通訊埠 80。確認你在 DNS 項目中使用正確的通訊埠號碼。關於使用其他通訊埠的資訊,請參閱「設定入口網站使用的 HTTP 通訊埠」。
轉換完成。