HoneyMoose

欢迎来到 Confluence 的开始使用指南文档。在这个稳定中，你将会找到有关对 Confluence 进行评估的指南和其他的一些有用的内容。当你开始使用 Confluence 的时候，这些信息能够帮助你更好的了解 Confluence 。 空间的小组 针对这个指南中的部分，我们将使用一个虚构的组织，这个组织被我们标识为空间项目（Teams in Space）。我们的任务是： "进行飞行研究和技术整合来对航空航天进行科技进行革命化的推进。同时让人类能够在 2020 年第一次登陆火星。" 你现在已经是 'See Space EZ' 项目小组的宇航员了，我们将要考虑在火星上定居了。 继续下一步 —— 请继续阅读有关 Confluence 的这个使用指南，让我们帮助你展示 Confluence 中有用的功能和一些方便的特性。 Tutorial: Navigate Confluence The dashboard The space directory The space sidebar Keyboard shortcuts Complete your mission Tutorial: Space ace Create a project space Create your personal space Create the team's PR space Delete and archive spaces https://www.cwiki.us/display/CONF6ZH/Get+started

一个 cron 表达式是以 6-7 时间字段来定义一个计划任务是如何按照时间被执行的。每一个字段中的数据库而已为数字或者是一些特定的字符串来进行表达。每一个字段是使用空格或者 tab 进行分隔的。 下面的表格中显示了每一字段中可以被使用的字符和被允许的值。 你可以为这些字段指定一些特殊的值在 cron 表达式中，能够为你提供更多的世界控制和计划任务的频率控制。最常用的字符包括有： '*' — 一个通配符，表示的是所有允许的值。 '?' — 表达的是忽略这个字段的意思。当这个字段被设置后，这个字段表示的是计划任务在这个时间点没边际（例如： 'Month', 'Day of week' 或者'Year'）。 有关更多 Confluence 的表达式，请参考 Cron Trigger tutorial on the Quartz website 页面中的内容。 1 秒（Seconds） 0-59 是（Yes） 2 分钟（Minutes） 0-59 是（Yes） 3 小时（Hours） 0-23 是（Yes） 4 每月中的天（Day of month） 1-31 是（Yes） 5 月（Month） 1-12 or JAN-DEC 是（Yes） 6 每周中的天（Day of week） 1-7 or SUN-SAT 是（Yes） 7 年（Year） 1970-2099 否（No） * 包括有特殊字符 https://www.cwiki.us/display/CONF6ZH/Scheduled+Jobs

下面是有关你可以调整的计划任务列表。 Confluence 备份（Back Up Confluence） 对 Confluence 站点执行 备份 操作。 每集群（Per cluster） At 2am every day 检查集群安全（Check Cluster Safety） 针对集群方式的 Confluence 安装，这个计划任务将会保证在集群中只有一个 Confluence 节点向数据库中写入信息。 针对标准方式（非集群方式）版本的 Confluence，这个任务被用来警告用户，谁错误的连接到第二个 Confluence 数据库实例，这个数据库已经被一个 Confluence 使用了。in use. 每集群（Per cluster） Every 30 seconds 清理 Journal 实体（Clean Journal Entries） 周期化的清理 journal  实体，这个能够保证数据的大小能够保持正常的增长速度而避免过度膨胀。 每节点（Per node） 每天的 2 AM 清理临时目录（Clean Temporary Directory） 清理 <confluence-home>/temp 目录中的临时文件。这个目录被导出任务或其他一些任务创建。 这个清理不包括 Confluence 安装目录中文件的清理。 每节点（Per node） 每天的 4 AM 清理过期的邮件错误（Clear Expired Mail Errors） 清理 The Mail Queue 队列中的通知错误。当一个邮件因为某个原因而发送失败没有发送成功的话，一个通知错误将会被发送到邮件错误队列中。 每集群（Per cluster） 每天的 3 AM 清理过期的记住我令牌（Clear Expired Remember Me Tokens） 清理所有过期的记住我（Remember Me）令牌。记住我这个令牌超过两周后就会过期。 每集群（Per cluster） 每个月的 20 号 邮件每日报表（Email Daily Reports） 针对 Confluence 的内容的修改，为 所有订阅者 发送每天的更新通知。 所有有关 Confluence 的内容修改记录将会只记录最后 24 小时的修改。这个推荐你只能修改任务发送邮件的...

