Centos7.2安装XWIKI 11.10.5

本文记录XWIKI 11.10.5 版本在Centos7.2上的配置

安装前的准备

1：根据需求确认xwiki版本，不同版本的xwiki支持特性不一样。

    这里我安装了官网推荐的11.10.5。

2：根据xwiki版本确认对应的依赖环境。

    1) Java支持：我安装的版本是11.10.5，所以选择安装Java8。

    2) Servlet支持：我安装的版本是11.10.5，所以选择我选择的是主流的Tomcat7.0。

    3) 数据库支持：我安装的版本是11.10.5，这里选择的是postgresql9.6。

第一步 安装JAVA

1：查看系统版本号

cat /etc/redhat-release
cat /proc/version

2：查看Java8是否安装

rpm -qa |grep java-1.8*

3：安装Java8

sudo yum install java-1.8.0-openjdk* -y

4：查看安装的Java版本

java -version
openjdk version “1.8.0_252”
OpenJDK Runtime Environment (build 1.8.0_252-b09)
OpenJDK 64-Bit Server VM (build 25.252-b09, mixed mode)

5：我的系统是Centos7.2,安装之后默认已经配置了环境变量和自启动，无需手动操作

第二步 安装Tomcat7.0

按照XWIKI11.10.5的环境要求要安装支持Servlet3.0.1版本。A Servlet Container supporting Servlet 3.1 (Servlet 3.0.1 for XWiki version < 12). Check the Servlet Containers officially supported by XWiki devs.

1：查看官网找到支持servlet3.0.1的TomCat下载


2：使用wget下载安装包,解压缩后放到/opt目录下(目录可以按照自己习惯指定)（tar命令-C可以指定目标路径）

wget https://mirror.bit.edu.cn/apache/tomcat/tomcat-7/v7.0.104/bin/apache-tomcat-7.0.104.tar.gz
sudo tar zxvf ./apache-tomcat-7.0.104.tar.gz -C /opt/

3：添加Tomcat环境变量

sudo vi /etc/profile

在最后面添加两行：

export CATALINA_HOME=/opt/apache-tomcat-7.0.104
export PATH=$PATH:$CATALINA_HOME/bin

使环境变量生效：

source /etc/profile

查看版本状态：

catalina.sh version

4：如果需要修改tomcat的默认端口8080，请更改配置文件/opt/apache-tomcat-7.0.104/conf/server.xml。我这里没有做修改。

5：这时候在网页上输入主机IP地址+8080就会出现TOMCAT的页面，说明Tomcat安装好了。

6：tomcat的log文件目录为/opt/apache-tomcat-7.0.104/logs
下面的catalina.out文件保存了最新的log内容。

第三步 安装postgresql9.6

按照XWIKI11.10.5安装要求安装数据库Postgresql9.6。A Database and a JDBC 4.2 Driver for your database (JDBC 4 was required for XWiki versions < 11.5). Check the databases offically supported by XWiki devs.
1：查看postgresql官网找到符合xwiki11.10.5的版本 postgresql需要满足JDBC4.2的驱动要求


2：在线安装postgresql
可以找到postgresql数据库版本的安装源，并且有安装命令

sudo yum install https://download.postgresql.org/pub/repos/yum/reporpms/EL-7-x86_64/pgdg-redhat-repo-latest.noarch.rpm
sudo yum install postgresql96
sudo yum install postgresql96-server
sudo /usr/pgsql-9.6/bin/postgresql96-setup initdb
sudo systemctl enable postgresql-9.6
sudo systemctl start postgresql-9.6

3：配置环境变量
最后一行添加如下内容

sudo vi /etc/profile

4：登陆postgresql，创建xwiki数据库，添加xwiki用户并授权访问xwiki数据库权限
这里使用postgresql的第一种登陆方式（本地用户）登陆数据库创建数据库并添加用户和权限。

su postgres
psql -U postgres
alter user postgres with password ‘xwiki123xwiki’;(注意这里一定要加;号)
create database xwiki; (注意这里一定要加;号)
create user xwiki with password ‘xwiki123xwiki’;
grant all on DATABASE xwiki to xwiki;

