none
[openafs-wiki.git] / TWiki / TWikiInstallationGuide.mdwn
index 57c41be..8aa5091 100644 (file)
@@ -53,6 +53,7 @@ Request and download the TWiki 01-Sep-2001 distribution in Unix ZIP format from
 >      <Directory "/home/httpd/twiki/bin">
 >       Options +ExecCGI
 >       SetHandler cgi-script
+>       AllowOverride all
 >       Allow from all
 >      </Directory>
 >      <Directory "/home/httpd/twiki/pub">
@@ -148,7 +149,7 @@ To install TWiki on a system where you don't have server administrator privilege
 - Point your Web browser at `http://yourdomain.com/twiki/bin/view` and start TWiki-ing away!
 - Edit the [[TWikiPreferences]] topic in the TWiki:TWiki web to set the `WIKIWEBMASTER` email address, and other preferences.
 - Edit the [[WebPreferences]] topic in each web, if necessary: set individual `WEBCOPYRIGHT` messages, and other preferences.
-- Enable email notification of topic changes, [[MonitoringSiteActivity]] has more.
+- Enable email notification of topic changes, [[TWikiSiteTools]] has more.
 - Edit the [[WebNotify]] topic in all webs and add the users you want to notify.
 - Add the TWiki:Main/PoweredByTWikiLogo to your [[WebHome]] topic.
 - You can add new `%VARIABLES%`. Define site-level variables in the [[TWikiPreferences]] topic. See also: [[TWikiVariables]].
@@ -165,6 +166,7 @@ With your new TWiki installation up and running, you can manage most aspects of
   1. **Rename** file `.htaccess.txt` in the `twiki/bin` directory to `.htaccess` and change it to your needs. For details, consult the HTTP server documentation (for Apache server: [[1]](http://www.apache.org/docs/mod/directives.html), [[2]](http://www.mcs.kent.edu/system/web_help/htaccess/introduction.html)). In particular, the following <font>red</font> part needs to be configured correctly: <br /><code>Redirect <font>/urlpath/to/TWiki/index.html</font> http://<font>your.domain.com/urlpath/to/TWiki/bin/</font>view</code><br /><code>AuthUserFile <font>/filepath/to/TWiki/data/</font>.htpasswd</code><br /><code>ErrorDocument 401 <font>/urlpath/to/TWiki/bin/</font>oops/TWiki/TWikiRegistration?template=oopsauth</code>
     - **_NOTE:_** In case you renamed the CGI script files to have a file extension you need to reflect that in the `edit`, `view`, `preview`, etc entries in `.htaccess`.
     - **_NOTE:_** The browser should ask for login name and password when you click on the <u>Edit</u> link. In case `.htaccess` does not have the desired effect you need to enable it: Add "AllowOverride All" to the Directory section of `access.conf` for your `twiki/bin` directory.
+    - **_NOTE:_** The distribution package has a `twiki/data/.htpasswd` file which contains some TWiki core team user accounts and a guest user account. You probably want to remove those accounts by deleting the entries in `.htpasswd`. Do not remove the guest user in case you want to allow guest logins.
   2. **Copy** the [[TWikiRegistrationPub]] topic to [[TWikiRegistration]]. Do that by either editing the topics in theTWiki web, or by renaming the `.txt` and `.txt,v` files in the `twiki/data/TWiki` directory.
     - **_HINT:_** You can customize the registration form by deleting or adding input tags. The `name=""` parameter of the input tags must start with: `"Twk0..."` (if this is an optional entry), or `"Twk1..."` (if this is a required entry). This ensures that the fields are processed correctly.
 - Register yourself in the [[TWikiRegistration]] topic.
@@ -206,4 +208,4 @@ Optionally, you can also:
 
 See [[Appendix A: TWiki File System|Main/AppendixFileSystem]] for an installed system snapshot and descriptions of all files in the TWiki 01-Sep-2001 distribution.
 
--- [[PeterThoeny]] - 13 Sep 2001 <br /> -- [[MikeMannix]] - 14 Sep 2001 <br />
+-- [[PeterThoeny]] - 13 Sep 2001 <br /> -- [[MikeMannix]] - 03 Dec 2001