Log-Cutter 日志切割清理工具

    Log-Cutter 是JessMA开源组织开发的一个简单实用的日志切割清理工具。对于服务器的日常维护来说，日志清理是非常重要的事情，如果残留日志过多则严重浪费磁盘空间同时影响服务的性能。如果用手工方式进行清理，会花费太多时间，并且很多时候难以满足实际要求。例如：如何在每个星期六凌晨3点把超过 2G 大的日志文件进行切割，保留最新的 100M 日志记录？ 网上没有发现能满足本座要求的日志切割工具，因此花了一些闲暇时间自己写了一个。由于要在多个平台上使用，为了方便采用 Java 实现。本工具命名为 Log-Cutter，主要有以下特点：

1. 支持 Linux、Mac 和 Windows 等所有常见操作系统平台

2. 支持命令行交互式运行

3. 支持后台非交互式运行（Linux/MAC 下使用 daemon 进程实现，Windows 用系统 ServICE 实现）

4. 支持三种日志清理方式：删除日志文件、切割日志文件、归档日志文件

5. 支持对 GB18030、UTF-8、UTF-16LE、UTF-16BE 等常用日志文件类型进行切割

6. 高度可配置（程序执行周期、要删除的日志文件过期时间、要切割的日志文件阀值和保留大小等均可配置）

    详细说明与使用方法参考：《操作指南》

• 使用方法：

**************************************************************
**** LogCutter - JessMA Open Source, all rights reserved. ****
**************************************************************

一、环境要求
--------------------------------------------------
1) Java 版 本: JDK / JRE 1.6 以上
2) 依赖程序包: dom4j、Log4j、ant、juNiversalchaRDEt
--------------------------------------------------

二、配置文件
--------------------------------------------------
1) 程序配置文件: conf/config.XML (默认)
    （示例参考：conf/config-template.xml）
2) 日志配置文件: conf/log4j2.xml (默认)
    （示例请参考：conf/log4j2.xml）
--------------------------------------------------

三、安装部署
（注 ：LogCutter 需要配置 ‘JAVA_HOME’ / ‘JRE_HOME’ 和 ‘CLASSPATH’ 系统环境变量）
--------------------------------------------------
1) 配置系统环境变量 ‘JAVA_HOME’（或 ‘JRE_HOME’） 和 ‘CLASSPATH’
2) 在 LogCutter配置文件（默认：conf/config.xml）中配置清理规则
3) 启动 LogCutter
--------------------------------------------------

四、启动方式
--------------------------------------------------
1) Windows
    A) 前台运行: > run.bat [ -f config-file ]
    
    B) 后台运行: > LogCutter.exe  {    
                                    -install-demand  (安装手动启动服务)
                                    -install-auto    (安装自动启动服务)
                                    -uninstall       (删除服务)
                                    -start           (启动服务)
                                    -stop            (停止服务)
                                    -status          (查看服务状态)
                                 }

  *** 注 *** 
  @ LogCutter.exe 以 Windows 系统服务的方式运行，安装好后也可以通过 Windows 服务管理器进行管理
  @ LogCutter.exe 是 32 位程序，LogCutter_x64.exe 是 64 位程序，根据当前系统平台使用其中之一

    C) 单次运行: > run.bat -1 [ -f config-file ]

2) Linux / UNIX
    A) 前台运行: $ run.sh [ -f config-file ]
    B) 后台运行: $ run.sh [ -f config-file ] -d
    C) 单次运行: $ run.sh -1 [ -f config-file ] [ -d ]

  *** 注 ***
  @ 可以把 run.sh 启动命令加入 /etc/rc.d/rc.local 中，从而设置为开机时自动运行
  @ 可以把 run.sh -1 放入 CronTab 中定期执行，并且不用常驻内存，如：
    ## 30 2 * * 2,4,6 root /usr/local/LogCutter/bin/run.sh -1 > /dev/null
--------------------------------------------------