帮酷LOGO
0 0 评论
文章标签:Xwiki  Ubuntu  lts  

XWiki是一个流行的企业级开源wiki平台,用Java编写,在可扩展性和易用性方面,XWiki作为知识库,公共门户和更多的企业部署在各个公司。

在本文中,我将指导你在Ubuntu 16.04服务器实例上安装XWiki 9.11.2的过程,OpenJDK 8、Tomcat 8和MySQL 5.7会在安装进程中作为依赖项自动安装。

前提条件

  • 一个新的Ubuntu 16.04,服务器实例,具有至少2GB内存,建议4GB或更多。假设它的IP地址是203.0.113.1,
  • 一个sudo用户。
  • 服务器实例已使用apt更新到最新的稳定状态,

设置XWiki的APT repo

以sudo用户身份登录,然后在服务器实例上下载,并且设置XWiki (长期支持)repo :


cd
wget -q"https://maven.xwiki.org/public.gpg" -O- | sudo apt-key add -
sudo wget"https://maven.xwiki.org/lts/xwiki-lts.list" -P /etc/apt/sources.list.d/
sudo apt update

注意:如果你想尝试最新的稳定XWiki版本(但是,不是LTS),你可以下载以下XWiki APT仓库:


cd
wget -q"https://maven.xwiki.org/public.gpg" -O- | sudo apt-key add -
sudo wget"https://maven.xwiki.org/stable/xwiki-stable.list" -P /etc/apt/sources.list.d/
sudo apt update

安装Xwiki捆绑包(包括Xwiki LTS 9.11.2、Tomcat 8、MySQL5.7等)

当部署在生产中时,XWiki需要使用Java Servlet容器和数据库软件,作为一个灵活的wiki平台,XWiki正式提供各种集成选项,可以使用以下命令显示XWiki APT repo中的所有可用选项:

 
apt search xwiki

 

搜索结果将类似于以下内容:


xwiki-common/lts 9.11.2 all
xwiki-mysql-common/lts 9.11.2 all
xwiki-pgsql-common/lts 9.11.2 all
xwiki-solr-data/lts 9.11.2 all
xwiki-tomcat7-common/lts 9.11.2 all
xwiki-tomcat7-mysql/lts 9.11.2 all
xwiki-tomcat7-pgsql/lts 9.11.2 all
xwiki-tomcat8-common/lts 9.11.2 all
xwiki-tomcat8-mysql/lts 9.11.2 all
xwiki-tomcat8-pgsql/lts 9.11.2 all

如果要使用XWiki最常见的依赖项,可以在一个命令中安装所有必需的组件,如下所示:


sudo apt install xwiki-tomcat8-mysql/lts -y

安装过程中,你会被要求多次为root用户设置一个新密码,只保留密码字段为空,然后按Enter键跳过此步骤,我们会在安装MySQL时解决这个问题。

当被询问是否要 Configure database for xwiki with dbconfig-common? 选择<Yes>,然后按ENTER键。

当被要求提供一个 MySQL application password for xwiki 你可以输入特定的MySQL应用程序密码,也可以将密码字段留空,后者会告诉XWiki使用一个随机的MySQL应用程序密码。

安装XWiki和所有必需的依赖项后,确保安装了MySQL :


sudo /usr/bin/mysql_secure_installation

在这个进程中,程序会问你一些问题,按如下方式回复它们:

  • 是否要设置验证密码插件? Y
  • 请输入0 = LOW,1 = MEDIUM,2 = STRONG:2
  • 新密码:a-strong-MySQL-root-password
  • 输入新密码:a-strong-MySQL-root-password
  • 你想继续使用提供的密码? Y
  • 删除匿名用户? Y
  • 不允许远程登录root? Y
  • 删除测试数据库并访问它? Y
  • 现在重新加载权限表? Y

修改XWiki配置文件来增强XWiki的安全性。

使用vi编辑器打开XWiki配置文件:


sudo vi /etc/xwiki/xwiki.cfg

查找下面显示的两行:


xwiki.authentication.validationKey=totototototototototototototototo
xwiki.authentication.encryptionKey=titititititititititititititititi

将两个参数值替换为两个不同的随机字符串,并确保每个字符串的长度相同,例如:


xwiki.authentication.validationKey=f0130dfa6fc841e920d5e1056184c03e
xwiki.authentication.encryptionKey=z84kf92ko073tgjdnvkdfmms91qa0ke4

保存和退出:

 
:wq

 
!

默认内存配额太低无法在中运行Tomcat8和Xwiki,在正确启动Tomcat8中的Xwiki实例之前,需要增加默认内存配额,如下所示。


sudo cp /etc/default/tomcat8 /etc/default/tomcat8.bak
sudo vi /etc/default/tomcat8

查找行:


JAVA_OPTS="-Djava.awt.headless=true -Xmx128m -XX:+UseConcMarkSweepGC"

修改如下所示的行:


JAVA_OPTS="-Djava.awt.headless=true -Xmx1024m"

注意:1024M的内存仅是运行小型或中等XWiki站点的最低限额,你可能需要根据你的具体要求对这一行进行调整。

