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
106
107
108
109
110
|
Run Deb-o-Matic
===============
Launch Deb-o-Matic
------------------
Deb-o-Matic needs root privileges to be executed, otherwise it refuses to
start. In order to launch it, you can use the following command:
*sudo debomatic -c debomatic.conf*
with ``debomatic.conf`` being the configuration file as described in the
:doc:`configuration` section. Make sure this file exists, otherwise Deb-o-Matic
will refuse to start.
Interactive mode
................
Deb-o-Matic will try to enter daemon mode automatically. If that is not
possible, Deb-o-Matic will be executed in interactive mode, and will be bound
to the shell that executed it, as a regular process.
It is also possible to force interactive mode by passing ``-i`` or
``--interactive`` option while invoking ``debomatic`` command:
*sudo debomatic -c debomatic.conf -i*
This is particularly useful for debugging purposes.
Oneshot mode
............
Deb-o-Matic will try to build all files found in the ``incoming`` directory.
Alternatively, it is possible to attempt to build a single file by passing
``-o`` or ``--oneshot`` option while invoking ``debomatic`` command, following
by the file name of the package to build, which must be located in the
``incoming`` directory:
*sudo debomatic -c debomatic.conf -o package_version_source.changes*
Stop Deb-o-Matic
----------------
In order to stop Deb-o-Matic, you should pass ``-q`` or ``--quit`` option to
``debomatic``:
*sudo debomatic -c debomatic.conf -q*
Deb-o-Matic will not terminate child processes immediately, but will wait for
them to end first, so it could take a while to completely stop a Deb-o-Matic
instance.
.. CAUTION::
Deb-o-Matic uses a rather strong locking mechanism, so it is not recommended
to terminate debomatic process with ``kill`` command.
Using service command
---------------------
If you installed Deb-o-Matic using Debian package, you could start, stop, and
restart Deb-o-Matic with the following commands, respectively:
*sudo service debomatic start*
*sudo service debomatic stop*
*sudo service debomatic restart*
You will need to adjust configuration stored in ``/etc/default/debomatic`` file
to manage Deb-o-Matic with this method, though. In particular, you will have to
set ``DEBOMATIC_AUTOSTART`` variable to 1.
Service configuration
.....................
In order to start Deb-o-Matic with ``service`` command, you must adjust some
parameters defined in ``/etc/default/debomatic`` file.
* ``DEBOMATIC_AUTOSTART``
This option indicates whether to execute Deb-o-Matic at system boot. Default
value is set to ``0`` to avoid accidental executions without a sane
configuration. It must be set to ``1`` in order to launch Deb-o-Matic.
* ``DEBOMATIC_CONFIG_FILE``
This option indicates the configuration file Deb-o-Matic is going to use.
* ``DEBOMATIC_OPTS``
This option allows to pass extra options to Deb-o-Matic.
Using systemctl command
-----------------------
If you installed Deb-o-Matic using Debian package, and your system does use of
systemd as default init, you could start, stop, and restart Deb-o-Matic with
the following commands, respectively:
*sudo systemctl start debomatic*
*sudo systemctl stop debomatic*
*sudo systemctl restart debomatic*
systemd unit file is configured to look for ``/etc/debomatic/debomatic.conf``
as its default configuration file. You can change this path by providing a
systemd override file.
|
