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         * In case you use Group permission control, edit jobs/fixupcheck.sh
   6
   7 Make sure you have the submodules checked out:
   8
   9         git submodule update --init
  10
  11 THEN, do
  12
  13         make
  14
  15 which will do some preprocessing in theory.
  16 Now, you can do the installation itself:
  17
  18         make install
  19
  20 will then install Girocco according to Girocco::Config (you might need to be
  21 root, depending on the exact settings).
  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 Girocco is reasonably self-sufficient, but does depend on a few external
  33 programs and libraries:
  34
  35 - darcs, if you want to handle darcs:// mirroring
  36 - python-chardet, if you want to handle non-utf8 darcs imports
  37 - bzr-fastimport, if you want to handle bzr:// mirroring