中文标题【Confluence Home 和其他重要的目录】
Confluence home 目录
Confluence Home 目录是存储 Confluence 信息,查找索引,页面附件的地方。其实 Home 目录也可以定义为数据目录。
找到 Home 目录
Confluence 的 home 目录是你在安装 Confluence 的时候定义的。存储位置定义在 confluence-init.properties
文件中,这个文件位于你 Confluence 安装目录的 confluence/WEB-INF/classes
目录下。
当 Confluence 正在运行的时候,你可以从下面的配置连接中找到 home 目录的配置路径: 基本配置(General Configuration) > > 系统信息(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 能正常启动所需要的所有配置,例如有:
|
| 这个目录存储了 Confluence 所使用附件的每一版本。 你可以为你的附件存储指定一个特定的其他目录,这个配置是在 在数据中心模式下,这个目录通常是能在 Shared Home 目录中定义的。 |
| Confluence 将会把每天的备份文件存储在这里,同时也会存储你手动创建的备份文件。在这个备份目录中的备份文件通常的文件名是按照 你可以为你的备份文件存储指定一个特定的其他目录,这个配置是在 在数据中心模式下,这个目录通常是能在 Shared Home 目录中定义的。 |
| Confluence 安装了一系列的插件。bundled-plugins 目录是 Confluence 在启动的时候解压压缩的插件后存储的地方。这个目录将会在 Confluence 每一次重启的时候进行刷新,所以将这个目录中安装的插件删除的话是不会删除 Confluence 已经安装的插件的。因为这些内容将会在下一次 Confluence 重启的时候重新创建。 |
| 这个是 Confluence 运行使用 Embedded H2 Database 模式的时候数据库存储的位置。在这种情况下,这个目录存储了 Confluence 运行所需要的所有数据库数据。如果你配置 Confluence 使用外部数据库例如你使用的数据库是 MySQL 的话,这个目录是不需要的。 |
| Confluence 的索引在 Confluence 使用的频率非常高,查找 Confluence 最近更新的内容列表对 Confluence 运行来说是非常重要的。如果这个目录中的数据丢失或者损坏了,你可以通过重构完整索引的方式将这些内容进行恢复。这个过程可能要花费很差的时间,花费时间的长度与你系统运行的数据量有多少有关系。 你可以为你的索引文件存储指定一个特定的其他目录,这个配置是在 |
journal/ | 所以添加的日志(journal )存储在这里,这个添加的日志为你对页面进行修改的的时候(例如,页面添加了评论,点赞,新页面等)。Journal 中的内容将会被处理并添加到索引中(每 5 秒钟处理一次)。 在集群环境下,这个目录中保存了各个实例需要同步的内容。keeps the indexes on each node in sync. |
logs/ | Confluence 的应用程序日志存储在这个目录中。 |
| 所有的 Confluence 插件存储在数据库中。为了能够更加快速的访问插件所需要的 Jar 文件,Confluence 将会把这些存储在数据库中的插件缓存到本地上来,这个缓存目录为 plugin-cache 目录。这个目录中的内容将会在 Confluence 每一次重新启动的时候刷新,在每一次 Confluence 重新启动的时候,数据将会从 Confluence 数据库中缓存到这里,将这个目录中安装的插件删除的话是不会删除 Confluence 已经安装的插件的。 |
|
你可以为你的备份文件存储指定一个特定的其他目录,这个配置是在 |
| 为图片缩略图存储的临时文件目录。这个目录只用来使用为缩略图的换成,当这个文件中的内容删除后,当图片下一次访问的时候,系统会重新将文件的缩略图存在这个文件夹中创建。 在数据中心模式下,这个目录通常是能在 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
.
请注意:这个临时目录与 Confluence Home 目录中导出的临时目录是不相同的。请查看上面表格中有关
<confluence-home>/temp
的配置来修改你临时目录的配置。