中文标题【Confluence Home 和其他重要的目录】

Confluence 安装目录

Confluence 安装的目录(Confluence Installation directory)定义的是 Confluence 是在那里进行安装的。这个目录有时候也被称为 Confluence 安装目录(Confluence Install directory)。

安装目录中的一些重要文件:

  • bin/setenv.bat or bin/setenv.sh
    这个文件通常被用来编辑 CATALINA_OPTS 内存和垃圾回收的设置,同时也定义了系统的属性。
  • confluence/WEB-INF/classes/confluence-init.properties 
    这个文件中定义了 Confluence Home 目录的位置。


本页中的内容:

Confluence home 目录

Confluence Home 目录是存储 Confluence 信息,查找索引,页面附件的地方。其实 Home 目录也可以定义为数据目录。

找到 Home 目录

Confluence 的 home 目录是你在安装 Confluence 的时候定义的。存储位置定义在 confluence-init.properties 文件中,这个文件位于你 Confluence 安装目录的 confluence/WEB-INF/classes 目录下。

当 Confluence 正在运行的时候,你可以从下面的配置连接中找到 home 目录的配置路径:  > 系统信息(System Information > Confluence 信息 - Home 目录(Confluence Information - Confluence Home)

如果你现在正在使用的是 Confluence 数据中心(集群服务器),同时你已经配置了共享 home (shared home)目录,这个目录中应该已经有一些数据了(例如附件和备份等),那么你共享目录的大小可能改变。你共享目录的路径应该在你的 <local-home>/confluence.cfg.xml 文件中的 confluence.cluster.home 属性定义。

Home 目录中的内容

Confluence home 目录存储了 Confluence 在运行中所使用的数据。下面对 Confluence home 目录中使用的数据和文件进行一些说明:

文件或目录(File or directory)用途(Purpose)

confluence.cfg.xml

这个文件有 Confluence 能正常启动所需要的所有配置,例如有:

  • 产品许可证(Product license)
  • 上下文路径(Context path)
  • 数据库配置细节,例如数据库地址,连接池配置等
  • 重要目录的路径

attachments/

这个目录存储了 Confluence 所使用附件的每一版本。

你可以为你的附件存储指定一个特定的其他目录,这个配置是在 confluence.cfg.xml 文件中的 attachments.dir 配置定义的。

在数据中心模式下,这个目录通常是能在 Shared Home 目录中定义的。

backups/

Confluence 将会把每天的备份文件存储在这里,同时也会存储你手动创建的备份文件。在这个备份目录中的备份文件通常的文件名是按照 daily-backup-YYYY_MM_DD.zip 格式定义的。

你可以为你的备份文件存储指定一个特定的其他目录,这个配置是在 confluence.cfg.xml 文件中的 daily.backup.dir 配置定义的。

在数据中心模式下,这个目录通常是能在 Shared Home 目录中定义的。

bundled-plugins/

Confluence 安装了一系列的插件。bundled-plugins 目录是 Confluence 在启动的时候解压压缩的插件后存储的地方。这个目录将会在 Confluence 每一次重启的时候进行刷新,所以将这个目录中安装的插件删除的话是不会删除 Confluence 已经安装的插件的。因为这些内容将会在下一次 Confluence 重启的时候重新创建。

database/

这个是 Confluence 运行使用 Embedded H2 Database 模式的时候数据库存储的位置。在这种情况下,这个目录存储了 Confluence 运行所需要的所有数据库数据。如果你配置 Confluence 使用外部数据库例如你使用的数据库是 MySQL 的话,这个目录是不需要的。

index/

Confluence 的索引在 Confluence 使用的频率非常高,查找 Confluence 最近更新的内容列表对 Confluence 运行来说是非常重要的。如果这个目录中的数据丢失或者损坏了,你可以通过重构完整索引的方式将这些内容进行恢复。这个过程可能要花费很差的时间,花费时间的长度与你系统运行的数据量有多少有关系。

你可以为你的索引文件存储指定一个特定的其他目录,这个配置是在 confluence.cfg.xml 文件中的 lucene.index.dir 配置定义的。

journal/

所以添加的日志(journal )存储在这里,这个添加的日志为你对页面进行修改的的时候(例如,页面添加了评论,点赞,新页面等)。Journal  中的内容将会被处理并添加到索引中(每 5 秒钟处理一次)。

在集群环境下,这个目录中保存了各个实例需要同步的内容。keeps the indexes on each node in sync.

logs/Confluence 的应用程序日志存储在这个目录中。

plugin-cache/

所有的 Confluence 插件存储在数据库中。为了能够更加快速的访问插件所需要的 Jar 文件,Confluence 将会把这些存储在数据库中的插件缓存到本地上来,这个缓存目录为 plugin-cache 目录。这个目录中的内容将会在 Confluence 每一次重新启动的时候刷新,在每一次 Confluence 重新启动的时候,数据将会从 Confluence 数据库中缓存到这里,将这个目录中安装的插件删除的话是不会删除 Confluence 已经安装的插件的。

temp/

temp 目录被用来使用为运行时候的功能临时存储的地方,例如导出,导入,文件上传和索引。在这个目录中存储的文件为临时存储的文件。当 Confluence 实例没有运行的时候,你可以安全的清空这个文件夹中的所有内容。一个每天运行的计划任务将会删除这个文件中不在需要的文件。

你可以为你的备份文件存储指定一个特定的其他目录,这个配置是在 confluence.cfg.xml 文件中在 webwork.multipart.saveDir 配置新的存储位置。

thumbnails/

为图片缩略图存储的临时文件目录。这个目录只用来使用为缩略图的换成,当这个文件中的内容删除后,当图片下一次访问的时候,系统会重新将文件的缩略图存在这个文件夹中创建。

在数据中心模式下,这个目录通常是能在 Shared Home 目录中定义的。


修改 Home 目录的位置

当 Confluence 第一次启动的时候,Confluence 将会读取 confluence-init.properties 文件并从这个文件中确定如何去查找 Home 目录。

希望修改 home 目录的路径,你可以在 confluence-init.properties 文件中按照下面的格式修改 confluence.home 的属性:

  • Windows 
    在 Window 环境下,路径 C:\confluence\data 将会被写成:
    confluence.home=C:/confluence/data  
    请注意需要将反斜杠(\)修改为斜杆(/)
  • Linux / Solaris
    在任何基于 Linux 环境的系统中,属性的定义遵守 Linux 定义的常规句法:
    confluence.home=/var/confluence/

符号链接(symbolic links)

在 Confluence 的 home 目录中,可能会有一些符号链接。你需要必须定义为绝对路径。如果你有磁盘空间存储的问题,请修改 confluence.home 目录的配置指派到有足够空间的磁盘。生成文件所使用的绝对路径(例如导出的时候)将会使用 confluence.home 中配置的绝对路径,当在构造 URLs 的时候。当一个子目录有不同的的路径的时候,URL 的构造可能会不正常,你可能会收到页面没有找到的错误。这个信息用来避免下页面中显示目录的所有结构。

修改 Confluence 配置

Confluence 配置文件:confluence-cfg.xml 在 home 目录中可能参照你 Confluence home 目录的原始位置。你需要编辑这个文件来升级参考这些文件指向到新的位置。在这个文件中有下面 2 个属性可以进行配置:

  • daily.backup.dir 如果你还没有配置,你的备份已经在其他地方进行存储了。
  • hibernate.connection.url 如果你现在正在使用嵌入的 HSQL 数据库。

数据库

所有的其他数据库,包括有页面,内容都存储在数据库中。如果你安装的 Confluence 是用于评估或者你选择使用的是 Embedded H2 Database 数据库。数据库有关的文件将会存储在 database/ 目录中,这个目录位于 Home 目录下面。否则数据库将会存储你 Confluence 站点所使用的所有数据。

临时目录(安装目录)

temp 目录是由 Java 运行时进行配置的,同时一些 Confluence 的组件将会写入历史文件或者锁定文件到这个目录中。

临时目录位于安装目录下的 /temp 目录中。

希望修改这个目录的位置,重启你的 Java虚拟机(Java Virtual Machine)的时候配置下面的参数:

-Djava.io.tmpdir=/path/to/your/own/temp/directory.

(warning) 请注意:这个临时目录与 Confluence Home 目录中导出的临时目录是不相同的。请查看上面表格中有关 <confluence-home>/temp 的配置来修改你临时目录的配置。