双机开发指南５

Offline:中文即下线。Offline入口的作用刚好和onlie相反，负责把资源下线。例如，IP资源类型的offline入口会让IP失效。当调用完offline入口后，系统会调用monitor查看有没有下线成功。
Offline入口脚本也会返回一个值，作用和online是相对的。即offline完后，系统过多少秒再调用monitor查看有没有下线成功。在许多场合，启一个应用要花许多时间，同样，停止一个应用也要花许多时间。总而言之，当返回0，表示offline调用完立马调用monitor入口检查有没有下先成功。返回X，表示X秒后再调用monitor检查。

Clean：中文即清理。Clean入口极其重要，因为它负责双机系统异常的处理。当clean成功则返回0，失败返回1。
当出现以下几种异常时，系统会调用clean入口
VCSAgCleanOfflineHung
VCSAgCleanOfflineIneffective
VCSAgCleanOnlineHung
VCSAgCleanOnlineIneffective
VCSAgCleanUnexpectedOffline
VCSAgCleanMonitorHung

这几种异常的含义：
VCSAgCleanOfflineHuang：系统调用offline入口时，没能在指定时间内返回一个值出来，即offline入口脚本timeout了。
VCSAgCleanOfflineIneffective：系统调用offline入口时，没能生效
VCSAgCleanOnlineHung：系统调用online入口时，没能在指定时间返回一个值出来，即online入口脚本timeout了。
VCSAgCleanOnlineIneffective：系统调用online入口时，没能生效
VCSAgCleanUnexpectedOffline：资源因为故障而下线
VCSAgCleanMonitorHung：系统调用monitor入口时，没能在指定时间内返回一个值出来，即monitor入口脚本timeout了。



Agent参数：
CleanTimeout：系统调用clean入口时的最长时间，即要在这个参数指定的秒数内必须执行完clean入口，否则就抛出异常。默认值60秒。