希望查看一个计划任务最后运行的时间和这个计划任务最后一次运行花费了多长时间。单击计划任务边上的 历史（History ） 连接。 如果一个计划任务从来没有运行的胡啊，那么这个历史的链接是不会显示的。 屏幕截图：任务执行历史 https://www.cwiki.us/display/CONF6ZH/Scheduled+Jobs

在默认的情况下，所有的 Confluence 计划任务都是默认启用的。 使用 启用（Disable ）/ 禁用（Enable ） 连接操作来启用和禁用每一个计划任务。 不是所有的加护任务都可以被禁用的。 https://www.cwiki.us/display/CONF6ZH/Scheduled+Jobs

手动运行一个任务 希望手动运行一个计划任务，进入计划任务的列表中，找到你希望手动运行的计划任务，在这个计划任务的边上选择 运行（Run） 。这个计划任务将会马上执行。 不是所有的计划任务都可以手动运行的。 修改任务的计划 希望修改计划任务的计划时间： 找到你希望修改的计划任务边上的 编辑（ Edit ）。 使用 Cron 表达式输入你希望这个计划任务运行的新日期和时间——关 Cron 表达式的相关信息，请参考 下面 的内容。 保存（Save ） 你对计划任务的修改，或者 重置（Revert ） 为默认设置。 不是所有的计划任务都可以配置时间的。 屏幕截图：配置一个计划任务 https://www.cwiki.us/display/CONF6ZH/Scheduled+Jobs

希望访问 Confluence 计划任务配置界面： 进入  >  基本配置（ General Configuration）  > 计划任务（Scheduled Jobs） 所有的计划任务将会按照下面的格式列出来： 状态（Status ） - 这个计划任务的状态。这个状态为 'Scheduled' （当前这个计划任务是启用的）或者 'Disabled'。 上次执行（Last Execution） - 这个计划任务上次执行的日期和时间。如果这个计划任务没有执行的话，这个字段为空。 下次执行（Next Execution） - 这个计划任务下次执行的日期和时间。如果任务被禁用的话，这个字段将会显示符号（-）。 平均执行时间（Avg. Duration） - 计划任务的执行时间（毫秒）这个时间表示的是这个计划任务执行完成所消耗的世界（上次任务完成所需要的时间）。 操作（Actions） - 对计划任务可以进行操作，包括编辑，手动运行，查看历史或者禁用这个任务。 屏幕截图：计划任务 https://www.cwiki.us/display/CONF6ZH/Scheduled+Jobs

管理员控制台能够允许你对 Confluence 运行的计划任务进行计划的调整，这些计划任务将会按照你的调整按时执行。可以按照计划执行的任务如下： Confluence 站点备份 存储优化任务，清理 Confluence 的临时目录中的文件和缓存 索引优化任务，确定 Confluence 的索引能够保持与数据库同步是最新的索引 邮件队列优化任务，确保 Confluence 的邮件任务能够处理邮件队列并且所有的邮件都能发送出去。 你需要具有 系统管理员权限 才能对计划任务进行编辑和手动运行。 https://www.cwiki.us/display/CONF6ZH/Scheduled+Jobs

如果你得到了与下面显示内容类似的信息话，那么你最好考虑修改 Confluence 的日志级别输出更多的信息。如果你考虑通过 Atlassian support 获得帮助，那么这些详细的错误信息能够更好的帮助我们找到问题的原因。 增加日志的级别将会让我们能够对下面的问题进行诊断： org.springframework.dao.DataIntegrityViolationException: (HibernateTemplate): data integrity violated by SQL '' ; nested exception is java.sql.BatchUpdateException: Duplicate entry '1234' for key 1   at org.springframework.jdbc.support.SQLStateSQLExceptionTranslator.translate(SQLStateSQLExceptionTranslator.java: 88 ) caused by: java.sql.BatchUpdateException: Duplicate entry '1234' for key 1   at com.mysql.jdbc.ServerPreparedStatement.executeBatch(ServerPreparedStatement.java: 647 ) 或者 (HibernateTemplate): data integrity violated by SQL '' ; nested exception is java.sql.BatchUpdateException: ORA- 00001 : unique constraint ( CONFLUENCE.SYS_C0012345) violated 这个文档对如果在你的系统中增加日志级别，并让日志输出更多详细信息进行了说明。 Changing the logging levels via the Administration Console 从 Confluence 2....

