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。允许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
    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实例并管理它们。

例子: /etc/resin/resin.xml

 
    resin
    resin
 

 
 

 
   
 

 
    resin
    resin
 

 
   
 

 
   
     
       
     
   
 

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

例子: /etc/resin/resin.xml

 
    resin
    resin
 

 
    6700

   
 

 
    6701

   
 

 
   
 

　　在上面的例子中，启动Resin， 使用 -server app-a参数将启动一个在端口6700上的watchdog，使用 -server app-b参数将启动一个在端口6701上的watchdog。

例子: starting app-b with watchdog-port=6701

resin-3.2.x> java -jar lib/resin.jar -server app-b start

ISP watchdog管理
　　在ISP的环境中，你可能需要为watchdog使用一个隔离的配置文件，它为不同的用户启动Resin实例。在这个情况下，你要确保watchdog.xml不能被这些普通用户读取，要创建一个管理用户来读取这个文件。

●启动和重启用户的Resin JVM
●设置JVM参数和Java可执行性
●设置Resin实例的root-directory
●setuid user-name 和 group-name
●设置resin.xml配置
●打开受保护的端口，例如80
●可选的chroot设置

watchdog将使用给定的帐号作为setuid来启动Resin实例。它也能打开任何需要的保护端口，例如80。
例子: /etc/resin/watchdog.xml

 

 
    -Xmx256m
 

 
    user_1
    group_1

    /home/user_1/conf/resin.xml
    /home/user_1/www

   
 

  ...

 
    user_n
    group_n

    /home/user_n/conf/resin.xml
    /home/user_n/www