summaryrefslogtreecommitdiff
path: root/mans/iceccd.1
blob: 1a517890d1f8631bec6238fd9db654a8e871ad4e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
.\"Generated by db2man.xsl. Don't modify this, modify the source.
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "ICECREAM DAEMON" 1 "April 21th, 2005" "Icecream" "Icecream User's Manual"
.SH NAME
iceccd \- Icecream daemon
.SH "SYNOPSIS"
.ad l
.hy 0
.HP 7
\fBiceccd\fR [\fB\-n\ \fInetname\fR\fR] [\fB\-m\ \fImax_processes\fR\fR] [\fB\-\-no\-remote\fR] [\fB\-w\fR] [\fB\fB\-d\fR\fR | \fB\fB\-\-daemonize\fR\fR] [\fB\-l\ \fIlogfile\fR\fR] [\fB\-s\ \fIschedulerhost\fR\fR] [\-v\ [v\ [v]]] [\fB\fB\-r\fR\fR | \fB\fB\-\-run\-as\-user\fR\fR] [\fB\-b\ \fIenv\-basedir\fR\fR] [\fB\fB\-u\fR\fR | \fB\fB\-\-nobody\-uid\fR\fR\fI nobodyuid\fR] [\fB\-\-cache\-limit\ \fIMB\fR\fR] [\fB\-N\ \fIhostname\fR\fR]
.ad
.hy

.SH "DESCRIPTION"

.PP
The Icecream daemon has to run on all nodes being part of the Icecream compile cluster\&. It receives compile jobs and executes them in a chroot environment\&. The compile clients send their compile environment the first time they send a job to a particular daemon, so that the environment of the daemon doesn't have to match the one of the client\&.

.PP
The daemon also has to run on clients sending compile jobs to the Icecream network\&. If a node should be able to send compile jobs, but never receive any, start the daemon with the option \-m 0\&.

.PP
All Icecream daemons need to have contact to the Icecream scheduler which controls the distribution of data between compile nodes\&. Normally the daemon will automatically find the right scheduler\&. If this is not the case you can explicitly specify the name of the Icecream network and the host running the scheduler\&.

.SH "OPTIONS"

.TP
\fB\-n\fR \fInetname\fR
The name of the icecream network the daemon should connect to\&. There has to be a scheduler running for the network under the same network name\&.

.TP
\fB\-m\fR \fImax_processes\fR
Maximum number of compile jobs started in parallel on machine running the daemon\&.

.TP
\fB\-\-no\-remote\fR
Prevents jobs from other nodes being scheduled on this one\&.

.TP
\fB\-w\fR


.TP
\fB\-d\fR, \fB\-\-daemonize\fR
Detach daemon from shell\&.

.TP
\fB\-l\fR \fIlogfile\fR
Name of file where log output is written to\&.

.TP
\fB\-s\fR \fIscheduler_host\fR
Name of host running the scheduler for the network the daemon should connect to\&. This option might help if the scheduler can't broadcast its presence to the clients due to firewall settings or similar reasons\&.

.TP
\fB\-v\fR, \fB\-vv\fR, \fB\-vvv\fR
Control verbosity of daemon\&. The more v the more verbose\&.

.TP
\fB\-r\fR, \fB\-\-run\-as\-user\fR
Force running the daemon with user rights\&. Usually you will need to run the daemon with root rights\&.

.TP
\fB\-b\fR \fIenv_basedir\fR
Base directory for storing compile environments sent to the daemon by the compile clients\&.

.TP
\fB\-u\fR, \fB\-\-nobody\-uid\fR \fInobodyuid\fR
Id of user nobody\&. This user id is used when the daemon is dropping privileges\&.

.TP
\fB\-\-cache\-limit\fR \fIMB\fR
Maximum size in Mega Bytes of cache used to store compile environments of compile clients\&.

.TP
\fB\-N\fR \fIhostname\fR
The name of the icecream host on the network\&.

.SH "SEE ALSO"

.PP
icecream, scheduler, iceccd, icemon

.SH "AUTHOR"

.PP
Cornelius Schumacher