5：postgresql配置访问权限
使用默认配置修改数据库管理员（postgresq）默认密码，创建xwiki数据库，添加xwiki用户，赋予xwiki数据库权限（这一步不做的话，修改配置文件中的Unix connect 为md5后就无法登录）
/usr/lib/postgresql/9.5/bin/pg_ctl -D /var/lib/postgresql/9.5/main -l logfile start

第一步：允许外网访问数据库
第59行：将listen_adress = “localhost” 修改为listen_adress = “*”
sudo vi /var/lib/pgsql/9.6/data/postgresql.conf

第二步：配置允许使用数据库用户名和密码（md5）登录数据库
如果没有做这一步，将无法使用数据库的用户名和密码登录，只能使用服务器的postgres用户免密码登录。
修改一：允许本地用户（服务器用户）通过数据库的账号和密码登录数据库
修改二：允许本机（服务器）通过TCP和数据库用户名和密码的连接数据库
修改三：允许外网用户通过数据库用户名和密码的连接数据库

**第三步：重启数据库使配置生效

sudo systemctl restart postgresql-9.6**

第四步 安装xwiki11.10.5

1:下载xwiki的WAR包

从9.5版本开始没有xwiki企业版安装包，看起来XIP更好安装一些。这里选择WAR安装

2：将war文件解压到tomcat的webapp目录下

sudo mkdir /opt/apache-tomcat-7.0.104/webapps/xwiki
sudo unzip xwiki-platform-distribution-war-11.10.5.war -d /opt/apache-tomcat-7.0.104/webapps/xwiki

3：修改配置文件

第一步：修改xwiki.properties配置文件

sudo vi /opt/apache-tomcat-7.0.104/webapps/xwiki/WEB-INF/xwiki.properties

修改一：将91行取消注释，设置/var/lib/xwiki/data/为xwiki数据存储目录

修改二：修改第522行，允许首次通过网页访问xwiki时候开启自动配置向导（否则会生成一个空的wiki）

第二步：修改配置文件xwiki.cfg
sudo vi /opt/apache-tomcat-7.0.104/webapps/xwiki/WEB-INF/xwiki.cfg
修改一：修改第107行附近的三行注释，保证数据附件按照本地文件形式保存（放在数据库保存可能无法上传大的附件）


修改二：修改第296行的数据，取消注释允许管理员登录

第三步：修改数据库配置文件hibernate.cfg.xml

sudo vi /opt/apache-tomcat-7.0.104/webapps/xwiki/WEB-INF/hibernate.cfg.xml
第一处修改：注释掉99行的默认数据库


第二处修改：取消173行左右的postgresql数据库的注释，修改数据库的用户名和密码

4：为xwiki创建数据文件夹

sudo mkdir /var/lib/xwiki
sudo mkdir /var/lib/xwiki/data

5：下载postgresql JDBC驱动，放到xwiki的lib目录下

sudo cp ./postgresql/postgresql-42.2.12.jar /opt/apache-tomcat-7.0.104/webapps/xwiki/WEB-INF/lib
sudo /opt/apache-tomcat-7.0.104/bin/shutdown.sh
sudo /opt/apache-tomcat-7.0.104/bin/start.sh

6：浏览器中输入服务器IP地址:8080开始配置XWIKI

其它参考

1：开启XWIKI管理员之后管理员用户名和密码默认为

superadmin system

2：如何删除xwiki文件和持久化目录

sudo mkdir /opt/apache-tomcat-7.0.104/webapps/xwiki/
sudo rm -vrf /var/lib/xwiki/data/*

3：如何删除xwiki数据库，postgresql环境配置参考链接

psql -U postgres
revoke ALL on DATABASE xwiki from xwiki;
drop database xwiki;
sudo systemctl restart postgresql-9.6

4：XWIKI配置出错后重新配置

5：Ubuntu设置tomcat为服务，并且开机自启动,参考链接

6：Tomcat启动命令，Tomcat环境配置参考链接

startup.sh(/opt/apache-tomcat-7.0.104/bin)

7：Nginx和Tomcat混合使用参考链接

8：mysql(mariaDB)配置XWIKI参考链接

9：XWIKI中文网站内容汇总，基于xwiki版本7.0,参考链接