Task Executer
Scripts running on a remote machine and executing tasks as defined by
TaskExeContrib.
Purpose & scope
The task executer is running on a remote machine executing a task. It is a key concept of the
TaskExeContrib.
Here we describe how to set-up and use an executer machine. We also provide technical information about the executer implementation.
Installation instructions
DO NOT install on a TWiki server.
The task executer is typically set-up on a remote machine where it runs as a
Linux service or
Windows service.
MS Windows executer set-up
In the following set-up instructions paths and command lines are given as examples and should be altered according to your machine settings.
- Set-up a web server. Preferably Apache 2.2.
- Install the executer using the Windows installer provided.
- Fix the Shebang line in the CGI
exestart
and exestatus
.
- Copy the folder
c:\executer\cgi-bin\executer
to your web server cgi-bin
directory.
- Set the credentials for accessing your TWiki web site in
c:\executer\cfg\executer.cfg
.
- Set the
smtphost
in c:\executer\cfg\executer.cfg
for SENDMAIL
command.
- Run the Executer:
- In a console:
- Open a console. Go to
c:\executer\bin\executer
and run perl executer.pl
.
- As a Windows service:
- You can use ExeService to set it up for you.
- Double check the service's Log On information. Maybe you want to use specific user to gain write access to your TWiki pages.
Note: When using MS Windows operating system as a build server you may want to prevent long running process to freeze on a dialog box:
- Disable Windows modal dialog box that can potentially freeze the executer.
- Restart your machine if you have updated the MS Windows registry.
Linux executer set-up
- Set-up a web server. Preferably Apache 2.2.
- Install the
zip
or tgz
provided in your home directory.
- Fix the Shebang line in the CGI
exestart
and exestatus
.
- Set the credentials for accessing your TWiki web site in
~/executer/cfg/executer.cfg
- Run the executer:
- In a console:
- Open a console. Go to
~/executer/bin/executer
and run perl executer.pl
.
Executer registration
Once your machine is set-up
register your executer.
Executer troubleshooting
If you are experiencing problems with an Executer you should:
- Check login/password in
executer.cfg
- Check login/password of the Executer Windows service
- Delete files in
c:\executer
. DO NOT delete the directories in c:\executer
.
- Try to run it in console instead of Windows service
System documentation
\lib\Slion\bin\executer.pl - Infinite loop using Slion::TWiki::Executer and waiting for task request from web server.
\lib\Slion\TWiki\Executer.pm - Sub class Slion::TWiki::Client adding functionalities for parsing a Task topic and and executing Commands
\lib\Slion\TWiki\Client.pm - Provides API for reading and writing topics from a TWiki web site
\cgi-bin\executer\exestatus - CGI, output some Javascript for automatic status update from web page.
\cgi-bin\executer\exestart - CGI, used to trigger a
Task.
Package content
File: |
Description: |
data/TWiki/ExecuterContrib.txt |
Documentation |
executer/lib/Slion/TWiki/Client.pm |
Perl module |
executer/lib/Slion/TWiki/Executer.pm |
Perl module |
executer/lib/Slion/Email.pm |
Perl module |
executer/lib/TWiki/Func.pm |
Perl module |
executer/lib/TWiki/Attrs.pm |
Perl module |
executer/bin/executer.pl |
Perl script |
executer/cfg/executer.cfg |
Configuration file |
executer/cgi-bin/executer/exestart |
Perl cgi |
executer/cgi-bin/executer/exestatus |
Perl cgi |
Contrib Info