xwiki 5.0 安装及使用

国内xwiki安装使用资料较少，有的也是些老版本。根据自己使用xwiki经验，总结出来，供参考

以里程碑2版为例。下载页面

http://enterprise.xwiki.org/xwiki/bin/view/Main/Download

初次windows 安装用户下载标准windows安装版本，一路安装向普通windows程序一样。C:\Program Files\XWiki Enterprise 5.0-milestone-2\

提供的是hsqldb作为默认内置数据库，和xwiki在一个jvm里，判断依据

hibernate.cfg.xml里

<property name="connection.url">jdbc:hsqldb:file:${environment.permanentDirectory}/databaseiki_db;shutdown=true</property>

 

安装后，默认数据库密码在C:\Program Files\XWiki Enterprise 5.0-milestone-2\webapps\xwiki\WEB-INF下的xwiki.cfg

xwiki.superadminpassword= ，注释去掉，才生效。

1.中文问题 xwiki.superadminpassword中文化，已经很简单了。管理员wiki-Localization ，默认语言都选zh，不支持多语言即可，日期格式也可以设置，默认是西方的月日，年，可以改成中式的yyyy-MM-dd HH:mm:ss
如果选择多语言支持后，登录后老显示英文，右上角不停选择default 才能首页wiki欢迎文字是中文，xwiki已经自备了中文内容。但此时有些还是英文的，没翻译全。

2.权限问题：

某个space或page赋予某个组访问权限后，还要在权限菜单里设置该组全局访问权限，后者不设，还是回报权限错误。

设置非注册用户不能查看，则注册页面也没法看了。故第二个红圈处不能勾选。

3. 隐藏某些spaces，官网资料http://www.xwiki.org/xwiki/bin/view/FAQ/How+can+I+hide+a+space+for+some+users说改 xwikivars.vm里blacklistedSpaces 参数值。但你会发现一般注册用户还会是会看到这些

#if ($hasAdmin || $isAdvancedUser)
 #set ($blacklistedSpaces = [])
#else
 #set ($blacklistedSpaces = ['Import', 'Panels', 'Scheduler', 'Stats', 'XAppClasses', 'XAppSheets', 'XAppTemplates', 'XWiki', 'WatchCode', 'WatchSheets', 'XApp', 'WatchAdmin', 'Watch', 'ColorThemes', 'AnnotationCode'])
#end

需要改成这样

#if ($isAdvancedUser)
  #set ($blacklistedSpaces = [])
#else
  #set ($blacklistedSpaces = ['Blog','Macros','Main','XWiki','Import', 'Panels', 'Scheduler', 'Stats', 'XAppClasses', 'XAppSheets', 'XAppTemplates', 'XWiki', 'WatchCode', 'WatchSheets', 'XApp', 'WatchAdmin', 'Watch', 'ColorThemes', 'AnnotationCode'])
#end

说明一般注册了的用户都具有 #set ($hasAdmin = $xwiki.hasAccessLevel('admin')) 权限.修改vm 不用重启，即时生效

4.hsql 的xwiki导成mysql的。见http://www.xwiki.org/xwiki/bin/view/FAQ/How+to+migrate+from+HSQLDB+to+MySQL。导出为backup.xar文件.安装创建数据库，hibernate.cfg.xml配置为mysql后，登录空wiki，会提示没内容，让你导入。一般文件会超过，按提示采用大xar文件导入。但没成功，加进去后，不能成为有效的导入页面。后重新导出xar文件，不包括历史信息。缩小到32m以下，导入成功。

5.使用mysql后内存不足，问题。默认启用512M最大内容，改用mysql。启动时xwiki进程会宕机，修改start_xwiki.bat里最大内存后好了。还有要在my.in里增加max_allowed_packet=64M，否则导入xar时也会报错:Parameter of prepared statement which is set through mysql_send_long_data() is longer than 'max_long_data_size' bytes

6.上传同名附件会替换，不会重新命令（jspwiki是？).导入officeppt文档，选项是否用office document viewer,是则附件里不会出现每个jpeg图片（xwiki做了此转换，实际在页面里播放的是一张一张图片组合成的流），而只有一个ppt附件 不勾选，则出现这些图片。重新以勾选再上传同名文件，则会覆盖原ppt附件。图片保留，奇怪的是，图片全没有更新，因为没有转换为图片，而是作为一个整体在document viewer里展示而已，和图片已无关系，不是上传1张张图片或者转换为1张张图片作为附件

7.win7,win8，要改下默认安装目录，不要安装在c:\program files 因为没权限写。可改成c:\xwiki

8,windows安装完后图形化界面不动，点next没反映，直接点quit 或者关闭窗口。不影响已经安装成功的事实，在关闭此窗口前，xwiki已经可以用了。

9.debug日志如何打开？start_xwiki_debug.bat不能在后续访问中打印debug级别日志