% mkdir /export/twiki
% useradd -d /export/twiki -s /bin/bash twiki
% cd /export
% chown twiki:other twiki
% passwd twiki

% mkdir /export/twiki/sjws7u2/https-<hostname>/docs/twiki
% cp TWiki-4.2.0.tgz /export/twiki/sjws7u2/https-<hostname>/docs/twiki
% cd /export/twiki/sjws7u2/https-<hostname>/docs/twiki
% gunzip TWiki-4.2.0.tgz
% tar xf TWiki-4.2.0.tar

• cd /export/twiki/sjws7u2/https-<hostname>/config
  
  
• Edit the 'default' section of obj.conf file to include the following two lines
  
  NameTrans fn="pfx2dir" from="/twiki/view" dir="/export/twiki/sjws7u2/<hostname>/docs/twiki/bin/view" name="cgi"
Service fn="send-cgi" type="magnus-internal/cgi" nice="10"
  
  Hopefully the following example gives an idea on where to insert those two lines. In the example, 't2000-240-08' is the hostname.
  

   % diff -C 3 obj.conf obj.conf.orig
  
  *** obj.conf    Wed May 14 01:36:34 2008
  --- obj.conf.orig       Wed May 14 01:02:52 2008
  ***************
  *** 10,17 ****
    AuthTrans fn="match-browser" browser="*MSIE*" ssl-unclean-shutdown="true"
    NameTrans fn="ntrans-j2ee" name="j2ee"
    NameTrans fn="pfx2dir" from="/mc-icons" dir="/export/twiki/sjws7u2/lib/icons" name="es-internal"
  - # Consider anything in the directory /export/twiki/sjws7u2/https-t2000-240-08/docs/twiki/bin to be a CGI
  - NameTrans fn="pfx2dir" from="/twiki/view" dir="/export/twiki/sjws7u2/https-t2000-240-08/docs/twiki/bin/view" name="cgi"
    PathCheck fn="uri-clean"
    PathCheck fn="check-acl" acl="default"
    PathCheck fn="find-pathinfo"
  --- 10,15 ----
  ***************
  *** 20,27 ****
    ObjectType fn="type-j2ee"
    ObjectType fn="type-by-extension"
    ObjectType fn="force-type" type="text/plain"
  - # Run CGI processes with a "Nice" level of 10
  - Service fn="send-cgi" type="magnus-internal/cgi" nice="10"
    Service method="(GET|HEAD)" type="magnus-internal/directory" fn="index-common"
    Service method="(GET|HEAD|POST)" type="*~magnus-internal/*" fn="send-file"
    Service method="TRACE" fn="service-trace"
  --- 18,23 ----

% cat ~/.profile | grep PATH
export PATH=/usr/bin:/usr/sbin:/usr/local/bin:/usr/sfw/bin:/usr/csw/bin:$PATH

1. Create the config file LocalLib.cfg.
   
   
   1. There is a template for this config file in twiki/bin/LocalLib.cfg.txt. Copy LocalLib.cfg.txt to LocalLib.cfg.
      

      % cd /export/twiki/sjws7u2/https-<hostname>/docs/twiki/bin
      % cp LocalLib.cfg.txt LocalLib.cfg

      
      
   2. Edit LocalLib.cfg to update the $twikiLibPath variable.
      $twikiLibPath = "/export/twiki/sjws7u2/https-<hostname>/docs/twiki/lib";
   
   
   
2. Manually create the config file LocalSite.cfg.
   

   % cd /export/twiki/sjws7u2/https-<hostname>/docs/twiki/lib
   % cp TWiki.spec LocalSite.cfg

   
   
3. Update the following variables with appropriate values in LocalSite.cfg.
   
   $TWiki::cfg{DefaultUrlHost}, $TWiki::cfg{ScriptUrlPath}, $TWiki::cfg{PubUrlPath}, $TWiki::cfg{PubDir}, $TWiki::cfg{TemplateDir}, $TWiki::cfg{DataDir}, $TWiki::cfg{LocalesDir}, and $TWiki::cfg{OS}, $TWiki::cfg{RCS}{EgrepCmd} and $TWiki::cfg{RCS}{FgrepCmd}.
   
   This diff output shows how they were configured in the demo TWiki that I used for the Proof-Of-Concept (POC). The hardware it was deployed on is a Sun Fire T2000. So Cool Stack was installed on the server to take advantage of the optimized Perl.

% cd /export/twiki/sjws7u2/https-<hostname>/bin
% ./stopserv
% ./startserv

% cd /export/twiki/sjws7u2/https-/docs/twiki/bin
% ./view