日志级别 DEBUG - 被设计为用来获得最多的信息和事件，在对应用程序进行调试的时候，这个日志级别通常能够提供最多的有效信息（查看应用程序怎么了） INFO - 有关系统正常运行-计划任务运行，服务器开始和结束的世界，用户触发的进程和操作的一些有关声明和输出 WARN - 有关这方面的内容并不是表示系统本身出错了，而是表示系统本身有优化的空间 ERROR - 有关这个的输出表示的是系统在运行的时候遇到了一些错误 FATAL - 有关这个级别的输出表示系统进入了一个非常糟糕的状态并且已经不能从这个状态中恢复了。 TRACE - 没有在 Confluence 中输出 有 2 个方法能够对 Confluence 的日志输出进行调整，相关的方法描述在 log4j Logging Levels 中。 通过 管理员控制台（Administration Console） 修改运行日志的级别（这个修改将会在系统重启后失效，不是一个永久的修改）。 手动修改 <Confluence-Install>\confluence\WEB-INF\classes\log4j.properties 文件。 默认日志级别 标准的 Confluence 日志级别 WARN 被保留在 Confluence 服务器中与 Confluence 管理员进行通信。 WARN 及其更高的日志级别应该在 Confluence 保留使用为某些特定的用途，这些能够提醒系统管理员关注这些错误的日志信息，然后对出现的问题进行纠正。 请参考 log4j manual 来获得更多的信息。 https://www.cwiki.us/display/CONF6ZH/log4j+Logging+Levels

我们推荐你根据你的需求来配置你自己的 Confluence 日志。你可以有下面 2 种方法来修改你的日志： 通过 Confluence 管理员控制台进行配置 – 你的修改仅在本次修改有效，下次重启后将会把所有修改重置。 编辑属性文件 – 你的修改将会在下次重启后生效同时针对所有的会话。 这 2 种方式的修改的方法将在下面的章节中描述。在一些很不常见的情况下，你可能同时还需要修改 logging.properties 文件。 术语： 在 log4j 中，一个 'logger' 就是一个命名的实体。日志名是大小写敏感的，这些命名还遵循分段命名的结构。例如一个 logger 被命名为 com.foo ，那这个名是  com.foo.Bar 的上级名称。 在 Confluence 管理员控制台中配置日志 你可以通过 Confluence 管理员控制台（Administration Console） 来修改 Confluence 的一些日志的表现。任何按照这个方法修改的的内容只会在当前 Confluence 的运行实例阶段有效（重启 Confluence 后，你修改的配置将失效）。这里修改的配置内容将不会写入到 log4j.properties 文件中，同时当你在下一次停止 Confluence 的时候修改的内容将会被丢弃。 Confluence 的管理员控制台不能修改所有的日志表现。如果你不能在下面的描述的内容中找到修改的对象，那么你需要停止 Confluence 后 编辑日志属性文件 。 Confluence 管理员控制台中的 日志和属性（ Logging and Profiling ）界面显示了当前定义的所有日志列表。在这个界面中你可以： 打开或者关闭 page profiling 。 打开或者关闭 SQL 语句日志。 为一个类或者包添加一个新的日志。 为一个类或者包删除一个新的日志。 为一个类或者包设置日志的级别（INFO, WARN, FATAL, ERROR 或者 DEBUG）。 重置所有的日志级别到 predefined 属性。 修改日志配置 在屏幕的右上角单击  控制台按钮  ，然后选择  General Configuration 链接。 在左侧面板中 管理（Adm...

