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