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"
Java开源知识库:XWiki安装(Windows平台)_第1张图片

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

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

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


重启MYSQL服务:

Java开源知识库:XWiki安装(Windows平台)_第2张图片


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

你可能感兴趣的:(Java开源知识库:XWiki安装(Windows平台))