xwiki管理指南-安装教程

XWiki是一款基于java所编写的wiki，它可以运行在如Tomcat，Jetty，JBoss，WebLogic，WebSphere等Servlet容器上并利用关系型数据库(HSQL, MySQL等)来存储数据，大部分数据库产品都可以在XWiki上运行但是必须进行正确的设置。

如下介绍3种安装XWiki的方式：

• 使用已包含Servlet容器（Jetty）和数据库（HSQL）并带有默认wiki首页的打包版本的XWiki安装。如果你是新手并且想快速尝试XWiki的功能，推荐使用这种方式安装。
• 使用war包来安装XWiki，但是你必须设置好你的Servlet容器和数据库让XWiki工作起来。
• 使用deb包安装最新版本的XWiki和相关的插件。

如果你想要升级正在使用的XWiki，请参阅升级指南

如果你已经安装完XWiki,请查看其他感兴趣的话题或者跳转至管理指南参阅如何设置和维护你的XWiki。

如果你想手动安装XWIKI或者迁移现有的XWiki，请参阅有关手册

安装需求

• Java7或者更高的版本（6.0以下版本的XWiki需要安装Java6或者更高的版本）
• 支持Servlet3.0.1的Servlet容器（7.0 以下的XWiki需要安装Servlet2.4）
• 数据库的JDBC 4驱动（7.0 以下的XWiki需要安装JDBC 3）
• 适合的内存大小
• 请参阅发行说明查看你所选择的XWiki和哪一种浏览器以及数据库兼容 

安装教程

这里我们将教你怎么对XWiki进行详细的配置，你可以按下面的方式一步一步进行安装或者参阅你所感兴趣的部分并安装。

这些教程并未通过开发团队的测试，因此以下的安装方式有可能不准确或已经过时。

• XWiki On OpenShift (Platform-as-a-Service)
• XWiki On Windows (French)
• XWiki On Debian 4 (Etch) - Tomcat - PostgreSQL (or MySQL) (English)
• XWiki On Debian 4 (Etch) - Tomcat - PostgreSQL (or MySQL) (German)
• XWiki On Windows - GlassFish - Oracle (Russian)
• XWiki on OpenSUSE - Tomcat - MySQL (English)
• XWiki On Archlinux - Tomcat - hsql or MySQL (English)

安装方式

使用已打包的XWiki版本

此版本已集成XWiki，数据库和一个轻量级的Java容器。
此版本不推荐在真实的生产环境中使用，如果你想要在真实生产环境中使用它，请参阅其他两个方式。

使用war包（适用于生产环境）

此版本包含一个可以在Java容器（如Tomcat）或者其他操作系统上进行安装的Java程序。

使用deb包（适用于生产环境）

提供了一个可以在基于Debian的操作系统中使用的.deb软件包。它可以使用dpkg或apt安装;此安装是自动化的。

在Arch Linux上使用yaourt

安装或者升级Arch Linux: yaourt -S xwiki-enterprise.

故障排除

你可以在已设置好的Servlet和数据库（如Tomcat和MySQL）上使用XWiki的管理员工具进行基础的故障检测和排除，但是此工具的部分功能只能在linux上运行。

在同一个容器中运行多个XWiki的实例

如果你看到以下错误:

com.xpn.xwiki.XWikiException: Error number 3 in 0: Could not initialize main XWiki context
Wrapped Exception: Failed to get cache factory component
...
Caused by:
org.infinispan.jmx.JmxDomainConflictException: Domain already registered org.xwiki.infinispan

你需要编辑在WEB-INF/cache/infinispan/config.xml下的每个XWiki实例的设置，并更改jmxDomain(globalJmxStatistics标签下)的值提供一个唯一的名字。

在代理服务器上运行XWiki

插件管理器通常在远程仓库去搜索和获取相关的插件，如果你的网络上安装的XWiki通过代理服务器连接到因特网，那么你将无法搜索到相关插件并且你的日志文件将出现Connection refused的异常。

因此你需要配置让XWiki知道你的代理服务器。

XWiki使用Apache httpclient中的默认java代理设置。详情请参见Java Networking and Proxies documentation，其主要目的是在系统的范围内增加有关代理的属性。 

对于Tomcat6 应该这样配置：编辑/<tomcat-home>/bin/catalina.sh 并增加 JAVA_OPTS 变量的设置:

JAVA_OPTS="$JAVA_OPTS -Dappserver.home=$CATALINA_HOME -Dappserver.base=$CATALINA_HOME -Dhttp.proxyHost=proxy.mycompany.com -Dhttp.proxyPort=7777 -Dhttps.proxyHost=proxy.mycompany.com -Dhttps.proxyPort=7777 -Xmx512m -XX:MaxPermSize=196m $XWIKI_OPTS"

错误:Unsupported major.minor version 51.0

因为从版本6.0开始，XWiki需要安装Java7而您正在使用Java6，因此您需要升级你的Java版本。

无网络的情况下安装XWiki

以下提供三种方法：

• 在本地设置一个插件仓库，不管是Maven Repository还是Extension Repository Application，你都必须事先在插件仓库中存储你要用的插件，这并不是一件什么难的事情。
• 安装已打包好的XWiki版本，当中已经包含了一系列默认的wiki页面。
• 请不要使用安装向导并使用XAR导入的特性来导入wiki的页面