任务调度QuartzDesk（Lite Edition）安装部署和使用小结

QuartzDesk 是一个 Java Quartz 调度器管理和监控的图形化工具，提供很多强大和专门的特性。旨在为使用 Quartz 的 Java 开发者提供查询和监控的功能。

一、环境要求

Oracle Java (JDK) 6, 7, 8

apache-Tomcat 6.x or 7.x

mysql5.6+

 

二、安装部署QuartzDesk

1. 版本说明

QuartzDesk共有三种版本：Lite Edition/Standard Edition/Enterprise Edition，其中Lite Edition是免费版，Standard Edition/Enterprise Edition是商用版。

免费版只有部分监控功能，商用版的功能比较全。各版本的安装步骤和功能比较可参见下图（截图来自https://www.quartzdesk.com/documentation/installation-steps）。

 

2. 下载

    在官网 www.quartzdesk.com下载相应的版本，本文选择quartzdesk-web-2.0.1.war

 

3.  安装和配置

    本文介绍标准的安装过程，如果只是想简单调研可以参考官网提供的一步安装教程（主页https://www.quartzdesk.comFAQs下搜索one-step-installation）。

 

3.1 数据库

   //在mysql数据库中创建名为quartzdesk的用户（密码任意设置），例如：

    CREATE USER 'quartzdesk'@'localhost' IDENTIFIED BY '123456';

    //创建一个名为quartzdesk的数据库

    create database quartzdesk;

   //给用户授权，取保quartzdesk用户对quartzdesk数据库有操作权限

    GRANT ALL ON *.* TO 'quartzdesk'@'localhost';

 

3.2 JDBC Driver   

    下载JDBC驱动（本文使用mysql-connector-java-5.1.22-bin.jar），把JAR文件拷贝到TOMCAT_HOME/lib目录下 

3.3 Data Source

     打开TOMCAT_HOME/conf/server.xml 文件，在GlobalNamingResources 后面加上如下代码，其中红色部分根据实际情况替换。

<!--

MySQL JDBC data-source used by the QuartzDesk web application.

-->

<Resource name="jdbc/QuartzDeskDS"

auth="Container"

type="javax.sql.DataSource"

removeAbandoned="true"

removeAbandonedTimeout="30"

maxActive="10"

maxIdle="1"

maxWait="2000"

validationQuery="select 1"

poolPreparedStatements="true"

username="quartzdesk"

password="123456"

driverClassName="com.mysql.jdbc.Driver"

url="jdbc:mysql://localhost:3306/quartzdesk?cachePrepStmts=true"/>

 

3.4 创建工作目录

    创建一个名为word_dir的工作目录（本地任何地方都行），把license.key文件拷贝到该目录下。license.key文件可在官网主页上Try /Purchase 处获得。

    打开quartzdesk-web-2.0.1.war包（把后缀改成.zip后解压打开），把extras/work目录下的所有文件拷贝到word_dir下。

   至此，work_dir目录下至少包含了license.key，logback.xml，quartzdesk.properties三个文件。

 

3.5 配置

   打开work_dir/quartzdesk.properties，把db.profile的值改成mysql_innodb。

   此外，还可以在work_dir/logback.xml文件中修改日志的配置。

3.6 停止tomcat
    TOMCAT_HOME/bin/shutdown.sh

3.7 部署应用   

    打开quartzdesk-web-2.0.1.war包，把extras/tomcat/quartzdesk.xml文件拷贝到TOMCAT_HOME/conf/Catalina/localhost目录下。打开quartzdesk.xml 文件，把quartzdesk.work.dir的值改成实际的work_dir地址，例如：

    <Parameter name="quartzdesk.work.dir" value="F:/quartzdesk/work_dir"/>

    把quartzdesk-web-2.0.1.war的文件名改成quartzdesk.war，并把它拷贝到TOMCAT_HOME/webapps目录下。

3.8 安全设置

   打开TOMCAT_HOME/conf/tomcat-users.xml文件，加入用户权限信息。以下是tomcat-users.xml文件的一个样例：

<?xml version='1.0' encoding='utf-8'?>
<tomcat-users>

...

<!-- QuartzDesk web application roles -->

<role rolename="QuartzDeskUser"/>

<role rolename="QuartzDeskMonitor"/>

<role rolename="QuartzDeskService"/>

<user username="user" password="password" roles="QuartzDeskUser"/>

<user username="monitor" password="password" roles="QuartzDeskMonitor"/>

<user username="service" password="password" roles="QuartzDeskService"/>

</tomcat-users>

 

3.9 启动tomcat

    TOMCAT_HOME/bin/startup.sh    

4. 访问测试

   浏览器中输入http://TOMCAT_HTTP_HOST:TOMCAT_HTTP_PORT/quartzdesk，按提示输入用户名和密码，如果能打开页面，说明安装部署成功。否则，查看TOMCAT_HOME/logs 和work_dir/logs下的日志查看原因。

 

三、 使用quartzdesk监控quartz Schedulers

    使用Quartzdesk监控quartz Schedulers包括以下两步：

1. Enabling remote JMX access to the Platform MBean Server of the JVM the Quartz scheduler is running on (Platform MBean Server is a standard component of all modern  JVMs). 

2. Exporting the Quartz scheduler management interface (MBean) to the JVM’s Platform MBean Server.

Windows下：

1. 在Eclipse的Arguments里修改JVM的参数，并点击run

-Djava.rmi.server.hostname=localhost

-Djavax.management.builder.initial=

-Dcom.sun.management.jmxremote=true

-Dcom.sun.management.jmxremote.port=1099

-Dcom.sun.management.jmxremote.ssl=false

-Dcom.sun.management.jmxremote.authenticate=false

-Dorg.quartz.scheduler.jmx.export=true

 

 

 

2. 执行JAVA_HOMEinjconsole.exe，验证JMX能否连接Quartz scheduler。

 

3. 验证能连接之后，用浏览器打开http://TOMCAT_HTTP_HOST:TOMCAT_HTTP_PORT/quartzdesk，添加connection，就可以开始监控了。

 

Linux下：

1. 写一个启动程序，把样例中标红部分加入启动程序

#!/bin/bash

usage()

{

        echo "usage: `basename $0` curl URL_ADDR --data-binary CSV_FILE_NAME -H 'Content-type:text/plain;charset=gb2312'"

}

if [ $# -ne 0 ]; then

        usage

        exit 1

fi

java -jar -Djava.rmi.server.hostname=localhost -Djavax.management.builder.initial= -Dcom.sun.management.jmxremote=true -Dcom.sun.management.jmxremote.port=1099 -Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.authenticate=false -Dorg.quartz.scheduler.jmx.export=true XX.jar

2. 执行上述启动程序

3. 用浏览器打开http://TOMCAT_HTTP_HOST:TOMCAT_HTTP_PORT/quartzdesk，添加connection，就可以开始监控了。