欢迎来到 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 小时的修改。这个推荐你只能修改任务发送邮件的时间为每 24 个小时中的某一个时间、 每集群（Per cluster） 每天的 12 AM 刷新边际索引队列（Flush Edge Index Queue） 刷新边际索引队列，能够保证 Confluence 的索引是最新的索引。 每节点（Per node） 每 30 秒 刷新本地任务队列（Flush Local Task Queue） 刷新本地任务队列。（Confluence 的内部任务通常具有很高的刷新频率）。 每节点（Per node） 每分钟 刷新邮件队列（Flush Mail Queue） 发送 mail queue 队列中已经队列的邮件通知。这并不包括批量的通知。编辑 发送批量的通知（Send batched notifications）任务，如果你同时希望修改通知的发送频率包括页面或者博客的更新。 每集群（Per cluster） 每分钟 发送批量通知（Send batched notifications） 从有关上次任务运行后，发送有关页面或者博客更新的邮件通知。如果邮件并不是很多的话，可以增加这个发送的频率，如果你有很多邮件通知的话，你可以减少发送邮件的频率。这个设置对 Confluence 的性能提升会有很大的影响。 每集群（Per cluster） 每 10 分钟 刷新任务队列（Flush Task Queue） 刷新任务队列（Confluence 的内部任务通常具有很高的刷新频率）。 每节点（Per node） 每分钟 发送推荐更新邮件（Send Recommended Updates Email） 触发发送推荐更新邮件给用户。这个任务是每个小时运行一次的，但是用户可以收到每周更新或者每日更新，这个是根据用户自己属性的设置不同而不同的。这个时间与时区是对应的。 每集群（Per cluster） 每小时 清理老的计划任务运行信息（Purge Old Job Run Details） Confluence 存储每一个计划任务的运行情况在数据库表 scheduler_run_details 中。为了保持数据库中保存有足够的信息，但是又不至于扩大数据库的存储，清理老的计划任务细节（Purge Old Job Run Details）任务将会日常运行删除细节： 超过 90 的天成功任务。 超过 7 天的未成功的任务。 有可以重置 system properties 中的一些设置；jobs.limit.per.purge, all.jobs.ttl.hours and unsuccessful.jobs.ttl.hours。 每集群（Per cluster） 每天的 11 PM https://www.cwiki.us/display/CONF6ZH/Scheduled+Jobs

希望查看一个计划任务最后运行的时间和这个计划任务最后一次运行花费了多长时间。单击计划任务边上的 历史（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.7 开始，你可以在你的 Confluence 管理员控制台中调整日志的级别——请阅读 Working with Confluence Logs 页面中的相关内容。下面我们将会告诉你如何直接编辑 log4j 文件。 打开 confluence/WEB-INF/classes/log4j.properties 然后取消注释下面的行。 ## 行是注释，请保持这行的完整。 ## log hibernate prepared statements/SQL queries (equivalent to setting 'hibernate.show_sql' to 'true') #log4j.logger.net.sf.hibernate.SQL=DEBUG ## log hibernate prepared statement parameter values #log4j.logger.net.sf.hibernate.type=DEBUG 如果你不能在你的 log4j.properties 文件中找到上面的内容的话，请在文件的最后添加上这些内容。 重启 Confluence。 重新操作你出现错误的的步骤。 压缩你的日志目录然后添加到你的支持请求工单中。 如果你使用的是 Oracle 数据库同时你收到了一个 constraint error，请询问你的数据库管理员是哪个一个数据库表和列有约束（例如：CONFLUENCE.SYS_C0012345），获得相关信息后将这些内容添加到你的工单中。 打开 confluence/WEB-INF/classes/log4j.properties 文件，删除在第一步中添加的上面 4 行（让 Confluence 输出更多的日志信息将会影响 Confluence 的性能，在生产环境中，你应该不输出这些信息）。 相关主题 Enabling Detailed SQL Logging Working with Confluence Logs Troubleshooting failed XML site backups https://www.cwiki.us/display/CONF6ZH/Troubleshooting+SQL+Exceptions

日志级别 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