lunch

= Lunch = {{{
#!html
}}}
Lunch is a distributed process starter and manager for GNU/Linux. It might also work under other operating systems when they have a X terminal application and the python and bash interpreters. SSH needs to be installed as well. * The first step is to configure your SSH client. The steps to manage ssh keys are in the SshKeysManagement page. * Next, download and install lunch on every computer.

= Download =
Here is the package of the latest stable release: (recommended) * http://svn.sat.qc.ca/trac/lunch/raw-attachment/wiki/WikiStart/lunch_0.1.7_all.deb

Here is a package of the latest development version: (experimental) * http://svn.sat.qc.ca/trac/lunch/raw-attachment/wiki/WikiStart/lunch_0.2.1_all.deb

If you had previously installed Lunch using the Makefile, you might need to do this : {{{
sudo rm -f /usr/local/bin/lunch
sudo rm -f /usr/local/share/man/man1/lunch.1
sudo rm -f /usr/local/share/applications/lunch.desktop
sudo rm -f /usr/local/share/icons/lunch.svg
sudo rm -f /usr/local/share/icons/lunch.png
sudo rm -f /usr/local/share/pixmaps/lunch.png
}}}

= Learn More = * See the RoadMap to see what is coming. * Please add tickets to warn us about bugs and ask for features. * If you are curious, the ReleaseProcess page has details on how we package the application. * In a latter version, a UserInterface is planned.

Here is a process tree created with lunch 0.1 : {{{
xterm───bash───python─┬─python───sh───xterm───python───sh───xeyes
└─python───sh───xterm───python───sh───xeyes
}}}
Here is a process tree created with lunch 0.2 : {{{
xterm───bash───python─┬─python───xeyes
└─python───xeyes
}}}

= How-to =
Dependencies
It uses ssh, xterm and the multiprocessing and subprocess python modules. Python2.4 or later is needed for subprocess. {{{
sudo apt-get install openssh-client openssh-server python-setuptools mercurial
}}} {{{
sudo easy_install --prefix=/usr/local multiprocessing
}}}
(there might be a python-multiprocessing package if you use a newer Ubuntu or Debian) We will drop multiprocessing in version 0.2.

Installation
Checkout the latest version from the repository. {{{
mkdir -p ~/src
cd ~/src
hg clone https://svn.sat.qc.ca/hg/lunch
cd lunch
}}}

Install lunch to /usr/local/bin/lunch on both local and remote hosts. (type your password) {{{
sudo make install
}}}
There should be a Lunch icon in the Application/Other Gnome menu.

Try it out
Copy the "config-sample" example config file to the local ~/.lunchrc. Edit the configuration file to suit your needs. {{{
cp doc/examples/config-sample ~/.lunchrc
edit ~/.lunchrc
}}}

Start the lunch master:: {{{
lunch
}}}

Usage details
A remote lunch as a slave is started this way/ {{{
lunch -s -c "xlogo"
lunch -s -c "xdg-open /usr/local/share/icons/Lunch.svg"
}}}
How to customize your lunch file
The ~/.lunchrc file is written in Python and the only function needed is add_command. Here are some examples:: {{{
add_command(command="xlogo", env={}, title="xlogo")
add_command(command="mplayer /usr/share/example-content/Ubuntu_Free_Culture_Showcase/StopMotionUbuntu.ogv", env={}, title="mplayer")
}}}
Setting the user and host arguments make it be issued through SSH to a remote host:: {{{
add_command(command="xlogo", env={"DISPLAY":":0.0"}, user=_user, host="example.org", title="remote_xlogo")
}}}
Here is a Lunch config file for miville. Note that the sleep attribute is for processes AFTER which we need to wait. {{{
add_command("/home/aalex/src/miville/branches/services/py/mivilled -o 0", title="miville un", priority=1, sleep=1)
add_command("/home/aalex/src/miville/branches/services/py/mivilled -o 1", title="miville deux", priority=1, sleep=1)
add_command("telnet localhost 14444", title="miville un", priority=2)
add_command("telnet localhost 14445", title="miville deux", priority=2)
}}}

= LICENSE = {{{
Lunch
Copyright (C) 2008 Société des arts technologiques (SAT)
http://www.sat.qc.ca
All rights reserved.

This file is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 2 of the License, or
(at your option) any later version.

Lunch is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with Lunch. If not, see <http://www.gnu.org/licenses/>.
}}}

= IMAGES =
The source of Lunch's icon is http://commons.wikimedia.org/wiki/File:Fruit-cherries.svg and is in the public domain. Thank you Rocket000 !