installation1Add my vote for this tag windows1Add my vote for this tag create new tag
, view all tags
ALERT! NOTE: This is a SupplementalDocument topic which is not included with the official TWiki distribution. Please help maintain high quality documentation by fixing any errors or incomplete content. Put questions and suggestions concerning the documentation of this topic in the comments section below! Use the Support web for problems you are having using TWiki.

Windows Cookbook for TWiki 4.1.2

I am thankful to the TWiki community for writing this great software. I had installed the Cairo release using the Windows Cookbook. Now I have installed 4.1.2 but I found that the cookbook does not give exact procedure for 4.1.2. I have installed it on two machines and have tried to create this cookbook with exact steps I have followed. If you follow the steps given here, the installation should work. Do not skip any step, as it may be difficult to trace later.

This cookbook is based on the Windows Cookbook for Twiki 3. Thanks to all who wrote that. I have taken a lot of things from the previous cookbook for this. This is my small contribution in return to all the help I received from the TWiki community. Please feel feel to correct any errors or add additional info / variations.

By the way, I am a novice in software and hence I may not be able to offer any help on any issues.

-- ChengappaCB

Server OS

My installation is on Windows Server 2003 Standard Edition . (But it should work for other flavours of W2k and other 4.x versions of TWiki too). For this cookbook, the name the server will be “ twikiserver ”. In my installation, this server was a part of the corporate domain (corporate.com). Browser is IE 6. Installation done with logging in as administrator (local administrator)


Download the Apache source for 1.3.39 for Windows. (Other versions may work too !). File name is “apache_1.3.39-win32-x86-no_src.msi”. You may need to navigate around in http://httpd.apache.org/download.cgi to figure out from where to download this.

Install Apache

  • Double-click the .MSI file to run the installer
  • Give your email id in ‘ administrator’s email address’ and choose ‘ Run as service ’ (this is the default) in the relevant screen. Choose ‘ Complete installation’
  • Specify C:\ as the installation directory - this actually installs Apache into c:\apache (if you specify c:\apache, it installs into c:\apache\Apache). Putting Apache into c:\Program Files is not recommended for easy editing of Apache config files from Cygwin.

Test Apache

  • The ‘Apache’ service would have started automatically. If not, there could be a problem and you may need to start it manually. (right click on ‘my computer’, choose manage, expand ‘services and applications’, choose services and look for ‘Apache’)
  • Open the browser and type http://twikiserver. You should see a screen and the first line of the screen should be:

“If you can see this, it means that the installation of the Apache web server software on this system was successful. You may now add content to this directory and replace this page”.

  • If you have come till this, congratulations! If not, please start from beginning.


Install Cygwin

