twiki安装手记
时间：2009-03-11 来源：buxoman
-*- mode:outline -*-
* 安装过程实录
twiki是一个企业级的wiki系统，整个系统采用perl写就，具有精细的权限管理，比较适合在企业内部使用。
这个系统的资料虽然很丰富，但绝大部分都是英文的，看起来确实有点困难。本文就是我在学习、安装、配置、使用、管理中的一些笔记和心得。希望这个东西对于其它想尝试和使用该wiki系统的人有所帮助。可能会有不准确甚至错误的地方，请指出来。
* 安装
（0）系统环境
Windows Vista Home版
（1）取得twiki安装包。
我采用非安装形式的ZIP包。
版本：twiki-4.2.1
取得安装包后，将其解压缩到C盘根目录下（我喜欢放在这里，你也可以放在你喜欢的地方）。在目录命令上有一点要注意：不要使用空格，否则twiki在运行中会出错的。另外也最好不要使用中文的目录，大家都知道，国外的软件很少能正确处理汉字目录名的。到时候出一些莫名其妙的问题，让人焦头烂额的就不好了。
（2）取得activeperl的安装包。
默认安装即可。安装后，在C盘根目录下出现目录C:/Perl。
在twiki的配置中会用到。
注意把C:/Perl/bin目录加入到系统的PATH环境变量中。如果添加正确，那么在command命令行上输入perl命令就能显示一些正确信息，而不是找不到命令的错误信息。
（3）取得apache的安装包。
取最新的可执行安装包即可。安装过程中各种配置选项选择默认的配置即可。
我喜欢把这些软件都安装在C盘根目录下。
* 配置apache
鉴于我不是一个专业的服务器管理员，因此我们只按照最简单的方式进行配置。
有下列几个项目要进行配置：
** （1） ServerRoot
我的apache装在目录c:/Apache2.2，因此我就如下填写：
ServerRoot "C:/Apache2.2"
** （2）Listen
指定服务器监听的端口。好像默认就是80端口。可以指定IP地址，也可以不指定。我的设定如下：
Listen 80
由于某些原因，可能80端口已经被其他软件使用了。这时候可以指定一个别的端口，比如9000。
** （3）ServerName
服务器的名字。当你在浏览器地址栏里输入地址时就是这个了。我的设定如下：
ServerName localhost:80
如果你使用了不同的监听端口，这里要一致。
** (4) 检查apache是否正确安装
打开浏览器，在地址栏输入：
http://localhost
如果显示一个"It works"的页面，就表明apache web服务器正确地安装了。
* 配置TWiki
这个部分是比较难搞定的。
** (1) 修改LocalLib.cfg指定lib目录的绝对地址
在twiki/bin/目录下有一个模板文件LocalLib.cfg.txt，将其重命名为LocalLib.cfg。
然后打开该文件，修改其中的变量：
$twikiLibPath = "C:/twiki/lib";
其中的地址采用绝对地址。对于Windows系统来说，路径中的分隔符采用类似于Unix系统中的反斜线，
而不是采用Windows中的正向斜线。
最后，将修改好的LocalLib.cfg文件移动到目录twiki/lib/下。
** (2) 运行自动化工具指定Perl解释器的地址
打开cmd.exe(命令行)， 进入到目录 twiki/bin/，运行下列工具：
c:\twiki\bin> perl ..\tools\rewriteshbang.pl
屏幕会出现一些信息，首先提示你输入perl.exe的路径：
Enter path to interpreter [hit enter to choose 'perl']: C:/Perl/bin/perl.exe
根据你的输入，它会再次提示：
Enter path to interpreter [hit enter to choose 'C:/Perl/bin/perl.exe' ]:
这次直接回车即可。回车后，会看到一些提示：xxxx modified。提示有22个文件被修改。
接下来进入到twiki/tools目录，再次运行刚才的perl脚本：
c:\twiki\tools> perl rewriteshbang.pl
画面出现与之前类似的问题提示，你仍然输入 C:/Perl/bin/perl.exe。之后再次询问时直接回车即可。
最后提示有一个文件被改变。
* 修改Twiki的httpd配置文件
在Twiki安装的根目录下有个文件twiki_httpd_conf.txt, 将其重命名为twiki_httpd.conf，
然后将提示要求你修改路径的地方（以多个#符号开头）都修改成你的安装的绝对路径，例如
/home/httpd/twiki 换成 C:/twiki
* 修改Apache的conf/httpd.conf文件
在httpd.conf文件的最后，添加下列包含语句：
include "C:/twiki/twiki_httpd.conf"
到程序菜单中利用Apache的功能检查下配置文件，如果有配置错误就会提示。
一般会提示php_admin_flag engine off有错误，简单地注释掉这一行即可。
* 进入浏览器进行Twiki的初步配置
在浏览器地址中输入
http://localhost/twiki/bin/configure
就会出现一个配置画面。第一次进入系统，只有一个General path settings(12 warnings)可供配置。
** (1) 初消路径设定告警
在进入配置页面后，General path settings后会有个告警数量提示。点击该标签就会打开各种配置项。
首先就把其中凡属于Windows路径中的斜线替换成反斜线，其它的暂时不管它。
在页面的下方有个next按钮。点击按钮进入下一个保存页面。
保存页面要求你输入密码。若不设定密码它是不让你保存的。为了方便先配置一个容易记忆的密码，比如twiki123。
设定好密码后，有个change password and save按钮。点击后出现一个修改后的配置更新显示页面。
这个页面的最下方有两个连接，其中一个是 Return to configuration。点击这个连接回到配置页面。
这时你会发现配置页面多出了很多配置项，而且 General path settings也不提示告警了。
** (2) 消除Security setup安全告警
展开这个配置栏，配置项{Htpasswd}{FileName}中指定了用户密码存储文件名。
初始的文件名是C:/twiki/data/.htpasswd。
但是，我们要消除的告警不在这里，而是提示有Waring的第一项Paths的配置。
这个配置项类似于Windows中Path环境变量的设定。我们可以在这里指定twiki可以搜索的系统路径。
对于Windows来说， C:/Windows/system32这个目录是一定要加上的。其它的则需要按需加入了。
对于Windows有个简便的办法：进入命令行界面，输入PATH现实系统环境变量，然后将其抄到我们的配置项即可。
C:\Users\zyx>PATH
PATH=C:\Perl\site\bin;C:\Perl\bin;C:\Windows\system32;C:\Windows;C:\Windows\System32\Wbem
去掉其中明显不需要的路径，比如暴风影音的路径，还有那些不存在的路径，然后把这些路径拷贝过去就行了。
上述例子中的路径已经是我修改过后的路径。
同样点击页面最下方的next按钮，进入保存页面。输入密码，点击save按钮保存。
显示配置更新的页面，最后点击下面的连接返回到配置页面，继续进行后面的配置。
** (3) 消除Store settings存储配置中的错误设定
{StoreImpl} 选择【rcsWrap】还是【rcsLite】?
Twiki是利用rcs工具来进行版本管理的。在Unix提供上一般会安装，但对于Windows系统来说却没有这个软件。
因此只能用它自带的用perl实现的一个替代品。因此，这里就选择rcsLite即可。
保存这个配置后在返回这里。你会很高兴的发现许多的错误都被消除了。
** (4) 消除Mail and Proxies 邮件与代理的告警
对于Twiki来说，注册机制需要启用邮件。下列配置项需要设定：
{webMasterEmail} [email protected]
这个根据实际情况来设定就好了。我在自己的PC机上装着玩儿，所以就直接设定成了上面那样。
我曾经试过设定成webmaster@localhost，结果它仍然告警说不能识别为一个有效的邮件地址。
保存此设定后在回到配置页面，我们会发现已经没有任何的告警或错误了！
到这里已经完成了设定的第一步。先欣赏下我们的成果吧！
在浏览器中输入
http://localhost/twiki/bin/view
看看自家的twiki网站页面。
* 中文设定
对于咱中国人来说，看洋文毕竟太费脑子了。所以汉化是首要工作。
很可惜，Twiki对于汉字的支持不是很好，也就是能用而已。
(待续)
* 安装过程实录
twiki是一个企业级的wiki系统，整个系统采用perl写就，具有精细的权限管理，比较适合在企业内部使用。
这个系统的资料虽然很丰富，但绝大部分都是英文的，看起来确实有点困难。本文就是我在学习、安装、配置、使用、管理中的一些笔记和心得。希望这个东西对于其它想尝试和使用该wiki系统的人有所帮助。可能会有不准确甚至错误的地方，请指出来。
* 安装
（0）系统环境
Windows Vista Home版
（1）取得twiki安装包。
我采用非安装形式的ZIP包。
版本：twiki-4.2.1
取得安装包后，将其解压缩到C盘根目录下（我喜欢放在这里，你也可以放在你喜欢的地方）。在目录命令上有一点要注意：不要使用空格，否则twiki在运行中会出错的。另外也最好不要使用中文的目录，大家都知道，国外的软件很少能正确处理汉字目录名的。到时候出一些莫名其妙的问题，让人焦头烂额的就不好了。
（2）取得activeperl的安装包。
默认安装即可。安装后，在C盘根目录下出现目录C:/Perl。
在twiki的配置中会用到。
注意把C:/Perl/bin目录加入到系统的PATH环境变量中。如果添加正确，那么在command命令行上输入perl命令就能显示一些正确信息，而不是找不到命令的错误信息。
（3）取得apache的安装包。
取最新的可执行安装包即可。安装过程中各种配置选项选择默认的配置即可。
我喜欢把这些软件都安装在C盘根目录下。
* 配置apache
鉴于我不是一个专业的服务器管理员，因此我们只按照最简单的方式进行配置。
有下列几个项目要进行配置：
** （1） ServerRoot
我的apache装在目录c:/Apache2.2，因此我就如下填写：
ServerRoot "C:/Apache2.2"
** （2）Listen
指定服务器监听的端口。好像默认就是80端口。可以指定IP地址，也可以不指定。我的设定如下：
Listen 80
由于某些原因，可能80端口已经被其他软件使用了。这时候可以指定一个别的端口，比如9000。
** （3）ServerName
服务器的名字。当你在浏览器地址栏里输入地址时就是这个了。我的设定如下：
ServerName localhost:80
如果你使用了不同的监听端口，这里要一致。
** (4) 检查apache是否正确安装
打开浏览器，在地址栏输入：
http://localhost
如果显示一个"It works"的页面，就表明apache web服务器正确地安装了。
* 配置TWiki
这个部分是比较难搞定的。
** (1) 修改LocalLib.cfg指定lib目录的绝对地址
在twiki/bin/目录下有一个模板文件LocalLib.cfg.txt，将其重命名为LocalLib.cfg。
然后打开该文件，修改其中的变量：
$twikiLibPath = "C:/twiki/lib";
其中的地址采用绝对地址。对于Windows系统来说，路径中的分隔符采用类似于Unix系统中的反斜线，
而不是采用Windows中的正向斜线。
最后，将修改好的LocalLib.cfg文件移动到目录twiki/lib/下。
** (2) 运行自动化工具指定Perl解释器的地址
打开cmd.exe(命令行)， 进入到目录 twiki/bin/，运行下列工具：
c:\twiki\bin> perl ..\tools\rewriteshbang.pl
屏幕会出现一些信息，首先提示你输入perl.exe的路径：
Enter path to interpreter [hit enter to choose 'perl']: C:/Perl/bin/perl.exe
根据你的输入，它会再次提示：
Enter path to interpreter [hit enter to choose 'C:/Perl/bin/perl.exe' ]:
这次直接回车即可。回车后，会看到一些提示：xxxx modified。提示有22个文件被修改。
接下来进入到twiki/tools目录，再次运行刚才的perl脚本：
c:\twiki\tools> perl rewriteshbang.pl
画面出现与之前类似的问题提示，你仍然输入 C:/Perl/bin/perl.exe。之后再次询问时直接回车即可。
最后提示有一个文件被改变。
* 修改Twiki的httpd配置文件
在Twiki安装的根目录下有个文件twiki_httpd_conf.txt, 将其重命名为twiki_httpd.conf，
然后将提示要求你修改路径的地方（以多个#符号开头）都修改成你的安装的绝对路径，例如
/home/httpd/twiki 换成 C:/twiki
* 修改Apache的conf/httpd.conf文件
在httpd.conf文件的最后，添加下列包含语句：
include "C:/twiki/twiki_httpd.conf"
到程序菜单中利用Apache的功能检查下配置文件，如果有配置错误就会提示。
一般会提示php_admin_flag engine off有错误，简单地注释掉这一行即可。
* 进入浏览器进行Twiki的初步配置
在浏览器地址中输入
http://localhost/twiki/bin/configure
就会出现一个配置画面。第一次进入系统，只有一个General path settings(12 warnings)可供配置。
** (1) 初消路径设定告警
在进入配置页面后，General path settings后会有个告警数量提示。点击该标签就会打开各种配置项。
首先就把其中凡属于Windows路径中的斜线替换成反斜线，其它的暂时不管它。
在页面的下方有个next按钮。点击按钮进入下一个保存页面。
保存页面要求你输入密码。若不设定密码它是不让你保存的。为了方便先配置一个容易记忆的密码，比如twiki123。
设定好密码后，有个change password and save按钮。点击后出现一个修改后的配置更新显示页面。
这个页面的最下方有两个连接，其中一个是 Return to configuration。点击这个连接回到配置页面。
这时你会发现配置页面多出了很多配置项，而且 General path settings也不提示告警了。
** (2) 消除Security setup安全告警
展开这个配置栏，配置项{Htpasswd}{FileName}中指定了用户密码存储文件名。
初始的文件名是C:/twiki/data/.htpasswd。
但是，我们要消除的告警不在这里，而是提示有Waring的第一项Paths的配置。
这个配置项类似于Windows中Path环境变量的设定。我们可以在这里指定twiki可以搜索的系统路径。
对于Windows来说， C:/Windows/system32这个目录是一定要加上的。其它的则需要按需加入了。
对于Windows有个简便的办法：进入命令行界面，输入PATH现实系统环境变量，然后将其抄到我们的配置项即可。
C:\Users\zyx>PATH
PATH=C:\Perl\site\bin;C:\Perl\bin;C:\Windows\system32;C:\Windows;C:\Windows\System32\Wbem
去掉其中明显不需要的路径，比如暴风影音的路径，还有那些不存在的路径，然后把这些路径拷贝过去就行了。
上述例子中的路径已经是我修改过后的路径。
同样点击页面最下方的next按钮，进入保存页面。输入密码，点击save按钮保存。
显示配置更新的页面，最后点击下面的连接返回到配置页面，继续进行后面的配置。
** (3) 消除Store settings存储配置中的错误设定
{StoreImpl} 选择【rcsWrap】还是【rcsLite】?
Twiki是利用rcs工具来进行版本管理的。在Unix提供上一般会安装，但对于Windows系统来说却没有这个软件。
因此只能用它自带的用perl实现的一个替代品。因此，这里就选择rcsLite即可。
保存这个配置后在返回这里。你会很高兴的发现许多的错误都被消除了。
** (4) 消除Mail and Proxies 邮件与代理的告警
对于Twiki来说，注册机制需要启用邮件。下列配置项需要设定：
{webMasterEmail} [email protected]
这个根据实际情况来设定就好了。我在自己的PC机上装着玩儿，所以就直接设定成了上面那样。
我曾经试过设定成webmaster@localhost，结果它仍然告警说不能识别为一个有效的邮件地址。
保存此设定后在回到配置页面，我们会发现已经没有任何的告警或错误了！
到这里已经完成了设定的第一步。先欣赏下我们的成果吧！
在浏览器中输入
http://localhost/twiki/bin/view
看看自家的twiki网站页面。
* 中文设定
对于咱中国人来说，看洋文毕竟太费脑子了。所以汉化是首要工作。
很可惜，Twiki对于汉字的支持不是很好，也就是能用而已。
(待续)
相关阅读 更多 +
