Confluence相关背景知识

2021年4月13日更新

最近的confluence停止了对server版的支持，license都是data center的，以往的旧版本只能是cluster模式，这种情况下只需要使用默认的建议安装即可。选择默认的Multicast模式。

参考：
https://confluence.atlassian.com/doc/set-up-a-confluence-data-center-cluster-982322030.html
Multicast

查看Confluence有哪些系统插件：

http://cqq.com:8090/plugins/servlet/upm/manage/system

查看各插件的版本通过查看系统信息：（需要admin权限）
http://cqq.com:8090/admin/systeminfo.action

RSS feed有一个bug，。构造html页面的vm文件中多加了一个[]，导致发起请求时，带上了[]，导致tomcat响应400:

Confluence的Home目录以及重要目录说明：
https://confluence.atlassian.com/doc/confluence-home-and-other-important-directories-590259707.html

• bin/setenv.bat 或者bin/setenv.sh文件：
  可用来编辑一些CATALINA_OPTS变量、内存设置、gc变量等系统属性。
• confluence/WEB-INF/classes/confluence-init.properties：
  在这里指定confluence的home目录。

Confluence的Home目录是Confluence存储其配置信息、搜索索引和附件的目录。 “Home目录”也叫“数据目录”。

其他文件及目录的介绍：

• confluence.cfg.xml: 包含confluence的各种属性。
  
• attachments/: confluence上的所有附件都存在这里。如果想要更改，可以编辑confluence.cfg.xml文件的这个属性attachments.dir
• backups/: 每日自动备份（或手动备份）的内容会存放在这里，文件名大概是：daily-backup-YYYY_MM_DD.zip这个样子。想要更改这个位置，可以编辑confluence.cfg.xml的这个属性daily.backup.dir。
• bundled-plugins/: 每次confluence重启的时候，都会重新从数据库中读取。所以，删除这个目录下的文件并不能卸载这个插件！
• database/: 如果使用外部数据库，比如mysql，就不会用到这个目录。
  
• index/: 应用程序大量使用Confluence索引进行内容搜索和最近更新的列表，这对于正在运行的Confluence实例至关重要。 如果此目录中的数据丢失或损坏，可以通过从Confluence中运行完整重新索引来恢复它。 此过程可能需要很长时间，具体取决于Confluence数据库存储的数据量。
  
• journal/: [暂时不太清楚]
• logs/: confluence的应用日志。
• plugin-cache/: Confluence所有的插件都存放在数据库中，但为了能快速访问插件JARs中的类，于是把插件缓存到了这个目录下。当系统安装或者卸载插件的时候会更新这个目录。每次confluence重启的时候，都会重新从数据库中读取。所以，删除这个目录下的文件并不能卸载这个插件！
  
• temp/: 用于一些运行时的功能，比如exporting, importing, file upload and indexing。此目录中的文件是临时文件，可在Confluence关闭时被安全地删除。 Confluence中的daily job会删除不再需要的文件。也可以在confluence.cfg.xml文件中定义不同的temp目录，然后在webwork.multipart.saveDir属性中设置新的值
• thumbnails/: 存放图片文件的缩略图。
• shared-home/: 某些功能的缓存文件，比如Office文件以及PDF预览也放在这个目录下。也用于迁移到Data Center,。

所有其他的数据，包括页面的内容，都是存放在数据库中的。

如何更改Home目录

当Confluence启动的时候，会去confluence-init.properties文件中寻找Home目录的位置。想要更改Home目录，需要编辑confluence-init.properties文件的confluence.home属性。

License所在目录

Confluence的License写在其Home目录（也叫confluecne安装目录）的这个文件里

confluence.cfg.xml

到时候更新这里就行了。

当试用Confluence的时候，默认会使用内嵌的H2 Database
参考：https://confluence.atlassian.com/doc/embedded-h2-database-145098285.html
是以一个home目录下的database/h2db.mv.db文件形式存在。

H2 database管理

可以直接在<confluence安装目录>/confluence/WEB-INF/lib/h2-x.x.x.jar
启动jar文件。
我这里是

java -jar h2-1.4.196.jar

安装过程

