Subsections


Configuration

Common configuration

Section [main]

Variable Information Example
log_cfg config log file (/etc/sched/log.cfg log_cfg=/etc/log.cfg
debug debug log level debug=10

Using log

Sched use Log4perl system (see http://log4perl.sourceforge.net/). You can be interested by following categories :

sched_master module

Permission

The configuration file must be read only by the sched_master user (sched/sched for example). This file contains master password, it must be keep secret from other users (600 mode for example).

Section [master]

Variable Informations Exemple
dsn database string connection dsn=dbname=sched
db_dir directory for reconnection data. db_dir=/path/to/db
master_port master listen port (tcp) master_port=5544
view_passwd sched_view connection password view_passwd=test
user This is used to set the effective user that the master process should run as. After initial program startup and before starting to accept request, master will drop its effective privileges and run as this user. You may specify either a username or a UID. user=nobody
group

This is used to set the effective group that the master process should run as. After initial program startup and before starting to accept request, master will drop its effective privileges and run as this group. You may specify either a groupname or a GID.

group=nogroup

Example

plume:~# cat /etc/sched/master.cfg
[main]
log_cfg=/etc/sched/log.cfg
debug=20

[master]
db_dir=/var/spool/sched
dsn=dbname=sched;user=sched;password=xxx

master_passwd=xxxx
master_port=5544
view_passwd=ce1243c8b432abc494b01ff36ea

sched_view module

Permission

The configuration file must be read only by the http user (www-data/www-data for example). This file contains master password, it must be keep secret from other users (400 mode for example).

Section [cgi]

Variable Informations Example
dsn database string connection dsn=dbname=sched
master_ip master ip address master_ip=127.0.0.1
master_passwd master connection password master_passwd=xxx
master_port master listen port (tcp) master_port=5544

Example

plume:~# cat /etc/sched/cgi.cfg
[main]
log_cfg=/etc/sched/log.cfg
debug=20

[cgi]
dsn=dbname=sched;user=sched;password=xxx
master_ip=localhost
master_passwd=ce1243c8b432abc494b01ff36ea
master_port=5544

sched_job module

Permission

The configuration file must be read by users who are using sched_job (root/sched for example). This file contains master password, it must be keep secret from other users (640 mode for example). A unix group can be defined for this usage.

Section [job]

Variable Information Example
job_dir job storage directory. Job which are in this directory can be launch without specify path. job_dir=/var/spool/sched
work_dir job work directory (stdout, stderr, status file...) work_dir=/var/spool/sched
db_dir directory for reconnection data. db_dir=/path/to/db
master_ip master ip address master_ip=localhost
master_passwd master connection password master_passwd=xxx
master_port master listen port (tcp) master_port=5544
master_retry time between 2 reconnection (sec) master_retry=60
master_read_retry time between 2 forced read master_read_retry=6
master_encrypt this option allows to crypt or not the connection (in case of problem of version) master_encrypt=0
master_compress this option allows to compress or not the connection (in case of problem of version) master_compress=1
master_ping time between 2 ping message. These messages are used to keep connection active and flush waiting messages in the network. master_ping=200
hostname name use with master (default set to hostname) hostname=plume

Example

plume:~# cat /etc/sched/job.cfg
[main]
log_cfg=/etc/sched/log.cfg
debug=20

[job]
work_dir=/var/lib/sched/job/wd
job_dir=/home/eric/travail/sched/src/xml/job
master_ip=localhost
master_port=5544
master_passwd=xxxx
master_retry=2
db_dir=/var/lib/sched/job/db
hostname=plume

sched_slave module

Permission

The slave configuration file must be read by users who are using sched_slave (root/root for example). This file contain master password, it must be keep secret from other users (400 mode for example).

It's possible to use a normal account for this daemon, also you have to setup sudo or super to launch task with other user.

Section [slave]

Variable Information Example
work_dir job work directory (stdout, stderr, status file...) work_dir=/var/spool/sched
db_dir directory for reconnection data. db_dir=/var/lib/sched/sl/db
master_ip master ip address master_ip=localhost
master_passwd master connection password master_passwd=xxx
master_port master listen port (tcp) master_port=5544
master_retry time between 2 reconnection (sec) master_retry=60
master_read_retry time between 2 forced read master_read_retry=6
master_ping time between 2 ping message. These messages are used to keep connection active and flush waiting messages in the network. master_ping=200
hostname name use with master (default set to hostname) hostname=plume

Example

plume:~# cat /etc/sched/slave.cfg
[main]
log_cfg=/etc/sched/log.cfg
debug=20

[slave]
master_ip=localhost
master_port=5544
master_passwd=xxxx
master_retry=10
work_dir=/var/lib/sched/job/wd
db_dir=/var/lib/sched/slave/db
hostname=plume2

sched_xfer module

This section must be placed in slave.cfg file.

Section [xfer]

Variable Informations Exemple
xfer_inet inet interface used (0.0.0.0 for all) xfer_inet=10.2.3.6
xfer_port xfer listen port (tcp) xfer_port=8081
xfer_user This is used to set the effective user that the xfer process should run as. After initial program startup and before starting to accept request, xfer will drop its effective privileges and run as this user. You may specify either a username or a UID. xfer_user=nobody
xfer_group

This is used to set the effective group that the xfer process should run as. After initial program startup and before starting to accept request, xfer will drop its effective privileges and run as this group. You may specify either a groupname or a GID. (this group must be able to read files under [slave]/work_dir)

xfer_group=sched

Exemple

plume:~# cat /etc/sched/slave.cfg
[main]
log_cfg=/etc/sched/log.cfg
debug=20

[slave]
master_ip=localhost
master_port=5544
master_passwd=xxxx
master_retry=10
work_dir=/var/lib/sched/job/wd
db_dir=/var/lib/sched/slave/db
hostname=plume2

[xfer]
xfer_inet = 0.0.0.0
xfer_port = 8081
xfer_user = nobody
xfer_group = sched

Eric 2005-12-17