管理代理 ma,在 HADB 主机上执行管理命令。管理代理还通过重新启动 HADB 节点监控进程(如果失败)来确保其可用性。
管理代理 ma 命令的语法为:
ma [common-options] [ service-options] config-file
其中:
common-options 是管理代理命令语法中介绍的一个或多个通用选项。
service-options 是管理代理命令语法中介绍的 Windows 服务选项之一。
config-file 是管理代理配置文件的完整路径。有关更多信息,请参见自定义管理代理配置。
选项 |
说明 |
默认值 |
---|---|---|
--define name=value-D |
将 value 指定给属性 name,其中属性为配置文件中定义的属性之一。此选项可以重复多次。 |
无 |
--help-? |
显示帮助信息。 |
False |
--javahome path-j |
使用位于 path 的 Java 运行时环境(1.4 版或更高版本)。 |
无 |
--systemroot path-y |
通常设置在 %SystemRoot% 中的操作系统根目录的路径。 |
无 |
--version-V |
显示版本信息。 |
False |
管理代理命令语法介绍了将管理代理作为 Windows 服务来启动的选项。-i、-r 和 -s 选项相互排斥,即每次只能使用其中一个选项。
在 Windows 上为配置文件或命令行中的属性值指定路径时,使用双引号 (") 对包含空格的文件路径进行转义。使用双引号和反斜杠对冒号 (:) 驱动器分隔符和反斜杠 (\) 目录分隔符进行转义,如下所示:"\: 和 "\\。
表 3–2 管理代理服务选项(仅限于 Windows)
选项 |
说明 |
默认值 |
---|---|---|
--install-i |
将代理作为 Windows 服务来安装并启动该服务。仅使用 -i、-r 和 -s 选项之一。 |
False |
--name servicename-n |
在主机上运行多个代理时,将指定名称用于服务。 |
HADBMgmtAgent |
--remove-r |
停止服务并从 Windows 服务管理器中删除代理。仅使用 -i、-r 和 -s 选项之一。 |
False |
--service-s |
将代理作为 Windows 服务来运行。仅使用 -i、-r 和 -s 选项之一。 |
False |
HADB 包含可用于自定义管理代理设置的配置文件。未指定配置文件而启动管理代理时,将使用默认值。如果指定了配置文件,管理代理将使用该文件中的设置。您可以在域中所有主机上重复使用该配置文件。
使用 Java Enterprise System,该文件中的所有条目均被注释掉。使用默认配置时无需任何更改。要自定义管理代理配置,请从文件删除注释,并按需要更改值,然后启动将配置文件指定为参数的管理代理。
管理代理配置文件安装在:
Solaris 和 Linux:/etc/opt/SUNWhadb/mgt.cfg。
Windows:install_dir\lib\mgt.cfg。
使用独立安装程序将管理代理配置文件安装在:
Solaris 和 Linux:HADB_install_dir/bin/ma.cfg。
Windows:HADB_install_dir\bin\ma.cfg。
下表介绍了配置文件中的设置。
表 3–3 配置文件设置
设置名称 |
说明 |
默认值 |
---|---|---|
console.loglevel |
控制台的日志级别。有效值为 SEVERE、ERROR、WARNING、INFO、FINE、FINER、FINEST |
WARNING |
logfile.loglevel |
日志文件的日志级别。有效值为 SEVERE、ERROR、WARNING、INFO、FINE、FINER、FINEST |
INFO |
logfile.name |
日志文件的名称和位置。必须为具有读取/写入权限的有效路径。 |
Solaris 和 Linux:/var/opt/SUNWhadb/ma/ma.log Windows:HADB_install_dir\ma.log |
ma.server.type |
客户机协议。仅支持 JMXMP。 |
jmxmp |
ma.server. jmxmp.port |
用于内部 (UDP) 和外部 (TCP) 通信的端口号。必须为正整数。建议范围为 1024-49151。 |
1862 |
ma.server. mainternal.interfaces |
具有多个接口的计算机的内部通信接口。必须为有效的 IPv4 地址掩码。同一个域的所有管理代理必须使用相同的子网。 例如,如果主机有两个接口 10.10.116.61 和 10.10.124.61,使用 10.10.116.0/24 可以使用第一个接口。斜杠后的数字表示子网掩码的位数。 |
无 |
ma.server. dbdevicepath |
存储 HADB 设备信息的路径。 |
Solaris 和 Linux:/var/opt/SUNWhadb/4 Windows:HADB_install_dir\device |
ma.server. dbhistorypath |
存储 HADB 历史文件的路径。 |
Solaris 和 Linux:/var/opt/SUNWhadb Windows:REPLACEDIR(运行时由实际 URL 替换。) |
ma.server. dbconfigpath |
存储节点配置数据的路径。 |
Solaris 和 Linux:/var/opt/SUNWhadb/dbdef Windows:C:\Sun\SUNWhadb\dbdef |
repository.dr.path |
域系统信息库文件的路径。 |
Solaris 和 Linux:/var/opt/SUNWhadb/repository Windows:C:\Sun\SUNWhadb\repository |
您可以使用两种方式启动管理代理:
作为服务启动,用于生产。请参见将管理代理作为服务启动。为确保管理代理的可用性,请确保系统重新引导时管理代理可以自动重新启动。请参见确保管理代理自动重新启动。
作为常规进程(在控制台模式下)启动,用于评估、测试或开发。请参见在控制台模式下启动管理代理。
对于每种启动方式,启动过程会因使用的是 Java Enterprise System 还是独立的 Application Server 而有所不同。
将管理代理作为服务启动,可确保它继续运行直到系统关闭或管理代理被明确停止。
要将管理代理作为服务启动,请使用以下命令:
/etc/init.d/ma-initd start
要停止该服务,请使用以下命令:
/etc/init.d/ma-initd stop
要将管理代理作为 Windows 服务启动,请使用以下命令: HADB_install_dir\bin\ma -i [config-file ]
可选参数 config-file 指定了管理代理配置文件。仅当您希望更改默认管理代理配置时,才使用配置文件。
要将管理代理作为服务来停止和删除(注销),请使用以下命令:HADB_install_dir\bin\ma -r [ config-file ]
要执行管理,请选择“管理工具”|“服务”,以便能够启动和停止该服务、禁用自动启动等等。
要将管理代理作为服务启动,请使用以下命令:
HADB_install_dir/bin/ma-initd start
要停止该服务,请使用以下命令:
HADB_install_dir/bin/ma-initd stop
要将管理代理作为 Windows 服务启动,请使用以下命令: HADB_install_dir\bin\ma -i [config-file ]
可选参数 config-file 指定了管理代理配置文件。仅当您希望更改默认管理代理配置时,才使用配置文件。
要将管理代理作为服务来停止和删除(注销),请使用以下命令:HADB_install_dir\bin\ma -r [ config-file ]
要执行管理,请选择“管理工具”|“服务”,以便能够启动和停止该服务、禁用自动启动等等。
在 Windows 平台上,将管理代理作为服务启动后,您可以使用 Windows 管理工具将服务的启动类型设置为“自动”并设置所需的恢复选项。
在 Solaris 和 Linux 平台上,在 ma 进程失败或操作系统重新引导时,使用本节介绍的过程确保管理代理的可用性。这样做适用于生产部署。
以下过程确保管理代理仅在系统进入以下两个运行级时才启动:
在 Solaris 上,运行级 3(默认值)。
在 RedHat Linux 上,运行级 5(图形模式的默认值)。
进入其他运行级将停止管理代理。
本节假定您对操作系统初始化和运行级有基本的了解。有关这些主题的信息,请参见您的操作系统文档。
请确保您系统的默认运行级为 3 或 5。
要查看系统的默认运行级,请检查文件 /etc/inittab,并在靠近顶部的位置,查找类似于如下所示的行:
id:5:initdefault:
本示例显示了默认运行级 5。
创建文件 /etc/init.d/ma-initd 的如下软链接:
/etc/rc0.d/K20ma-initd /etc/rc1.d/K20ma-initd /etc/rc2.d/K20ma-initd /etc/rc3.d/S99ma-initd /etc/rc5.d/S99ma-initd /etc/rcS.d/K20ma-initd |
重新引导计算机。
取消激活自动启动和停止代理、删除链接或将链接名称中的字母 K 和 S 更改为小写。
在 shell 中,将当前目录更改为 HADB_install_dir/bin。
编辑 shell 脚本 ma-initd。
确保脚本中 HADB_ROOT 和 HADB_MA_CFG 的默认值反映您的安装:
HADB_ROOT 为 HADB 安装目录 HADB_install_dir。
HADB_MA_CFG 为管理代理配置文件的位置。有关更多信息,请参见自定义管理代理配置。
将 ma-initd 复制到目录 /etc/init.d。
创建文件 /etc/init.d/ma-initd 的如下软链接:
/etc/rc0.d/K20ma-initd /etc/rc1.d/K20ma-initd /etc/rc2.d/K20ma-initd /etc/rc3.d/S99ma-initd /etc/rc5.d/S99ma-initd /etc/rcS.d/K20ma-initd |
取消激活自动启动和停止代理、删除链接或将链接名称中的字母 K 和 S 更改为小写。
您可能希望在控制台模式下为评估或测试手动启动管理代理。请勿在生产环境中以这种方式启动管理代理,因为系统或进程失败后 ma 进程将不会重新启动而且命令窗口关闭时该进程将终止。
要在控制台模式下启动 HADB 管理代理,请使用以下命令:
opt/SUNWhadb/bin/ma [config-file]
管理代理的默认配置文件为 /etc/opt/SUNWhadb/mgt.cfg
要停止管理代理,请中止进程或关闭 shell 窗口。
要在控制台模式下启动管理代理,请使用以下命令:
HADB_install_dir\bin\ma [config-file]
可选参数 config-file 为管理代理配置文件的名称。有关配置文件的更多信息,请参见自定义管理代理配置。
要停止代理,请中止进程。
要在控制台模式下启动管理代理,请使用以下命令:
HADB_install_dir\bin\ma [config-file]
可选参数 config-file 为管理代理配置文件的名称;有关更多信息,请参见自定义管理代理配置。
要停止管理代理,请中止进程。
要在控制台模式下启动 HADB 管理代理,请使用以下命令:
HADB_install_dir/bin/ma [config-file]
管理代理的默认配置文件为 HADB_install_dir/bin/ma.cfg。
要停止管理代理,请中止进程或关闭 shell 窗口。