指定 Confluence 日志选项 这里是一些特定的日志配置，你可能在对问题进行调试的时候需要。 在日志中记录数据库使用的 SQL 查询请求 你可能希望增加日志的中的内容，记录 Confluence 系统向数据库中插入数据的时候使用的 SQL 语句。针对一些特定的问题的诊断，这个配置能够帮你找到你肯能需要的一些信息。 你可以通过下面的 2 种方法启用在你的日志中记录 SQL 的内容： 在系统运行的时候记录 – 请参考 上面的指南 。 通过日志配置文件 – 请参考这里的 Enabling Detailed SQL Logging 。 日志用户查看/访问 Confluence 每一个页面的详细信息 你可以配置那些用户访问了你 Confluence 站点的那些页面。只仅仅只能通过修改日志配置文件才能进行配置，请参考下面 Enabling Detailed SQL Logging 页面中的内容。 搜索日志文件获得已知问题 Atlassian 问题解决和支持工具包括有一个日志分析器。这个日志分析器能够检查你 Confluence 的日志来找到日志中的错误，同时根据日志中的错误来对我们已知知识库和问题跟踪系统中的内容进行对比。 请参考 Troubleshooting Problems and Requesting Technical Support 页面中的内容来找到如何设置按照时间来执行扫描你的日志文件。 .https://www.cwiki.us/display/CONF6ZH/Working+with+Confluence+Logs

修改日志文件的大小和数量 在默认的情况下，Confluence 将会保持 5 个日志文件，每一个日志文件的大小超过 20 MB 的时候将会被重写。 你可以修改默认日志文件的大小和数量，通过编辑 <CONFLUENCE-INSTALL>/confluence/WEB-INF/classes/log4j.properties 文件中的内容。 log4j.appender.confluencelog.MaxFileSize=20480KB log4j.appender.confluencelog.MaxBackupIndex= 5 修改日志级别 请参考 Configuring Logging 页面中的内容来修改 Confluence 中的日志配置文件。 https://www.cwiki.us/display/CONF6ZH/Working+with+Confluence+Logs

在 log4j 中，一个输出被定义为 'appender'。希望修改 log 文件的目标，你需要停止 Confluence 然后修改设置 log4j.properties 日志配置文件的  ' Logging Location and Appender ' 设置。有关这个文件的路径，请参考 上面 的说明。 在一个标准的配置文件中，你可以找到下面 2 个 appenders。 com.atlassian.confluence.logging.ConfluenceHomeLogAppender  – 这个是默认的日志输出器（appender ）在 上面 描述得文件中。这个日志输出器有允许下面的设置： MaxFileSize MaxBackupIndex org.apache.log4j.RollingFileAppender  – 如果你希望记录日志到不同的位置，取消 RollingFileAppender 行前面的备注，同时修改下面的日志文件路径。注释掉 ConfluenceHomeLogAppender 行的内容。 Synchrony 日志路径也可以通过同样的方式进行修改。 Confluence 绑定了 log4j 提供的所有功能。有关 log4j 日志输出容器的的定义，请参考  log4j documentation 页面中的内容。 https://www.cwiki.us/display/CONF6ZH/Working+with+Confluence+Logs

找到 Confluence 的日志文件 这部分内容对 Confluence 的默认日志表现进行描述并且假设你没有对 Confluence 的默认日志配置进行修改。为了统一在不同平台中的日志输出，Confluence 使用 atlassian-confluence.log 为主要日志，而不使用应用服务器日志。 当你启动 Confluence 的时候，日志实体将会发送日志直到 Confluence 完全初始化完成。任何在服务器控制台中输出的日志也会同时输出到上面描述的文件中。 当启动完成后，所有的日志将会输出到 <confluence-home>/logs/atlassian-confluence.log 。例如： c:/confluence/data/logs/atlassian-confluence.log 。 请注入，默认的位置位于 Confluence 的 home 目录中（home directory） 而不是在应用服务器的日志目录中的。home 目录的路径可以在 <confluence-installation>/confluence/WEB-INF/classes/confluence-init.properties 中指定。 找到 Confluence 的日志配置文件 有关 Confluence 和 Synchrony  的日志表现定义在下面的属性文件： <CONFLUENCE-INSTALL>/confluence/WEB-INF/classes/log4j.properties 这个文件是标准的 Logj 配置文件，请参考 Apache log4j documentation 页面中的描述。 https://www.cwiki.us/display/CONF6ZH/Working+with+Confluence+Logs

