|
|
Open source tools written in Java. Sponsored by Acelet corporation |
| |Home | Products | Documents | Downloads | Partners | Contact | |
Note: SuperWatchdog uses many panels from SuperScheduler. See Scheduler Menus and Windows for more information.
Watchdog Doer: Displays the Watchdog Panel with Doer capacity.
Watchdog Talker: Displays the Watchdog Panel with Talker capacity.
History: Displays the History Table Panel. The History Period Panel will pop up first for you to specify a history period.
DoerTalker: Displays the DoerTalker Table Panel.
Task Database: Displays the Direct Task Database Connection Panel.
Preference: Displays the Preference Panel.
About: Shows version number and license information.
This panel shows working task activity in graphic mode.
Print: Prints this chart on printer.
The title of this panel is Activity. It shows activities of working tasks.
This panel hosts two panels: the Activity Table Panel and the Activity Chart Panel. They show the same information, but in different modes: text mode and graphic mode.
Old working tasks will be deleted automatically after reaching the Working task display max number. See the Preference Panel for more information.
This panel shows run time activities of tasks (working tasks).
There are buttons on the toolbar:
Detail: Displays History Task Panel to show detailed information.
Kill: Kill the highlighted task. If the working task is not running on the JVM, set status as Lost. See Working Task for more information.
The main part of this panel is a table:
Name: The names of tasks. If a task is a composite task or a retry task, the showing name will be <composite task name>.<member task name> or <retry task name>.<member task name>.
Real host: The machines on which tasks were executed.
Working status: The working statuses of tasks.
Last run time: The last run times of the tasks.
Trigger: Summary information about the trigger. If a task is a composite task or a retry task, the Trigger will be On call.
Last result: The results of task executions.
Group: The group of the task.
This panel allows you to choose the type of history information.
Activity: The historical working task information. Click Ok, the History Table Panel will appear.
Log: The historical log information about schedule and major task events. Click Ok, the Log Table Panel will appear.
The lower part of this panel is a Period Panel.
The main differences between History Panels and Log Panels are:
Direct Task Database Connection Panel
This panel allows you to specify task database parameters. SuperWatchdog uses these parameters to connect to the task database directly. You can use your log database as the task database, or you can use another database as well.
This panel will pop up automatically when it is necessary.
This is an administrator tool. Do not change those parameters unless it is absolutely necessary. If you do need to change those parameters, please work with your database administrator to set these parameters.
Note: If you change it to different database, you need to put the new driver file on the CLASSPATH when you start Super. See Environment Variables for details.
Driver: The task database driver name. The class or jar file must be on the CLASSPATH. See Environment variables for more information.
URL: The task database URL.
User: The task database user name. If you use default database, do not change User. If you use other database, the User is assigned by your database administrator. You can not create a new user from this panel.
Password: The password for the task database User. This is the password associated with User already set in the log database. You can not create new password from this panel. Password can not be empty.
Remember user name and password: Check this if you want the User and Password be saved. This is to remember user name and password for this panel only. Other panels provide similar facilities. Note: User and Password are saved as plain text. If you have security concerns, please leave password empty. See Security guideline for logins for more information.
Ok: Connects to the task database and saves parameters. If the new connection is successful, it takes effect immediately. If the new connection fails, it will not affect the current connection.
Cancel: Closes this panel without doing anything.
Note: If you want to specify query timeout, you need to do it on Preference Panel.
Note: If you use other database, the database driver classes must be on the CLASSPATH. See Environment variables for more information.
This panel shows all Doers and Talkers working on the task database. There may be more than one task database. For each task database, one or more Doer/Talker work on it. This panel only shows the Doer/Talker which are connected to the task database.
Task database: The task database URL and login name.
Name: Doer name or Talk name. It is machine name plus word "Doer" or "Talker". Note: This panel shows one Doer or Talker running on that machine. It does not show the number of instances of Doers or Talkers running on that machine.
Last heartbeat time: The time for the last heartbeat. Note 1: if the time is very resent, that means the Doer or Talker is running. If the time was more than an interval before, that Doer or Talker is not running. Note 2: The data shown here is a snapshot.
Delete: Deletes the highlighted item.
This panel allows you to edit parameters for JMS trigger.
This panel inherits from Message Trigger Panel. The main difference is: the Export buttons are removed.
Ok: Accepts the data and closes this panel.
Cancel: Cancels the operation and closes this panel.
This panel shows schedule and task historical information.
Name: Task name.
Real host: The machine on which the task was executed.
Working status: The status of the task execution.
Last run time: The execution time of the task.
Brief: The summary information about the task.
Last result: The result text from the execution.
Detail: Displays History Task Panel to show detailed information of the highlighted line.
Close: Closes this panel.
This panel shows history information of running tasks. This is a read-only panel.
See History Table Panel for the differences between the History Task Panel and the Log Task Panel.
Name: Task name.
Real host: The machine on which the task was executed.
Working status: The status of the execution.
Brief: The brief information about the task.
Start Time: The start time of the task.
End Time: The end time of the task.
Job: The job of the task.
Result: The result text from the execution.
Close: Closes this panel.
Note: Some information may depend on Working status. For example, if it is Task started, the Result is not available, because the result has not been produced yet at that time.
This panel shows schedule and task historical information. The information comes from log database.
See History Table Panel for the differences between the History Table Panel and the Log Table Panel.
Name: Task name.
Logger: The machine which logged this event.
Working status: The status of the execution.
Trigger: The summary information about the trigger.
Time: The execution time of the task.
Job: The job of the task.
Other: One of creator, result or error text.
Detail: Displays Log Task Panel to show detailed information of the highlighted line.
Close: Closes this panel.
Note: Some information may depend on Working status. For example, if it is Task started, the Result is not available, because the result has not been produced yet at that time.
This panel shows history information of running tasks. This is a read-only panel.
See History Table Panel for the differences between the History Task Panel and the Log Task Panel.
Name: Task name.
Logger: The machine on which the task was executed.
Working status: The status of the execution.
Trigger: The summary information about the trigger.
Time: The execution time of the task.
Job: The job of the task.
Status: The status of the task.
Desired Host: the desired machine for running the task. Empty means the task can run on any machine.
Creator: The creator or modifier of the task. This is for Task modified events only.
Result: The result text from the execution. This may or may not be available, depending on the Log includes result of Preference. This is for all Tasks events except Task modified event.
Close: Closes this panel.
Note: Some information may depend on Working status. For example, if it is Task started, the Result is not available, because the result has not been produced yet at that time.
This panel shows summary information about tasks. This is the Task Organizer.
There are two groups of buttons on the toolbar. The first group is related to the selected item, while the second group if for the panel. There is a space between these two groups.
Edit: Edits the highlighted task to modify its parameters by opening a Task Panel. It also can un-suspend a suspended task to restore it to active. To restore it back to active, click on the Edit button and click the Ok button on the Task Panel.
Delete: Deletes the highlighted task. If the task is executed at that moment, the executed process will not be affected. But all future activities of the task is canceled immediately. The task will be removed permanently.
Activate: Brings the task to be active.
Suspend: Halts the task. If the task is executed at that moment, the executed process will not be affected. But all future schedules of the task are canceled immediately. The task will NOT be removed. If you want to restore the task again, click on the Edit button and click on the Ok button on the Task Panel.
Run: Runs the highlighted task immediately once. Actually, it is a request to run the task immediately. A Doer will pick up the task.
Export: Writes the highlighted task to a file.
Add: Adds a new task by opening the Task Panel.
Refresh: Re-reads everything from task database and re-paints this panel. This button is to manually refresh. Usually, the panel automatically refreshes itself if anything is changed. You do not need to refresh this panel manually.
Import: Reads and adds a task from a file.
Close: Closes this window.
This panel allows you to specify preferences for the SuperWatchdog. The values are stored in the task database, not on the local machine, so all Doers and Talkers who use the same task database share the same preference values. New values take effect immediately unless stated otherwise.
Interval: The interval, in seconds, between two refreshes. Note: new value will take effect in old interval plus new interval: if the old interval was 5 and new interval is 10, the change will be effective in 15 seconds.
Extra interval for Gateway mode: The extra interval for Gateway mode. Gateway is slower than native mode. This extra interval is needed to make SuperWatchdog more stable. The actual interval is the regular Interval plus this. The Native mode will ignore this extra interval.
Max display number on Activity Panel: The maximum number of task records to be displayed on Activity Panel. Note: this is a suggested number. SuperWatchdog may "round it up" to a convenient value.
Working task retire time: The retire time for working tasks records. Old records will be deleted regularly.
Query timeout: The SQL query timeout for task database.
Log includes result: Check this if you want SuperWatchdog to log event with the last result. The last result is the output of the task. The last result, sometimes, may be very long. Leave it unchecked if you do not want to see the last result be part of log message.
LogAgent timeout: The timeout for log messages through LogAgent, in seconds. New value will not take effect until the SuperWatchdog restarts.
Minimum duration: The minimum duration for a task. SuperScheduler update the task database when a task starts and ends. If the duration of the task is too short, the updating procedures may compete with each other. With a minimum duration, the system will be more stable. It is recommended that the minimum duration equals or greater than query timeout.
Log history timeout: The timeout when select log history, in seconds.
Maximum heartbeat miss: The maximum allowed number of heartbeat miss in a row. If the number of missed heartbeat is small than this, SuperScheduler will ignore the miss. When the missed heartbeat is greater than this, an exception will be thrown once. No exception for future heartbeat miss. When there is one good heartbeat, the count for missed heartbeat will reset to zero.
This panel allows you to set job. It is similar to the Set Job Panel of SuperScheduler.
This panel allows you to specify a trigger. See information on SuperWatchdog Term.
Type: The trigger type. There are following types:
Delay: The delay time for starting the task after it is triggered.
Other sections are depend on the value of Type. One of the following section will appear:
File timestamp: For File trigger.
File name: The file name whose timestamp is watched.
Ripeness criteria: The criteria indicates a slow grow file getting ripe. The unit is second. The timestamp of a slow grow file may change many times when it is growing. If in a period (this criteria) the timestamp does not change, SuperWatchdog will assume that the file is ripe and will trigger the event and execute the task. This is for slow grow file. Note 1: if the value you specify is too small, it may be triggered more than once during the period of growing. Note 2: The frequency of updating timestamps of files may be Operating System dependent. Note 3: If you expect a file needs 10 minutes to be mature, set this value to 600 seconds.
JMS: For JMS (Java Message Service). Either Queue or Topic. This replaces both JMS queue and JMS topic triggers.
Browse: Displays a JFileChooser window for you to choose an exported file from EasyJMS. An Edit JMS Trigger panel will be displayed later for editing data
Detail: Displays a Edit JMS Trigger panel for editing data.
JMS queue: For JMS queue trigger. This is deprecated. For J2EE 1.4 servers, please use unified, common interface JMS (which is not particular for either Queue or Topic).
JMS queue name: the name for the JMS queue.
JMS queue text: the text for the JMS queue. It must be exact text.
JMS topic: For JMS topic trigger. This is deprecated. For J2EE 1.4 servers, please use unified, common interface JMS (which is not particular for either Queue or Topic).
JMS topic name: the name for the JMS queue.
JMS topic text: the text for the JMS queue. It must be exact text.
MBean notification: For JMX (Java Management eXtension) notification.
Browse: Displays a JFileChooser window for you to choose an exported file from EasyJMX. A Notification Panel will be displayed later for editing data
Detail: Displays a Notification Panel for editing data.
User: For User trigger.
Class name: The full class name for User defined trigger.
Browse: Opens a FileChooser to choose a file.
This panel allows you to specify the Datasource JNDI name for the task database for SuperWatchdogEjbGateway.
Datasource name: The JNDI name of the datasource for the task database. The datasource must be set and available on the application server.
See the Task database and SuperWatchdog EJB Gateway for related information.
This panel allows you to specify Tasks.
Name: The name of this task. It must be a unique name.
Job: The target job. It shows brief information about the job. This field is not editable, please use the Browse button next to it to set the job.
Set job: Displays the Set Job Panel for specifying the job.
Trigger: Shows brief information about the trigger. Please use the Set Trigger button to set the trigger. This field is not editable.
Set Trigger: Displays the Set Trigger Panel for specifying the trigger.
Period: Effective period. The status of the task will be Inactive if it is out of this period and will not be triggered.
Set Period: Displays the Period Panel for specifying the effective period.
Status: Shows the status of the task. When you click on the Ok button, the status is set by the system. This field is not editable.
Desired host: The desired computer which runs this task. If you leave it empty, any computer can run this task. If you specified a name, then only the named computer can run the task. It can be many names delimited by commas (","). All names here are equal and the order is not important. You can put spaces around commas for easy reading.
Description: This is an optional field for your convenience.
Comments: This is an optional field for your convenience.
Creator: Shows the user who creates or modifies this task. This field is not editable.
Alarm Email: The email address to send alarm email for this task. See Alert email and Alarm email for more information. If this address is not set, there will be no alarm email for this task. Note: Mail Server must be set. See Mail Server Panel from the main menu > System > Mail Server for related information.
Modified at: Shows the last modification time of this task. This is the last activity time. This field is not editable.
Ok: Closes this panel and saves all specified information. The Status will be set to be Standby, if it is possible.
Cancel: Cancels changes and closes this panel.
This is the main panel of SuperWatchdog. The menu bar is on the top. The top panel is the Organizer (Organizer Panel) and the bottom summary panel is the Activity (Activity Tabbed Panel).
The title of the window shows the mode, either Doer or Talker. There are some visible differences between Doer and Talker: