Supervisor User's Guide
     Next

Supervisor User's Guide

Version 3.0a4

Chris McDonough

Agendaless Consulting, Inc. (http://agendaless.com)

Mike Naberezny

Maintainable Software, LLC. (http://maintainable.com)

Copyright © 2006-2008 Agendaless Consulting and Contributors

2008-03-12

Table of Contents

1. Using Supervisor
1.1. Introduction
1.1.1. Overview
1.1.2. Supervisor Components
1.1.3. Platform Requirements
1.2. Installing
1.2.1. Installing To A System With Internet Access
1.2.2. Installing To A System Without Internet Access
1.2.3. Creating A Configuration File
1.3. Running Supervisor
1.3.1. Adding a Program
1.3.2. Running Supervisord
1.3.3. Running Supervisorctl
1.3.4. Signals
1.3.5. Runtime Security
1.4. Configuration File Syntax and Semantics
1.4.1. [unix_http_server] Section Settings
1.4.2. [inet_http_server] Section Settings
1.4.3. [supervisord] Section Settings
1.4.4. [supervisorctl] Section Settings
1.4.5. [program:x] Section Settings
1.4.6. [include] Section Settings
1.4.7. [group:x] Section Settings
1.4.8. [eventlister:x] Section Settings
1.4.9. [rpcinterface:x] Section Settings
1.5. Subprocesses
1.5.1. Nondaemonizing of Subprocesses
1.5.2. pidproxy Program
1.5.3. Subprocess Environment
1.5.4. Process States
1.6. Logging
1.6.1. Activity Log
1.6.2. Child Process Logs
1.7. Events
1.7.1. Event Listeners and Event Notifications
1.7.2. Configuring an Event Listener
1.7.3. Writing an Event Listener
1.7.4. Event Types
1.8. Extending Supervisor's XML-RPC API
1.8.1. Configuring XML-RPC Interface Factories
1.9. memmon Memory Monitor Event Listener
1.9.1. Description
1.9.2. The memmon Command
1.9.3. Configuring Memmon Into the Supervisor Config
1.10. Upgrading From Older Releases
1.10.1. Upgrading from Supervisor 2 to Supervisor 3
1.11. Frequently Asked Questions
1.12. Development of Supervisor
1.12.1. Development Resources
1.12.2. Contributing
1.12.3. Sponsoring
1.12.4. Author Information
2. XML-RPC API Reference
2.1. Status & Control
2.1.1. supervisor.getAPIVersion()
2.1.2. supervisor.getSupervisorVersion()
2.1.3. supervisor.getIdentification()
2.1.4. supervisor.getState()
2.1.5. supervisor.readLog()
2.1.6. supervisor.clearLog()
2.1.7. supervisor.shutdown()
2.1.8. supervisor.restart()
2.2. Process Control
2.2.1. supervisor.getProcessInfo()
2.2.2. supervisor.getAllProcessInfo()
2.2.3. supervisor.startProcess()
2.2.4. supervisor.stopProcessGroup()
2.2.5. supervisor.stopProcess()
2.2.6. supervisor.stopAllProcesses()
2.2.7. supervisor.sendProcessStdin()
2.3. Process Logging
2.3.1. supervisor.readProcessStdoutLog()
2.3.2. supervisor.readProcessStderrLog()
2.3.3. supervisor.clearProcessLogs()
2.3.4. supervisor.clearAllProcessLogs()
2.4. Fault Codes
Index

List of Figures

1.1. Subprocess State Transition Graph

List of Tables

1.1. supervisord Command-Line Options
1.2. Signal Handlers
1.3. [unix_http_server] Section Values
1.4. [inet_http_server] Section Values
1.5. [supervisord] Section Values
1.6. [supervisorctl] Section Values
1.7. [program:x] Section Values
1.8. [include] Section Values
1.9. [group:x] Section Values
1.10. [rpcinterface:x] Section Values
1.11. Process States
1.12. Activity Log Levels
1.13. Header Tokens
1.14. Event Listener States
1.15. EVENT Event Type
1.16. PROCESS_STATE Event Type
1.17. PROCESS_STATE_STARTING Event Type
1.18. PROCESS_STATE_RUNNING Event Type
1.19. PROCESS_STATE_BACKOFF Event Type
1.20. PROCESS_STATE_STOPPING Event Type
1.21. PROCESS_STATE_EXITED Event Type
1.22. PROCESS_STATE_STOPPED Event Type
1.23. PROCESS_STATE_FATAL Event Type
1.24. PROCESS_STATE_UNKNOWN Event Type
1.25. PROCESS_COMMUNICATION Event Type
1.26. PROCESS_COMMUNICATION_STDOUT Event Type
1.27. PROCESS_COMMUNICATION_STDERR Event Type
1.28. SUPERVISOR_STATE_CHANGE Event Type
1.29. SUPERVISOR_STATE_CHANGE_RUNNING Event Type
1.30. SUPERVISOR_STATE_CHANGE_STOPPING Event Type
1.31. TICK Event Type
1.32. TICK_5 Event Type
1.33. TICK_60 Event Type
1.34. TICK_3600 Event Type
1.35. memmon Command-Line Options
1.36.
2.1. supervisor.getAPIVersion() Parameters
2.2. supervisor.getAPIVersion() Return Value
2.3. supervisor.getSupervisorVersion() Parameters
2.4. supervisor.getSupervisorVersion() Return Value
2.5. supervisor.getIdentification() Parameters
2.6. supervisor.getIdentification() Return Value
2.7. supervisor.getState() Parameters
2.8. supervisor.getState() Return Value
2.9. supervisor.getState() State Codes
2.10. supervisor.readLog() Parameters
2.11. supervisor.readLog() Return Value
2.12. supervisor.readLog() Offset and Length
2.13. supervisor.clearLog() Parameters
2.14. supervisor.clearLog() Return Value
2.15. supervisor.shutdown() Parameters
2.16. supervisor.shutdown() Return Value
2.17. supervisor.restart() Parameters
2.18. supervisor.restart() Return Value
2.19. supervisor.getProcessInfo() Parameters
2.20. supervisor.getProcessInfo() Return Value
2.21. supervisor.getAllProcessInfo() Parameters
2.22. supervisor.getAllProcessInfo() Return Value
2.23. supervisor.startProcess() Parameters
2.24. supervisor.startProcess() Return Value
2.25. supervisor.stopProcessGroup() Parameters
2.26. supervisor.stopProcessGroup() Return Value
2.27. supervisor.stopProcess() Parameters
2.28. supervisor.stopProcess() Return Value
2.29. supervisor.stopAllProcesses() Parameters
2.30. supervisor.stopAllProcesses() Return Value
2.31. supervisor.sendProcessStdin() Parameters
2.32. supervisor.sendProcessStdin() Return Value
2.33. supervisor.readProcessStdoutLog() Parameters
2.34. supervisor.readProcessStdoutLog() Return Value
2.35. supervisor.readProcessLog() Offset and Length
2.36. supervisor.clearProcessLogs() Parameters
2.37. supervisor.clearProcessLogs() Return Value
2.38. supervisor.clearAllProcessLogs() Parameters
2.39. supervisor.clearProcessLogs() Return Value
2.40. Supervisor Fault Codes

List of Examples

1.1. [unix_http_server] Section Example
1.2. [inet_http_server] Section Example
1.3. [supervisord]Section Example
1.4. [supervisorctl]Section Example
1.5. [program:x] Section Example
1.6. [include] Section Example
1.7. [group:x] Section Example
1.8. [eventlistener:x] Section Example
1.9. [rpcinterface:x] Section Example
1.10. Sample Activity Log Output
1.11. memmon Example Configuration 1
1.12. memmon Example Configuration 2
1.13. memmon Example Configuration 3
     Next
     Chapter 1. Using Supervisor