附录 B. HA 资源参数
本附录提供 HA 资源参数的描述。您可以使用 luci 配置这些参数,方法是使用
ccs
命令,或者编辑 /etc/cluster/cluster.conf
文件。表 B.1 “HA 资源小结” 列出了这些资源、其对应的资源代理以及其他包含参数描述表格的参考。有关资源代理详情请查看任意集群节点中的 /usr/share/cluster
文件。
除在这个附录中描述的资源代理外,
/usr/share/cluster
目录还包括资源组的仿制 OCF 脚本 service.sh
。有关包含在这个脚本中的参数详情请参考 service.sh
脚本。
有关
cluster.conf
元素和属性的完整列表及描述,请参考 /usr/share/cluster/cluster.rng
中的集群方案,以及 /usr/share/doc/cman-X.Y.ZZ/cluster_conf.html
中的注释方案(例如:/usr/share/doc/cman-3.0.12/cluster_conf.html
)。
资源 | 资源代理 | 参数描述参考 |
---|---|---|
Apache | apache.sh | 表 B.2 “Apache 服务器” |
Condor 事务 | condor.sh | 表 B.3 “Condor 事务” |
文件系统 | fs.sh | 表 B.4 “文件系统” |
GFS2 文件系统 | clusterfs.sh | 表 B.5 “GFS2” |
IP 地址 | ip.sh | 表 B.6 “IP 地址” |
HA LVM | lvm.sh | 表 B.7 “HA LVM” |
MySQL | mysql.sh | 表 B.8 “MySQL” |
NFS 客户端 | nfsclient.sh | 表 B.9 “NFS 客户端” |
NFS 导出 | nfsexport.sh | 表 B.10 “NFS 导出” |
NFS 服务器 | nfsserver.sh | 表 B.11 “NFS 服务器” |
NFS/CIFS 挂载 | netfs.sh | 表 B.12 “NFS/CIFS 挂载” |
Open LDAP | openldap.sh | 表 B.13 “Open LDAP” |
Oracle 10g/11g 故障切换事务 | oracledb.sh | 表 B.14 “Oracle 10g/11G 故障切换事务” |
Oracle 10g 故障切换事务 | orainstance.sh | 表 B.15 “Oracle 10g 故障切换事务” |
Oracle 10g 侦听程序 | oralistener.sh | 表 B.16 “Oracle 10g 侦听程序” |
PostgreSQL 8 | postgres-8.sh | 表 B.17 “PostgreSQL 8” |
SAP 数据库 | SAPDatabase | 表 B.18 “SAP 数据库” |
SAP 事务 | SAPInstance | 表 B.19 “SAP 事务” |
Samba | samba.sh | 表 B.20 “Samba 服务器” |
脚本 | script.sh | 表 B.21 “脚本” |
Sybase ASE | ASEHAagent.sh | 表 B.22 “Sybase ASE 故障切换事务” |
Tomcat 6 | tomcat-6.sh | 表 B.23 “Tomcat 6” |
虚拟机 | vm.sh | 表 B.24 “虚拟机”
注:如果主机集群可支持虚拟机,则 Luci 会将其显示为虚拟服务。
|
luci 字段 | cluster.conf 属性 | 描述 |
---|---|---|
名称 | name | Apache 服务名称 |
服务器 Root | server_root | 默认值为 /etc/httpd 。 |
配置文件 | config_file | 指定 Apache 配置文件。默认值为 /etc/httpd/conf 。 |
httpd 选项 | httpd_options | httpd 的其他命令行选项。 |
关闭等待(秒为单位) | shutdown_wait | 指定等待正确关闭服务的秒数。 |
字段 | luci 字段 | cluster.conf 属性 |
---|---|---|
事务名称 | name | 指定 Condor 事务唯一名称。 |
Confor 子系统类型 | type | 为这个事务指定 Condor 子系统类型:schedd 、job_server 或者 query_server 。 |
luci 字段 | cluster.conf 属性 | 描述 |
---|---|---|
名称 | name | 指定文件系统资源名称。 |
文件系统类型 | fstype | 如果没有指定,mount 会尝试确定文件系统类型。 |
挂载点 | mountpoint | 挂载这个文件系统的文件系统结构路径。 |
设备、文件系统标签或者 UUID | device | 指定与这个文件系统资源关联的设备。可以是块设备、文件系统标签或者文件系统的 UUID。 |
挂载选项 | options | 挂载选项,即在挂载文件系统时使用的选项。这要根据具体文件系统决定。支持的挂载选项请查看 mount (8) man page。 |
文件系统 ID(自选) | fsid | 注意 File System ID 只可由 NFS 服务使用
当创建新的文件系统资源时,您可以让此字段保持空白。保持空白后会在配置过程中提交参数后自动分配 file system ID。如果您要具体指定 file system ID,请在此字段中指定。
|
强制卸载 | force_unmount | 如果启用该功能,则会强制卸载文件系统。默认设置为 disabled 。Force Unmount 会杀死使用该挂载点的所有进程以便在其尝试卸载时释放挂载点。 |
强制 fsck | force_fsck | 如果启用该选项,则会在挂载前在文件系统中运行 fsck 。默认设置为 disabled 。 |
启用 NFS 守护进程以及 lockd 临时规避方法(红帽企业版 Linux 6.4 以及之后的版本) | nfsrestart | 如果使用 NFS 导出您的文件系统,并偶尔无法卸载(在关机或者服务重新定位的过程中),设定这个选项将在执行卸载操作前取消所有文件系统参考。设定这个选项需要您启用 NFS 服务器 资源一同使用。您应只将这个选项设定为最后的手段,因为这是卸载文件系统的强制手段。 | 选项,并一定不能与
使用快速状态查看 | quick_status | 启用后,请执行快速状态查看。 |
卸载失败时请重启主机节点 | self_fence | 如果已启用,则在卸载这个文件系统失败时重启该节点。filesystem 资源代理使用值 1、yes 、on 或者 true 启用这个参数;使用 0、no 、off 或者 false 禁用这个参数。默认设置为 disabled 。 |
luci 字段 | cluster.conf 属性 | 描述 |
---|---|---|
名称 | name | 文件系统资源名称 |
挂载点 | mountpoint | 挂载文件系统资源的路径。 |
设备、文件系统标签或者 UUID | device | 与文件系统资源关联的设备文件。 |
文件系统类型 | fstype | 在 luci 中设定 GFS2 |
挂载选项 | options | 挂载选项 |
文件系统 ID(自选) | fsid | 注意 File System ID 只可由 NFS 服务使用
当创建新的 GFS2 资源时,您可以让此字段保持空白。保持空白后会在配置过程中提交参数后自动分配 file system ID。如果您要具体指定 file system ID,请在此字段中指定。
|
强制卸载 | force_unmount | 如果启用该选项,则会强制卸载文件系统。默认设置为 disabled 。Force Unmount 会杀死使用该挂载点的所有进程以便在其尝试卸载时释放挂载点。使用 GFS2 资源时,服务停止时不卸载挂载点除非 Force Unmount 是 enabled。 |
启用 NFS 守护进程以及 lockd 临时规避方法(红帽企业版 Linux 6.4 以及之后的版本) | nfsrestart | 如果使用 NFS 导出您的文件系统,并偶尔无法卸载(在关机或者服务重新定位的过程中),设定这个选项将在执行卸载操作前取消所有文件系统参考。设定这个选项需要您启用 NFS 服务器 资源一同使用。您应只将这个选项设定为最后的手段,因为这是卸载文件系统的强制手段。 | 选项,并一定不能与
卸载失败时请重启主机节点 | self_fence | 如果已启用,且在卸载这个文件系统时失败,则该节点将立即重启。一般它与 force-unmount一同使用,但不是必须的。filesystem 资源代理使用值 1、yes 、on 或者 true 启用这个参数;使用 0、no 、off 或者 false 禁用这个参数。 |
luci 字段 | cluster.conf 属性 | 描述 |
---|---|---|
IP 地址,子网掩码字节 | address | 该资源的 IP 地址(和自选子网页面字节)。根据 CIDR 表示法,子网页面字节或者网络前缀长度可紧跟该地址,并使用斜线作为分隔符(例如:10.1.1.1/8)。这是一个虚拟 IP 地址。支持 IPv4 和 IPv6 地址,因为 NIC 链接监控每个 IP 地址。 |
监控链接 | monitor_link | 如果没有这个 IP 地址绑定的 NIC 的链接,启用此选项将导致状态检查失败。 |
禁用静态路由更新 | disable_rdisc | 禁止使用 RDISC 协议更新路由。 |
删除 IP 地址多少秒后进入睡眠状态 | sleeptime | 指定睡眠状态时间(单位为秒)。 |
luci 字段 | cluster.conf 属性 | 描述 |
---|---|---|
名称 | name | 这个 LVM 资源的唯一名称。 |
卷组名称 | vg_name | 被管理卷组的说明性名称。 |
逻辑卷名称(可选) | lv_name | 被管理的逻辑卷名称。如果该卷组中被管理的逻辑卷在一个以上,则这个参数是可选的。 |
如无法清除 LVM 标签则 fence 该节点 | self_fence | 如果无法清除 LVM 标签则需要 fence 该节点。LVM 资源代理使用 1 或者 yes 启用此参数,使用 0 或者 no 禁用它。 |
luci 字段 | cluster.conf 属性 | 描述 |
---|---|---|
名称 | name | 指定 MySQL 服务器资源名称。 |
配置文件 | config_file | 指定配置文件。默认值为 /etc/my.cnf 。 |
侦听地址 | listen_address | 指定 MySQL 服务器的 IP 地址。如果没有提供 IP 地址,则会为该设备使用第一个 IP 地址。 |
mysqld 选项 | mysqld_options | httpd 的其他命令行选项。 |
启动等待(秒为单位) | startup_wait | 指定等待正确终止服务启动的秒数。 |
关闭等待(秒为单位) | shutdown_wait | 指定等待正确关闭服务的秒数。 |
luci 字段 | cluster.conf 属性 | 描述 |
---|---|---|
名称 | name | 这是客户端用来在资源树中进行参考的符号名。这与 Target 选项不一样。 |
目标主机名、通配符或网络组群 | target | 这是您要执行挂载的服务器。可使用主机名、通配符(基于 IP 地址或者主机名)或者定义主机,或者导出主机的网络组群定义该服务器。 |
允许恢复这个 NFS 客户端 | allow_recover | 允许恢复。 |
选项 | options | 为这个客户端定义一组选项 — 例如:额外客户端访问权力。有关详情请参考 exports (5) man page,《常规选项》。 |
luci 字段 | cluster.conf 属性 | 描述 |
---|---|---|
名称 | name |
资源的说明性名称。NFS 导出资源确定 NFS 守护进程正在运行。它可重复使用,通常只需要 NFS 导出资源。
注意
为 NFS 导出命名以便区别于其他 NFS 资源。
|
luci 字段 | cluster.conf 属性 | 描述 |
---|---|---|
名称 | name |
NFS 服务器资源的描述性名称。NFS 服务器资源对将 NFSv4 文件系统导出到客户端非常有帮助。因为 NFSv4 方法起作用,所以每次在一个服务器中只能有一个 NFSv4 资源。另外,不可能在每个集群节点中同时还使用本地 NFS 事务时使用该 NFS 服务器资源。
|
luci 字段 | cluster.conf 属性 | 描述 |
---|---|---|
名称 | name |
NFS 或者 CIFS 挂载的符号名。
注意
只有将集群服务配置为 NFS 客户端时才需要这个资源。
|
挂载点 | mountpoint | 挂载文件系统资源的路径。 |
主机 | host | NFS/CIFS 服务器 IP 地址或者主机名。 |
NFS 导出目录名或者 CIFS 共享 | export | NFS 导出目录名或者 CIFS 共享名称。 |
文件系统类型 | fstype |
文件系统类型:
|
强制卸载 | force_unmount | 如果启用 Force Unmount ,则集群会在服务停止时杀死所有使用该文件系统的进程。杀死所有使用该文件系统的进程可释放文件系统。另外,如果卸载失败则会重启该服务。 |
停止重新定位操作的过程中不卸载该文件系统。 | no_unmount | 如果启用,可指定在停止或者重新定位操作中不能卸载的文件系统。 |
选项 | options | 挂载选项。指定挂载选项列表。如果没有指定,则会使用 -o sync 挂载文件系统。 |
luci 字段 | cluster.conf 属性 | 描述 |
---|---|---|
名称 | name | 指定文件系统名称用于日志记录或者其它目的。 |
配置文件 | config_file | 指定配置文件的绝对路径。默认值为 /etc/openldap/slapd.conf 。 |
URL 列表 | url_list | 默认值为 ldap:/// 。 |
slapd Options | slapd_options | slapd 的其它命令行选项。 |
关闭等待(秒为单位) | shutdown_wait | 指定等待正确关闭服务的秒数。 |
luci 字段 | cluster.conf 属性 | 描述 |
---|---|---|
Oracle 事务的事务名称(SID) | name | 事务名称。 |
Oracle 用户名 | user | 这是在 Oracle AS 事务中运行的 Oracle 用户的用户名。 |
Oracle 应用程序主目录 | home | 这是 Oracle(应用程序,不是用户)主目录。您安装 Oracle 后就会配置这个目录。 |
Oracle 安装类型 | type | Oracle 安装类型。默认:10g ,只有数据库事务以侦听程序 base ,数据库、侦听程序、企业版管理器以及 ISQL*PLUS:base-em (或者 10g ),或者互联网应用程序服务器(基础设施):ias (或者 10g-ias )。 |
虚拟主机名(可选) | vhost | 与 Oracle 10g 安装主机名匹配的虚拟主机名。注:在启动/停止某个 oracledb 资源的过程中,您的主机名可能会临时更改为这个主机名。因此,您应该只将 oracledb 资源配置为专有服务的一部分。 |
luci 字段 | cluster.conf 属性 | 描述 |
---|---|---|
Oracle 事务的事务名称(SID) | name | 事务名称。 |
Oracle 用户名 | user | 这是在作为 Oracle 事务运行的 Oracle 用户的用户名。 |
Oracle 应用程序主目录 | home | 这是 Oracle(应用程序,不是用户)主目录。您安装 Oracle 后就会配置这个目录。 |
Oracle 侦听程序列表(可选,使用空格分开) | listeners | 可使用数据库事务启动的 Oracle 侦听程序列表。侦听程序名称使用空格分开。默认为空白,即禁用侦听程序。 |
锁定文件路径(可选) | lockfile | 用来检查 Oracle 是否应该运行的锁定文件位置。默认为 /tmp 目录中的某个位置。 |
luci 字段 | cluster.conf 属性 | 描述 |
---|---|---|
侦听程序名称 | name | 侦听程序名称。 |
Oracle 用户名 | user | 这是在作为 Oracle 事务运行的 Oracle 用户的用户名。 |
Oracle 应用程序主目录 | home | 这是 Oracle(应用程序,不是用户)主目录。您安装 Oracle 后就会配置这个目录。 |
luci 字段 | cluster.conf 属性 | 描述 |
---|---|---|
名称 | name | 指定文件系统名称用于日志记录或者其它目的。 |
配置文件 | config_file | 定义配置文件的绝对路径。默认值为 /var/lib/pgsql/data/postgresql.conf 。 |
Postmaster 用户 | postmaster_user | 在 root 无法运行该数据库服务器时运行该服务器的用户。默认值为 postgres。 |
Postmaster 选项 | postmaster_options | Postmaser 的其他命令行选项。 |
关闭等待(秒为单位) | shutdown_wait | 指定等待正确关闭服务的秒数。 |
luci 字段 | cluster.conf 属性 | 描述 |
---|---|---|
SAP 数据库名称 | SID | 指定唯一 SAP 系统识别符。例如:P01。 |
SAP 可执行目录 | DIR_EXECUTABLE | 为 sapstartsrv 和 sapcontrol 指定完全限定路径。 |
数据库类型 | DBTYPE | 指定以下数据库类型之一:Oracle、DB6 或者 ADA。 |
Oracle 侦听程序名称 | NETSERVICENAME | 指定 Oracle TNS 侦听程序名称。 |
ABAP 栈尚未安装,只安装了 Java 栈。 | DBJ2EE_ONLY | 如果您没有在 SAP 数据库中安装 ABAP 栈,则启用这个参数。 |
应用程序等级监控 | STRICT_MONITORING | 激活应用程序等级监控 |
自动启动恢复 | AUTOMATIC_RECOVER | 启用或禁用自动启动恢复。 |
Java SDK 路径 | JAVE_HOME | Java SDK 路径。 |
JDBC 驱动程序文件名 | DB_JARS | JDBC 驱动程序文件名。 |
预启动脚本路径 | PRE_START_USEREXIT | 预启动脚本路径。 |
后启动脚本路径 | POST_START_USEREXIT | 后启动脚本路径。 |
预停止脚本路径 | PRE_STOP_USEREXIT | 预停止脚本路径 |
后停止脚本路径 | POST_STOP_USEREXIT | 后停止脚本路径 |
J2EE 事务启动目录 | DIR_BOOTSTRAP | J2EE 事务引导程序目录的完全限定路径。例如:/usr/sap/P01/J00/j2ee/cluster/bootstrap 。 |
J2EE 安全存储路径 | DIR_SECSTORE | J2EE 安全存储目录的完全限定路径。例如:/usr/sap/P01/SYS/global/security/lib/tools 。 |
luci 字段 | cluster.conf 属性 | 描述 |
---|---|---|
SAP 事务名称 | InstanceName | 完全限定的 SAP 事务名称。例如:P01_DVEBMGS00_sapp01ci。 |
SAP 可执行目录 | DIR_EXECUTABLE | sapstartsrv 和 sapcontrol 的完全限定路径。 |
包含 SAP 启动侧写的目录 | DIR_PROFILE | SAP 启动侧写的完全限定路径。 |
SAP 启动侧写名称 | START_PROFILE | SAP 启动侧写的指定名称。 |
指定检查启动状态前等待的秒数 | START_WAITTIME | 指定检查启动状态前等待的秒数(不等待 J2EE-Addin)。 |
启用自动启动恢复 | AUTOMATIC_RECOVER | 启用或禁用自动启动恢复。 |
预启动脚本路径 | PRE_START_USEREXIT | 预启动脚本路径。 |
后启动脚本路径 | POST_START_USEREXIT | 后启动脚本路径。 |
预停止脚本路径 | PRE_STOP_USEREXIT | 预停止脚本路径 |
后停止脚本路径 | POST_STOP_USEREXIT | 后停止脚本路径 |
注意
根据 表 B.20 “Samba 服务器”,当创建或者编辑集群服务时,直接将 Samba 服务资源而不是服务中的资源连接到该服务。
luci 字段 | cluster.conf 属性 | 描述 |
---|---|---|
名称 | name | 指定 Samba 服务器的名称。 |
配置文件 | config_file | Samba 配置文件路径 |
smbd 的其他命令行选项 | smbd_options | smbd 的其他命令行选项。 |
nmbd 的其他命令行选项 | nmbd_options | nmbd 的其他命令行选项。 |
关闭等待(秒为单位) | shutdown_wait | 指定等待正确终止服务关闭的秒数。 |
luci 字段 | cluster.conf 属性 | 描述 |
---|---|---|
名称 | name | 指定自定义用户脚本的名称。该脚本资源允许使用符合 LSB 标准的 init 脚本启动集群的服务。 |
脚本文件的完整路径 | file | 输入自定义脚本所在路径(例如:/etc/init.d/userscript )。 |
luci 字段 | cluster.conf 属性 | 描述 |
---|---|---|
事务名称 | name | 指定 Sybase ASE 资源的事务名称。 |
ASE 服务器名称 | server_name | 为 HA 服务配置的 ASE 服务器名称。 |
Sybase 主目录 | sybase_home | Sybase 产品的主目录。 |
登录文件 | login_file | 包含登录密码对的登录文件全路径。 |
接口文件 | interfaces_file | 用来启动/访问 ASE 服务器的接口文件全路径。 |
SYBASE_ASE 目录名 | sybase_ase | sybase_home 中安装 ASE 产品的目录名。 |
SYBASE_OCS 目录名 | sybase_ocs | sybase_home 中安装 OCS 产品的目录名。例如:ASE-15_0。 |
Sybase 用户 | sybase_user | 可运行 ASE 服务器的用户。 |
关闭等待(秒为单位) | start_timeout | 启动超时值。 |
关机等待(秒为单位) | shutdown_timeout | 关机超时值。 |
深度探测超时 | deep_probe_timeout | 在运行深度探测时,确定服务器没有响应前等待 ASE 服务器响应的最长秒数。 |
luci 字段 | cluster.conf 属性 | 描述 |
---|---|---|
名称 | name | 指定文件系统名称用于日志记录或者其它目的。 |
配置文件 | config_file | 指定配置文件的绝对路径。默认值为 /etc/tomcat6/tomcat6.conf 。 |
关闭等待(秒为单位) | shutdown_wait | 指定正常结束关闭服务的要等待的秒数。默认值为 30。 |
重要
根据 表 B.24 “虚拟机”,当使用虚拟机资源配置集群时,应该使用
rgmanager
启动和停止虚拟机。使用 virsh
启动虚拟机可导致虚拟机在一个以上的位置中运行,从而造成虚拟机中的数据崩溃。有关配置您的系统,以减少管理员意外使用集群和非集群工具,“重复启动”虚拟机的几率的详情请参考 第 2.14 节 “在集群的环境中配置虚拟机”。
注意
虚拟机资源与其他集群资源配置不同。要使用 luci 配置虚拟机资源,请在集群中添加服务组,然后在该服务中添加资源,选择
虚拟机
作为资源类型,并输入虚拟机资源参数。有关使用 ccs
配置虚拟机的详情请参考 第 5.12 节 “虚拟机资源”。
luci 字段 | cluster.conf 属性 | 描述 |
---|---|---|
服务名称 | name | 指定虚拟机名称。当使用 luci 界面时,您可以将其指定为服务名。 |
自动启动这个服务 | autostart | 如果启用,则这台虚拟机会在集群达到定额数后自动启动。如果禁用这个参数,则这台虚拟机就不会在集群达到定额数后自动启动。虚拟机处于 disabled 状态。 |
独家运行 | exclusive | 如果启用,这台虚拟机则只能重新定位独占另一个节点运行,即在没有其它虚拟机运行的节点中运行。如果没有可用的虚拟机供其独占运行,则虚拟机在失败后就无法重启。另外,由于使用 Run exclusive ,其它虚拟机也无法重新定位到运行这台虚拟机的节点。您可以使用手动启动或者重新定位操作覆盖这个选项。 |
故障切换域 | domain | 定义在虚拟机失败事件中可尝试的集群成员列表。 |
恢复策略 | recovery | Recovery policy 提供以下选项:
|
重启选项 | max_restarts , restart_expire_time | 如果您选择 | 或者 作为该服务的恢复策略,您可以指定在重新定位或者禁用该服务前最多重启失败的次数,并指定多少秒后不再重启。
迁移类型 | migrate | 指定迁移类型 live 或者 pause ,默认设置为 live 。 |
迁移映射 | migration_mapping |
为迁移指定可替换接口。例如:您可以在当某个节点用于虚拟机迁移的网络地址与该节点用来进行集群通信的地址不同时指定可替换接口。
指定以下说明当您将虚拟机从
member 迁移到 member2 时,您实际上是迁移到 target2 。同样,当您从 member2 迁移到 member 时,您使用 target 迁移。
member:target,member2:target2
|
状态程序 | status_program |
除对出现的虚拟机进行常规检查外要运行的状态程序。如果指定,则每分钟执行一次状态程序。这可让您了解虚拟机中关键服务的状态。例如:如果某台虚拟机运行网页服务器,您的状态程序可查看该网页服务器是否启动并运行。如果该状态检查失败(返回一个非零值),就是覆盖了该虚拟机。
启动虚拟机后,该虚拟机资源代理会周期性调用该状态程序,并期待得到一个成功返回代码(0)。5 分钟后超时。
|
用来生成虚拟机的 xmlfile 路径 | xmlfile | 到 libvirt XML 文件的完整路径包含 libvirt 域定义。 |
虚拟机配置文件路径 | path |
一组用冒号分隔的路径,虚拟机资源代理(
vm.sh )用它搜索虚拟机配置文件。例如:/mnt/guests/config:/etc/libvirt/qemu 。
重要
该路径应该永远不直接指向某个虚拟机配置文件。
|
虚拟机快照目录路径 | snapshot | 到保存虚拟机映像的快照目录的路径。 |
Hypervisor URI | hypervisor_uri | Hypervisor URI(通常为自动)。 |
迁移 URI | migration_uri | 迁移 URI(通常为自动)。 |
在迁移过程中使用 ssh 传递数据 | tunnelled | 在迁移过程中使用 ssh 传递数据。 |