第五章 Linux服务资源说明

EterneCluster在Linux下提供了常用的服务资源，如apache，mysql，oracle，db2等配置，只需使用界面简单的配置几个选项即可把相关资源管理起来。下面简单的以apache为例介绍一下具体配置过程：

添加服务资源时，服务名称选项选择apache,可看到有两个选择框“只显示必须的参数”，“显示高级参数”。

反选“只显示必须的参数”即可看到关于apache服务的一些常用参数，选择“显示高级参数”可查看高级参数。一般情况下只需更改常用参数。

我们关心的为当前配置是否和EterneCluster的默认参数是否一致即可，如不一致，需要改变其值，如configfile配置项目的默认值为“/etc/apache2/httpd.conf”，而正确的路径应该为“/etc/httpd/conf/httpd.conf”，因此就点选红框3所在的值空白框，把“/etc/httpd/conf/httpd.conf”写入即可。

点击确定按钮就可把configfile配置改变为正确的配置。

其他的服务配置和apache一样，查找当前配置，如和默认的参数不一致，更改即可。

如果在实施中遇到没有的服务，如果该服务是有一个在/etc/init.d/目录下的启动停止脚本的话，你可以采用简单的方法将其转化为一个服务，当然也可以采用将该脚本嵌入anything服务里面的方式来加入集群管理。

（一）、anything 的说明及配置

用途及描述

管理任意服务，为一通用服务以便管理几乎所有的服务。

支持的参数

binfile

执行文件的完整名称（包含路径）。此程序应该为持续运行的并且运行期间保持一样的PID，而不是执行一些操作后就直接退出的程序。

注：此参数为必须填写的参数，没有默认值。

cmdline_options

传递给执行程序的命令行选项

注：可选参数，没有默认值

pidfile

用以读取/写入PID的文件。

注：可选参数，默认值为“/var/run/anything_default.pid”

logfile

日志文件，写入STDOUT

注：可选参数，没有默认值

errlogfile

日志文件，写入STDERR

注：可选参数，没有默认值

user

运行命令的用户角色

注：可选参数，默认值为“root”

monitor_hook

用来运行监控操作的命令

注：可选参数，没有默认值。

stop_timeout

在停止操作中，在发送kill -SIGKILL命令前，成功发送kill -TERM的等待时间。

注：可选参数，默认值10秒。

（二）、Apache的说明及配置

用途及描述

管理Apache网络服务器实例，可操作Version1.X和Version2.X的Apache服务器。”apache服务资源”可启动Apache服务，并且可以持续的监测服务并且监测其是否运转正常。因此如果在开始操作超时范围内监测操作没有成功启动，”apache服务资源”就会报告错误状态。

默认的监测操作为加载服务器的状态页面。请确保服务器的状态页面工作正常，并且其访问权限只允许从lcalhost（地址：127.0.0.1）访问。更多请参见statusurl和testregex参数属性。

支持的参数

configfile

Apache配置文件的完整路径。

注：可选参数，默认值为‘/etc/apache2/httpd.conf’

httpd

httpd程序完整路径

注：可选参数，默认值为‘/usr/sbin/httpd’

port

监测statusurl状态信息所使用的端口号。它默认为配置文件里的端口号，如果配置文件里没有定义，则为80

注：可选参数，没有默认值

statusurl

要监测的URL地址，默认为Apache服务器的状态页。如果没有指定，则其值为Apache配置文件里的值。

如果设定了这个值，那么请您确保此链接地址访问权限只能从localhost(127.0.0.1)访问。

注：可选参数，没有默认值

testregex

匹配statusurl页面的正则表达式，大小写敏感。

注：可选参数，默认值为‘</ *body *>[[:space:]]*</ *html *>’

client

查询Apache的客户端，如果没有指定，服务资源就会试图在系统上查找一个。目前支持wget和curl。

注：可选参数，没有默认值

testurl

要测试的URL地址。

testregex20

匹配statusurl页面的正则表达式，大小写敏感。

注：可选参数，没有默认值

