none
authorPeterThoeny <PeterThoeny>
Wed, 4 Jun 2003 06:28:50 +0000 (06:28 +0000)
committerPeterThoeny <PeterThoeny>
Wed, 4 Jun 2003 06:28:50 +0000 (06:28 +0000)
TWiki/TWikiInstallationGuide.mdwn

index 2b47ac7..a52324c 100644 (file)
@@ -160,10 +160,10 @@ You can also edit `$localPerlLibPath` in the `setlib.cfg` file if you are not ro
 - Set the permission of all files below `twiki/data` so that they are writable by user `nobody`. A simple way is to `chmod` them to `-rw-rw-r--` (664) and to `chown` them to `nobody`.
 - Set the permission of the `twiki/data` directory and its subdirectories so that files in there are writable by user `nobody`. A simple way is to chmod them to `drwxrwxr-x` (775) and to `chown` them to `nobody`.
 - Set the permission of the `twiki/pub` directory and all its subdirectories so that files in there are writable by user `nobody`. A simple way is to `chmod` them to `drwxrwxr-x` (775) and to `chown` them to `nobody`.
-- %H% The `twiki/data/*/*.txt,v` RCS repository files in the installation package are locked by user `nobody`. If your CGI scripts are **_not_** running as user `nobody`, it's not possible to check in files (you'll see that the revision number won't increase after saving a topic). In this case, you need to unlock all repository files (check the RCS man pages) and lock them with a different user, ex `www-data`, or delete them all - new files will be automatically created the first time each topic is edited. A simple way to change ownership is with a search-and-replace in all files; for example, using perl:
+- %H% The `twiki/data/*/*.txt,v` RCS repository files in the installation package are locked by user `nobody`. If your CGI scripts are **_not_** running as user `nobody`, it's not possible to check in files (you'll see that the revision number won't increase after saving a topic). In this case, you need to unlock all repository files (check the RCS man pages) and lock them with a different user, such as `www-data`, or delete them all - new files will be automatically created the first time each topic is edited. A simple way to change ownership is with a search-and-replace in all files; for example, using Perl (type this carefully!):
 
 > cd twiki/data
->     perl -pi~ -e 's/nobody(\:[0-9\.]+[\;\s]+strict\;)/www-data$1/' */*,v
+>     perl -pi~ -e 'NR <= 10 && s/nobody:/www-data:/ ' */*,v
 
 ### <a name="Step 3: Set the Main Configurati"></a> Step 3: Set the Main Configuration File
 
@@ -178,11 +178,12 @@ You can also edit `$localPerlLibPath` in the `setlib.cfg` file if you are not ro
 
 ### <a name="Step 4: Configure Site-Wide Emai"></a> Step 4: Configure Site-Wide Email Preferences
 
-- From your web browser, edit the [[TWikiPreferences]] topic in the TWiki:TWiki web to set the `WIKIWEBMASTER` email address, and other email settings required for registration and [[WebChangesAlert]] to work:
+- Edit the [[TWikiPreferences]] topic in the TWiki web (by pointing your browser to http://yourdomain.com/twiki/bin/view/TWiki/TWikiPreferences) to set the `WIKIWEBMASTER` email address, and other email settings required for registration and [[WebChangesAlert]] to work:
   - `WIKIWEBMASTER` should be set to the email address of the TWiki administrator
   - `SMTPMAILHOST` is typically set on Windows or other non-Unix/Linux systems, where `sendmail` or similar is not available. When this is set and the Perl module <code>**Net::SMTP**</code> is installed, TWiki will connect to this SMTP server (e.g. `mail.yourdomain.com`) to send email for user registration and [[WebChangesAlerts]]. If you do have a sendmail-type program, leave `SMTPMAILHOST` unset so that the external sendmail program is used instead (defined by <code>**$mailProgram**</code> in <code>**TWiki.cfg**</code>).
   - `SMTPSENDERHOST` is optional, and set to the domain name sending the email (e.g. `twiki.yourdomain.com`). For use where the SMTP server requires that you identify the TWiki server sending mail. If not set, <code>**Net::SMTP**</code> will guess it for you.
 - You may want to set up other [[TWikiPreferences]] later on.
+- To enable the [[WebChangesAlerts]] (email notifications) you need to read about cron in the topic [[TWikiSiteTools]].
 
 ### <a name="Step 5: Finish Up from Your Brow"></a> Step 5: Finish Up from Your Browser
 
@@ -234,4 +235,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]] - 28 Dec 2002 <br /> -- [[MikeMannix]] - 16 May 2002
+-- [[PeterThoeny]] - 03 Jun 2003 <br /> -- [[MikeMannix]] - 16 May 2002