在《一个小团队使用的知识管理方案与工具》中我们介绍了一些 Confluence 的基本特性，今天我们来看看这个工具的一些安装部署问题。

1. Java 与 PostgreSQL 安装配置

1.1 Oracle Java JDK 8

https://www.oracle.com/java/technologies/javase/javase8u211-later-archive-downloads.html
注册一个 oracle 账号就行，需要的文件：jdk-8u251-linux-x64.tar.gz

  1. 创建目录，解压。

    1. mkdir /usr/java
    2. tar zvxf jdk-8u251-linux-x64.tar.gz -C /usr/java

  2. 环境配置，修改 ~/.bashrc（或者 /etc/profile）文件。

    1. vim ~/.bashrc

  3. 添加以下内容。

    1. export JAVA_HOME=/usr/java/jdk1.8.0_251
    2. export PATH=$JAVA_HOME/bin:$PATH
    3. export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar

  4. 使环境变量生效。

    1. source ~/.bashrc

  5. 检查配置是否成功。

    1. $ java -version
    2. java version "1.8.0_251"
    3. Java(TM) SE Runtime Environment (build 1.8.0_251-b08)
    4. Java HotSpot(TM) 64-Bit Server VM (build 25.251-b08, mixed mode)

    image.png

1.2 PostgreSQL

PostgreSQL 是 Atlassian 官方推荐用于 Confluence 的数据库，接下来我们需要安装 PostgreSQL，并执行一些必要的设置。

1. 安装

Linux 下 PostgreSQL 数据库的安装请参考《Linux 下 PostgreSQL 源码编译安装》一文，这里不赘述。

2. 配置

创建用于 Confluence 的数据库。详细可以参考《How to install Confluence on Centos7 with PostgreSQ》。

  1. $ sudo -u postgres -i
  2. $ psql
  3. psql (10.13)
  4. Type "help" for help.
  6. postgres=# CREATE USER confluencedbuser PASSWORD 'confluencedbpassword';
  7. postgres=# CREATE DATABASE confluencedb WITH ENCODING 'UNICODE' LC_COLLATE 'C' LC_CTYPE 'C' TEMPLATE template0;
  8. postgres=# GRANT ALL PRIVILEGES ON DATABASE confluencedb to confluencedbuser;
  9. \q
  10. -bash-4.2$ exit

2. 下载安装 Confluence


2.1 下载

  1. $ mkdir /data/apps/atlassian
  2. $ cd /data/apps/atlassian
  3. $ wget https://product-downloads.atlassian.com/software/confluence/downloads/atlassian-confluence-7.2.1-x64.bin

2.2 安装

给 atlassian-confluence-7.2.1-x64.bin 添加可执行权限后进行安装。
mkdir-atlassian-dir.png

然后，执行 ./atlassian-confluence-7.2.1-x64.bin 安装，注意安装完成后先不要急着启动！！！
atlassian-confluence-install.jpg

2.3 破解

由于 Confluence 本身是一个收费的软件，想要免费安装，可以使用 pengzhile 提供的在 GitHub 上开源了对 Atlassian 家所有产品（包括插件市场所有收费插件）的破解方法。

