Tuesday, January 16, 2007

[log] Installing TWiki on Bluehost

Installed twiki on my bluehost account tonight. As always, the general installation instruction misses small but critical steps --- but I guess bumming around and debugging until things worked is what makes this fun (and then rm -r the whole thing and doing it again just to make sure I could really do it).

Unpack

> [FTP TWiki-4.0.5.tar to home dir]
> cd ~
> gunzip TWiki-4.0.5.tar
> mkdir public_html/twiki
> cd public_html/twiki
> tar xvf ~/TWiki-4.0.5.tar

Setup .cfg and bin files
> cp bin/LocalLib.cfg.txt bin/LocalLib.cfg
> [Edit LocalLib.cfg change $twikiLibPath to /{full path}/twiki/lib]
> [Add .pl extension to all executable files in bin]

Set read permission on pub files
> cd pub
> chmod -R a+r *

Set configuration options
> [Bring up twiki/bin/configure.pl in browser]
> Under "General Path Settings", fix paths listed in {PubDir}, {TemplateDir}, {DataDir}, {LocalesDir}
> Under "General Path Settings", {ScriptSuffx}, enter .pl
> Under "Security Setup", uncheck {UseClientSessions} (CGI:Session Perl module not yet available)
> Under "Security Setup", {LoginManager}, select TWiki::Client::TemplateLogin
> Under "Security Setup", {AuthScripts}, add .pl to each of the files in the list

Request to install CGI:Sessions Perl module
> 1:19 am Emailed bluehost support to install CGI::Sessions Perl module. (Else template based login does not work)
> 6:33 am Bluehost support emailed with confirming that the module has been installed
> [Bring up twiki/bin/configure.pl in browser]
> Under "Security Setup", Check {UseClientSessions}

Fun diversion. Thanks to hints from http://opensource.christophercraft.com/?p=70

7 comments:

  1. bluehost rocks!

    ReplyDelete
  2. I know -- so glad i finally switched from 1and1.

    ReplyDelete
  3. WAIT! Make sure to protect your sensitive non-public folders beneath the wiki root!

    One easy way to do this is to create a file called .htaccess containing the following line:
    deny from all

    You need to then copy this file into the following folders beneath the wiki root: data, lib, locale, templates, tools, working.

    There's a sample file called twiki_httpd_conf.txt that contains other tips/directives that would also help protect the 'configure' scripts.

    ReplyDelete
  4. Thank you, very helpful instructions!

    ReplyDelete
  5. Working with TWiki-4.3.2:
    Can't find reference to step above regarding Security Setup:
    "Security Setup", {AuthScripts}, add .pl to each of the files in the list

    (I think it works now automagically)

    Also used the built-in Perl module installer to add in CGI::Session 4.42 (so you don't have to bug support, uncheck then recheck "UseClientSession")

    Got an error:
    TWiki detected an internal error - please check your TWiki logs and webserver logs for more information.

    Can't locate Unicodepath in @INC (@INC contains: path . path-linux path path-linux path path path path path path path-linux path path)

    Tried fixing by installing the following according to help forum file, but no joy:
    Unicode::String

    Had to follow "manual patch" fix for "Render.pl" (remember to change write permissions!) as per here:
    http://tinyurl.com/yj4dd5y

    ReplyDelete
  6. Exclusive Discount: BlueHost At $3.45/Mo
    Free ‘.com’ domain
    24/7 technical support
    WordPress integration
    Unlimited traffic
    30-day money-back guarantee
    BlueHost WEb Hosting

    ReplyDelete
  7. DreamHost is definitely the best web-hosting company with plans for any hosting needs.

    ReplyDelete