Managing and Monitoring Scheduled Tasks

The manage-tasks utility can be used to obtain a list of scheduled tasks, to display task status, and to cancel scheduled tasks. The following procedures provide examples of managing scheduled tasks. For more information, see manage-tasks in Sun OpenDS Standard Edition 2.0 Command-Line Usage Guide.

To Obtain Information About Scheduled Tasks

1. Display a summary of all scheduled tasks.

   $ manage-tasks -D "cn=directory manager" -w password -n -s
   ID                Type    Status
   ------------------------------------------------
   2008100912550010  Backup  Completed successfully
   2008100912554710  Backup  Completed successfully
   2008100912560510  Backup  Waiting on start time
   2008100912561410  Backup  Waiting on start time

2. Display additional information on a particular task, specified by its task ID.

   $ manage-tasks -D "cn=directory manager" -w password -n -i 2008100912550010
   
   Task Details
   ------------------------------------------------------
   ID                        2008100912550010
   Type                      Backup
   Status                    Completed successfully
   Scheduled Start Time      Immediate execution
   Actual Start Time         Oct 9, 2008 12:55:00 PM SAST
   Completion Time           Oct 9, 2008 12:55:01 PM SAST
   Dependencies              None
   Failed Dependency Action  None
   Email Upon Completion     None Specified
   Email Upon Error          None Specified
   
   Backup Options
   ----------------------------
   Backup All        true
   Backup Directory  ../backups
   
   Last Log Message
   ------------------------------------------------------------------------------
   [09/Oct/2008:12:55:01 +0200] severity="NOTICE" msgCount=4 msgID=10944795
   message="The backup process completed successfully"

To Cancel a Scheduled Task

• Run the manage-tasks utility with the -c or --cancel option.

  The following command cancels a particular task, specified by its task ID:

  $ manage-tasks -D "cn=directory manager" -w password -n -c 2008100912561410

To Cancel a Recurring Task

You can cancel an entire recurring task, in which case both the recurring task and its next scheduled iteration are canceled. Alternatively, you can cancel only the next scheduled task iteration, in which case future recurring task iterations will be spawned by the task scheduler.

1. Use the manage-tasks command to display the summary of scheduled tasks.

   $ manage-tasks -D "cn=directory manager" -w password -n -s
   
    ID                                             Type    Status
    
   ----------------------------------------------------------------------------
    Hourly Backup                                  Backup  Recurring
    Hourly Backup - Wed Jan 14 13:00:00 SAST 2009  Backup  Waiting on start time

2. Run the manage-tasks utility with the -c or --cancel option.
   • Cancel the entire recurring task by specifying its task ID.

     $ manage-tasks -D "cn=directory manager" -w password -n -c "Hourly Backup"
     Task Hourly Backup canceled

   • Cancel the next scheduled task by specifying its task ID.

     $ manage-tasks -D "cn=directory manager" -w password -n \
       -c "Hourly Backup - Wed Jan 14 13:00:00 SAST 2009 "
     Task Hourly Backup - Wed Jan 14 13:00:00 SAST 2009  canceled