Installation Guide

Installation

Windows

On windows you have 2 choices. 1. Follow the Unix guide (next section) or 2. download the installer.

The windows installer is basically re-packaged XAMPPLite distribution which contains Apache, PHP and some extras. RADWiki has been added to the package and everything is wrapped up in an installer.

Note that for the sake of simplicity you can only install into c:\RADWiki. RADWiki can be found in c:\RADWiki\dist and other XAMPPLite files in c:\RADWiki\xampplite

If you want to set up things somewhat different, but still rather quickly, you can of course downlodad XAMPPLite yourself (or XAMPP, a distribution with more bells and whistles). Check it out at http://apachefriends.org. Note that they also have distributions for Linux. If you decide to do it yourself please follow the Unix guide.

Linux/Unix, OSX, etc

Setting up RADWiki is a fairly standard procedure (for a PHP project). Before you start the following components must be installed and functional:

  • Apache
  • PHP 5
    • PDO with SQLite (shared library) enabled. Make the following changes to your php.ini file:

; Add (or uncomment) the following lines in the php.ini file
; replace ".so" with the extension that is correct for your platform (Windows: ".dll")
extension=php_sqlite.so
extension=php_pdo.so
extension=php_pdo_sqlite.so

If your operating system is Ubuntu Linux (tested on 7.04) you can install apache, php and sqlite running this command (remember to modify the php.ini file afterwards):

apt-get install php5-sqlite

Installation instructions;

  • Extract the RADWiki archive into the web root of the Apache server
  • You may rename the default directory (the top directory extracted from the archive) if you wish to do so.
  • Rename or copy site.ini.dist (in the top directory) to site.ini and modify this file as needed (see below).
  • Test that everything works by directing your web browser to http://<installation_host>/RADWiki
  • Note: If your host is doolittle.com and you extracted and renamed the default directory to myWikiApps that would be http://doolittle.com/myWikiApps
  • Go to Settings -> useradmin to change the administrator password. When prompted for a user and password use Admin/Admin.
  • To setup/add/remove applications the applications.ini file must be edited. See the ApplicationGuide for more on this subject.

Configure site.ini

  • Make sure that SITE_ROOT_DIR and SITE_ROOT_URL are correct.
  • Change SITE_NAME to get a different title in the browser "bar".
  • If you are going to make lot of page changes set MAX_REVISION to a high number. When the value of page versions (for a single page) is equal to MAX_REVISION old page versions will be deleted.

Example

;;;; Site Directories
SITE_ROOT_DIR = /CHANGE/PATH/TO/RADWiki
SITE_ROOT_URL = /RADWiki

;;;; Other
STYLE = default
SITE_NAME = R*A*D*Wiki

;;;; Choose the default application
DEFAULT_APP = RADWIKI

;;;; Select the number of page revisions to save
MAX_REVISION = 25

Unless otherwise stated, the content of this page is licensed under Creative Commons Attribution-Share Alike 2.5 License.