Clicking Manage Job Definitions in the Server, Site, or Customer Scheduled Jobs dialog displays options for viewing or updating existing jobs or or creating new job definitions.
Before working with this dialog, review important concepts descibed in the Scheduled Jobs Overview.
Note that you cannot view or modify CommonSpot standard scheduled jobs.
CommonSpot takes care of the details of inserting jobs you create into the ColdFusion scheduler and maintaining changes.
Note that this dialog may show both factory and non-factory (or custom) scheduled job definitions. You cannot view or modify the factory CommonSpot scheduled job definitions. For sample job definition XML, see the XML files for the factory jobs in the /commonspot/schema/sched-tasks directory..
The Source Scope identifies the level at which the job definition was imported, the Target Scope identifies the scope of the "command" API that will be executed. Use Source Scope information to determine where to view, modify, or delete job definitions.
Jobs definition imported at one level can execute at another. For example, importing a job definition with a target scope of Site at the server level makes the job available for all sites on the server. Importing the same job at the Customer level makes it available only to sites belonging to that customer. See the Scheduled Job Overview for more information.
In the Actions column, clicking the Import Job icon displays the Import Job Definition dialog in edit mode for viewing or changing an existing job. Note that you cannot view, modify, or delete CommonSpot factory scheduled job definitions.
Note that server-level jobs do not automatically replicate to replication targets. You must separately add and run server-level jobs on target servers.
For example, importing a job definition with a target scope of Site at the server level makes the job available for all sites on the server. Importing the same job at the Customer level makes it available only to sites belonging to that customer.See Creating Scheduled Jobs for more information.
Click to sort by column head.
Jobs in the Available state display as options for Site-, Server-, or Customer-level scheduling.
In the Actions column, clicking the Import Job icon 
displays the Import Job Definition dialog in edit mode for viewing or changing an existing job. Note that you cannot view, modify, or delete CommonSpot scheduled jobs.
Remove individual job definitions by clicking the associated delete icon 
.
Scheduled Jobs can have one of three states:
Clicking the Change State icon 
displays the Change Job Definition State dialog. Edit rights to other job definitions are a function of current credentials. The example above shows how this dialog would appear to an administrator with server-level access. Administrators with site- or customer-level rights can view the list of jobs but cannot view, edit, or delete custom XML.
CommonSpot ships with 10 standard job definitions defined to run as follows. Your usage depends on which CommonSpot features are installed. Except as noted under Recommended Interval below, job start times default to the current time.
|
Task |
Function |
Recommended Interval |
| Site Jobs (run at the site level) | ||
|
Rebuild Cache (Non-Cache Server) |
Detects and updates all changes to stored files. Scheduling this task during off-peak usage conserves server resources while maintaining content freshness. You can run once for each scheduled time or set up a continuous or interval-based schedule, to regularly rebuild cache at pre-set periods that make sense for your site. |
Site-specific, but generally, once daily, during low-activity times. |
|
Rebuild Cache (Cache Server) |
Sites running CommonSpot Cache Servers in a Shared Database environment can use this utility to automatically update cache for all target servers at your site. |
Site-specific. For dedicated, high-powered servers, you can consider a short interval, if server resouces are shared, consider a longer period. See the description and installation instructions for Cache Servers in the Shared Database Configuration Guide and: |
|
Send Broken Link Notifications |
Examines system links to both internal pages and external URLs, determines if any are invalid, and reports status. Optionally emails content owners or authors when invalid links are detected. |
Once nightly. See: |
| Send Content Freshness Reminders | Monitors the content expiration date of pages, and sends an email reminder to users who request notification. |
Once nightly. See: |
| Test Site Background Process | Verifies site-level background process scheduling and process execution. Writes a log entry to verify that the scheduled background process is running. | For internal use. |
| Generate Static Content | For sites licensed for Static Content Generation feature, this job detects and outputs static content to one or more target servers. |
Site-specific. See: |
| Server Jobs | ||
| Rebuild Stale Cache |
Detects and regenerates recently viewed expired content on target servers. CommonSpot updates oldest stale cache first.
This task includes a Number of Threads argument for assigning system resources.
For non-Cache Servers, this value defaults to 1 - CommonSpot rebuilds stale cache for no more than one site at any given time.
For Cache Servers, the recommendation for Number of Threads is two times the number of processors. For example, a quad-core server can process stale cache for up to 8 sites simultaneously (or update up to 8 pages simultaneously. |
Run every 2 to 5 minutes on all servers to distribute load.
See:
See also the description and installation instructions for Cache Servers in the Shared Database Configuration Guide and the CommonSpot Performance Guide.. |
| Check Replication | For sites licensed for CommonSpot Replication, detects whether real-time or scheduled replication is required. |
Site-specific. See: |
| Test Server Background Process | Verifies server-level background process scheduling and process execution. Creates log entries. Writes a log entry to verify that the scheduled background process is running. | For internal CommonSpot testing |
| Heartbeat (Cache Server) | Processes remote requests for this server. | CommonSpot attempts to insert this job automatically during Cache Server installation and sets it to run every 2 minutes (starting immediately after install with no end date). Insert this job on all servers at your site. |
| Customer Jobs (runs at the customer level) | ||
| Test Customer Background Process | Verifies customer-level background process and execution. Writes a log entry to verify that the scheduled background process is running. | For internal use |
Related Links
You can download PDF versions of the Content Contributor's, Administrator's, and Elements Reference documents from the support section of paperthin.com (requires login).
For technical support:
The following guides are available locally on your CommonSpot Server: