test

Service Registry 3.1 管理指南

管理 Java DB 資料庫

Registry 會使用 Java DB 資料庫。Java DB 是 Apache 軟體基金會開放原始碼關聯式資料庫計劃的商用發行版本。這個 Apache 計劃的名稱是 Derby。

依預設，資料庫位在 RegistryDomain-base/3.0/data/registry/soar/ 目錄中。資料庫備份會位在 RegistryDomain-base/3.0/backup/ 目錄中，其中包括一個含備份日期 (例如，20060419-004759) 的子目錄名稱。

依預設，Java DB 資料庫會在內嵌式模式中執行作業。這表示，它會與 Service Registry 在相同的 JVM 中執行，而且只接受來自 Service Registry 這個用戶端的連線。您無法進行遠端連線。當 Java DB 在內嵌式模式中執行時，只有在它未執行的狀況下，才可以備份資料庫 (離線備份)。如需操作說明，請參閱執行資料庫的離線備份。

在 Registry 網域執行時，如果您需要能夠備份資料庫 (線上備份)，您必須在網路伺服器模式中執行 Java DB 資料庫。如需操作說明，請參閱從內嵌式模式切換至網路伺服器模式和執行資料庫的線上備份。

當 Java DB 在網路伺服器模式中執行時，Java DB 可在常見用戶端/伺服器配置中，接受多個用戶端連線。例如，Service Registry 和 SQL 用戶端可同時與 Java DB 進行通訊。當 Java DB 在網路伺服器模式中執行時，會使用預設值為 1527 的資料庫連接埠。Service Registry 這類的用戶端會使用此連接埠與資料庫通訊。

當 Java DB 在網路伺服器模式中執行時，Service Registry 會在網路用戶端模式中執行。

在網路伺服器模式中執行的資料庫必須以密碼加以保護，讓只有經過認證的用戶端才可以使用資料庫。當資料庫在內嵌式模式中執行時，您也可以使用相同的方式保護資料庫，但這並不是必要的步驟。

依預設，此時會設定 ServiceRegistry-base /install/install.properties 檔案中的特性，讓 Java DB 在內嵌式模式中執行。表 1–3 將顯示這些設定。

表 1–3 Java DB 的預設特性設定

特性設定 

說明 

registry.install.clientDatabase=false

啟用內嵌式模式 

registry.install.RequireDatabaseAuthentication=false

不要求資料庫認證 

registry.install.DatabaseUserID=APP

將使用者 ID 設定為 APP (未使用)

registry.install.DatabasePassword=app123

將密碼設定為 app123 (未使用)

如需有關 Java DB 的更多詳細資訊，請參閱 Java DB 文件，文件位在 Java DB 網站。

Procedure要求資料庫認證

依預設，不需要資料庫認證。當資料庫在內嵌式模式中執行時，可能會要求認證，而當資料庫在網路伺服器模式中執行時，則必須要求認證。

  1. 變更為 Service Registry 安裝目錄︰

    cd ServiceRegistry-base/install

  2. 在文字編輯器中，開啟 install.properties 檔案副本。

  3. 將 registry.install.RequireDatabaseAuthentication 特性的設定從 false 變更為 true。

  4. 編輯 registry.install.DatabaseUserID 特性的設定。

    對於內嵌式模式，此值可以是 APP 或空白：

    registry.install.DatabaseUserID=APP
    registry.install.DatabaseUserID=

    對於網路伺服器模式，此值必須是 APP。

  5. 編輯 registry.install.DatabasePassword 特性的設定。

    密碼必須至少包含 6 個字元。預設值為 app123。

  6. 儲存並關閉檔案。

  7. 停止並重新啟動 Registry 的 Application Server 網域。若要這麼做，請執行以下指令 (全部位於同一行)：

    Ant-base/ant -f build-install.xml Dinstall.properties= props-file appserver.domain.bounce

    其中 props-file 是您在在 [以後配置] 方式安裝之後以 Root 身份使用自訂特性配置 Service Registry或在 [以後配置] 方式安裝之後以非 Root 使用者身份使用自訂特性配置 Service Registry中所編輯 install.properties 檔案副本的路徑名稱。

