|  | @@ -0,0 +1,44 @@
 | 
	
		
			
				|  |  | +# Tripal Daemon
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +This module is meant to provide a simple means of creating a robust
 | 
	
		
			
				|  |  | +command-line-driven, fully bootstrapped PHP Daemon. It uses the PHP-Daemon
 | 
	
		
			
				|  |  | +(https://github.com/shaneharter/PHP-Daemon) Library to create the Daemon (via
 | 
	
		
			
				|  |  | +the Libraries API) in order to not re-invent the wheel ;-).
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +## FEATURES
 | 
	
		
			
				|  |  | +* Provides a Drush interface to start/stop your Daemon.
 | 
	
		
			
				|  |  | +* Your daemon starts in the background and is detached from the current
 | 
	
		
			
				|  |  | +   terminal.
 | 
	
		
			
				|  |  | +* Daemon will run all Tripal Jobs submitted within 20 seconds.
 | 
	
		
			
				|  |  | +* A log including the number of jobs executed, their identifiers and results.
 | 
	
		
			
				|  |  | +* Lock Files, Automatic restart (8hrs default) and Built-in Signal Handling &
 | 
	
		
			
				|  |  | +   Event Logging are only a few of the features provided by the Daemon API
 | 
	
		
			
				|  |  | +   making this a fully featured & robust Daemon.
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +## REQUIREMENTS
 | 
	
		
			
				|  |  | +* Libraries API (https://www.drupal.org/project/libraries)
 | 
	
		
			
				|  |  | +* PHP-Daemon Library version 2.0 (https://github.com/shaneharter/PHP-Daemon)
 | 
	
		
			
				|  |  | +* Drush 5.x (https://github.com/drush-ops/drush)
 | 
	
		
			
				|  |  | +* Drush Daemon API (https://www.drupal.org/project/drushd)
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +## INSTALLATION
 | 
	
		
			
				|  |  | +* Install all required modules as per their instructions.
 | 
	
		
			
				|  |  | +* Install this module as you would normally install a contributed drupal
 | 
	
		
			
				|  |  | +   module. See:https://drupal.org/documentation/install/modules-themes/modules-7
 | 
	
		
			
				|  |  | +   for further information.
 | 
	
		
			
				|  |  | +* Download the PHP-Daemon Library and extract it in your sites/all/libraries
 | 
	
		
			
				|  |  | +   directory. The folder must be named "PHP-Daemon".
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +## TRIPAL DAEMON USAGE
 | 
	
		
			
				|  |  | +* Start Daemon
 | 
	
		
			
				|  |  | +    drush trpjob-daemon start
 | 
	
		
			
				|  |  | +* Stop Daemon
 | 
	
		
			
				|  |  | +    drush trpjob-daemon stop
 | 
	
		
			
				|  |  | +* Check the Status
 | 
	
		
			
				|  |  | +    drush trpjob-daemon status
 | 
	
		
			
				|  |  | +* Show the Log
 | 
	
		
			
				|  |  | +   * List the last 10 lines of the log file:
 | 
	
		
			
				|  |  | +      drush trpjob-daemon show-log
 | 
	
		
			
				|  |  | +   * List the last N lines of the log file:
 | 
	
		
			
				|  |  | +      drush trpjob-daemon show-log --num_lines=N
 |