Head to http://cygwin.com , and click the Install or update now! link. Save the setup.exe in a directory, e.g. c:\download\cygwin-dist. Now run the Cygwinsetup.exe file - this will also install Perl and RCS in one fell swoop.
  • Choose Internet install
  • On first page, accept the defaults (be sure that the default text file type is Unix to avoid problems with attachment uploads, and specify 'install for all users')
  • Select c:\download\cygwin-dist as the local package directory, and suitable proxy settings, then pick a local mirror site (I chose http://cygwin.internet.bs)
  • In the package list screen, hit the View button until you get an alphabetical list that says Full to the right of the button.
  • Leave the radio button on Curr (Current)
    • The Current column shows what's installed on your system (if anything)
  • For each package, make sure the New column in the installer has a version number under it. If there is a version number shown already, leave it as it is. If it says 'Skip' or 'Keep' (meaning it's already installed), single-click that word until a version number is shown. When you select some of the packages, some other related packages get selected automatically.
  • Make sure you select the following packages (under Package column) - : (There may be some other packages selected already. Leave them as they are). I have given the versions which worked for me.
    • bash (3.2.25-17)
    • binutils (20060817-1)
    • coreutils (6.9-5)
    • diffutils (2.8.7-1)
    • gcc (3.4.4-3)
    • grep (2.5.1a-4)
    • gzip (1.3.12-2)
    • make (3.81-1)
    • nano (2.0.6-1)
    • ncftp (3.2.1-1)
    • pcre (7.2-1)
    • perl (5.8.8-4)
    • rcs (5.7-4)
    • tar (1.19-1)
    • unzip (5.52-2)
    • w32api (3.10-1)
    • wget (1.10.2-2)

NOTE: Do not include lynx if you are upgrading from an older Cygwin installation (to avoid annoying DLL messages) - if you want Lynx, read the Cygwin FAQ entry and upgrade libncurses5.

  • Hit Next to do the installation.
    • NOTE : The mandatory packages require a download of about 12 MB - about half of this is Perl, which would be necessary even without Cygwin, and most of the rest is gcc, which is required for simple installation of Perl modules that use the C language. A default installation of Cygwin 1.5.10, plus required packages, needs around 150 MB of free disk space - if you are tight on disk space or Internet bandwidth, de-select all but the mandatory packages, but if not, there is no harm in downloading more.
    • NOTE : The installer keeps a local copy of downloaded files, so it's easy to re-install without re-downloading.
  • Let the installer create the shortcuts suggested
  • You can always come back and re-run the installer again later if you missed anything.
Environment setup:
  1. Set the HOME environment variable to c:\cygwin\home\YOURUSER, where YOURUSER is your userid, e.g. jsmith or administrator. Go into Control Panel, double-click the System icon, and select Advanced, then click Environment Variables. Under User Variables, click New... . Now type HOME (must be upper case) as the variable name, and c:\cygwin\home\administrator ( assuming that you have logged in as administrator) as the value, and hit OK.
  2. Similiarly, set TEMP to c:\temp .
  3. Create the c:\cygwin\home\administrator directory. Create c:\temp if not present already.

Test Cygwin

  1. Launch the desktop icon - this runs the bash shell, which has command line editing features
    • Use the cursor up key to recall previous commands - normal PC editing keys can then be used to edit a command
    • TIP: When typing a directory or file name, hit the TAB key after the first few letters of the name - bash will 'complete' the name. If bash beeps at you, hit TAB again to see the files/directories that match the name so far, and type a bit more before hitting TAB. This saves a lot of time!
  2. Type rcs -V - you should see the RCS version, 5.7
  3. Type perl -v - you should see the Perl version, 5.8.8
  4. Type grep home /etc/passwd - you should see some output.
The Cygwin User Guide is well worth reading for some background on how Cygwin works.

Configure Cygwin for binary mode

  1. This is very important - omitting this step leads to a partially working system that corrupts RCS files - without this, Cygwin tools (including Perl and RCS) will add unwanted carriage returns (Ctrl/M, '\r') to files in an attempt to translate between the Windows and Unix text file formats (Unix text files only use line feeds ('\n').
  2. Stay in the Cygwin (bash) shell, and type the following (use only forward slashes, i.e. '/'):
The following are the commands if you have installed Twiki on your C drive . (Please note the spaces between characters. Between mkdir and /twiki for example)

$ cd /

$ mkdir /twiki /c c:/twiki

$ mount -b -s c:/twiki /twiki

$ mount -b -s c:/ /c

$ mount -b -c /cygdrive

$ mount

C:\cygwin\bin on /usr/bin type system (binmode)
C:\cygwin\lib on /usr/lib type system (binmode)
C:\cygwin on / type system (binmode)
c:\twiki on /twiki type system (binmode)
c: on /c type system (binmode)

The following are the commands if you have installed Twiki on your D drive . My installation is on D drive. Henceforth, it is assumed that the Twiki is on your D drive

$ cd /

$ mkdir /twiki /c /d d:/twiki

(This will create the directories /twiki, /c, /d and d:/twiki. If you have already created d:/twiki, it gives an error which can be ignored)

$ mount -b -s d:/twiki /twiki

$ mount -b -s c:/ /c

$ mount -b -s d:/ /d

$ mount -b -c /cygdrive

$ mount

C:\cygwin\bin on /usr/bin type system (binmode)
C:\cygwin\lib on /usr/lib type system (binmode)
C:\cygwin on / type system (binmode)
d:\twiki on /twiki type system (binmode)
c: on /c type system (binmode)
d: on /d type system (binmode)

  • This configures/twiki (known as a 'mount point') to map ontod:/twikiand for that directory tree to always be in binary mode, and does the same for/c, mapping it ontoc:/. The last-but-one command sets binary as the default for any unmounted drives (e.g. z:/, aka/cygdrive/z).
  • It is very important that all lines in the output of mountsay '(binmode)' at the end of each line
    • If the lines forC:\cygwindirectories do not, you should uninstall and then re-install Cygwin to ensure that binary attachment uploads will work.
  • You can now refer to files using Unix paths, e.g. /twiki/bin/viewor/c/apache/Announcement - see the Cygwin documentation for more details on this.
Now test this, still using the Cygwin shell:

Type cd /twiki

Type echo hi >t

Type cat -v t

You should see hi as the output

If you see filename errors, your mounts did not work for some reason - check your typing If you see hi^M as output, your /twiki directory is not in binary mode

Clean up by typing rm t

This setup is written to the Windows registry, so there's no need to put these commands into a.profilefile. For more information on binary vs text mode, see this User Guide section and this FAQ entry.


Download TWiki

Download the latest TWiki (4.1.2 in this case) release from http://twiki.org/ and save it in the d:\twiki directory.

Install TWiki

Unzip the downloaded ZIP file under d:/twiki using WinZip, or by going into Cygwin and doing the following - you can hit the TAB key to complete filenames after you've typed the first part:

$ cd /twiki

$ unzip TWiki-4.1.2.zip

You can also unzip this in Windows into d:\twiki

Configuring components

Now that all the components are installed, you need to configure them.

Configuring Apache

The setup given here is fairly simple, in that it allows only TWiki to be served by the web server. For more complex setups, you can investigate the Alias and ScriptAlias commands that are left commented out in this configuration.
  • NOTE : This needs reviewing for security holes and to ensure nothing is missed, though this config does work.

1. Configure Apache (part 1)

Using a suitable text editor edit c:/apache/conf/httpd.conf as follows - this tells Apache where TWiki lives, and removes the need to tinker with the Windows environment settings. (You may need to give the necessary share and NTFS permissions for the folder for the username you use to edit the file, if you get ‘permission denied’ error)

Note the trailing '/' characters in various places - they are important!

Edit the following lines, some of which already exist in the file: I have mentioned the changes in bold.

# Change this to point to the Apache administrator (e.g. you)

ServerAdmin you@yourdomain.com

(This would already be in place if you have given the email id while installing Apache)

# Replace DocumentRoot "C:/apache/htdocs" with

DocumentRoot "D:/twiki"

# Replace <Directory "C:/apache/htdocs"> with

<Directory "D:/twiki">

Find the following lines and add the lines in bold below them:

    AllowOverride None
# Controls who can get stuff from this server.
    Order allow,deny
    Allow from all

<Directory "D:/Twiki/bin/">

# RD: Changed None to All in next line, to enable .htaccess

AllowOverride All

Allow From All

Options ExecCGI

SetHandler cgi-script


<IfModule mod_env.c>

# Adjust TZ for your server timezone, e.g. EST5EDT - put the non-daylight-savings

# timezone code first (e.g. EST or GMT), followed by the number of hours that it's behind GMT

# during non-daylight-savings time (use '-5' for timezones in advance of GMT).


SetEnv RCSINIT -x,v/

# Adjust TEMP and TMP for your server and create directories if necessary

SetEnv TEMP c:/temp

SetEnv TMP c:/temp

SetEnv LOGNAME system

SetEnv HOME D:/Twiki


2. Configure Apache (part 2)

Add an AddHandler line to the section ofhttpd.conf (add the line in bold after the following text) - this removes the need to rename all the TWiki CGI scripts later in the installation.
  • Note the trailing ' . ' on the AddHandler line.

# Document types
<IfModule mod_mime.c>
    TypesConfig conf/mime.types

# TWiki setup - avoid renaming scripts

AddHandler cgi-script .


Remember to restart Apache after this.

Now if you point your browser to http://twikiserver, you should get the Twiki screen below:

Welcome to TWiki

Note: These pages do not need to be accessible by browsers. Preventing access will increase security and will not affect TWiki in any way.

Configuring Cygwin

Open the windows explorer, right click your cygwin directory (c:/path/to/cygwin) and choose "Properties". Select the "Security" tab and click ‘advanced’ and set the permissions as follows:

  1. Uncheck 'inherit permissions', click the 'copy ' button when prompted. Click apply.
  2. For the 'Everyone' or 'Users' group, uncheck Write access and Full Control (There were two lines for Users in my installation. One vanished after I did this.)
  3. Add the groups (if not present) CREATOR OWNER, SYSTEM and give them Full Control..
  4. Add the users Administrator (if not present), Your_Name and give them Full Control
  5. Click ‘apply’ and ‘OK’. The permissions for creator owner do not show up in the main screen (they return to blank but appear only in the ‘advanced’ screen). That is fine

Note, if the "Security" tab doesn't appear in your "Properties" dialog, see this article.

Just to be on the safer side, stop and start the Apache services.

Configure TWiki

Create the file twiki/bin/LocalLib.cfg. There is a template for this file intwiki/bin/LocalLib.cfg.txt. The filetwiki/bin/LocalLib.cfgmust contain a setting for$twikiLibPath, which must point to the absolute file path of yourtwiki/libe.g. /home/httpd/twiki/lib. To do this,

Copy the file D:\Twiki\bin\LocalLib.cfg.txt to D:\Twiki\bin\LocalLib.cfg

Edit the line:

$twikiLibPath = "/absolute/path/to/your/lib"


$twikiLibPath = "/twiki/lib";

Visit ApacheConfigGenerator and type in the entries given below in bold at the relevant prompts:

Enter the full file path to your twiki root directory (mandatory): /twiki

Enter the IP address range or hostnames that will have access to configure - separate with spaces : This is optional. You can give the name or IP of your desktop / server from where you plan to do the remaining configuration. Leave it blank for now

Enter the list of user names that are allowed to view configure: This is optional. You can give your username using which you plan to do the remaining configuration. Leave it blank for now

Choose your Login Manager: None - No login

Prevent execution of attached files as PHP scripts if PHP is installed: No PHP Installed

Page to return when authentication fails: None. Use Apache default 401 message

Version of TWiki: 4.1.X

Leave the other fields blank

Click ‘Update config file’. This generates the text for twiki.conf.. Click Highlight text . Copy the highlighted text into a text editor and save it as twiki.conf under D:\Twiki.

Open the file C:\Apache\conf\httpd.conf . Add the following line at the end:

include "D:/Twiki/twiki.conf"

Editing the CGI scripts

Editing the Shebang lines

Now to edit the curiously named 'shebang lines' at the top of the TWiki CGI scripts. This is required so the Apache server knows what interpreter (perl) to use with the scripts.

You must use the Cygwin shell to do this (unless you are a Perl expert) - don't use the Windows command shell, cmd.exe (aka DOS Prompt)

Then do the following, which quickly edits the 19 or so files, using Perl - the important lines are in bold.

Type the Perl line very carefully

If you do mis-type the perl line, you can restore from the .backup directory and re-run the command, as it will only edit the original files, not the backups with '~' suffixes.

$ cd /twiki/bin

$ ls

attach   geturl         oops     rdiff     save        testenv  viewfile
changes  installpasswd  passwd   register  search      upload
edit     mailnotify     preview  rename    statistics  view

$ mkdir .backup $ cp * .backup

$ head -1 view

#!/usr/bin/perl -wT

$ perl -pi~ -e 's;#!/usr/bin/perl;#!c:/cygwin/bin/perl;' *[a-z]

$ head -1 view

#!c:/cygwin/bin/perl -wT

$ ls

attach    geturl          oops      rdiff      save         testenv   viewfile~
attach~   geturl~         oops~     rdiff~     save~        testenv~  view~
changes   installpasswd   passwd    register   search       upload
changes~  installpasswd~  passwd~   register~  search~      upload~
edit      mailnotify      preview   rename     statistics   view
edit~     mailnotify~     preview~  rename~    statistics~  viewfile

If for some reason the edit goes wrong, just type cp .backup/* . (while within the bin directory) to restore the original distribution files. Use ls -a to see the .backup directory, and ls -a .backup to view its contents.

Optional step : you can do 'rm -f *~' to clean out the backups made by Perl, but that's not essential as all the original files cannot be executed. If you do this, type the command very carefully , as a space after the '*' will wipe out all files in this directory!

Note: Whenever you install any addon or plugin which creates/copies a file into the directory /twiki/bin, you will need to edit that file and change the first line from

#!/usr/bin/perl -wT


#!c:/cygwin/bin/perl -wT

Remember this when the new plugin starts displaying errors!

Set File Permissions

For the following configuration use the cygwin shell. Run cygwin and execute the following commands:

$ cd /twiki

$ chmod -R 755 bin

$ chmod 777 lib

Now to test the configuration:

Open the browser and go to http://twikiserver . Click on Configure TWiki. Alternately, you can go to http://twikiserver/bin/configure . It should open this screen:

You are almost near the end.

Click on ‘General path settings’ under ‘Settings’ menu. It will drop down a list.

Check for the warnings in orange and error in red. In my installation, there were 1 error and 7 warnings.

  • Any errors in your configuration will be highlighted.
  • Warnings are non-fatal, but are often a good indicator that something that is wrong.
  • The little δ after an entry means that the current value is not the same as the default value. If you hover the cursor over the δ, a popup will show you what the default value is.
  • EXPERT means a setting is for expert use only. You should not fiddle with it unless you know what you are doing, or at least have read all the documentation!
Let us correct them.

Error: /tmp/twiki/ is not writable

In the Cygwin window, type the following commands:

$ cd /tmp

$ mkdir twiki

$ chmod 777 twiki

Ensure that these entries are correct in the configuration screen

{DefaultUrlHost}δ : http://twikiserver

{ScriptUrlPath}δ : /bin

{PubUrlPath}δ : /pub

{PubDir}δ : /twiki/pub

{TemplateDir}δ : /twiki/templates

{DataDir}δ : /twiki/data

{LocalesDir}δ : /twiki/locale

Click Next . In the next screen, ignore the warning:

WARNING: You have not defined a password. Your TWiki can be reconfigured by anyone who can run configure !

Do not enter any password (for now). Just click Save. After it saves, click ‘ Return to configuration’ at the bottom of the screen.

Now the previous errors should have disappeared and new errors would have been displayed. There will be some more text before the settings. Please read them carefully and understand.

Under Security setup there may be one error and one warning:

Error: The CGI::Session Perl module is required for session support, but is not available.

First, you need to install and configure the cpan tool. You only have to do this once. From the Cygwin shell, type the following:

$ export TEMP=/c/temp

NOTE : If you are behind a non-proxy-based firewall that requires the use of passive FTP, the initial file downloads by Net::FTP may appear to hang - just wait 5 or more minutes and the CPAN tool should eventually start using ncftpget, which is part of Cygwin and works behind a firewall. If this doesn't work and you are behind a typical NAT-based firewall, try typing the following at the Cygwin shell before running cpan - to force Net::FTP to use passive FTP, letting it get through such firewalls:

$ export FTP_PASSIVE=1

$ cpan

(You will need to use the steps above when you need to run CPAN in future)

Note: Putting the export TEMP=/c/temp command into ~/.profile in cygwin/etc is recommended to make this setting persistent. If you do not make it persistent, you have to type the command every time you want to use cpan. Without the TEMP variable, some modules may fail to install on Windows 2000 or XP and higher.

You will be asked many questions about configuration and preferences - just press Enter to accept the defaults until you get to the questions about mirror sites. If you are behind a proxy-based firewall, also answer the questions about FTP proxies. The CPAN tool will fetch a series of files, some quite large, as part of this setup process, so be patient...

After some files have been downloaded, you will be asked to select your continent, your country, and then one or more mirror sites - just type the number of the mirror sites you want to use (pick a few in case one is down):

(1) Africa
(2) Asia
(3) Central America
(4) Europe
(5) North America
(6) Oceania
(7) South America
Select your continent (or several nearby continents) [] 2 4

It may display: Sorry! since you don't have any existing picks, you must make a geographic selection. Just continue to the next screen given below…

(1) China (Asia)
(2) Hong Kong (Asia)
(3) Indonesia (Asia)
(4) Israel (Asia)
(41) Sweden (Europe)
(42) Switzerland (Europe)
(43) Ukraine (Europe)
(44) United Kingdom (Europe)
Select your country (or several nearby countries) [] 10 32 44

It may display: Sorry! since you don't have any existing picks, you must make a geographic selection. Just continue to the next screen given below…

(13) ftp://ftp.osmirror.nl/pub/cpan/ (Netherlands)
(14) ftp://ftp.quicknet.nl/pub/CPAN/ (Netherlands)
(15) ftp://mirror.hostfuss.com/CPAN/ (Netherlands)
(16) ftp://mirror.vuurwerk.nl/pub/CPAN/ (Netherlands)
8 more items, hit SPACE RETURN to show them
Select as many URLs as you like (by number),
put them on one line, separated by blanks, e.g. '1 4 5' [] 1 2 3 4 5 6 7 8

Enter another URL or RETURN to quit: []
New set of picks:

Eventually, you will see the cpan installer's shell prompt, cpan> , which means you are now ready to install a few modules - the tool will do all the work for you.

cpan> install CGI::Session

This will install the CGI::Session. If there are any errors regarding firewalls or connectivity, you will have to resolve them. Finally, it will display the line:

install -- OK


Type exit to close CPAN.

CPAN: The Manual Way (I have not tried this)

If you find that cpan doesn't work for you, perhaps because you are behind an uncooperative corporate firewall, you may have to install the modules manually. In this case, you need to read the CPAN INSTALL page and visit the CPAN search site to search for each module. Search for the name shown below, and download the module.




Usually installation involves downloading the module distribution into a temporary directory and unpacking it (a .tar.gz or .tgz file is unpacked using tar zxvf file ). Then type the following:

$ perl Makefile.PL

$ make

$ make test

$ make install

The make test step should not be skipped - for example, one known problem is with the Digest::SHA1 module on Windows NT, which does not pass its tests and does not work. This causes problems with password encoding. In this event you can use another encoding scheme or switch to unencoded passwords. There may be other problems on the various Windows configurations, and you can save yourself a lot of time by running the tests.

There will be a warning in Security Setup:

Warning: You've asked that some scripts require authentication, but haven't specified a way for users to log in. Please pick a LoginManager other than 'none'.

Ignore this warning for the now.

Under Log files, there may be 4 errors.

Error: /twiki/data/ is not writable

In the cygwin window, type the following commands:

$ cd /twiki

$ chmod 775 data

$ cd data

$ chmod –R 664 *

$ chmod 775 *

$ cd ..

$ chmod -R 775 pub

$ chown -R SYSTEM data

$ chown -R SYSTEM pub

If you go to http://twikiserver/bin/configure now, it should show one warning on security setup and 3 warnings on mail and proxies which can be ignored for now.

Your TWiki 4.1.2 is UP AND RUNNING ! Congratulations !!

Go to http://twikiserver/bin/view/TWiki/WebHome to see the TWiki page. Play around in the sandbox, create new pages, force TWiki to create new versions etc to make sure that everything is working.

Let us now eliminate the warnings:

Go to http://twikiserver/bin/configure, drop down ‘Mail and proxies’.

At {WebMasterEmail}δ, enter your email id.

At {WebMasterName}δ, enter your name (this is optional. This is the name in the From: filed of the mails sent from TWiki)

At {SMTP}{MAILHOST}, enter the IP address of your SMTP server for outgoing mail

This should remove the warnings at ‘Mail and proxies’. Run configure again to check.

The warning on ‘Security setup’ can be removed by dropping down the security setup menu and setting the {LoginManager} under ‘Authentication’ from None to TWiki::Client::TemplateLogin but this requires that any user who requires to edit will need to register in TWiki. For this, your email setup (SMTP etc) should be up and running. If this is not up for you, please see DisableEmailSendForRegistration for some tips.

You might also want to make the installation secure by setting {Htpasswd}{Encoding} to sha1 etc. Please do have a look at all the other parameters in configure and adjust accordingly.

Once you have done that, do not forget to set a good password for saving the changes in configure script. When you click ‘Next’ after making changes, the next screen displays the warning: WARNING: You have not defined a password. Your TWiki can be reconfigured by anyone who can run configure !

Please read the notes on security, enter a good password at “ New Password ” and “ Confirm Password ” and click “Change password and Save ”.

Visit http://twikiserver/bin/view/TWiki/WebHome to browse your own TWiki !

Enable Email Notification

Each TWiki web has an automatic email notification service that sends you an email with links to all of the topics modified since the last alert. To enable this service:

  • Confirm the Mail and Proxies settings in the Configure interface.
  • Create a batch file Mailnotify.bat in the D:\twiki directory and enter this line:
c:\cygwin\bin\perl -I D:\Twiki\bin D:\Twiki\tools\mailnotify -q
  • Go to control panel - Scheduled tasks in your server and setup a scheduled task to call D:\twiki\Mailnotify.bat at some frequency. You may wish to create a local user without password expiry, to be used for this job.


If you are running the TWiki in your organisation where the users login to a domain, you might want to spare the users the trouble of registering themselves in TWiki by allowing them to use their domain login ids. Here is one of the methods:

This will remove the need for the users to register in TWiki but their WIKIUSERNAME will look like Main.YOURDOMAIN\userlogin. We need to remove the YOURDOMAIN\ from it. For this, there is a good plugin at http://twiki.org/cgi-bin/view/Plugins/LoginNameAliasesPlugin. Install the Dakar version of this and enable it in configure. In the LoginNameAliasesPlugin page in your TWiki installation, set REMOVE_PREFIX to YOURDOMAIN\ (Set REMOVE_PREFIX = YOURDOMAIN\ ). This should make the WIKIUSERNAME appear as Main.loginid. If it doesn't, please check the logs as per LoginNameAliasesPluginDoc (This would have been copied into your own installation). You can set the parameters DEBUG and LOGGING to off after it works.

Please note that even if the user logs into the domain as UserlogiN, the WIKIUSERNAME will appear as Main.userlogin. To put some of these users into some groups, user their WIKIUSERNAMES without the Main. part (e.g.: userlogin1, userlogin2 instead of Main.userlogin1, Main.userlogin2)

-- Contributors: ChengappaCB - 26 Dec 2007

Comments & Questions about this Supplemental Document Topic


I have installed Twiki application in my local desktop and configured as pe the document provided at "http://www.twiki.org/cgi-bin/view/TWiki/WindowsInstallCookbookForTWiki04x01#Server_OS". After the configuration I cannot able to access the URL "http://twikiserver/". Could some one please assist.

-- SharathSharma - 18 Jul 2008


I've installed per these instructions and when I click "Next" on the configuration screen (no errors being displayed) I get:

Use of uninitialized value $filename in substitution (s///) at (eval 42) line 23.

Any thoughts about this? Thanks!

-- RobStanfield - 18 Sep 2008

Please use the Support forum if you have questions about TWiki features. This comment section is about the documentation of this topic.
Topic attachments
I Attachment History Action Size Date Who Comment
GIFgif image001.gif r1 manage 0.1 K 2007-12-26 - 05:51 ChengappaCB Cygwin logo
GIFgif image002.gif r1 manage 0.3 K 2007-12-26 - 05:52 ChengappaCB Image for Note:
JPEGjpg image003.jpg r1 manage 18.8 K 2007-12-26 - 05:53 ChengappaCB First Configure screen
Edit | Attach | Watch | Print version | History: r5 < r4 < r3 < r2 < r1 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r5 - 2008-09-18 - RobStanfield
  • Learn about TWiki  
  • Download TWiki
This site is powered by the TWiki collaboration platform Powered by Perl Hosted by OICcam.com Ideas, requests, problems regarding TWiki? Send feedback. Ask community in the support forum.
Copyright © 1999-2018 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.