配置 HADB

本小節說明以下基本 HADB 配置作業：

• 建立管理網域

• 建立資料庫

• 檢視和修改配置屬性

• 配置 JDBC 連線池

建立管理網域

hadbm createdomain 指令可建立包含指定 HADB 主機的管理網域。此指令可初始化主機和持續性配置存放區之間的內部通訊通道。

該指令語法為：

hadbm createdomain
 [--adminpassword=password |--adminpasswordfile=
file | --no-adminauthentication] [--agent=maurl]
 hostlist

hostlist 運算元是以逗號分隔的 HADB 主機清單，其中每一個均為有效的 IPv4 網路位址。希望位於新網域中的所有主機都包括在 hostlist 中。

請參閱一般選項，以取得指令選項說明。

使用此指令之前，請確定 HADB 管理代理程式可在 hostlist 中的每台主機上執行。此外，管理代理程式還必須：

• 不是現有網域的成員。

• 配置為使用同一連接埠。

• 能夠經由 UDP、TCP 和使用 IP 多重播送到達彼此。

hadbm 建立管理網域之後，會啟用網域中的所有主機。然後管理代理程式即可以用於管理資料庫了。建立 HADB 網域之後是建立 HADB 資料庫。如需有關建立 HADB 資料庫的更多資訊，請參閱建立資料庫。

範例 3–2 建立 HADB 管理網域

以下範例在四個指定的主機上建立管理網域：

hadbm createdomain --adminpassword= password host1,host2,host3,host4

hadbm 成功執行指令後，會顯示以下訊息：

Domain host1,host2,host3, host4 created.

建立 HADB 網域後，將 HADB 套裝軟體的路徑和版本與管理代理程式一同註冊。

建立資料庫

使用 hadbm create 指令手動建立資料庫。

使用此指令建立資料庫之前，請首先建立管理網域並註冊 HADB 套裝軟體。如果在執行 hadbm create 時尚未執行這兩個步驟，則會隱式執行這兩個步驟。雖然這看似需要較少的工作，但任何指令中出現故障均會很難除錯。而且，hadbm create 是不可分割的，即如果其中一個隱式指令失敗，則已成功執行的指令將不會回復。因此，最好僅在建立網域並註冊 HADB 套裝軟體之後建立資料庫。

例如，如果 hadbm createdomain 和 hadbm registerpackage 成功執行，但 hadbm create database 失敗，hadbm createdomain 和 hadbm registerpackage 進行的變更將繼續。

建立資料庫

1. 建立管理網域。

   如需更多資訊，請參閱建立管理網域

2. 註冊 HADB 套裝軟體。

   如需更多資訊，請參閱註冊 HADB 套裝軟體。

3. 使用 hadbm create 指令建立資料庫。

   如需有關指令語法的資訊，請參閱以下小節。

hadbm create 指令語法

dbname 運算元指定資料庫名稱，該名稱必須是唯一的。若要確保資料庫名稱的唯一性，請使用 hadbm list 指令列出現有資料庫名稱。請使用預設資料庫名稱，除非需要建立多個資料庫。例如，若要在同一組 HADB 機器上建立具有獨立資料庫的多個叢集，請為每個叢集使用獨立的資料庫名稱。

hadbm create 指令將錯誤訊息寫入主控台，而非記錄檔。

表 3–7 說明特殊的 hadbm create 指令選項。請參閱一般選項，以取得其他指令選項說明。

範例 3–3 建立資料庫範例

以下指令為建立資料庫的範例：

hadbm create --spares 2 --devicesize 1024 --dbpassword secret123
 --hosts n0,n1,n2,n3,n4,n5

指定主機

可使用 --hosts 選項指定以逗號分隔的資料庫節點之主機名稱或 IP 位址清單。hadbm create 指令可為清單中的每個主機名稱 (或 IP 位址) 建立一個節點。節點數必須相等。使用重複主機名稱在同一機器上建立具有不同連接埠號的多個節點。確定同一機器上的節點並非鏡像節點。