安装了很多遍，这次试一下用git跟踪一下各个过程。
之前都选择都试用模式(Trial)，这次选择一下生产模式(Production)。

可以看到配置文件 confluence.cfg.xml会记录安装的步骤，一些生成的配置信息。
第一步，


第二步，

第三步，配置license

第四步，选择内置数据库，
于是生成了数据库文件，以及一些日志

并设置了默认的连接h2数据库的用户名密码：sa/空

然后可以看到，还弄了一些插件过来（可能是从安装目录复制过来的）。

然后下一步，第五步，让你设置一些示例数据

Empty Site不建议，因为没数据，有些东西就无法触发。

第六步，点击Empty Site之后，修改了配置文件confluence.cfg.xml

新建了attachments目录，

修改了h2数据库。所以示例站的数据应该在这个数据库里。其实attachments目录下就是一些图片，只是文件名是这样

添加用户

http://cqq.com:8090/admin/users/createuser.action
参考：
http://confluence.gjingao.com/pages/viewpage.action?pageId=328043
https://www.cwiki.us/display/CONFLUENCEWIKI/Add+and+Invite+Users#AddandInviteUsers-%E6%89%8B%E5%8A%A8%E6%B7%BB%E5%8A%A0%E7%94%A8%E6%88%B7

用户注册

默认是不允许用户注册的

Confluence的启动进程

有两个进程，

一个是h2数据库的(安装的时候选择内置数据库会设置成h2数据库)，

/Library/Java/JavaVirtualMachines/jdk1.8.0_101.jdk/Contents/Home/jre/bin/java -classpath /Users/caiqiqi/repos/atlassian-confluence-6.13.0/temp/2.1.0-master-e100417c.jar:/Users/caiqiqi/repos/atlassian-confluence-6.13.0/confluence/WEB-INF/lib/h2-1.4.196.jar -Xss2048k -Xmx1g synchrony.core sql

另外一个是tomcat的进程：

/Library/Java/JavaVirtualMachines/jdk1.8.0_101.jdk/Contents/Home/bin/java -Djava.util.logging.config.file=/Users/caiqiqi/repos/atlassian-confluence-6.13.0/conf/logging.properties -Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager -Djdk.tls.ephemeralDHKeySize=2048 -Djava.protocol.handler.pkgs=org.apache.catalina.webresources -Dorg.apache.catalina.security.SecurityListener.UMASK=0027 -XX:ReservedCodeCacheSize=256m -XX:+UseCodeCacheFlushing -Dconfluence.context.path= -Datlassian.plugins.startup.options= -Dorg.apache.tomcat.websocket.DEFAULT_BUFFER_SIZE=32768 -Dsynchrony.enable.xhr.fallback=true -Xms1024m -Xmx1024m -XX:+UseG1GC -Datlassian.plugins.enable.wait=300 -Djava.awt.headless=true -XX:G1ReservePercent=20 -Xloggc:/Users/caiqiqi/repos/atlassian-confluence-6.13.0/logs/gc-2019-09-17_14-41-39.log -XX:+UseGCLogFileRotation -XX:NumberOfGCLogFiles=5 -XX:GCLogFileSize=2M -XX:-PrintGCDetails -XX:+PrintGCDateStamps -XX:-PrintTenuringDistribution -Dignore.endorsed.dirs= -classpath /Users/caiqiqi/repos/atlassian-confluence-6.13.0/bin/bootstrap.jar:/Users/caiqiqi/repos/atlassian-confluence-6.13.0/bin/tomcat-juli.jar -Dcatalina.base=/Users/caiqiqi/repos/atlassian-confluence-6.13.0 -Dcatalina.home=/Users/caiqiqi/repos/atlassian-confluence-6.13.0 -Djava.io.tmpdir=/Users/caiqiqi/repos/atlassian-confluence-6.13.0/temp org.apache.catalina.startup.Bootstrap start

附录

Confluence中文文档可以好好看看：
https://www.cwiki.us/display/CONFLUENCEWIKI

网上找了一份Confluence 6.9的源码和jenkins的wiki页面：
https://cloudled.com/support/confluence-6.9.0-source
https://github.com/jenkins-infra/confluence