testconffile

包含测试配置的文件。如果你必须监测不止一个的网络应用或者要传入大小写敏感的参数（如passwords）时，这个参数就会很有用。此外，使用配置文件是指定某些参数的唯一途径。

注：可选参数，没有默认值

testname

配置文件里的测试名称

注：可选参数，没有默认值

options

当启动Apache服务时额外的参数。请参见 man httpd(8)

注：可选参数，没有默认值

evnfiles

包含额外环境变量的文件。

注：可选参数，默认值为”/etc/apache2/envvars”

（三）、DB2的说明及配置

用途及描述

配置DB2服务

支持的参数

Instance

数据库的实例。

注：必填参数，没有默认值

Admin

该实例的admin用户。

注：可选参数，没有默认值

（四）、Filesystem的说明及配置

用途及描述

文件系统的资源脚本。它管理共享储存媒体上的文件系统。

标准的检测操作为深度0（也称为探测），检查文件系统是否被mount了。如果你想做深入测试，设置 ET_CHECH_LEVEL为下面的值：

10 : 读设备的最开始的16个blocks（raw read）。没有block设备的文件系统如NFS，SMBFS或bind mouts，这个操作结果为等待。

20 : 测试状态文件能否写和读。这个状态文件权限必须为root用户可写。这就不适用于NFS mount，NFS输出通常有“root_squash”选项的设置。在这种配置情况下，你必须要使用它和只读监控（深度=10）两个中的一个，并且输出"no_root_squash"项目在你的NFS服务器上，或者担保状态文件所在的目录的写权限。

支持的参数

device

文件系统块设备的名称、装入的 -U、-L 选项或 NFS 装入规范。

注：必选参数，无默认值为

directory

文件系统的mount点

注：必选参数，无默认值

fstype

要装入的文件系统的可选类型

注：必选参数，无默认值

options

要以 -o 选项给出的任何其他待装入选项。对于绑定装入，在这里添加“bind”，

将 fstype 设置为“none”。能正确处理“bind,ro”之类的选项。

注：可选参数，无默认值

statusfile_prefix

资源监视（深度20）时状态文件用的前缀。如果你不指定这个参数，所有的状态文件就会在一个单独的目录里被创建。

注：可选参数，默认值为‘.Filesystem_status/’

（五）、ids的说明及配置

用途及描述

OCF 资源代理用于将 IBM Informix Dynamic Server (IDS) 实例作为高可用性资源

管理。

支持的参数

informixdir

IDS 的典型安装完成后环境变量 INFORMIXDIR 所具有的值。换句话说，就

是安装 IDS 的路径（结尾无 /）。如果该参数未指定，脚本将尝试从壳层环

境获取该值。

注：可选参数，无默认值为

informixserver

IDS 的典型安装完成后环境变量 INFORMIXSERVER 所具有的值。换句话

说，就是要管理的 IDS 服务器实例的名称。如果该参数未指定，脚本将尝

试从壳层环境获取该值。

注：可选参数，无默认值

onconfig

IDS 的典型安装完成后环境变量 ONCONFIG 所具有的值。换句话说，就是

INFORMIXSERVER 中为 IDS 实例指定的配置文件的名称。将在 /etc/ 搜索

指定的配置文件。如果该参数未指定，脚本将尝试从壳层环境获取该值。

注：可选参数，无默认值

dbname

该参数定义用于监视 IDS 实例的数据库。如果该参数未指定，脚本将默认

使用“sysmaster”数据库。

注：可选参数，默认值为’sysmaster’

sqltestquery

在参数“dbname”指定的数据库上运行的 SQL 测试查询，用于监视 IDS 实例，

并判断其功能是否正常。如果该参数未指定，脚本将默认使用“SELECT

COUNT(*) FROM systables;”。

注：可选参数，默认值为‘SELECT COUNT(*) FROM systables;’

（六）、LVM的说明及配置

用途及描述

LVM 的资源服务。它将服务资源作为 Linux Volume Manager 卷 (LVM) 管理。

