Warning. This is not a typical or normal installation provided here. This topic needs to be rewritten

• You should not be installing an old 1.0.9 on Centos. Always install the latest released Foswiki.
• The description below show an installation using port 81. That is not normal and not recommended.

Installing Foswiki 1.0.9 under CentOS 5.2

Scenario

• OS: CentOS 5.2
• Perl: v5.8.8, /usr/bin/perl
• Apache: Apache/2.2.3
  • doc root: /var/www/
  • config files: /etc/httpd/conf.d/
  • Apache user and group: apache:apache

Installation steps

All steps should be executed as root user.

Install perl LWP

Using yum from console:

• yum install perl-libwww-perl

Download & Extract

The link to tar.gz file is located in the following page:

• http://foswiki.org/Download/DownloadFoswiki

Download and extract:

• cd /tmp
• wget http://downloads.sourceforge.net/project/foswiki/foswiki/1.0.9/Foswiki-1.0.9.tgz?use_mirror=mesh
• cd /var/www/
• tar -xvf /tmp/Foswiki-1.0.9.tgz
• mv Foswiki-1.0.9/ foswiki/
• chown -R apache:apache /var/www/foswiki

Create LocalLib.cfg

The LocalLib.cfg file is used by Foswiki to find Perl libraries.

• • cd /var/www/foswiki/bin
  • cp LocalLib.cfg.txt LocalLib.cfg
  • chown apache:apache LocalLib.cfg
  • vi LocalLib.cfg
  • Change the row $foswikiLibPath into $foswikiLibPath = "/var/www/foswiki/lib";

Protect configuration page

Create .htpasswd file to protect configuration page:

• cd /var/www/foswiki/data
• htpasswd -c .htpasswd AdminConfigure
• choose a password (if you forget just delete and recreate the file)
• chown apache:apache .htpasswd

Reference:

• http://foswiki.org/Support/ProtectingYourConfiguration

Create conf file for apache

Open the following URL:

• http://foswiki.org/Support/ApacheConfigGenerator

Fill the fields as follows (leave blank or unchecked the parameters not listed here):

• Host Name: localhost
• Port: 81
• Path: /var/www/foswiki
• URL Path: / (for short URL)
• Short-URLs: Enabled (you'll need an Apache module for this to work: mod_rewrite)
• Runtime Engine: CGI
• Enter the list of user names that are allowed to access configure: AdminConfigure?
• Choose your Login Manager: TemplateLogin?
• Page to return when authentication fails: UserRegistration
• Click on "Update config file" button
• Copy the text that appears in the box below
• Paste the configuration in foswiki.conf file: vi /etc/httpd/conf.d/foswiki.conf
• Add the red lines of code in the file foswiki.conf in the following tag:
  <!FilesMatch "^(configure)$">
  SetHandler cgi-script
  Order Deny,Allow
  Deny from all
  Require user AdminConfigure
  Satisfy All
  </FilesMatch>
• Save and exit the file: :wq!
• Restart the webserver: service httpd restart

Reference:

• http://foswiki.org/Support/ProtectingYourConfiguration
• http://foswiki.org/Support/ShorterUrlCookbook

Ready to start installation

In your browser point to:

• http://<yoururl>:81/bin/configure
• A popup will appear: authenticate with username and password configured before ( AdminConfigure:<yourpassword>)
• You'll be prompted to a configuration page: check the warnings, usually foswiki guess the right way all the paths.
• Click on the Next button at bottom of the page.
• In the new page you have to choose a new password: this password belong to the special user "admin", built in into the system. We'll use one more time this user to create wiki Administrators later.
• Click on the button "Change password and save"
• A report page is displayed.
• Return to configuration (bottom page link)
• Click on "Mail and Proxies"
• Set the webmaster email (you'll receive notifications), the webmaster name and the mail program used to send mail.
• Click on next, then Save
• At the bottom you can find the link to the Foswiki frontpage.

Create the first administrator

Once the first page of the wiki is loaded log in as:

• user = admin
• password = the one chosen in "Protect your configuration" chapter

Go to:

• http://localhost:81/Main/AdminGroup

And follow the instructions in the yellow box.
You can use a wikiname that still doesn't exist (let's say MyName).
After you completed the steps editing the AdminGroup topic just register with the wikiname used in the previous step (eg. MyName):

• http://localhost:81/System/UserRegistration

Now you have an administrator user!