保存和退出:

 
:wq

 
!

重新启动Tomcat 8以使所有修改生效:


sudo systemctl restart tomcat8.service

修改UFW防火墙规则以允许在端口上进行Web访问8080


sudo ufw allow 8080
sudo ufw enable

初始化"Distribution Wizard"web界面上的XWiki

此时,你已经设置了一个功能齐全,但是内容是空的XWiki站点。你需要在名为"Distribution Wizard"的初始XWiki Web界面上完成几个后续任务,包括创建管理员用户,并且为此Wiki安装风格和必需的扩展。

将你喜爱的网页浏览器指向http://203.0.113.1:8080/xwiki,你将自动进入"Distribution Wizard"web界面,单击"Continue"按钮以开始向导。

在" Step 1 - Admin user "页面,你需要输入用户的管理员凭据,例如:


FIRST NAME: `John`
LAST NAME: `Doe`
USERNAME (Required): `johndoe`
PASSWORD (Required): `yourpassword`
CONFIRM PASSWORD (Required): `yourpassword`
EMAIL ADDRESS: `johndoe@example.com`

在填写所有必需的字段后,单击"Register and login"按钮继续。

在下一页上显示" You are connected with user John Doe. ",单击"Continue"按钮创建用户名John Doe,它用户名为johndoe,并且移动。

在" Step 2 - Flavor ,页,单击" XWiki Standard Flavor 9.11.2 单击"Install this flavor",然后单击按钮以移动。

在下一页上详细说明" XWiki Standard Flavor 9.11.2 ",单击"Install"按钮执行安装。

如果已安装了flavor,所有需要的扩展都将在页面上列出,单击"Continue"按钮安装它们。

有了所有需要的扩展,点击右下角的"Continue"按钮移动。

在" Step 4 - Report ,页,你可以查看创建的所有页面。

如果需要,可以点击相应的红色X按钮删除不受欢迎的页面。

最后,单击"Continue"按钮完成"Distribution Wizard",你将以之前设置的管理员用户身份进入XWiki仪表板。

(可选)缩短XWiki站点URL

默认情况下,由于Tomcat可以同时服务多个应用程序,因此需要在URL http://203.0.113.1:8080/xwiki上访问XWiki站点,但是,如果XWiki是在Tomcat中运行的惟一应用程序,并且你希望通过删除/xwiki后,缀缩短站点的XWiki URL,那么应该修改3个XWiki配置文件,如下。

文件修改1


cd /etc/tomcat8/Catalina/localhost/
sudo cp xwiki.xml ROOT.xml
sudo mv xwiki.xml xwiki.xml.bak

文件修改2


cd /etc/xwiki
sudo cp xwiki-tomcat8.xml xwiki-tomcat8.xml.bak
sudo vi xwiki-tomcat8.xml

查找行:


<Context path="/xwiki" docBase="/usr/lib/xwiki" privileged="true" crossContext="true">

修改路径参数的值:


<Context path="/" docBase="/usr/lib/xwiki" privileged="true" crossContext="true">

保存和退出:

 
:wq

 
!

文件修改3


cd /etc/xwiki
sudo cp xwiki.cfg xwiki.cfg.bak
sudo vi xwiki.cfg

查找行:

 
# xwiki.webapppath=

 

取消注释:

 
xwiki.webapppath=

 

保存和退出:

 
:wq

 
!

最后,重新启动Tomcat 8以应用所有修改:


sudo systemctl restart tomcat8.service

从现在开始,你会直接从http://203.0.113.1:8080/访问你的XWiki站点。

(可选)设置Nginx反向代理

默认情况下,tomcat 8适用于端口8080,你只能从同一端口访问你的XWiki站点。如果你想通过删除端口号部分来方便访问者访问,则可以在XWiki和访问者之间安装Nginx作为反向代理。

首先,使用apt安装Nginx :


sudo apt install nginx -y

接下来,通过修改Nginx的默认站点配置,将它设置为反向代理:


cd /etc/nginx/sites-available
sudo mv default default.bak
sudo vi default

使用以下命令填充文件:


server {
listen 0.0.0.0:80;

proxy_request_buffering off;
proxy_buffering off;

location / {
 proxy_pass http://127.0.0.1:8080;
 proxy_redirect off;
 proxy_set_header Host $host;
 proxy_set_header X-Real-IP $remote_addr;
 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
 proxy_set_header X-Forwarded-Host $server_name;
}
}

保存和退出:

 
:wq

 
!

启动Nginx服务并将它设置为在系统启动时自动启动:


sudo systemctl restart nginx.service
sudo systemctl enable nginx.service

最后,相应地修改UFW防火墙规则:


sudo ufw allow 80
sudo ufw deny 8080
sudo ufw reload

从现在开始,XWiki站点的访问者不再需要指定端口号,他们应该直接访问http://203.0.113.1/



文章标签:Ubuntu  lts  Xwiki  

Copyright © 2011 HelpLib All rights reserved.    知识分享协议 京ICP备05059198号-3  |  如果智培  |  酷兔英语