1. Setting up a Wiki SCS Admins Talk 9/13/2005 Tod Pike

2. What's a Wiki? ● A web-based collaboration tool ● An unstructured document management system ● An intranet ● An issue or trouble ticket tracking system ● A Perl-based system to convert text to HTML ● Whatever you want it to be!

3. Some Twiki Features ● can be used with any web browser ● simple text formatting commands to do many common formatting tasks ● pages are grouped into collections called webs ● structured content ● revision control ● full text search

4. Assumptions/Requirements ● Primarily Linux based, although Windows installation possible ● Primarily for Apache web server (IIS possible) ● This talk is aimed at installing on a facilitized Linux machine (RH9) ● Twiki is lightweight – anything that will run Apache will work

5. Test Machine Configuration ● Pentium II 300MHz ● 256 MB Memory ● 20GB Hard Drive ● RedHat 9 facilitized ● TWiki software takes up ~11MB

6. Preliminaries ● Get the software - http://twiki.orghttp://twiki.org ● Review installation instructions ● Get root access on Linux box

7. Install Web Server (wwwsrv) ● (note: wwwsrv not available on FC3 yet) ● become root ● put “services=wwwsrv” in /etc/quirk.local ● run “dosupdepot” ● run “/usr/local/etc/nanny -reconfig /etc/nanny.conf” ● verify that httpd is running

8. Install Twiki Software ● Suggest installing in /usr0 ● cp TWiki20040902.tar.gz to /usr0 ● tar xvzf Twiki20040902.tar.gz ● check for security patches

9. Configure HTTPD

10. Configure Twiki ● edit /usr0/twiki/bin/setlib.cfg, set $twikiLibPath ● edit /usr0/twiki/lib/TWiki.cfg, check variables ● secure twiki/data, templates and lib directories by copying in subdir-htaccess.txt to.htaccess ● set file permissions - see: http://twiki.org/cgi-bin/view/TWiki/TWikiInstallationGuide http://twiki.org/cgi-bin/view/TWiki/TWikiInstallationGuide ● verify with http: /twiki/bin/testenvhttp: /twiki/bin/testenv

11. Configure your Twiki ● set site variables in: http: twiki/bin/view/TWiki/TWikiPreferences http: twiki/bin/view/TWiki/TWikiPreferences ● set up authentication – rename twiki/bin/.htaccess.txt to.htaccess – edit it, see comments at the top – basic authentication is default – set a password using “htpasswd” command for TwikiGuest (default is “Guest”)

12. More on Authentication ● see install docs for important information about setting up authentication – some files need to be renamed for the registration form ● possible to use WebISO – really a web server issue, not a Wiki issue.

13. Customize your Wiki ● Edit pages individually ● Set up skins – My skin preference is “dragon” – Edit TwikiPreferences to change ● Add plugins ● Anyone can edit anything! Revision control available for backing changes out.

14. Wiki Editing Basics ● Separate each paragraph with a blank line. ● To display a word or phrase in bold type, put it in asterisks: *bold type*. ● To display a word or phrase in italic, put it in underscores: _italic_. ● To display a word or phrase in bold italic, put it in double underscores: __bold italic__. ● To link to another Wiki topic, type the WikiWord for that topic. To link to a Wiki topic in another web, type the name of the web, and a dot: Sandbox.WebHome.

15. More Editing Basics ● headings: ---++ Topic (add dashes for sub- headings) ● list items: * (add 3 spaces for nested items) ● ordered list: number. ● definition: $term: def ● lots more of these!

16. Other Wiki Versions ● PmWiki: (used by official CSD site) http://www.pmwiki.org http://www.pmwiki.org ● MediaWiki: (used by Sapphire project, Wikipedia) http://www.mediawiki.org/wiki/MediaWiki http://www.mediawiki.org/wiki/MediaWiki ● many others – pick one you like and suits your programming skills (php vs. Perl, etc)

17. Demo http://temp-tgp.fac.cs.cmu.edu/twiki/bin/view/Main/WebHome

18. Questions ?