pstarter

Usage example at http://sibox.isgoodness.com

var pstarter = require('pstarter');

pstarter.startMaster(__dirname + '/config/configs.js', {}, function() {
var config = require('./config/configs.js');
pstarter.statServer(config.http.statPort, config.http.statHost);
if (process.env['NODE_ENV'] && process.env['NODE_ENV'] == 'development') {
pstarter.startWatch(__dirname, [__dirname +'/node_modules'], ['.js', '.json', '.html', '.css']);
}
}).startWorker(function() {
var config = require('./config/configs.js');

var express = require('express');
var bootstrap = require('./app/bootstrap.js');
var app = express.createServer();

bootstrap.setupApp(app, __dirname);
bootstrap.bootstrap(app);
bootstrap.postrun();
app.listen(config.http.port, config.http.ip);
});

Or run separate worker file

$3

var pstarter = require('pstarter');

pstarter.startMaster({}, {exec: './worker.js'});

$3

var pstarter = require('pstarter');
pstarter.startWorker(function() {
console.log('Hello world!');
});

Methods

$3

* confFile - configuration file or object. Only PID_FILE and http.numWorkers are used at the moment
* masterSettings - See http://nodejs.org/api/cluster.html#cluster_cluster_setupmaster_settings
* callback - function which will be called when master has forked workers

$3

* callback - will call when worker has attached listener on exit signal
* cleanupCallback - will call when worker receives exit signal. It pass a function for terminating process (or you can choose to exit).

$3

* root top folder to watch, all subfolder will also be watched
* skipFolders Array of folders you want to skip, absolute path
* exts Array of extension to listen on changes, including "."

$3

* port port to run stat server
* host host to run stat server

Start with init script on Ubuntu

You need to create a symbolic link /etc/init.d/pstarter to pstarter/etc/init.d/pstarter and make pstarter executable.
You need also specify NODE_BIN, SERVER, PID_FILE, AS_USER, NODEJS and NODE_ENV if your application uses it:
* NODE_BIN folder which contains SERVER
* SERVER application/server file to execute
* PID_FILE should be /var/run/pstarter.pid in production linux
* AS_USER the username or uid that you want to run your app (worker) with
* NODEJS executable nodejs
* NODE_ENV for your own application; normally development/production

$3

sudo /etc/init.d/pstarter start

$3

sudo /etc/init.d/pstarter restart

$3

sudo /etc/init.d/pstarter graceful

$3

sudo /etc/init.d/pstarter force-restart

$3

sudo /etc/init.d/pstarter stop

Register init script for startup at reboot in Ubuntu

cd /etc/init.d/
sudo update-rc.d pstarter defaults