fixing my own stupdiy. really not *that* much of a n00b
[ikiwiki.git] / doc / install / discussion.mdwn
1 No matter what I do, ikiwiki gives me a `Can't locate loadable object for module Locale::gettext in @INC` although I've installed (and reinstalled) the Locale module, and no luck. If I look at the directories in the INC path, I can see the file. The wiki won't compile in spite of this, and I've tried everything I can think of.. -- [[tychoish]]
2
3 ---
4
5 I am trying to install Ikiwiki version 2.1 from the source tarball.
6
7 It has all gone fairly smoothly until I try and run 'make'.
8
9 I.e. I have downloaded and unpacked ikiwiki_2.1.tar.gz and have run
10
11     perl Makefile.PL
12
13 ... which has run OK.
14
15
16 However when I then run 'make' I get:-
17
18     LANG=C perl -I.  -T ikiwiki.out doc html --templatedir=templates \
19                     --underlaydir=basewiki --nousedirs\
20                     --wikiname="ikiwiki" --verbose \
21                     --exclude=/discussion --no-discussion --userdir=users \
22                     --plugin=goodstuff \
23                     --plugin=haiku --plugin=polygen --plugin=fortune
24     Failed to load plugin IkiWiki::Plugin::mdwn: IkiWiki version 2 required--this is only version 1.01 at IkiWiki/Plugin/mdwn.pm line 7.
25     BEGIN failed--compilation aborted at IkiWiki/Plugin/mdwn.pm line 7.
26     Compilation failed in require at (eval 4) line 2.
27     BEGIN failed--compilation aborted at (eval 4) line 2.
28
29     make: *** [extra_build] Error 1
30  
31 How do I fix this?  There may be a bit of old ikiwiki left behind because
32 I did once have an older version installed but I thought I had removed all
33 traces of it.
34
35 > I'm quite sure that you still have some of it floating around, since
36 > ikiwiki seems to be loading an old IkiWiki.pm.
37
38 > I don't understand though why it's not finding ./IkiWiki.pm first. The
39 > `-I` in the command line should make it look for files in the current
40 > directory first. --[[Joey]]
41
42 Well I have searched around and there really is nothing left that I can see.
43
44 I have removed *everything* found by 'find' and 'locate' that contains 'ikiwiki' except the tar file
45 and started from the beginning again and I see exactly the same error.
46
47 Is it that I maybe have a too old version of some of the Perl dependencies?  The only mdwn.pm files
48 that I have are the two I have just extracted from the new tar file.  There is *no* ./IkiWiki.pm file
49
50 > It's interesting that you say you have no ./IkiWiki.pm file, since one is
51 > included in the tarball. What happened to it, I wonder? 
52
53 so what/where is it loading to satisfy the ....... aaaaaaaaaaahhhhhhhhhhhhhh!!!!!!
54
55 I wasn't noticing the case of the filename, I'd missed the upper case W and guess what 'find' shows me:-
56
57     /usr/local/lib/perl5/site_perl/5.8.8/IkiWiki.pm
58
59 Removing the above file has fixed my basic problem, now I'm getting lots of (non-fatal) errors
60 about "Can't locate Locale/gettext.pm", presumably that's a missing Perl module, I can probably
61 sort that out.
62
63
64 ## Errors when running 'make test'
65
66 OK, I've now got it to compile and install and presumably it's basically working.  However there
67 are a few errors when I run 'make test'.  Several errors have disappeared by installing more Perl
68 stuff (specifically XML::SAX) 
69
70 > XML::SAX is a requirement of XML::Simple, which is a documented build
71 > requirement. (Only really needed if you'll be using subversion actually).
72
73 and one error disappeared when I did a 'make install', i.e. the 'make
74 test' has a test which requires IkiWiki to be installed first.
75
76 > Yes, that bug is already fixed in subversion for the next release
77 > --[[Joey]]
78
79 However I'm still getting the following error in 'make test':-
80
81         t/pagename.................ok                                                
82         t/pagespec_match...........ok 1/52Modification of a read-only value attempted at /home/chris/webdev/ikiwiki/blib/lib/IkiWiki.pm line 1023.
83         # Looks like you planned 52 tests but only ran 23.
84         # Looks like your test died just after 23.
85         t/pagespec_match...........dubious                                           
86                 Test returned status 255 (wstat 65280, 0xff00)
87         DIED. FAILED tests 24-52
88                 Failed 29/52 tests, 44.23% okay
89         t/pagespec_merge...........ok                                                
90
91 > What version of perl are you using? It seems to have some problem with
92 > operator overloading.
93 > --[[Joey]]
94
95 home$ perl -v
96
97 This is perl, v5.8.8 built for i486-linux
98
99 ## Installation in a non-root enviroment
100 I had a pretty hellacious time installing Ikiwiki (largely due to problems
101 in Perl) and documented them in [[tips/SharedHosting]].  I'd like to get feedback on the doc and also know if I should file a few bugs to make the installation process a little friendlier to non-root folks.  Thanks for the great app!
102
103
104 ## Typing error?
105
106 [..] Mail::Sendmail, TimeDate, RPC::XML, [..]: should be DateTime? --[[vibrog]]
107
108 > No, TimeDate and DateTime are two different CPAN modules. Ikiwiki uses
109 > TimeDate. --[[Joey]]
110
111 ah, i still don't fully get it, though (the following is slightly shortened):
112
113     $ perl -MCPAN -e shell
114     cpan> install DateTime
115     DateTime is up to date.
116     cpan> install TimeDate
117     Warning: Cannot install TimeDate, don't know what it is.
118     Try the command
119         i /TimeDate/
120     to find objects with matching identifiers.
121
122 I'm trying to build IkiWiki on a fresh OpenSuse 10.3 box. I start out with
123
124     $ perl -MCPAN -e 'install Text::Markdown URI HTML::Parser HTML::Template HTML::Scrubber'
125     $ git clone git://git.ikiwiki.info/ ikiwiki && cd ikiwiki
126     $ perl Makefile.PL && make
127
128 Are there other prerequisites?
129 I also installed all optional Perl modules, except TimeDate.
130
131 > TimeDate is also, confusingly, known as Date::Parse. Perhaps CPAN would
132 > do better with that name. --[[Joey]]
133
134 good. Date::Parse was already installed. --[[vibrog]]
135
136 `make` exits with `make: *** [extra_build] Aborted`, `make test` complains `cannot stat 'ikiwiki.man'` --[[vibrog]]
137
138 > If you show me the actual error message, and not just the last line make
139 > outputs, I might be able to help. --[[Joey]]
140
141     ..
142     rendering todo/calendar_--_archive_browsing_via_a_calendar_frontend.mdwn
143     make: *** [extra_build] Segmentation fault
144
145 > So, perl on your system is segfaulting when running ikiwiki. What version
146 > of perl is this, and what version of what distribution? --[[Joey]]
147
148     $ perl -V
149     Summary of my perl5 (revision 5 version 8 subversion 8) configuration:
150     osname=linux, osvers=2.6.22, archname=i586-linux-thread-multi
151     uname='linux ravel 2.6.22 #1 smp 20070921 22:29:00 utc i686 i686 i386 gnulinux '
152     config_args='-ds -e -Dprefix=/usr -Dvendorprefix=/usr -Dinstallusrbinperl -Dusethreads -Di_db -Di_dbm -Di_ndbm -Di_gdbm -Duseshrplib=true -Doptimize=-O2 -march=i586 -mtune=i686 -fmessage-length=0 -Wall -D_FORTIFY_SOURCE=2 -fstack-protector -g -Wall -pipe'
153     hint=recommended, useposix=true, d_sigaction=define
154     usethreads=define use5005threads=undef useithreads=define usemultiplicity=define
155     useperlio=define d_sfio=undef uselargefiles=define usesocks=undef
156     use64bitint=undef use64bitall=undef uselongdouble=undef
157     usemymalloc=n, bincompat5005=undef
158
159 Not sure how to provide proper version information for you.--[[vibrog]]