Procedure執行資料庫的離線備份

如果資料庫在內嵌式模式中執行，您必須執行離線備份。

  1. 變更為 Service Registry 安裝目錄︰

    cd ServiceRegistry-base/install

  2. 執行以下指令 (全部位於同一行)：

    Ant-base/ant -f build-install.xml Dinstall.properties= props-file appserver.domain.stop

    其中 props-file 是您在在 [以後配置] 方式安裝之後以 Root 身份使用自訂特性配置 Service Registry或在 [以後配置] 方式安裝之後以非 Root 使用者身份使用自訂特性配置 Service Registry中所編輯 install.properties 檔案副本的路徑名稱。

  3. 執行以下指令 (全部位於同一行)：

    Ant-base/ant -f build-install.xml Dinstall.properties= props-file backup.db

  4. 執行以下指令 (全部位於同一行)，重新啟動網域：

    Ant-base/ant -f build-install.xml Dinstall.properties=props-file appserver.domain.start

Procedure從內嵌式模式切換至網路伺服器模式

若要從內嵌式模式 (預設) 切換至網路伺服器模式，請將 registry.install.clientDatabase 特性的設定從 false 變更為 true，並且要求資料庫認證。

在編輯特性之後，重新建立資料庫資源，然後停止再重新啟動 Application Server。

  1. 變更為 Service Registry 安裝目錄︰

    cd ServiceRegistry-base/install

  2. 在文字編輯器中，開啟 install.properties 檔案副本。

  3. 將 registry.install.clientDatabase 特性的設定從 false 變更為 true。

  4. 將 registry.install.RequireDatabaseAuthentication 特性的設定從 false 變更為 true。

  5. 必要時，請編輯 registry.install.DatabaseUserID 特性的設定。

    對於網路伺服器模式，此值必須是 APP。

  6. 編輯 registry.install.DatabasePassword 特性的設定。

    任何長度都有效。預設值為 app123。

  7. 儲存並關閉檔案。

  8. 重新建立資料庫連線池和相關資源。若要這麼做，請執行以下指令 (全部位於同一行)：

    Ant-base/ant -f build-install.xml Dinstall.properties= props-file appserver.jdbcResource.update

    其中 props-file 是您在在 [以後配置] 方式安裝之後以 Root 身份使用自訂特性配置 Service Registry或在 [以後配置] 方式安裝之後以非 Root 使用者身份使用自訂特性配置 Service Registry中所編輯 install.properties 檔案副本的路徑名稱。

  9. 停止並重新啟動 Registry 的 Application Server 網域。若要這麼做，請執行以下指令 (全部位於同一行)：

    Ant-base/ant -f build-install.xml Dinstall.properties= props-file appserver.domain.bounce

  10. 啟動 Java DB 資料庫。若要這麼做，請執行以下指令：

    asadmin start-database --dbhome database-directory

    依預設，此指令會將資料庫及其記錄檔放在目前的目錄中。使用 --dbhome 選項指定資料庫的位置 (通常是在 RegistryDomain-base /3.0/data/registry/soar)。

接下來的步驟

如果資料庫在網路伺服器模式中執行，您可以執行資料庫的線上備份。

稍後，如果您需要返回內嵌式模式，請按照相同步驟進行，但有以下例外狀況：

Procedure執行資料庫的線上備份

  1. 變更為 Service Registry 安裝目錄︰

    cd ServiceRegistry-base/install

  2. 檢查 install.properties 檔案副本的 registry.install.clientDatabase 特性是否設定為 true。

  3. 執行以下指令 (全部位於同一行)：

    Ant-base/ant -f build-install.xml Dinstall.properties= props-file backup.db

    其中 props-file 是您在在 [以後配置] 方式安裝之後以 Root 身份使用自訂特性配置 Service Registry或在 [以後配置] 方式安裝之後以非 Root 使用者身份使用自訂特性配置 Service Registry中所編輯 install.properties 檔案副本的路徑名稱。