具体做法如下。

  1. 将 atlassian-agent.jar 放在一个你不会随便删除的位置（你服务器上的所有 Atlassian 服务可共享同一个 atlassian-agent.jar）

    1. tar zvxf atlassian-agent-v1.2.3.tar.gz -C /data/apps/atlassian

  2. 非常重要！！！需要设置环境变量 JAVA_OPTS，避免开机失效。在 atlassian-agent 的说明中提供了3个建议，大家可以根据自己需要去设置，这里我们选择第二种方法：把 JAVA_OPTS 环境放到服务安装所在 bin 目录下的 setenv.sh 或 setenv.bat 中。 ```bash

    vim /data/apps/atlassian/confluence/bin/setenv.sh

CATALINA_OPTS=”-javaagent:/data/apps/atlassian/atlassian-agent-v1.2.3/atlassian-agent.jar ${JAVA_OPTS}”

  1. ![cinfluence-setenv.png](https://cdn.nlark.com/yuque/0/2020/png/126032/1597995687911-fbda3b21-b0b7-46be-90e0-2c47bc8d5ccc.png#align=left&display=inline&height=458&margin=%5Bobject%20Object%5D&name=cinfluence-setenv.png&originHeight=458&originWidth=1096&size=68445&status=done&style=none&width=1096)
  3. 3. 准备就绪后，我们就要开启 Configuration了，找到启动脚本并启动 start-confluence.sh，启动完成后我们可以通过浏览器进行访问。
  5. ![start_confluence.png](https://cdn.nlark.com/yuque/0/2020/png/126032/1597996164699-0354cc87-643e-4629-bb60-89cb03f5bf28.png#align=left&display=inline&height=488&margin=%5Bobject%20Object%5D&name=start_confluence.png&originHeight=488&originWidth=1097&size=40045&status=done&style=none&width=1097)
  8. <a name="tjo51"></a>
  9. ### 2.4 配置
  11. 在浏览器中打开 **http://localhost:8090** 或者 **http://<你服务器的公网IP>:8090 **，打开 Confluence 的配置页面。
  13. 选择中文，产品安装。<br />![01-产品安装.png](https://cdn.nlark.com/yuque/0/2020/png/126032/1597999463517-e03b1fa7-f268-46a8-ba65-4d39b7e46624.png#align=left&display=inline&height=656&margin=%5Bobject%20Object%5D&name=01-%E4%BA%A7%E5%93%81%E5%AE%89%E8%A3%85.png&originHeight=656&originWidth=1016&size=65578&status=done&style=none&width=1016)
  15. 获取应用。<br />![02-获取应用.png](https://cdn.nlark.com/yuque/0/2020/png/126032/1597999481268-bdc835dd-c251-472d-8538-4948d9e95876.png#align=left&display=inline&height=656&margin=%5Bobject%20Object%5D&name=02-%E8%8E%B7%E5%8F%96%E5%BA%94%E7%94%A8.png&originHeight=656&originWidth=1016&size=87512&status=done&style=none&width=1016)
  17. 获得服务器 ID 及授权码提示。<br />![03-授权码.png](https://cdn.nlark.com/yuque/0/2020/png/126032/1597999558030-923f3ab3-2c1b-48c3-9b62-f723850247e8.png#align=left&display=inline&height=656&margin=%5Bobject%20Object%5D&name=03-%E6%8E%88%E6%9D%83%E7%A0%81.png&originHeight=656&originWidth=1016&size=65756&status=done&style=none&width=1016)
  19. <a name="vQ8AV"></a>
  20. ### **2.5 授权码**
  21. 当我们在后台服务器通过命令行执行 java -jar /atlassian-agent.jar 时应该可以看到输出的 KeyGen 参数帮助。
  23. - 破解 Confluence 时，选择 conf 即可，具体命令如下：
  24. ```bash
  25. # 将server ID复制（-m 邮箱 -n 用户名 -o 公司名 -s SERVER ID）
  26. java -jar atlassian-agent.jar -p conf -m ishenweiyan@foxmail.com -n shenweiyan -o wiki-test -s B7DP-BX09-325B-DJLP


  • 破解团队日程表时，选择 tc 即可，具体命令如下：

    1. # 将server ID复制（-m 邮箱 -n 用户名 -o 公司名 -s SERVER ID）
    2. java -jar atlassian-agent.jar -p tc -m ishenweiyan@foxmail.com -n shenweiyan -o wiki-test -s B7DP-BX09-325B-DJLP

  • 破解 Confluence Questions 时，选择 questions 即可，具体命令如下：

    1. # 将server ID复制（-m 邮箱 -n 用户名 -o 公司名 -s SERVER ID）
    2. java -jar atlassian-agent.jar -p question -m ishenweiyan@foxmail.com -n shenweiyan -o wiki-test -s B7DP-BX09-325B-DJLP

将生成的授权码粘贴，下一步。
04-授权码.png

设置数据库，生产环境建议独立的数据。
05-设置数据库.png

选择 PostgreSQL 数据库，填写数据库信息，测试数据库连通性。
06-设置-测试数据库.png

过一会你就可以看到这个页面了，安装成功了。

一个小清新的知识管理和问题讨论平台 - 图7

3. 使用与管理

3.1 使用

1. 选择站点

如果是全新的站点，那就选择空白站点，如果只是升级或者备份恢复，那就选择从备份还原站点。这里我们选择”示范站点”。
07-示范站点.png

2. 配置用户管理

配置用户，如果有 Jira 环境的话 ，可以集成 Jira 的用户管理，也可以使用 confluence 自己的用户，那就选择“在confluence中管理用户和组”。
08-配置用户管理.png
09-设置系统管理员.png
10-设置成功.png

3. 创建空间

创建空间.png
空间创建完成后，就会自动进入已经创建好的空间，接下来，enjoy！
进入空间.png

3.2 站点管理

点击右上角，可以进行站点管理，常用的如 “一般配置”：
一般配置.png
点击一般配置，授权管理，可以查看到授权情况：
授权信息.png
当然本文介绍的方式仅用于学习体验，有能力的还是建议支持正版！！！

4. 备份恢复

Confluence 本身会有每日的备份管理，就是定时备份任务（“一般配置”→“每日备份管理”）。
每日备份管理.png
由于一些其他原因需要新建一个 Confluence 环境，然后还原的，可以点下面的“备份与还原”。

  • 如果您的导出文件很小(小于 25 MB)，请直接在浏览器“备份与还原”页面直接进行上传。
  • 而较大的文件需要从主目录导入。需要提前将备份的文件放到 /path/to/application-data/confluence/restore 下。

具体备份与还原，可以参考 “一般配置” → “备份与还原” 页面的详细介绍。
备份与还原-Confluence.png

5. 参考资料

  1. 武培轩，《CentOS 7 安装 JAVA环境（JDK 1.8）》，博客园
  2. 王良付，《CentOS 7.6 安装 Confluence 7.2》，良付の博客
  3. 胖哥叨逼叨，《Atlassian Confluence 部署-confluence安装》，WordPress
  4. Agile Project Management * DIY Electronics，《How to install Confluence on Centos7 with PostgreSQL》，Comtronic Blog