1Maypole::Manual::InstalUls(e3r)Contributed Perl DocumentMaatyipoonle::Manual::Install(3)
2
3
4
6 Maypole::Manual::Install - installing Maypole
7
9 The first thing you're going to need to do to get Maypole running is to
10 install it. Maypole needs an absolute shedload of Perl modules from
11 CPAN to do its job. I am unrepentant about this. Maypole does a lot of
12 work, so that you don't have to. This is called code re-use, and if
13 we're serious about code re-use, then Maypole should be re-using as
14 much code as possible in terms of Perl modules. In another sense, this
15 gives the impression that Maypole doesn't actually do all that much
16 itself, because all it's doing is gluing together already-existing
17 code. Well, welcome to code re-use.
18
19 The downside of code re-use is, of course, that you then have to
20 install a shedload of Perl modules from CPAN. If you're using OpenBSD
21 or FreeBSD, the wonderful ports system will be your friend. There's a
22 Maypole port in "p5-Maypole". Just type "make install".
23
24 Debian users, hang in there. There's a package coming.
25
26 For other Unices, the CPANPLUS or "CPAN" modules will help with this.
27 If you don't have "CPANPLUS" installed, my recommendation is to use
28 "perl -MCPAN -e install CPANPLUS" to install it and then throw
29 "CPAN.pm" away. In any case, one of these two should get all that May‐
30 pole needs:
31
32 % perl -MCPANPLUS -e 'install Maypole'
33 % perl -MCPAN -e 'install Maypole'
34
35 Information on installing under Windows is available from the wiki -
36 http://maypole.perl.org/?WindowsInstall
37
38 More information of installing under various Linux flavours is avail‐
39 able on the Wiki - http://maypole.perl.org/?LinuxInstall
40
41 You're also going to need a database server and a web server. For data‐
42 bases, I recommend SQLite (if you install the "DBD::SQLite" module, you
43 get the SQLite library for free) for prototyping and mysql for produc‐
44 tion; heavier duty users should use Postgresql or Oracle - Maypole
45 should be happy with them all. Maypole is happiest when running under
46 Apache "mod_perl", with the "Apache::Request" module installed, but as
47 I said, it is a blank slate, and everything is customizable. There is a
48 "CGI::Maypole" frontend available to run as a standalone CGI script.
49
50 As well as the documentation embedded in the Perl modules the distribu‐
51 tion also includes the manual, of which this is a part. You can access
52 it using the perldoc command, the man command, or by browsing CPAN.
53
54
55
56perl v5.8.8 2005-11-23 Maypole::Manual::Install(3)