Java开源知识库：XWiki安装（Windows平台）

准备安装XWiki，看了一下有三种安装方式：

XWiki is a Java-based wiki and runs on a Servlet Container such as Tomcat, Jetty, JBoss, WebLogic, WebSphere, etc. It also uses a relational database to store its content. It can run on almost any database (HSQL, MySQL, etc) but XWiki and the database need to be setup correctly.

There are 3 ways of installing XWiki:

• Use the Standalone distribution which already packages a Servlet Container (Jetty) and a database (HSQL). This is the recommended option for first time XWiki users and for users who wish to quickly try out XWiki.
• Use the WAR distribution and configure both your container and your database to work with it.
• Use the .deb package to install the last version of XWiki and the dependencies.

目标机需要满足以下条件：

• Java 6 or greater installed.
• A Servlet Container supporting Servlet 2.4.
• Enough memory, check the Memory section of the Performance Guide.
• Check the release notes for the version you're installing to see what browsers and databases are supported for it. You can also check our general support strategy.

（一）第一种方式：

我采用的第一种安装方式是独立运行的版本安装，包括exe安装，jar安装，或者zip解压的方式，可直接运行，方便想要快速用起来xwiki的人，比如下面是exe方式安装步骤：

采用最简单的windows的exe版本安装：

1、 安装jdk7；（下载地址： http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html）

2 、安装xwiki-enterprise-installer-windows-5.2.2.exe（下载地址：http://enterprise.xwiki.org/xwiki/bin/view/Main/Download）

3、启动start_xwiki.bat；

4、在浏览器中打开http://localhost:8080/；

5、Admin/admin登录

6、打开管理wiki界面，点击Localization，在默认语言栏中奖en改为zh，保存即切换为中文了。

问题：

但是我在win8系统上按照这个步骤一点问题都没有，XWiki还运行非常良好！！！

但是当我在win7和win Server2008上面安装exe版本的时候，到最后一步，点击next出现空白wizard，就再也不前进了，然后启动不了xwiki，安装解压版的(zip)也是，解压了之后，点击start.bat也是启动不了，出现一个异常然后控制台界面消失，都看不到是什么异常。。。 网上有人出现这个问题，xwiki作者回答的是新版本不会有这个问题，但是我装的是最新的版本啊，不知道为什么！！！ 是否是我的win7和server08上面有上面东西和它冲突了我也不知道。。。

（二）第二种方式：

我才用的第二种方式是 war文件 + tomcat + MySQL，安装到windows server 2008上，当然Web容器和数据库也可以换成其它的，下面是详细步骤：

（1）下载准备：

我用的是XWiki 5.2.2稳定版

Xwiki war文件：http://main.xwiki.org/xwiki/bin/view/DownloadCode/DownloadFeedback?downloadLink=http://download.forge.ow2.org/xwiki/xwiki-enterprise-web-5.2.2.war&projectType=Older%20Stable&projectVersion=5.2.2&projectID=1

Xwiki模版xar文件： http://main.xwiki.org/xwiki/bin/view/DownloadCode/DownloadFeedback?downloadLink=http://download.forge.ow2.org/xwiki/xwiki-enterprise-ui-mainwiki-all-5.2.2.xar&projectType=Older%20Stable&projectVersion=5.2.2&projectID=1

JDK：jdk7

Tomcat：tomcat7

MYSQL JDBC驱动： http://pan.baidu.com/s/1w33ch

（2）详细步骤：

1 安装JDK和Tomcat
设置JAVA_HOME，CATALINA_HOME，Path三个环境变量，前两者分别是JAVA安装主目录和Tomcat安装主目录。
修改tomcat端口号和设置URIEncoding="UTF-8"


2 安装MySQL：
我安装的是server only，因为是离线安装，所以没办法，如果可以联网你可以安装full或者developer
到其中有一步选择作用的时候，选择用作server

安装好之后将MYSQL的bin路径加到path中
修改my-default.ini，在[mysqld]下面加上
max_allowed_packet=64M
备注：例如删除大量页面时可能会出现发送到mysql包太大的错误，这个时候可以改大这个值。

打开CMD，开始创建数据库和用户


重启MYSQL服务：

3 部署XWiki到tomcat：
（1）拷贝war文件到webapps目录下，启动tomcat，然后再停掉
删除war文件，将war解压后的文件夹名字改为xwiki， 然后将MYSQL的JDBC驱动拷贝到xwiki的WEB-INF的lib目录下
（2）修改hibernate.cfg.xml文件注释掉HSQLDB的连接部分，放开MYSQL的连接部分
（3）修改catalina.bat文件，在

echo Using CATALINA_BASE:   "%CATALINA_BASE%"

的上方，加上下面两句：
set JAVA_OPTS=%JAVA_OPTS% -server -Xms800m -Xmx800m -XX:MaxNewSize=256m
set JAVA_OPTS=%JAVA_OPTS% -server -XX:PermSize=128M -XX:MaxPermSize=512m
不加的话会有内存/栈溢出错误（Out of Memory : Perm Gen Space - Stack Overflow）。
（4）修改xwiki.cfg放开超级管理员。
找到system那一行，去掉前面的“#”号。

4 打开浏览器输入:
http://localhost:port/xwiki
（1）情况1：如果联网：就点击continue，开始更新，直接成功装上了。
（2）情况2：如果没有联网，只能点击skip了，然后可以看到一个找不到文档的提示。
用超级管理员(superadmin/system)登录，然后点击管理xwiki，就可以开始导入xar模板文件了。
但是我的导入之后出现权限问题，再次单击xar文件，再次导入，退出登录，再次登录就会好了。

想要熟练使用XWiki，需要参阅教程：

http://platform.xwiki.org/xwiki/bin/view/AdminGuide/WebHome

其它参考资料：

http://zhidao.baidu.com/question/161644788.html?si=4

http://platform.xwiki.org/xwiki/bin/view/AdminGuide/InstallationTomcat

http://www.xwiki.org/xwiki/bin/view/FAQ/HowToSolveAJavaHeapMemoryError