3
Table Of Contents
- Distributed Processing Setup
- Contents
- Introduction to DistributedProcessing
- Getting Started Quickly
- Preparing a Network forDistributed Processing
- The Interfaces
- Creating and AdministeringClusters
- An Overview of Configuring a Cluster
- Configuring Service Nodes and Cluster Controllers
- Creating Clusters with AppleQadministrator
- About QuickClusters
- Advanced Settings in the AppleQmaster Preferences Pane
- Modifying and Deleting Clusters With AppleQadministrator
- Monitoring Cluster Activity
- Accessing Activity Logs
- Setting Cluster Preferences
- Setting Passwords and Scratch Storage
- Recovery and Failure Notification Features
- Command-Line Usage
- Installing AppleQmaster from the Command Line
- Shell Commands for Configuring Service Nodes and Cluster Controllers
- Shell Commands for Submitting Compressor Jobs
- Shell Commands for Submitting AppleQmaster Jobs
- Shell Commands for Monitoring Batches
- Using Scripts to Run AppleQmaster, Compressor, and BatchMonitor
- Troubleshooting
- Index
66 Chapter 4
Creating and Administering Clusters
If a batch fails
When the service is running, but one batch fails to process, a
service exception occurs.
When this happens, the cluster controller resubmits the batch immediately. It resubmits
the batch a maximum of two times. If the job fails on the third submission, the
distributed processing system stops resubmitting the job. In the Batch Monitor, the job
is moved to the History table, where the status column indicates that a failure occurred.
Failure Notification
There are two different ways that the Apple Qmaster distributed processing system can
provide information about a problem.
Email Notification
When a processing service stops unexpectedly, Apple Qmaster sends a notification
email to the address that was entered in the Apple Qadministrator Cluster Preferences
dialog for that cluster. If no address was entered there, the email is sent to the address
in the Internet settings of the computer on which the cluster controller is enabled.
Note:
Apple Qmaster does not currently support SMTP servers that require authentication.
Log files for individual jobs or batches
If a particular job or batch fails, a log file is generated that describes this failure. You can
find the name and location of this log file through the Batch Monitor. Select the batch
or job in the History table of the Batch Monitor window, and click the Info icon. If any
log files were generated because of failures in the processing of the item, the names
and locations of those logs are shown.
Notification and Log Labels
The following table lists the service labels used in the email notifications and logs:
Processing service type Notification label
Local Compressor service servicecontroller:com.apple.stomp.transcoder
Distributed Compressor service servicecontroller:com.apple.stomp.transcoderx
Distributed Apple Qmaster
service
servicecontroller:com.apple.qmaster.executor