支持的参数

volgrpname

卷组名。

注：可选参数，无默认值为

exclusive

如果设置，卷组就不激活。

注：可选参数，无默认值

（七）、mysql的说明及配置

用途及描述

管理MySQL数据库实例。

支持的参数

binary

MySQL程序的完整路径

注：可选参数，默认值为‘/usr/bin/mysqld_safe’

config

配置文件的完整路径

注：可选参数，默认值为‘/etc/my.cnf’

datadir

数据库文件所在的目录

注：可选参数，默认值为‘/var/lib/mysql’

user

运行MySQL的用户名

注：可选参数，默认值为‘mysql’

group

运行MySQL的组名

注：可选参数，默认值为‘mysql’

log

mysqld的日志文件

注：可选参数，默认值为‘/var/log/mysqld.log’

pid

MySQL的pid文件

注：可选参数，默认值为‘/var/run/mysql/mysqld.pid’

socket

MySQL的socket文件

注：可选参数，默认值为‘/var/run/mysql/mysqld.sock’

test_table

用于监测状态的测试表

注：可选参数，默认值为‘mysql.user’

test_user

MySQL的测试用户

注：可选参数，默认值为‘root’

test_passwd

MySQL测试用户的密码

注：可选参数，无默认值

enable_creation

如果MySQL数据库不存在，是否创建

注：可选参数，默认值为0

additional_parameters

启动mysqld的额外参数，例如: --skip-external-locking or --skip-grant-tables

注：可选参数，无默认值

（八）、nfsserver的说明及配置

用途及描述

Nfsserver 有助于将 Linux nfs 服务器作为 Linux-HA 中可故障转移的资源进行管理。

支持的参数

nfs_init_script

随 Linux distro 提供的默认 init 脚本。 nfsserver 资源代理将启动/停止/监视的工作转移到 init 脚本，因为启动/停止/监视 nfsserver 的步骤随 Linux distro 而异。

注：可选参数，默认值: /etc/init.d/nfsserver

nfs_notify_cmd

用于发送 NSM 重引导通知的工具。nfsserver 的故障转移可视为重引导到其他计算机。nfsserver 资源代理使用该命令通知所有客户端所发生的故障转移。

注：可选参数，默认值: /sbin/sm-notify/sbin/sm-notify

nfs_shared_infodir

nfsserver 资源代理将在这一特定目录中保存 nfs 的相关信息。该目录必须能

够在 nfsserver 本身故障转移前实现故障转移。

注：必选参数，无默认值

nfs_ip

用于访问 nfs 服务的浮动 IP 地址。

注：必选参数，无默认值

注意：NFS配置要求/etc/exports文件填写正确，同时要提供共享存储，详细配置请参考网站的配置手册。

（九）、nginx的说明及配置

用途及描述

nginx是流行的http服务器端软件。该资源agent可以用于管理nginx，由于nginx的配置可以很简单也可以很复杂，这个agent也被设计得尽可能支持各种配置。

支持的参数

configfile

配置文件，如果不指定，agent会利用ngnixd来查询其配置文件位置。

httpd

httpd可执行程序,缺省为/usr/sbin/httpd

port

httpd网络端口,缺省80

status_url

测试URL，用于检查httpd是否在线

status_regex

测试正则表达式，用于匹配上面测试URL的结果

testclient

测试客户端,可以是wget或者curl,缺省为curl

testurl

深入测试URL

testregex

深入测试正则表达式

testconffile

深入测试配置文件，详细情况请参考README.webapp文档

external_cmd

外部测试命令行，主要是用于深入检查。

options

nginx启动选项

（十）、oracle的说明及配置

用途及描述

管理ORACLE数据库实例。

支持的参数

sid

ORACLE的SID(ORACLE_SID)

注：必指定参数，无默认值

home

ORACLE的home目录（ORACLE_HOME），如果不指定，则 SID 及其用户主目录应列在 /etc/oratab 中

注：可选参数，无默认值

user

