Twiki 维基安装笔记

Twiki安装笔记

##关闭防火墙：

servi iptables stop

##禁用SElinx：setenforce 0

CentOS-5系统参考链接：https://www.linode.com/docs/websites/wikis/twiki-on-centos-5

下载：TWiki is 5.0.1版本

centos 6发行版按照以下方式安装

也可参考：http://www.tuicool.com/articles/ZZ3m2i

yum install httpd gd-devel perl-CPAN rcs

##注释：在命令行下输入cpan安装CGI::Session

cpan

install CGI::Session

##安装GD

install GD

##安装FreezeThaw

install "FreezeThaw"

##安装HTML::Tree

install "HTML::Tree"

##安装Time-modules，百度查找perl-Time-modules-2006.0814-1.el5.rf.noarch.rpm对应系统安装

centos5.X：rpm -ivh perl-Time-modules-2006.0814-1.el5.rf.noarch.rpm

#这个没有找到合适的命令,要先去http://search.cpan.org/~muir/Time-modules/下载Time-modules的模块然后解压：

tar zxvf Time-modules-2013.0912.tar.gz

cd Time-modules

perl Makefile.PL

make

make test

make install

##下载http://nchc.dl.sourceforge.net/project/twiki/TWiki%20for%20all%20Platforms/TWiki-6.0.1/TWiki-6.0.1.zip

mkdir /var/www/twiki

unzip TWiki-6.0.1.zip -d /var/www/twiki

##修改twiki目录的owner

chown -R apache:apache /var/www/twiki

##进入/var/www/twiki/bin目录，修改LocalLib.cfg

cp LocalLib.cfg.txt LocalLib.cfg

chown apache:apache LocalLib.cfg

vi LocalLib.cfg

#修改$twikiLibPath = "/var/www/twiki/lib";

find /var/www/twiki -name twiki_httpd_conf.txt

cp twiki_httpd_conf.txt twiki.conf

vi twiki.conf

或者到官网http://twiki.org/cgi-bin/view/TWiki/ApacheConfigGenerator生成一个配置文件twiki.conf。

#把含有home字符的路径都修改真实路径

#注释掉“php_admin_flag engine off”

cp twiki.conf /etc/httpd/conf.d

##放在这个目录里边的conf文件apache会自动加载的，后缀必须是.conf才行。

如果lib目录下没有LocalSite.cfg文件，那么Copy the file lib/TWiki.spec to lib/LocalSite.cfg

修改为正确内容。

一共有3个配置文件需要修改：

/var/www/twiki/twiki.conf

/var/www/twiki/bin/LocalLib.cfg 

/var/www/twiki/lib/LocalSite.cfg

chmod +w LocalSite.cfg

确保apache配置文件httpd.conf加载CGI模块

LocalSite.cfg文件可以在本文附件的内容添加或加载到http.conf配置文件之后直接访问http://192.168.1.58/bin/configure生成/var/www/twiki/lib/LocalSite.cfg。

##在浏览器中输入地址

http://192.168.1.61/twiki/bin/configure

##首次登陆设置管理员密码

##配置页面说明

General path settings：这里主要是修改一些目录相关的内容

DefaultUrlHost：

ScriptUrlPath:  /twiki/bin

PubUrlPath:  /twiki/pub

PubDir:  /var/www/twiki/pub

TemplateDir:  /var/www/twiki/templates

DataDir:  /var/www/twiki/data

LocalesDir:  /var/www/twiki/locale

WorkingDir:  /var/www/twiki/working

##关于中文的支持 - Localisation

UserInterfaceInternationalisation: 打勾，这个主要是界面是否可以看到中文

Languages： 勾选自己需要的语言

DisplayTimeValues： 选择servertime

UseLocale: 必须要选择，否则后续的设置是不会起作用的

Site.Locale: 设置为 zh_CN.UTF-8

Site.CharSet: UTF-8

看到一些警告可以忽略继续下一步就可以完成LocalSite.cfg文件的初始化

##发邮件

##TWiki支持自动发送验证邮件，用于用户注册和找回密码。要支持发邮件，首先在服务器上安装sendmail： 

yum install sendmail

##然后，在configure页面设置邮件相关项目，以下两项留空。

{SMTP}{MAILHOST} 留空

{SMTP}{SENDERHOST} 留空

## 批量添加用户

进入页面：http://<ipaddress>/twiki/bin/view/TWiki/BulkRegistration 根据说明进行配置

##页面设置

WebPreferences和TopicPreferences页面，可对Web或Topic进行设置，比如权限等等。详细的有哪些设置项，可参考：

http://<ipaddress>/twiki/bin/view/TWiki/TWikiPreferences

比如，要设置管理员才能修改的权限，需要在Wiki内容或者当前Topic的设置页面，添加如下语句： 

   Set ALLOWTOPICCHANGE = TWikiAdminGroup

注意格式为：[3个空格]Set[空格]xxx[空格]=[空格]xxx

#常见问题汇总

http://www.chekiang.info/2015/03/1438.html

1、CPAN安装模块报错：

Warning: prerequisite Locale::Maketext 1.17 not found. We have

解决centos5X：rpm -ivh perl-Time-modules-2006.0814-1.el5.rf.noarch.rpm

2、403错误，在twiki.conf添加以下内容

<FilesMatch "^(configure)$"> 

Allow from 127.0.0.1 192.168.1.123

Require user tom 

Satisfy Any

</FilesMatch>

满足一个条件就可以访问

3、CGI支持验证

查看httpd.conf中的“ScriptAlias /cgi-bin/”，把pl或者sh后缀的文件放在实际路径，添加+x权限，web打开网页查看结果。比如：http://192.168.1.254/cgi-bin/first.pl，会显示运行的结果即为正常。

打开http://192.168.1.254/twiki/bin/configure

报错：Failed to load the perl module CGI qw(:any).

http://twiki.org/cgi-bin/view/Support/SID-02079

官网解释这是由于使用CPAN安装CGI出现的不兼容问题，所以centos5.X开始还是不要CPAN安装先，并且只使用官网不要使用镜像地址。