1Documentation contributed by Tom van der Geer
2=============================================
3
4Most of this installation instruction is basic CPAN shell installation
5practice, but hey... If you think you don't need it, don't read it :o)
6
7
8A) Install required OS libraries (make sure you have a working
9development environment: make, gcc, etc.)
10
11Download latest SSL library (www.openssl.org), unpack, build and install
12
13B) Install Net::DRI dependencies
14
151. open the CPAN shell:
16    perl -MCPAN -e shell
17
18If this is the first time, it will run the CPAN shell setup procedure.
19You can usually get away by accepting all the default values. Be aware
20that it should find most of the required binaries (tar, make, wget, etc.)
21
222. On the CPAN shell commandline install the dependencies which are
23listed in the README of the Net::DRI tarbal. Just type:
24
25install <module name>
26
27<module name> in this case can be e.g. DateTime (mind lower- and
28uppercase characters) It can also be a 'sub'-module like SOAP::Lite
29(also include the '::'!)
30
31Whenever you install a module that is listed as dependency in the README
32it might depend on other modules as well. This will typically look
33something like:
34
35---- Unsatisfied dependencies detected during
36[J/JH/JHOBLITT/DateTime-Format-ISO8601-0.0403.tar.gz] -----
37     DateTime::Format::Builder
38Shall I follow them and prepend them to the queue
39of modules we are processing right now? [yes]
40
41Just accept prepending them to the queue. (default)
42
43
44My experience was that not all dependencies are properly detected like
45the example above. This can lead to those nasty errors during the
46test-phase of a module installation. E.g. during the installation of
47DateTime:
48
49t/07compare.............ok 17/26Can't locate Class/Singleton.pm in @INC
50
51The way I deal with them is:
52Scroll back in the modules testing log and locate the missing module. In
53this case "Class/Singleton.pm" which is part of module Class::Singleton.
54(not hard to figure that out, right?)
55Now first do:
56install Class::Singleton
57
58and after you've succesfuly installed this missing module, you can
59resume installing the module you wanted to install. In this case just
60type the installation line again:
61
62install DateTime
63
64NOTE. I found during the installtion of the Net::DRI dependency modules
65that I needed to additionally install the following modules. (yes,
66that's on top of all the official dependencies listed):
67
68File::Find::Rule
69Test::Pod
70Class::Singleton
71Net::SSLeay
72MIME::Parser
73
74So you might want to install these "just in case" before you run into
75errors. It won't harm your system if you do this without ever needing them.
76
77As a last resort, when there seem to be no more missing dependencies but
78the test still lists errors, you might choose to do a 'forced' install:
79
80force install SOAP::Lite
81
82Only do this when you made sure there are no missing dependencies!
83(Uhum.... I had to do this for one or two modules..... But hey, it works
84now)
85
86C) Install the Net::DRI module
87
88Finally we can install Net::DRI smoothly:
89
90install Net::DRI
91
92If the installation exits with "/usr/bin/make install  -- OK"
93there's nothing more standing between you and
94using the Net::DRI module. (Go treat yourself a beer)
95