ORACLE的用户，如果没有指定，则它使用ORACLE_HOME/dbs/*${ORACLE_SID}.ora文件的拥有者的用户。建议明确的指定user.

注：可选参数，无默认值

ipcrm

有时属于 Oracle 实例的 IPC 对象（共享的内存段和信号）可能会留到后面，导致实例无法启动。很难判断哪些共享段属于哪个实例，特别是很多实例以同一用户身份运行时。

这里我们用的方式为"oradebug"的特性和它的"ipc" 跟踪实用工具。一旦trace报告的格式或者措辞改变，分析就可能出错。但是，也有些预防措施可以避免误操作。还有一个 dumpinstipc 选项可用于打印属于该实例的IPC 对象。用它查看对跟踪文件的分析是否正确。

有三个设置可用：

- none：不干预IPC，希望最佳情况出现（注意：可能迟早会失败）

- instance：试图找出属于该实例的 IPC 材料并删除（默认；应该是安全的）

- orauser：删除运行该实例的用户拥有的所有 IPC（如果您以一个用户身份运行多个实例，或者有其他以该用户身份运行的应用程序使用 IPC，则不使用该选项）

默认设置“instance”应该是安全的，但在那种情况下不能确保实例会启动。若 IPC 对象已经被丢下（例如由于某人无情地终止了 Oracle 进程），则无法找出应删除的 IPC 对象。在那种情况下，人工干预是必需的，可能需要终止以同一用户运行的所有实例。第三个设置 orauser 确保 IPC 对象可删除，但它执行删除完全是基于 IPC 对象的所有权，因此只能在每个实例都以独立用户运行时使用。请报告出现的任何问题。

clear_backupmode

ORACLE的清除备份模式

注：可选参数，默认值: "false"

shutdown_method

如何停掉Oracle默认的方式"checkpoint/abort"为：

alter system checkpoint;

shutdown abort;

这应该是一个最快的并且安全的方式使得实例关掉。如果你觉得"shutdown abort"不适合你，你可以设置这一项为"immediate"：

我们会进行如下操作：

shutdown immediate;

注：可选参数，默认值: "checkpoint/abort"

（十一）、oralsnr的说明及配置

用途及描述

Oracle Listener 的资源脚本。它将 Oracle Listener 实例作为 HA 资源管理。

支持的参数

sid

ORACLE的SID(ORACLE_SID)

注：必指定参数，无默认值

home

ORACLE的home目录（ORACLE_HOME），如果不指定，则 SID 及其用户主目录应列在 /etc/oratab 中

注：可选参数，无默认值

user

以该用户身份运行该监听程序。

注：可选参数，无默认值

listener

要启动的监听程序实例（如同在 listener.ora 中定义的）。默认为 LISTENER。

注：可选参数，无默认值

（十二）、pgsql的说明及配置

用途及描述

PostgreSQL 的资源服务。它将 PostgreSQL 作为服务资源管理。

支持的参数

pgctl

pg_ctl 命令的路径

注：可选参数，默认值为’ /usr/bin/pg_ctl’

注意：此参数如果默认值和当前值不一样，则必须设置。比如pgsql-9.3版本此值为’/user/pgsql-9.3/bin/pg_ctl’

start_opt

启动选项（pgi_ctl 中的 -o start_opt）。例如 -i -p 5432

注：可选参数，无默认值

ctl_opt

附加的 pg_ctl 选项（-w，-W 等）。

注：可选参数，无默认值

psql

psql 命令的路径。

注：可选参数，默认值为’/usr/bin/psql’

pgdata

PostgreSQL 数据目录路径。

注：可选参数，默认值为’/var/lib/pgsql/data’

pgdba

拥有 PostgreSQL 的用户。

注：可选参数，默认值为’postgres’

pghost

PosrgeSQL 监听的主机名/IP 地址。

注：可选参数，无默认值

pgport

PosrgeSQL 监听的端口。

注：可选参数，默认值为’5432’

pgdb

将用于监视的数据库。

注：可选参数，默认值为’ template1’

logfile

PostgreSQL 服务器日志输出文件的路径。

注：可选参数，默认值为’/dev/null’

stop_escalate

采取 -m immediate 前允许重试(使用-m fast)的次数。

注：可选参数，默认值为30

（十三）、proftpd的说明及配置

用途及描述

proftpd的资源服务。

支持的参数

binary

proftpd 命令的路径

注：可选参数，默认值为’/usr/sbin/proftpd’

conffile

带完整路径的proftpd配置文件名。例如“/etc/proftpd.conf”

注：可选参数，默认值为’/etc/proftpd.conf’

pidfile

proftpd的PID文件。PID文件的位置在proftpd配置文件里定义。

注：可选参数，默认值为’/ var/run/proftpd.pid’

curl_binary

OCF_CHECK_LEVEL大于0时监控的curl程序的绝对路径。

注：可选参数，默认值为’/usr/bin/curl’

curl_url

OCF_CHECK_LEVEL大于0时监控的curl程序检查的URL。

注：可选参数，默认值为’ftp://localhost/’

test_user

OCF_CHECK_LEVEL大于0时监控的ftp用户的名称。

注：可选参数，默认值为’test’

curl_binary

OCF_CHECK_LEVEL大于0时监控的ftp用户的密码。

注：可选参数，无默认值

（十四）、Pure-FTPd的说明及配置

用途及描述

该脚本管理设置Pure-FTPd。

支持的参数

script

Pure-FTPd 启动脚本的完整路径。例如“/sbin/pure-confg.pl”

注：可选参数，默认值为’ /sbin/pure-confg.pl’

conffile

带完整路径的 Pure-FTPd 配置文件名。例如“/etc/pure-ftpd/pure-ftpd.conf”

注：可选参数，默认值为’ /etc/pure-ftpd/pure-ftpd.conf’

daemon_type

由 pure-ftpd 封装程序调用的 Pure-FTPd 守护程序。有效选项是：“”用于 pure-

ftpd，“mysql”用于 pure-ftpd-mysql，“postgresql”用于 pure-ftpd-postgresql，

“ldap”用于 pure-ftpd-ldap。

注：可选参数，无默认值

pidfile

PID 文件。

注：可选参数，默认值为’ /var/run/cluster/rsctmp/pure-ftpd-default.pid’

（十五）、rsyncd的说明及配置

用途及描述

该脚本管理 rsync 守护程序。

支持的参数

binpath

rsync 二进制文件路径。例如“/usr/bin/rsync”

注：可选参数，默认值为’ /sbin/pure-confg.pl’

conffile

带完整路径的 rsync 守护程序配置文件名。例如“/etc/rsyncd.conf”

注：可选参数，默认值为’/etc/rsyncd.conf’

bwlimit

该选项可用于指定最大传输速率，单位每秒千字节。该选项在将 rsync 用于

大文件（数兆字节以上）时最有效。由于 rsync 传输的性质，将发送数据

块，然后若 rsync 判断传输过快，将在发送下个数据块之前等待。结果使得

平均传输速率等于指定的上限。值为零表示没有限制。

注：可选参数，无默认值

（十六）、smb的说明及配置

用途及描述

该脚本管理 SAMBA服务器。

支持的参数

smb_init_script

默认的初始化脚本。

注：可选参数，默认值为’ /etc/init.d/smb’

（十七）、Squid的说明及配置

用途及描述

该脚本管理 Squid。

支持的参数

squid_exe

该参数指定 squid 的可执行文件

注：必须参数，无默认值

squid_conf

该参数为由该资源服务管理的squid实例指定配置文件

注：必须参数，无默认值

squid_pidfile

该参数为由该资源服务管理的squid实例指定进程 id 文件。

注：必须参数，无默认值

squid_port

该参数为由该资源服务管理的squid实例指定端口号。如果使用多个端口，只能指定其中之一。

注：必须参数，无默认值

squid_stop_timeout

此参数为可省略参数。在停止操作时，首先使用正常停止方法。随后等待该

参数指定的秒数后确认其完成。

注：可选参数，默认值为10

debug_mode

此参数为可选参数。该参数包含 x 或 v 时，该资源服务运行于调试模式。如果包

含 x，STDOUT 和 STDERR 都重定向到 debug_log 指定的日志文件，然后打

开 builtin 壳层选项 x。对 v 也是相似的。

注：可选参数，无默认值

debug_log

这是可选且可省略的参数。该参数指定调试日志的目标文件，仅适用于服务资源

运行于调试模式时。关于调试模式，请参见 debug_mode。如果未给出值但

值是必需的，将按以下规则确定：“/var/log/”为目录部分，配置文件的基本

名称为“syslog_ng_conf”，“.log”作为后缀。

注：可选参数，无默认值

（十八）、SybaseASE的说明及配置

用途及描述

该脚本管理 Sybase ASE。

支持的参数

sybase_home

该参数指定 sybase 的安装绝对路径，如/opt/sybase

注：必须参数，无默认值

sybase_ase

该参数指定ASE目录的名称，如ASE-15_0

注：必须参数，无默认值

sybase_ocs

该参数指定OCS目录的名称，如OCS-15_0

注：必须参数，无默认值

server_name

该参数为sybase服务的名称，如SYBASE

注：必须参数，无默认值

login_file

此参数为登录文件的绝对路径，此文件需要人工建立，内容格式为”normal user/passwd”，如创建/opt/sybase/pwd文件，文件内容为：normal sa/1234

则log_file的值为/opt/sybase/pwd，此文件由于存有用户名和密码，请设置好相应权限

注：必须参数，无默认值

interfaces_file

此参数为可选参数。该参数为用来启动和存取ASE服务器的接口文件的绝对路径

注:可选参数,默认值为<sybase_home>/interfaces (本例即/opt/sybase/interfaces)

sybase_user

这是可选且可省略的参数。该参数为运行ASE服务的用户

注：可选参数，默认值为sybase

shutdown_timeout

这是可选且可省略的参数。该参数为停止ASE服务的最大超时时间，单位为秒

注：可选参数，默认值为30

start_timeout

这是可选且可省略的参数。该参数为启动ASE服务的最大超时时间，单位为秒

注：可选参数，默认值为30

deep_probe_timeout

这是可选且可省略的参数。该参数为深入检测ASE服务的最大超时时间，单位为秒

注：可选参数，默认值为30

（十九）、Tomcat的说明及配置

用途及描述

该脚本管理 tomcat。

支持的参数

tomcat_name

资源的名称

注：可选参数，无默认值

script_log

该脚本日志的位置

注：可选参数，无默认值

tomcat_stop_timeout

停止时超时时间。

注：可选参数，无默认值

tomcat_suspend_trialcount

等待停止的重试次数。

注：可选参数，无默认值

tomcat_user

启动资源的用户名。

注：可选参数，无默认值

statusurl

状态确认的 URL。

注：可选参数，无默认值

java_home

Java 的用户主目录。

注：可选参数，无默认值

catalina_home

Tomcat 的用户主目录。

注：可选参数，无默认值

catalina_pid

Tomcat 的 PID 文件名。

注：可选参数，无默认值

tomcat_start_opts

Tomcat 启动选项。

注：可选参数，无默认值

catalina_opts

Catalina 选项。

注：可选参数，无默认值

catalina_rotate_log

旋转 catalina.out 标志。

注：可选参数，无默认值

catalina_rotatetime

旋转 catalina.out 的时间范围。

注：可选参数，无默认值

（二十）、Xinetd的说明及配置

用途及描述

Xinetd 的资源脚本。它启动/停止 xinetd 管理的服务。请注意，xinetd 守护程序

本身必须在运行：将不会启动或停止它。重要：如果群集管理的服务是唯一启

用的服务，应为 xinetd 指定 -stayalive 选项，否则会在检测信号停止时跳出。或

者，您也可以启用某些内部服务，例如 echo。

支持的参数

service

xinetd 管理的服务名

注：必须参数，无默认值