xwiki是使用java语言编写的开源wiki系统
xwiki有多种版本,standalone的版本可以直接下载之后独立安装,默认集成了jetty运行,但是这种方式安装xwiki,运行速度比较慢,在大部分的情况下不能满足企业的需求。
在linux系统上实现部署xwiki也有多种方式:
其中serlet container就有许多:
tomcat
glassfish
jboss等
关系型数据库的选择也是比较广泛的,在此使用tomcat和mysql
第一步:下载xwiki的war包
第二步:安装jdk
安装jdkde要点主要就是环境变量
导出JAVA_HOME
JRE_HOME
导出可执行程序到PATH变量
第三步:安装tomcat
1.设定CATALINA_HOME,测试tomcat是否可以正常启动,之后关闭tomcat,将xwiki的包解压到CATALINA_HOME/webapps/xwiki目录下
2.编辑tomcat的配置文件server.xml,设定为utf-8的编码格式
<Connector port="8080" ... URIEncoding="UTF-8"/>
3.如果linux的系统上没有安装X11相关库文件
激活headless mode:在CATALINA_HOME/bin下新建一个名为serenv.sh的文件
#!/bin/sh
export JAVA_OPTS="${JAVA_OPTS} -Djava.awt.headless=true"
4.如果要开启gzip压缩功能
<Connector port="8080" ... compression="on" compressionMinSize="2048" compressableMimeType="text/html,text/xml,text/css,text/javascript,application/x-javascript"/>
第四步:安装mysql
1.先用yum安装mysql
编辑mysql的配置文件:[mysqld]段添加default-storage-engine=Inonodb一项,将Innodb设定为默认存储引擎(因为xwiki经常需要进行事务回滚)
2.创建数据库
mysql> create database xwiki default character set utf8 collate utf8_bin
3.创建用户及授权
mysql>grant all privileges on *.* to [email protected] identified by ‘xwiki‘
4.配置xwiki使用mysql数据库
因为xwiki是使用java语言编写的,所以要使用mysql数据库就需要java的mysql连接器
mysql-connector-java*.jar 下载之后放到CATALINA_HOME/webapps/xwiki/WEB-INF/lib目录下
5.修改xwiki的配置文件,使用mysql数据库,将默认相关选项修改为如下:
<property name="connection.url">jdbc:mysql://localhost/xwiki</property>
<property name="connection.username">xwiki</property>
<property name="connection.password">xwiki</property>
<property name="connection.driver_class">com.mysql.jdbc.Driver</property>
<property name="dialect">org.hibernate.dialect.MySQL5InnoDBDialect</property>
<property name="connection.useUnicode">true</property>
<property name="connection.characterEncoding">UTF-8</property>
启动tomcat:访问本机的8080/xwiki,然后进行xwiki初始化
如果启动失败,查看tomcat的日志文件catalina.out
一般会出现out of memory error的错误:默认内存不够使用
解决办法:在上述的serenv.sh文件中添加:
CATALINA_OPTS="-Xmx1024m -XX:MaxPermSize=1000m"
具体使用的数字可以自己设定
至此,xwiki就可以在系统上跑起来,xwiki是一个功能比较强大的开源wiki系统,所以最主要的还是wiki的后续使用,如何使用好xwiki达到相应的效果