|
|
新版本校园Debian:wiki服务器的安装
一 wikid和教育
林君一直鼓捣我建设一个教育教学方面wiki服务器,也符合我一向认为的“wiki比blog更适合于教育教学”的观点,便应允。至于我们准备建设一个如何的wiki网站,它不同于目前已有的与教育相关的wiki网站的特色在哪里等问题,将另文叙述。以下只谈技术方面的问题。
二 wiki服务器的选择
由于开源世界的博大精深,反而使得这个选择非常的困难,这个网页(http://www.allwiki.com/wiki/Wiki ... ,结果如下:
几种主要wiki发布程序的最新版本:(2006年4月)
mediawiki 1.6.3
twiki 4.0.2
phpwiki 1.3.12 p2
docuwiki 20060305
moinmoin 1.5.3
而在Debian(Etch)中依次是:
mediawiki 1.4.15-1
twiki 20040902(? 没有人维护?)
phpwiki 1.3.11 p1
docuwiki 无
moinmoin 1.5.2-6
我不可能一一测试,最后只选择安装mediawiki和moinmoin两个进行安装测试。
考虑到sarge中这些软件的版本确实太老,而且按计划应该今年年底发布Etch,因此我安装mediawiki和moinmoin都是在Etch上进行,但是都没有使用Debian自己的包管理系统来安装,而是都选择了源代码安装。
三 基本系统LAMP的安装:
1 下载Sarge的netinst.iso安装光盘安装,我今天使用的是Sarge3.1r2。
2 安装Sarge系统。
3 进入新的系统,修改/etc/apt/sources.list文件,将其中的stable都修改为etch。
4 #apt-get update
5 #apt-get dist-upgrade
至此,etch系统已经安装完成。以上是当前官方推荐的安装etch的方式。
6 #apt-get install apache2 php5 mysql-server-5.0 mysql-client-5.0
构建LAMP系统,已经抛弃了经典的apache+php4+mysql4,现在用的都是新版本。也不用修改什么配置文件,现在都可以跑起来了。
7 #apt-get install php5-gd phpmyadmin
这一步并不是一定要,前者使得php可以处理图形,后者方便使用mysql数据库,因为我对mysql的命令行并不是很熟悉。
四 mediawiki的安装使用:
1 简介
MediaWiki全球最著名的开源wiki引擎,运行于PHP+MySQL环境。从2002年2月25日被作为维基百科全书---这个最著名的网络百科全书目前应该在国内无法访问---的系统软件,并有大量其他应用实例。目前MediaWiki的开发得到维基媒体基金会的支持。
mediawiki的优点主要体现在:能经受重量级应用的考验,功能丰富却架设简单,如全世界最大的wiki项目维基百科是使用mediawiki的成功范例,数据量、访问量都超级庞大;mediawiki的功能非常丰富,支持多语言版本,充分满足知识站点的需要;运行环境要求很低,架设过程简洁,即使新手也可以迅速建立自己的站点;具有最大的wiki程序社区的支持;持续开发,程序特性功能不断完善,保证未来的支持,因为mediawiki是受到维基媒体基金会支持的开源项目,在功能、性能、安全方面将不断优化。
2 源码安装----显然以下安装过程适合任何一种Linux发行版本:
2.1) 下载源码,2M多,官方网站上不了就找镜像网站!
2.2) 解压到apache2的缺省目录,一般是:
# cd /var/www
# tar zxvf ...../mediawiki-1.6.3.tar.gz
# ln -s mediawiki-1.6.3 mediawiki (我的习惯都做一个符号连接)
# cd mediawiki
然后最好仔细读读其中的README和INSTALL文件。
2.3) 将其中的config目录属性修改为可写:
# chmod a+w config
2.4) 在客户端打开浏览器,在浏览器的地址栏输入该wiki的地址,在我的环境下是:
http://192.168.1.203/mediawiki/
2.5) 第一使用的话,浏览器里面显示要求你先安装(setup)mediawiki。
2.6) 那就填表吧,一些重要的填表项目列于下:
之后,根据页面提示填写相应的内容:(请对以下内容做好记录,以便升级时使用)
* Site name:你的wiki站点名称。注意:这与网站本身的名字空间有关,建议使用简短的英文(以后可修改)
* Language:语种选择。建议选择zh-cn简体中文或zh-tw繁体中文;没必要就不要选支持繁简体自动转换的zh中文,否则此后网站提示的本地化工作量将增加很多
* Copyright/license medadata:版权类型。其中GNU为公开的自由版权,允许他人复制、修改;不确定该用什么版权时选no license metadata
* Sysop account name:站长的名字。这是建立wiki后的第一个管理员用户,以后无法改名。可考虑使用英文名字
* Shared memory caching:网站缓冲机制,建议选择Turck MMCache,将大幅提高整站的整体性能。
* MySQL server:填写空间服务商提供的MySQL服务器名称,一般为localhost
* Database table prefix:数据表前缀。建议设置前缀,以便与本站的其他软件公用MySQL数据库,甚至同时架设多个wiki(需放在不同目录)。
* DB root password:数据库超级用户root密码,缺省为空密码。
2.7) 执行了以上浏览器安装过程后,在config目录下会自动生成一个LocalSettings.php的本地配置文件,把它拷贝到wiki的主目录中---即config的上层目录。然后需要取消config目录的写权限,推荐直接删除,这是网站安全性的需要。
2.8) 享受mediawiki吧。
3 Debian安装
Etch中的mediawiki如果采用apt安装的话,要求使用php4+mysql4,在我的上述php5+mysql5系统中安装失败。
五 Moinmoin的安装使用:
1 简介:
MoinMoin是一个基于Python环境的wiki引擎程序,支持包括中文在内的多语种特性。Moin是德国北部方言“好”、“早上好”的意思,MoinMoin就是很好之意。
MoinMoin的特点主要是:完全使用文件来存储内容,不使用数据库;实现了全部Wiki规范,Unicode编码支持多语种;完整实用的wiki文本约定,编辑规则比较轻巧易学;支持多种扩展方式: 如宏,插件,预处理等;为数众多的插件中包括Tex科技文本输入、FreeMind思维导图、GraphViz示意图、gnuplot数据图表绘图等,这是我觉得非常重要的;真正跨平台实现等。
2 源码安装:
21) 本来我想先升级系统的Python到新的2.4版本,因为无论是Sarge还是Etch,其缺省使用的python都是2.3版本的,但由于我想使用mod_python的方式来运行MoinMoin,而目前的Etch中,没有libapache2-mod-python2.4这个包,但是有libapache2-mod-python2.3,所以我放弃了升级Python到2.4的计划。
如果以cgi的方式来运行MoinMoin,应该可以使用Python2.4
22) 下载MoinMoin源码并解压,以下是我的:
# cd
# wget http://...../moinmoin-1.5.3.tar.gz
# tar zxvf moinmoin-1.5.3.tar.gz
# cd moinmoin-1.5.3
以下23-25是MoinMoin官方要求的安装的三个步骤:
23) 基本安装
# apt-get install python2.3-dev (这步不可少,否则无法继续)
# python setup.py --quiet install
(如果是非root用户安装到/home下,则做法有所不同,详见官方文档,使用虚拟主机并采用cgi方式的用户这里注意)
MoinMoin被安装到 /usr/lib/python2.3/site-packages/MoinMoin和 /usr/share/moin目录下。
24) 创建实例
这个步骤实际上就是要把一些系统制作好的模版复制到用户的www目录去,并进行相应的文件权限设置,我假设要把自己的wiki建设在apache缺省目录的mymoin目录下。
# cd /var/www
# mkdir mymoin
# cd mymoin
# cp -R /usr/share/moin/data . # copy template data directory
# cp -R /usr/share/moin/underlay . # copy underlay data directory
# cp /usr/share/moin/config/wikiconfig.py . # copy wiki configuration sample file
(以上复制必要的文件和目录,最后那个小圆点不可忘记)
# cd /var/www
# chown -R www-data.www-data mymoin # check that USER and GROUP are correct
# chmod -R ug+rwx mymoin # USER.GROUP may read and write
# chmod -R o-rwx mymoin # everybody else is rejected
(以上是按官方要求设置文件和目录权限)
# cd mymoin
# nano wikiconfig.py
编辑这个配置文件主要是修改两个地方:使其使用绝对路径:
data_dir = '/var/www/mymoin/data/'
data_underlay_dir = '/var/www/mymoin/underlay/'
25) 配置MoinMoin的运行方式和修改apache配置文件
MoinMoin必须运行在Apache下,有四种不同的运行方式,分别是cgi,fast-cgi,mod_python,twisted,他们之间的区别在此略。我选择采用mod_python方式。
# apt-get install libapache2-mod-python2.3
(不知道Etch正式发布时是否会有mod_python2.4)
# apache2ctl restart
这里要结合查看log文件确定apache的mod_python已经启动。
修改apache的配置文件(分别是/etc/apache/httpd.conf和/etc/apache2/apache2.conf),在其中加入:
<Location /mymoin>
SetHandler python-program
# Add the path of your wiki directory
PythonPath "['/var/www/moin/mywiki'] + sys.path"
PythonHandler MoinMoin.request::RequestModPy.run
</Location>
26) 在客户端浏览器中输入:
http://your_server_ip/mymoin/
就可以了。
3 Debian安装:
使用 #apt-get install python2.3-moinmoin代替上述的22和23就可以,其余步骤相同。
以上只是两个Wiki服务器的安装,实际中,更为重要的工作是对服务器进行更精细的配置和修改,下回分解。 |
|