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