FOSwiki Related Notes

Fresh Installation of FOSwiki

  • With 'configure', once it's up go to 'find more extensions' and download/install the mod_perl thing.
  • FOSwiki doesn't seem to like suexec very much, vs TWiki. I had to take out suexec and just run everything as the Apache user.

Tests to Perform when Upgrading

  • If the site is erroring, probably you wiped out the foswiki part and didn't reinstall the mod_perl extension so that it can talk to mod_perl.
  • Hit - ensure that it correctly directs to the appropriate web (Gunwiki, not Main)!
    • If it points to Main, then
  • Edit the SitePreferences topic to ensure that FAVICON resolves to /favicon.ico
  • Ensure that administrative powers are set via the TWikiAdminGroup topic.
  • Look on the left, make sure there's a valid left nav bar with a functional registration link. Incidentally, FOSWiki seems to like having a "WebLeftBarExample" topic to use as a fallback if there's no custom WebLeftBar.
  • Look at the window title - is it something obnoxious like RefReloading < Gunwiki < Foswiki? If so, you want to edit templates/foswiki.tmpl to change it to something less lame, such as %WEB %: %TOPICTITLE %. Once FOSwiki supports a reasonable means of doing named topics, I'll stop hacking up its template display.
  • Are the breadcrumbs obnoxiously advertising foswiki? Edit templates/view.pattern.tmpl to remove the 'breadcrumb:wikitoolname' bit, and chop the 'seperator' entry off of 'currentweb'.

Login/Registration troubleshooting

Ensure that lib/LocalSite.cfg's $Foswiki::cfg{Htpasswd}{FileName} entry is set appropriately, to point at the .htpasswd file.

Things to insert into lib/LocalSite.cfg

$Foswiki::cfg{ScriptUrlPaths}{view} = '';

Things to insert into Main/SitePreferences.txt

Upgrading from TWiki

Finding Things to Adjust

  • Search for anything in your web that uses a %TWIKI % variable, particularly custom left side nav bars, etc.
  • Do a find . | grep -i twiki
    • I found that my twiki dev migration script was locking me out of administration when I used it to move into twiki. It turns out that the TWikiAdminGroup.txt file should have been called AdminGroup.txt from now on.


  • It is unfortunately necessary to do an all new LocalSite.cfg file.
  • Missing plugins that I actually use:
    • BBcode
    • CaptchaPlugin (ESSENTIAL unless there's something else that does this)
  • Missing plugins I'm not sure if I use:

-- SeanNewton - 30 Aug 2009

Edit | Attach | Watch | Print version | History: r7 | r5 < r4 < r3 < r2 | Backlinks | Raw View | Raw edit | More topic actions...
Topic revision: r3 - 2010-01-21 - SeanNewton
  • Edit
  • Attach
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 2008-2020 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback