Tags:
automation2Add my vote for this tag build1Add my vote for this tag create new tag
, view all tags

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.

  1. Set-up a web server. Preferably Apache 2.2.
  2. Install the executer using the Windows installer provided.
  3. Fix the Shebang line in the CGI exestart and exestatus.
  4. Copy the folder c:\executer\cgi-bin\executer to your web server cgi-bin directory.
  5. Set the credentials for accessing your TWiki web site in c:\executer\cfg\executer.cfg.
  6. Set the smtphost in c:\executer\cfg\executer.cfg for SENDMAIL command.
  7. 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:

  1. Disable Windows modal dialog box that can potentially freeze the executer.
  2. Restart your machine if you have updated the MS Windows registry.

Linux executer set-up

  1. Set-up a web server. Preferably Apache 2.2.
  2. Install the zip or tgz provided in your home directory.
  3. Fix the Shebang line in the CGI exestart and exestatus.
  4. Set the credentials for accessing your TWiki web site in ~/executer/cfg/executer.cfg
  5. 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

Author: TWiki:Main/StephaneLenclud
Copyright ©: 2006-2007, Stéphane Lenclud, All Rights Reserved
Contrib Version: 13778 (17 May 2007)
License: GPL (Gnu General Public License)
Change History:  
16 May 2007 Adding support for $taskspecweb, $taskspectopic and SENDMAIL
15 May 2007 Adding support for URLEXISTS, IF, ELSE, ENDIF
14 May 2007 Initial release
Dependencies:
NameVersionDescription
Config::Simple>=latestRequired.
LWP::UserAgent>=latestRequired.
Crypt::SSLeay>=latestRequired only if access TWiki through HTTPS.
Net::SMTP>=latestRequired only if using SENDMAIL command.
Carp>=latestRequired only if using SENDMAIL command.
MIME::Base64>=latestRequired only if using SENDMAIL command.
MIME::Types>=latestRequired only if using SENDMAIL command.
POSIX>=latestRequired only if using SENDMAIL command.

Other dependencies might be added through the Task specification.
Contrib Home: http://twiki.org/cgi-bin/view/Plugins/ExecuterContrib
Feedback: http://twiki.org/cgi-bin/view/Plugins/ExecuterContribDev
Appraisal: http://twiki.org/cgi-bin/view/Plugins/ExecuterContribAppraisal

Topic attachments
I Attachment History Action Size Date Who Comment
Unknown file formatmd5 ExecuterContrib.md5 r10 r9 r8 r7 r6 manage 0.2 K 2008-12-12 - 11:23 SopanShewale checksum file , Uploaded as a part of Release Process
Compressed Zip archivetgz ExecuterContrib.tgz r10 r9 r8 r7 r6 manage 23.2 K 2008-12-12 - 11:23 SopanShewale See ExecuterContrib for details. Untar and run the installer script, Uploaded as a part of Release Process
Compressed Zip archivezip ExecuterContrib.zip r10 r9 r8 r7 r6 manage 29.5 K 2008-12-12 - 11:23 SopanShewale See ExecuterContrib for details. Unzip and run the installer script , Uploaded as a part of Release Process
Unknown file formatEXT ExecuterContrib_installer r5 r4 r3 r2 r1 manage 4.2 K 2008-12-12 - 11:23 SopanShewale Installer Script, Uploaded as a part of Release Process
Unknown file formatmsi ExecuterSetup.msi r3 r2 r1 manage 106.0 K 2007-05-16 - 22:23 StephaneLenclud Windows installer
Edit | Attach | Watch | Print version | History: r7 < r6 < r5 < r4 < r3 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r7 - 2008-12-12 - SopanShewale
 
  • Learn about TWiki  
  • Download TWiki
This site is powered by the TWiki collaboration platform Powered by Perl Hosted by OICcam.com Ideas, requests, problems regarding TWiki? Send feedback. Ask community in the support forum.
Copyright © 1999-2016 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.