配置 HADB

本节介绍了以下基本 HADB 配置任务：

• 创建管理域

• 创建数据库

• 查看和修改配置属性

• 配置 JDBC 连接池

创建管理域

命令 hadbm createdomain 可以创建包含指定 HADB 主机的管理域。该命令初始化主机和持久性配置存储之间的内部通信通道。

该命令的语法为：

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

hostlist 操作数是以逗号分隔的 HADB 主机列表，其中每个主机都是一个有效的 IPv4 网络地址。hostlist 中包含您希望置入新域中的所有主机。

有关命令选项的说明，请参见常规选项。

使用该命令之前，请确保 hostlist 中的每台主机都在运行 HADB 管理代理。此外，这些管理代理必须：

• 不是现有域的成员。

• 配置为使用同一端口。

• 可以使用 IP 多址广播并通过 UDP、TCP 相互访问。

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 对的语法如下，其中仅当 device 为 DataDevice 时才需要 -devno：

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 Message Queue：7676

  • IIOP：3700

  • HTTP 服务器：80

  • 管理服务器：4848

  • HADB 节点：每个节点使用六个连续端口。例如，对于默认端口 15200，节点 0 使用 15200 至 15205，节点 1 使用 15220 至 15225，依此类推。

  磁盘空间必须足够；请参见 Sun Java System Application Server 发行说明。

查看和修改配置属性

您可以分别使用 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，将不会发生滚动重新启动，但更改仅适用于从 Application Server 实例建立的新的 HADB 连接。

配置属性

下表列出了可以通过 hadbm set 修改并通过 hadbm get 检索的配置属性列表。

配置 JDBC 连接池

Application Server 使用 Java Database Connectivity (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... 部分作为 serverList 连接池属性（表 3–10 所示）的值。

创建连接池

下表汇总了 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 资源设置。