|
» |
|
|
|
|
|
|
|
|
Rishi Singhal, OpenVMS Debugger team
|
|
|
|
|
This article provides a brief introduction to wikis, the advantages of a wiki for knowledge management, and a step-by-step approach to configuring a wiki engine (such as PmWiki) on an i64 system.
|
|
|
|
|
|
Requirements
- OpenVMS v8.3 running on an i64 system
- CSWS_PHP version 1.3 based on PHP 4.3.10
- CSWS v2.1-1 based on Apache
Installation
- Download pmwiki-2.2.0-beta65.zip from: http://www.pmwiki.org/wiki/PmWiki/Download
- Copy the kit to SYS$COMMON:[APACHE] (assuming ODS-5 system disk; can be copied to any other ODS-5 disk)
- Unzip the kit:
$ unzip pmwiki-2^.2^.0-beta65.zip
Configuring
- Modify SYS$COMMON:[APACHE.CONF]MOD_PHP.CONF to reflect access path for PmWiki. Add below line (after the line containing - Alias /php/ "/apache$root/php/scripts/")
Alias /wiki/ "/apache$common/pmwiki-2_2_0-beta65/"
- Restart apache and open a web browser pointing to the pmwiki.php script on the server:
http://node.domain.com/wiki/pmwiki.php
- PmWiki will then analyze your system configuration and provide instructions (if needed) for creating the wiki.d/ directory, which will be used to hold the pages created for your site.
- The following directories will be created:
Directory SYS$COMMON:[APACHE.pmwiki-2_2_0-beta65]
wiki_d.DIR;1 wikilib_d.DIR;1
- The names of these directories are expected to be wiki.d.dir & wikilib.d.dir, so rename them.
- When you first install PmWiki, the SYS$COMMON:[APACHE.pmwiki-2_2_0-beta65.local]config.php file does not exist. Copy the sample-config.php file (present in SYS$COMMON:[APACHE.pmwiki-2_2_0-beta65.docs] directory) to SYS$COMMON:[APACHE.pmwiki-2_2_0-beta65.local]config.php and use it as a starting point.
$copy SYS$COMMON:[APACHE.pmwiki-2_2_0-beta65.docs]sample-
config.php SYS$COMMON:[APACHE.pmwiki-2_2_0-
beta65.local]config.php
- Modify (uncomment or add) SYS$COMMON:[APACHE.pmwiki-2_2_0-beta65.local]config.php. For example, to add Logo, Title, Password, and Enabling upload uncomment the lines as below:
#Provide a title to your wiki
$WikiTitle = "Provide a title";
#If you want to have your own logo copy it to the
#SYS$COMMON:[APACHE.pmwiki-2_2_0-beta65.pub.skins.pmwiki] #directory
$PageLogoUrl = "$PubDirUrl/skins/pmwiki/urlogo.png";
#Provide password for the administrator
$DefaultPasswords['admin'] = crypt('onesecret');
# Enable upload
$EnableUpload = 1;
Your wiki is ready to go, so refresh your http://node.domain.com/wiki/pmwiki.php page. You should see a page similar to this:
|
|
|
|
|
|
- While configuring PmWiki, if this is encountered:
Fatal error: Call to undefined function: preg_match() in /apache$common/pmwiki-2_2_0-beta65/pmwiki.php on line 43
Two PHP extensions present in SYS$COMMON:[APACHE.PHP]PHP.INI have to be uncommented
extension=php_pcre.exe
extension=php_session.exe
- To restrict upload by the privileged few, modify SYS$COMMON:[APACHE.pmwiki-2_2_0-beta65.local]config.php as
#Set password for upload
$DefaultPasswords['upload'] = crypt('secrettwo');
- If you want to track the modifications history, modify SYS$COMMON:[APACHE.pmwiki-2_2_0-beta65.local]config.php as
#While posting if you want the author name to be specified #compulsorily
$EnablePostAuthorRequired = 1;
- To restrict editing by the privileged few, modify SYS$COMMON:[APACHE.pmwiki-2_2_0-beta65.local]config.php as:
#Not everyone will be allowed to edit. All the pages are read only otherwise
$DefaultPasswords['edit'] = crypt('secretthree');
- To provide links to sharepoint (Microsoft® Windows®) use this format:
%newwin%[[file:///\\share\file.txt]]
- To use the same formatting as you have typed in the wiki editor, put your contents as: [@ formatted contents @]
- To use a different skin (goto http://www.pmwiki.org/wiki/Cookbook/Skins), such as monobook (makes PmWiki look like MediaWiki/Wikipedia):
Download monobook.zip, extract it into SYS$COMMON:[APACHE.pmwiki-2_2_0-beta65.pub.skins] and add the following code to your local configuration file (SYS$COMMON:[APACHE.pmwiki-2_2_0-beta65.local]config.php):
$Skin = 'monobook';
|
|
|