Resin 的 watchdog(看门狗)介绍

为了稳定和安全，Resin使用一个独立的watchdog进程来启动和监视Resin服务器。watchdog连续你检测Resin服务器的状 态，如果其没有反应或者迟钝，将会重启Resin服务器进程。大多数情况下，watchdog从resin.xml中读取配置信息，而不需要其它的附加配 置。某些ISP服务商可能使用特别的配置，为了安全他们会配置watchdog来隔离JVM(Java虚拟主机)。

概述 
因为watchdog作为一个服务运行，大多数情况下你根本不需要注意它。标准的配置下，一个机器上的watchdog可以监视这个机器上所有JVM，因 此大部分情况下你不需要修改watchdog的配置。需要你管理watchdog的任务就是，如果机器发生了问题，停止watchdog,并检查 watchdog日志中Resin服务器的重启事件。

　　watchdog自动重启崩溃和退出的Resin服务。因此如果你想停止Resin,你需要告诉watchdog来停止Resin实例，或者完 全停止watchdog。使用resin.ar中的主程序(main)来控制watchdog，有用来启动、停止、重启Resin实例的命令，同样还有报 告watchdog状态的命令。

大多数用户不需要特别的配置watchdog，但是ISP和大的站点可能创建特殊的watchdog.xml(包含<watchdog- manager>标签)来控制watchdog。<watchdog-manager>允许ISP控制watchdog,为他们用户的 Resin实例指定附加的命令行参数，包括为他们的用户创建安全的chroot环境的能力。典型地，watchdog以root帐号运行，然而用户实例使 用他们各自的用户id。

命令行
　　resin.jar中的主类ResinBoot的命令行用来控制watchdog。主要的操作包括：start、stop、restart、shutdown和status。

start
　　"start"命令使用给定的server id启动一个新的Resin实例。ResinBoot首先会尝试在当前机器上的watchdog，在需要时会启动一个新的watchdog。在resin.xml中定义的server id必须是惟一的。
例如: watchdog启动

resin-3.2.x> java -jar lib/resin.jar -conf conf/test.conf -server a start
Resin/3.2.x started -server 'a' for watchdog at 127.0.0.1:6700

stop 
"stop"命令使用给定的server id停止Resin实例。如果停止的实例是watchdog管理的最后一个Resin实例，watchdog也会自动退出。如果没有指定 -server 参数,watchdog使用默认的 -server "" 。

例子: watchdog停止

resin-3.2.x> java -jar lib/resin.jar stop
Resin/3.2.x started -server '' for watchdog at 127.0.0.1:6600

status 
"status"命令统计被watchdog服务管理的Resin实例的状态。
例子: watchdog状态

resin-3.2.x> java -jar lib/resin.jar status
Resin/3.2.x status for watchdog at 127.0.0.1:6600

server '' : active
  password: missing
  user: ferg
  root: /home/test/resin/
  conf: /etc/resin/resin.xml

单一Resin实例 
　　这个例子显示了一个单一服务器站点，其监听标准的HTTP端口80,并以resin这个用户身份运行。在这个例子中watchdog是以root用户身份运行的，因此其能够绑定到特殊的端口80上，但是Resin实例是以resin身份运行的。

因为使用了默认的配置，watchdog监听6600端口来获取命令。
例子: /etc/resin/resin.xml

<resin xmlns="http://caucho.com/ns/resin ">
<cluster id="">

  <server id="app-a" address="127.0.0.1">
    <user-name>resin</user-name>
    <group-name>resin</group-name>

    <http port="80" />
  </server>

  <resin:import path="${resin.home}/conf/app-default.xml" />

  <host id="">
    <web-app id="" path="/var/www/htdocs" />
  </host>

</cluster>
</resin>

在一个机器上使用共享的watchdog实现负载平衡 
　　当在一个机器上运行多个Resin实例的时候，一个watchdog-manager就能管理所有的Resin实例。指定server id用来决定那个Resin实例是start或者stop。
在这个例子中，有一个web-tier服务器做为负载平衡器，两个app-tier服务器处理后台数据，它们都在一个机器上。为了维护和升级方便，一个站点可能需要多个app-rier服务器。当一个停机的时候，第二个服务器可以继续服务。
这个例子使用默认的watchdog配置，其读取的是标准的resin.xml文件。watchdog进程和ResinBoot都读取resin.xml 配置文件，因此不需要特别的watchdog配置。watchdog能够自动发现运行在这个机器上的多个Resin实例并管理它们。

同一机器使用不同的watchdog来实现负载平衡 
在某些情况下，最好让每个Resin实例有其自己的watchdog，例如当多个用户在使用相同的机器。每个<server>块配置一 个<watchdog-port>。因为watchdog将读取resin.xml使用<server>块匹配命令行参数中的 -server id，每个watchdog将启动期自己的端口。

例子: /etc/resin/resin.xml