Confluence 使用的是 Apache's log4j 日志服务。能够允许管理员通过编辑配置文件来控制日志的表现和日志输出文件。在系统中有 6 个日志输出级别，请参考 log4j logging levels 页面来获得更多信息。 如果你请求 Atlassian Support 为你提供支持服务，我们总是会要求你能够提供你 Confluence 应用的日志输出。要获得这些日志输出的最简单的方法是进入  >  基本配置（ General Configuration）  > 问题检查和支持工具（Troubleshooting and support tools） 然后根据弹出的提示，创建一个  Support Zip 。 https://www.cwiki.us/display/CONF6ZH/Working+with+Confluence+Logs

Confluence 支持一些可以从 Java 系统属性中配置的配置参数和调试（debugging ）设置。系统属性通常是使用 -D 为参数选项，这个选项是 Confluence 在运行后设置到 JVM 虚拟机中的。请参考： Configuring System Properties 页面中的内容来获得更多的信息。 开始版本 默认值 模块... 作用和影响 atlassian.forceSchemaUpdate 1.0 false atlassian-config 在默认的情况下，Confluence 只会在侦测到数据库更新后才会运行数据库 schema 更新。这个标志位将会强制 Confluence 在启动的时候对 schema  进行更新。 confluence.home 1.0 任何文件系统路径 Confluence and atlassian-config 如果这个属性被设置，Confluence 将会忽略 confluence-init.properties 属性文件中配置的信息，使用你在启动的时候指定的路径为 Confluence  Home 目录。 confluence.dev.mode 1.0 false Confluence 针对 Confluence 开发人员，启用更多的 debugging 选项（这个也可能会修改 spring bean 的默认 lazy 初始化方式，将会增加启动时间）。请不要在生产环境中启用这个选项。 confluence.disable.mailpolling 2.4 false Confluence 如果设置为 "true"，将会阻止 Confluence 从已经归档的空间中获得邮件。通过 WEB 界面的 "check for new mail" 进行手动操作依然可用。这个配置将不会影响发送邮件。 confluence.i18n.reloadbundles 1.0 true Confluence 设置这个属性将会导致 Confluence 在每次国际化（internationalized ）字符查找的时候载入 i18n 资源。这个在对翻译进行测试的时候会非常有用，但是会导致 Confluence 实例 运行缓慢 （...

校验你的设置 查看你 Confluence 当前使用的设置，请参考 Viewing System Properties 页面中的内容。 识别系统属性 请参考 Recognized System Properties 页面中的内容来找到针对你安装 Confluence 版本可以配置的系统属性参数。 https://www.cwiki.us/display/CONF6ZH/Configuring+System+Properties

当你使用 Start Confluence Automatically on Windows as a Service 的方式启动的时候，你有下面 2 种方式来配置你的系统属性：通过 command line 或者 in the Windows Registry 通过命令行方式来为 Windows 服务设置属性 如何通过命令行方式为 Windows 服务器设置属性： 找到 Confluence 在 Windows 中安装的服务名（进入 控制面板（ Control Panel ）> 管理工具（ Administrative Tools ）> 服务（ Services ））： 在上面的示例中，服务名称被命名为 Confluence121213135538 。 打开 Windows 的命令行窗口（选择 开始（Start ） >  cmd.exe ） cd 进入你安装 Confluence 实例的  bin 目录，然后运行下面的命令： tomcat8w //ES//<SERVICENAME> 按照上面的示例，这个命令应该修改为  tomcat8w //ES//Confluence121213135538 针对你使用 Confluence 的版本不同，Tomcat 的版本号也有可能不同。 单击 Java 标签页来查看当前启动的选项列表： 应用新的选线，或者修改选项，通过添加选项配置到已经存在的 Java Options 列表后面。请参考 Recognized System Properties 页面中的内容对属性参数进行配置。 通过 Windows registry 为 Windows services 设置属性 在一些 Window 的版本中，可能没有办法为启动服务添加 Java 变量的。如果你的 Windows 是这种情况的话，你必须添通过查看注册表中的选项列表来添加属性。 进入注册表编辑器（ 开始（Start） >  regedit.exe ）。 找到 Services 实体 HKEY_LOCAL_MACHINE >> SOFTWARE >> Apache Software Foundation ...