節點以此選項中列出的順序自零開始編號。第一個鏡像對為節點零 (0) 和一 (1)，第二個為二 (2) 和三 (3)，以此類推。奇數編號的節點在一個 DRU 中，偶數編號的節點在其他 DRU 中。使用 --spares 選項，備援節點為編號最大的節點。

如需有關配置雙網路介面的資訊，請參閱配置網路備援

指定裝置大小

使用 --devicesize 選項可指定裝置大小。建議的裝置大小：

(4x / nd + 4l/d) / 0.99

其中，

• x 為使用者資料的總大小

• n 為節點數 (由 --hosts 選項指定)

• d 為每個節點上的裝置數 (由 --datadevices 選項指定)

• l 為記錄緩衝區大小 (由屬性 LogBufferSize 指定)

  如果可能會發生重新分段 (例如，使用 hadbm addnodes)，則建議的裝置大小為：

  (8x / nd + 4l/d) / 0.99

設定異質多工式裝置路徑

若要為每個節點或服務設定不同的裝置路徑，請使用 hadbm create 的 -- set 選項。有四種類型的裝置：DataDevice、NiLogDevice (節點內部記錄裝置)、RelalgDevice (相關代數查詢裝置) 和 NoManDevice (節點管理員裝置)。每個 name =value 對的語法如下，其中，-devno 僅在 device 為 DataDevice 時需要：

node-nodeno.device-devno.Devicepath

例如︰

--set Node-0.DataDevice-0.DevicePath=/disk0,
Node-1.DataDevice-0.DevicePath=/disk 1

還可以設定歷史檔案的異質多工式路徑，如下所示：

node-nodeno.historypath=path

如需有關歷史檔案的資訊，請參閱清除和歸檔歷史檔案

未設定的特定節點或裝置裝置路徑均預設為 --devicepath 值。

使用 hadbm set 和 hadbm addnodes 指令變更歷史檔案的裝置路徑和位置。

疑難排解

如果您在建立資料庫時遇到困難，請檢查以下內容：

• 確定在所有主機上啟動了管理代理程式並定義了 HADB 網域。如需詳細資訊，請參閱啟動管理代理程式

• 必須設定檔案和目錄權限，以允許以下使用者對安裝、歷史、裝置和配置路徑擁有讀取、寫入和執行存取權限：

  • Sun Java System Application Server 管理使用者 (安裝期間設定)

  • HADB 系統使用者

    如需有關設定使用者權限的詳細資訊，請參閱準備 HADB 設定

  Application Server 和 HADB 連接埠指定不可與同一機器上的其他連接埠指定衝突。建議的預設連接埠指定為：

  • Sun Java System 訊息佇列：7676

  • IIOP：3700

  • HTTP 伺服器：80

  • 管理伺服器：4848

  • HADB 節點：每個節點使用六個連續的連接埠。例如，對於預設連接埠 15200，節點 0 使用 15200 至 15205 ，節點 1 使用 15220 至 15225，以此類推。

  磁碟空間必須充足，請參閱「Sun Java System Application Server Release Notes」。

檢視和修改配置屬性

可以分別使用hadbm get 和 hadbm set 指令檢視和修改資料庫配置。

取得配置屬性值

若要取得配置屬性值，請使用 hadbm get 指令。如需有效屬性清單，請參閱配置屬性。指令語法為：

hadbm get attribute-list | --all  
[dbname]  
[--adminpassword=password | --adminpasswordfile=file]  
[--agent=maurl]

dbname 運算元指定資料庫名稱。預設為 hadb。

attribute-list 運算元是以逗號分隔或引號引起的、並以空格分隔的屬性清單。--all 選項顯示所有屬性值。如需 hadbm get 的所有屬性清單，請參閱配置屬性。

請參閱一般選項，以取得指令選項說明。

範例 3–4 使用 hadbm get 之範例

hadbm get JdbcUrl,NumberOfSessions

設定配置屬性值

若要設定配置屬性值，請使用 hadbm set 指令。如需有效屬性清單，請參閱配置屬性

