ikiwiki (3.20130711) unstable; urgency=low
[ikiwiki.git] / doc / forum / upgrade_steps.mdwn
1 [[!meta date="2007-08-27 21:52:18 +0000"]]
2
3 I upgrades from 1.40  to 2.6.1. I ran "ikiwiki --setup" using my existing ikiwiki.setup configuration.
4 I had many errors like:
5
6     /home/bsdwiki/www/wiki/wikilink/index.html independently created, not overwriting with version from wikilink
7     BEGIN failed--compilation aborted at (eval 5) line 129.
8
9 and:
10
11     failed renaming /home/bsdwiki/www/wiki/smileys.ikiwiki-new to /home/bsdwiki/www/wiki/smileys: Is a directory
12     BEGIN failed--compilation aborted at (eval 5) line 129.
13
14 Probably about six errors like this. I worked around this by removing the files and directories it complained about.
15 Finally it finished.
16
17 > As of version 2.0, ikiwiki enables usedirs by default. See
18 > [[tips/switching_to_usedirs]] for details. --[[Joey]]
19
20 >> I read the config wrong. I was thinking that it showed the defaults even though commented out
21 >> (like ssh configs do). I fixed that part. --JeremyReed
22
23 My next problem was that ikiwiki start letting me edit without any password authentication. It used to prompt
24 me for a password but now just goes right into the "editing" mode.
25 The release notes for 2.0 say password auth is still on by default.
26
27 > It sounds like you have the anonok plugin enabled?
28
29 >> Where is the default documented? My config doesn't have it uncommented.
30
31 The third problem is that when editing my textbox is empty -- no content.
32
33 This is using my custom rcs.pm which has been used thousands of times.
34
35 > Have you rebuilt the cgi wrapper since you upgraded ikiwiki? AFAIK I
36 > fixed a bug that could result in the edit box always being empty back in
37 > version 2.3. The only other way it could happen is if ikiwiki does not
38 > have saved state about the page that it's editing (in .ikiwiki/index).
39
40 >> Rebuilt it several times. Now that I think of it, I think my early problem of having
41 >> no content in the textbox was before I rebuilt the cgi. And after I rebuilt the whole webpage was empty.
42
43 Now I regenerated my ikiwiki.cgi again (no change to my configuration,
44 and I just get an empty HTML page when attempting editing or "create".
45
46 > If the page is completly empty then ikiwiki is crashing before it can
47 > output anything, though this seems unlikely. Check the webserver logs.
48
49 Now I see it created directories for my data. I fixed that by setting 
50 usedirs (I see that is in the release notes for 2.0) and rerunning ikiwiki --setup
51 but I still have empty pages for editing (no textbox no html at all).
52
53 > Is IkiWiki crashing? If so, it would probably leave error text in the apache logs. --[[TaylorKillian]]
54
55 >> Not using apache. Nothing useful in logs other thn the HTTP return codes are "0" and bytes is "-"
56 >> on the empty ikiwiki.cgi output (should say " 200 " followed by bytes).
57
58 >>> You need to either figure out what your web server does with stderr
59 >>> from cgi programs, or run ikiwiki.cgi at the command line with an
60 >>> appropriate environment so it thinks it's being called from a web
61 >>> server, so you can see how it's failing. --[[Joey]]
62
63 (I am posting this now, but will do some research and post some more.)
64
65 Is there any webpage with upgrade steps?
66
67 > Users are expected to read [[news]], which points out any incompatible
68 > changes or cases where manual action is needed.
69
70 >> I read it but read the usedirs option wrong :(.
71 >> Also it appears to be missing the news from between 1.40 to 2.0 unless they dont' exist.
72 >> If they do exist maybe they have release notes I need?
73
74 >>> All the old ones are in the NEWS file. --[[Joey]]
75
76 --JeremyReed
77
78 My followup: I used a new ikiwiki.setup based on the latest version. But no changes for me.
79
80 Also I forgot to mention that do=recentchanges works good for me. It uses my 
81 rcs_recentchanges in my rcs perl module.
82
83 The do=prefs does nothing though -- just a blank webpage.
84
85 > You need to figure out why ikiwiki is crashing. The webserver logs should
86 > tell you.
87
88 I also set verbose => 1 and running ikiwiki --setup was verbose, but no changes in running CGI.
89 I was hoping for some output.
90
91 I am guessing that my rcs perl module stopped working on the upgrade. I didn't notice any release notes
92 on changes to revision control modules. Has something changed? I will also look.
93
94 > No, the rcs interface has not needed to change in a long time. Also,
95 > nothing is done with the rcs for do=prefs.
96
97 >> Thanks. I also checked differences between 1.40 Rcs plugins and didn't notice anything significant.
98
99 --JeremyReed
100
101 Another Followup: I created a new ikiwiki configuration and did the --setup to 
102 create an entirely different website. I have same problem there. No prompt for password
103 and empty webpage when using the cgi.
104 I never upgraded any perl modules so maybe a new perl module is required but I don't see any errors so I don't know.
105
106 The only errors I see when building and installing ikiwiki are:
107
108     Can't exec "otl2html": No such file or directory at IkiWiki/Plugin/otl.pm line 66.
109
110     gettext 0.14 too old, not updating the pot file
111
112 I don't use GNU gettext on here.
113
114 I may need to revert back to my old ikiwiki install which has been used to thousands of times (with around
115 1000 rcs commits via ikiwiki).
116
117 --JeremyReed
118
119 I downgraded to version 1.40 (that was what I had before I wrote wrong above).
120 Now ikiwiki is working for me again (but using 1.40). I shouldn't have tested on production system :)
121
122 --JeremyReed
123
124 I am back. On a different system, I installed ikiwiki 2.6.1. Same problem -- blank CGI webpage.
125
126 So I manually ran with:
127
128     REQUEST_METHOD=GET QUERY_STRING='do=create&page=jcr' kiwiki.cgi
129
130 And clearly saw the error:
131
132     [IkiWiki::main] Fatal: Bad template engine CGI::FormBuilder::Template::div: Can't locate CGI/FormBuilder/Template/div.pm
133
134 So I found my version was too old and 3.05 is the first to provide "Div" support. I upgraded my p5-CGI-FormBuilder to 3.0501.
135 And ikiwiki CGI started working for me.
136
137 The Ikiwiki docs about this requirement got removed in Revision 4367. There should be a page that lists the requirements.
138 (I guess I could have used the debian/control file.)
139
140 > There is a page, [[install]] documents that 3.05 is needed.
141
142 >> Sorry, I missed that. With hundreds of wikipages it is hard to read all of them.
143 >> I am updating the download page now to link to it.
144
145 I am now using ikiwiki 2.6.1 on my testing system.
146
147 --JeremyReed