summaryrefslogtreecommitdiff
path: root/INSTALLATION
blob: e79cd247580dfef34464e02f54357c2c6a7f6d43 (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
===============================================================================

Dependencies
------------

Perl Modules:

 * File::Touch
 * File::Glob
 * File::Basename
 * MIME::Base64
 * Email::Find

Some of these are distributed with perl itself but is left as an excercise to
the reader to figure out what you need in your distribution (for Debian Etch,
see below).

===============================================================================

Debian Packaging
----------------

For Debian Etch, the following packages will need to be installed:

* perl
* libgetopt-mixed-perl
* libdigest-perl
* libfile-touch-perl
* libfile-slurp-perl
* libclass-accessor-perl
* libdatetime-perl
* libfile-homedir-perl

Out of the box, cil provides two debian directories depending on which version
of Debian you wish to use. Currently, there isn't much difference but choose
which distro you want and link that to 'debian/'. e.g. for Etch, run:

 $ ln -s debian-etch debian

Then inside the main cil directory, you can type the following to create a
Debian paackage:

 $ dpkg-buildpackage -tc -us -uc -rfakeroot

which can then be installed with:

 $ sudo dpkg -i ../cil_0.5.1_all.deb

or added to a repository you are using for easier installation with apt-get or
aptitude.

Then, you can just run 'cil' from the command line.

===============================================================================

Running 'cil' without installing
--------------------------------

The quickest way to start is to 'cd' into the directory you untarred or cloned
the repo into.

 $ cd /path/to/cil/lib
 $ export PERL5LIB=`pwd`

Then you can either run by:

* /path/to/cil/bin/cil init
* export PATH=/path/to/cil/bin:$PATH
* cd ~/bin && ln -s /path/to/cil/bin/cil

===============================================================================

See http://www.chilts.org/projects/cil/ for further information.

===============================================================================