hadbm set [dbname] attribute
=value[,attribute=
value...]
 [--adminpassword=password | --adminpasswordfile=file]
 [--agent=maurl]

dbname 運算元指定資料庫名稱。預設為 hadb。

attribute=value 清單為以逗號分隔或引號引起的、並以空格分隔的屬性清單。

請參閱一般選項，以取得指令選項說明。

如果此指令成功執行，則會重新啟動資料庫，並使其處於資料庫之前所處狀態或更佳狀態。如需有關資料庫狀態的資訊，請參閱取得 HADB 的狀態。重新啟動 HADB (如重新啟動資料庫中所述)。

無法使用 hadbm set 設定以下屬性，而應在建立資料庫時設定 (請參閱建立資料庫)。

• DatabaseName

• DevicePath

• HistoryPath

• NumberOfDatadevices

• Portbase

• JdbcUrl (其值在資料庫建立期間根據 --hosts 和 --portbase 選項設定)。

使用 hadbm set 設定配置屬性 (除 ConnectionTrace 或 SQLTraceMode 之外) 會導致 HADB 的輪替式重新啟動。在輪替式重新啟動中，會停止每個節點，並使用新的配置啟動，每次一個節點；HADB 服務不會中斷。

如果設定 ConnectionTrace 或 SQLTraceMode，不會發生輪替式重新啟動，但變更會僅對應用程式伺服器實例的 HADB 連線有效。

配置屬性

下表列出可使用 hadbm set 修改和使用 hadbm get 擷取的配置屬性。

配置 JDBC 連線池

Application Server 使用 Java 資料庫連結 (JDBC) API 與 HADB 通訊。asadmin configure-ha-cluster 指令可自動建立 JDBC 連線池，以與 HADB 配合使用 (對於叢集 cluster-name)。連線池的名稱為 cluster-name-hadb-pool。JDBC 資源的 JNDI URL 為 jdbc/cluster-name -hastore。

連線池的初始配置通常是充足的。增加節點時，請變更持續的池大小，以便每個 HADB 使用中的節點均具有八條連線。請參閱增加節點。

本小節包含以下主題：

• 取得 JDBC URL

• 建立連線池

• 範例 3–5

• 建立 JDBC 資源

  如需有關連線池和 JDBC 資源的一般資訊，請參閱管理指南。

取得 JDBC URL

設定 JDBC 連線池之前，需要使用 hadbm get 指令如下所示來確定 HADB 的 JDBC URL：

hadbm get JdbcUrl [dbname]

例如︰

hadbm get JdbcUrl

此指令可顯示 JDBC URL，其形式如下：

jdbc:sun:hadb:host:port,
host:port,...

移除 jdbc:sun:hadb: 前綴並使用 host:port, host:port... 部分做為表 3–10 中所述之 serverList 連線池特性的值。

建立連線池

下表概括 HADB 必需的連線池設定。增加節點時變更持續的池大小，但請勿變更其他設定。

com.sun.hadb.jdbc.ds.HadbDataSource

下表概括 HADB 必需的連線池特性。增加節點時變更 serverList，但請勿變更其他特性。

範例 3–5 建立連線池

此為建立 HADB JDBC 連線池之 asadmin create-jdbc-connection-pool 指令的範例：

asadmin create-jdbc-connection-pool
--user adminname --password secret 
--datasourceclassname com.sun.hadb.jdbc.ds.HadbDataSource
--steadypoolsize=32
--isolationlevel=repeatable-read
--isconnectvalidatereq=true
--validationmethod=meta-data
--property username=storename:password=secret456:serverList=
host\:port,host\:port,
host\\:port,host\:port,
host\:port,host\:port
:cacheDatabaseMetaData=false:eliminateRedundantEndTransaction=true hadbpool

在 Solaris 上，使用雙反斜線 (\\) 替換特性值內的冒號字元 (:)。在 Windows 上，使用單反斜線 (\) 替換冒號字元 (:)。

建立 JDBC 資源

下表概括 HADB 必需的 JDBC 資源設定。