在这个页面中描述 Confluence 启动时如何设置 Java 属性和其他选项。 请查看 How to fix out of memory errors by increasing available memory 页面中内容来获得如何处理 OutOfMemory 错误。 Linux 在 Linux 安装环境下配置系统属性： 编辑 <installation-directory>/bin/setenv.sh 文件。 找到 CATALINA_OPTS= （针对 Confluence 5.5 及其早期版本，这个参数是 JAVA_OPTS=） 请参考 Configuring System Properties 页面中的内容对属性参数进行配置。 添加所有的参数为空格分离列表，在引号内。 Windows （从 .bat 文件启动） 在 Windows 中当使用 .bat 文件启动的时候配置系统启动参数： 编辑 <installation-directory>/bin/setenv.bat 文件。 找到 set CATALINA_OPTS=%CATALINA_OPTS% 部分 （在 Confluence 5.5 及其早期版本中，这个参数为 JAVA_OPTS=%JAVA_OPTS%） 请参考 Recognized System Properties 页面中的内容对属性参数进行配置。 所有添加的参数都使用的是空格分离列表。请确定不要修改  %CATALINA_OPTS% 字符。 https://www.cwiki.us/display/CONF6ZH/Configuring+System+Properties

Atlassian 支持或者 Atlassian 缺陷修复小组可能针对有一些关键问题会提供补丁来解决这些问题，但是这些问题还没有放到下一个更新版本中。这些问题将会使用 Class 类文件同时在官方 Jira bug-tracking system 系统中进行问题说明和描述。 针对 Confluence 分发安装指南 请按照下面的步骤安装补丁类文件： 关闭你的 Confluence 实例。 拷贝提供的类文件到 <installation-directory>/confluence/WEB-INF/classes/<subdirectories> ， <installation-directory> 必须替代为你的 Confluence 安装目录（如果你需要更多的信息，请参考 Confluence Installation Directory 中的内容）。 <subdirectories> 指定为特定的 JIRA 相关的问题。这个变量的值针对不同的问题显示不同的内容。 subdirectories 不会存在在你拷贝类文件之前。一些问题将会从 ZIP 文件中包含有补丁，这些包含在特定的目录结构。 重启你的 Confluence 实例，让你的修改生效。 Web 应用程序 /WEB-INF/classes 目录中的类文件将会比  /WEB-INF/lib 目录中的类文件先行载入。所以，在第一个文件夹中的类文件将会在系统运行后调用载入，JRA 中相同名字的类将会被先前载入的类覆盖。 取消补丁 希望取消补丁，你可以简单的将 <installation-directory>/confluence/WEB-INF/classes/ 文件夹中的类文件删除就可以了（在删除的时候请小心，只删除你需要恢复的版本），然后重启实例。 一旦与问题相关的补丁发布，问题解决了。你需要升级 Confluence 实例来修复这个问题并且将这个补丁恢复。补丁通常并不是非常好的解决方案也可能会不稳定。官方的修复和版本升级通常是最好的解决方案。 https://www.cwiki.us/display/CONF6ZH/Installing+Patched+Class+Files

手动安装语言包 希望以手动的方式按照语言包，你需要按照下面描述的方式上传语言包。一旦你安装成功后，语言包插件将会默认启用。 插件通常以 JAR 或者 OBR（ OSGi Bundle Repository ）的方式进行分发。希望安装一个插件： 选择 配置图标（cog icon） ， 然后在 Confluence 管理员中选择 基本配置（General Configuration）。 选择 管理插件（Manage Add-ons） 。 选择 上传插件（Upload Plugin） 。 选择 浏览（Browse ） 来从你的本地磁盘中找到你希望安装的插件文件并对这个文件进行选择，或者输入一个网络地址的 URL。 选择 上传（Upload） 。 这个插件将会上传到 Confluence 中，然后将会自动进行安装。 检查 用户安装的插件（user-installed plugins）列表，确定这个插件已经可用了。 如果必要的话，启用这个插件（一些插件会在安装完成后自动启用，其他的一些插件需要在安装完成后从管理插件页面手动进行启动）。 找到更多的语言包 你可以从 Atlassian Marketplace 中下载官方的语言包。你也可以从 Confluence 用户的开发社区中下载其他开发的语言包，Confluence 开发社区的地址为 https://translations.atlassian.com 。 https://www.cwiki.us/display/CONF6ZH/Installing+a+Language+Pack