# # AUTHSCHEME # There are 4 authentication options in the installer release. Manually you can add # more very simply by modifying the resulting twiki.conf file. The authentication # modules this has been tested with are: # # * NONE - Everyone can edit without registering, or logging in. # # * HTPASSWD_AUTH - Everyone can edit after registering, and logging in. # The location of the .htpasswd file manipulated by Twiki for this # is in: # * TWIKIBASELOCATION/TWIKISTEM/etc/.htpasswd # # * MOD_LDAP - LDAP Authentication using the MOD_LDAP module. This # is the module that uses the following apache directives: # * LDAPAuth # * LDAPServer # * LDAPuser # * LDAPBase # * LDAPSearchMode # # * AUTH_LDAP - LDAP Autrhentication using the AUTH_LDAP module. This # is the module that uses the following apache directives: # * AuthLDAPURL # AUTHSCHEME=HTPASSWD_AUTH # # FQDN # This is the hostname the twiki server is hosted on. # FQDN=127.0.0.1 # # HTTPDCONF # This is where the apache httpd.conf file is. This is needed so that # after creating a twiki.conf to include we can insert an "Include" line # into the httpd.conf to activate the twiki installation. On many linux # systems, this will be /etc/httpd/httpd.conf. On many solaris systems # the path will be more like /usr/local/apache/etc/httpd.conf or # /opt/apache/etc/httpd.conf or similar. (Depending on the sys admin) # HTTPDCONF=/cygdrive/c/Progra~1/Apache~1/Apache/conf/httpd~1.con # # HTTPDLOCATION # This is where apache server is on your system. (ie the directory that # normally contains the cgi-bin, htdocs, icons etc. Twiki need not be # installed there however. # HTTPDLOCATION=/cygdrive/c/Progra~1/Apache~1/Apache/ # # LDAPBASE # If using LDAP authentication, then you need to identified the distinquished # name to authenticate against - this is gained by combining the ldap base # with the uid field. # # An example LDAP base is given as the default. This varies depending on your # server type & installation. Please refer to your LDAP administrator if unsure # of what to put here. # LDAPBASE=dc=example,dc=com # # LDAPPORT # If using LDAP authentication, then to connect to the server as well as the # hostname, we need to know which port to connect to. This is usually port # 389 (default), but can occasionally be different. # LDAPPORT=389 # # LDAPSERVER # If using LDAP authentication, we obviously need to know which LDAP server to # use to authenticate requests. Common names are things like ldap.example.com, # directory.example.com, addressbook.example.com, phonebook.example.com . # # Please refer to your LDAP administrator if unsure what to put here. # LDAPSERVER=ldap.example.com # # LDAPUIDATTR # If using LDAP authentication, then you need the user id field/attribute # to authenticate against. This is usually "uid" (default), but can # occasionally be different. # LDAPUIDATTR=uid # # LOCALTEMPLATETARBALL # Location of a local tar ball of a template web. # LOCALTEMPLATETARBALL=etc/LocalTemplates.tar # # MAINWEBNAME # When a user registers with TWiki the user pages are placed in the %MAINWEB%. # Many people (not all) like to store user pages elsewhere - a "User", # "People", or "Home" web. If you want users placed in an alternative place, # the "Main" web will be renamed to the new name, and a new Main web will be # generated from the _default template web. # MAINWEBNAME=People # # TOOLNAME # A small number of people like to rebrand TWiki completely - which means # renaming the TOOLNAME something else. If your installation requires this, # change this variable. Again, you are unlikely to want to change this. # TOOLNAME=TWiki # # TWIKIAUX # Name of the aux directory for this twiki server. Things placed in the aux # directory are executable addons to twiki, which may utilise various parts # of twiki (eg similar to the view/edit scripts) but are local to an installation # and not part of the Twiki code base. (The alternative is to put the stuff in # the normal TWIKIBIN directory - but that makes life more complicated around # upgrade time. # TWIKIAUX=aux # # TWIKIBASELOCATION # This is the directory in which the entire twiki tree is unpacked beneath. # The Twiki tree is unpacked into the "TWIKISTEM" directory inside this. # eg: # given TWIKIBASELOCATION of /export (default) # TWIKISTEM of twiki (default) # # Then all the twiki stuff is unpacked into /export/twiki/ # ie $TWIKIBASELOCATION/$TWIKISTEM is the installation directory. # # The separation of path & directory allows for a greater variety of # installations # TWIKIBASELOCATION=/home # # TWIKIBIN # Name of the bin directory for this twiki server. Default is bin, # however some people have to run with a TWIKISTEM of "/" and a TWIKIBIN # directory of cgi-bin # TWIKIBIN=bin # # TWIKISTEM # This is two things : the name of the directory with twiki in, and the # "stem name" that will appear in the URL. eg with everything as defaults, # the request URL for a twiki Main.WebHome page would look like this: # # http://www.example.com/twiki/bin/view/Main/WebHome # # If the twikistem was twiki2, then the URL would look like this: # # http://www.example.com/twiki2/bin/view/Main/WebHome # # On the server the first URL may be served from this installation: # /export/twiki/ # # the second URL may be served from this installation: # /export/twiki2/ # TWIKISTEM=twiki # # TWIKIURL # Not everyone can run with a URL that looks like: # http://www.example.com/twiki/bin/view/Main/WebHome # # Some people need to run with an URL that looks more like: # http://www.example.com/~randomuser/twiki/bin/view/Main/WebHome # # This TWIKIURL allows the user to insert the ~randomuser part into the # URL using a TWIKIURL value of /~randomuser . The default value for # this option is "". (ie no leading path on the TWIKIURL) # # TWIKIURL= # # TWIKIWEBNAME # Having a set of web pages called "TWiki" can be confusing - people like to # know where to go for "System" things "Help" on the system and so on. Some # people like it, some don't. This allows you to configure it for yourself. # TWIKIWEBNAME=System # # WEBHOME # When integrating/publishing a TWiki web using GenHTML you have to exclude # pages, with the default being Web.* which allows you to exclude many # "system" pages. This is great. It does mean you miss out WebHome however! # # Renaming WebHome to something else - eg HomePage - sidesteps this issue # completely. In general many people probably will keep this as WebHome. # WEBHOME=HomePage # # WIKIUSERS # This is useful in the case of rebranding a TWiki for acceptance, having the # system put lists of users into a TWikiUsers page can be intimidating. # A common alternative is to rename TWikiUsers to LocalUsers. Again you are # unlikely to want to change this. # WIKIUSERS=TWikiUsers # # APACHECTLSCRIPT # The installer attempts to restart the Apache server. In order to do this, # the script runs a script along the lines of: # # /etc/init.d/apache restart # or # # apachectl restart # # If you are not using the default script name listed here, please change this # value to the full path name. (eg /etc/init.d/apache, /usr/sbin/apachectl, # etc) # APACHECTLSCRIPT="/cygdrive/c/Progra~1/Apache~1/Apache/apache.exe -w -n Apache -k restart"