editproj.cgi: actually initiate a restart when selected
[girocco.git] / INSTALL
1 FIRST, you need to configure Girocco:
2         * Edit Girocco/Config.pm
3         * Alternatively to above, copy over to and edit Girocc/Config2.pm and
4           run make and make install with GIROCCO_CONF=Girocco::Config2
5
6 Make sure you have the submodules checked out:
7
8         git submodule update --init
9
10 THEN, do
11
12         make
13
14 which will do some preprocessing in theory.
15 Now, you can do the installation itself:
16
17         make install
18
19 will then install Girocco according to Girocco::Config (you might need to be
20 root, depending on the exact settings).  Note that make needs to be GNU make
21 so adjust as needed (e.g. on some systems GNU make is gmake).
22
23 If you use the mirror mode or want to use the push notifications, you must
24 make sure taskd.pl is kept running.
25
26 At any rate, you will need to periodically call jobd maintenance job that
27 will refresh mirrored repositories, but also repack all repositories. You
28 can either just keep jobd.sh running (good if you have large amount
29 of repositories), or add a special invocation (advised by make install)
30 to your crontab.
31
32 The cron, fstab, rsyslog, screen and xinetd directories contain README files
33 and sample configuration files to help configure the system for Girocco.
34
35 Girocco is reasonably self-sufficient, but does depend on a few external
36 programs and libraries:
37
38 - darcs, if you want to handle darcs:// mirroring
39 - python-chardet, if you want to handle non-utf8 darcs imports
40 - bzr-fastimport, if you want to handle bzr:// mirroring