Confluence 6 管理协同编辑

协同编辑可以让项目小组中的协同合做达到下一个高度。这个页面对相关协同编辑中的问题进行了讨论，可以提供给你全部但愿了解的内容。

进入 Collaborative editing 页面来得到项目小组是如何进行实时的协同工做的，这些协同工做包括在软件需求，会议记录，历史查看和任何你任务须要进行协同工做的地方。

关于 Synchrony

协同编辑是经过 Synchrony 进行的，这个可以实时的同步数据。Synchrony 是一个可执行的进程，这个进程是在 Confluence 以外运行的，可是又是由 Confluence 自动进行管理的。在通常的状况下，这个进程是不须要 Confluence 的管理员进行手动管理的。

但愿检查 Synchrony 是否在运行，进入  > 基本配置（General Configuration） > 协同编辑（Collaborative editing）。

这里，你能够检查 Synchrony 的运行状态和当前的配置状况，包括当前的端口，数据库驱动和 Synchrony  使用的最大的 heap 大小。这些信息在你对 Synchrony 进行问题排除的时候很是有用。

Synchrony 在默认的状况下是运行在 8091 端口的，在一个内部的 Synchrony  代理意思是你不须要打开其余的端口。

修改编辑模式

编辑模式肯定了你站点全部用户使用协同编辑的体验，这个是你对协同编辑进行启用和关闭的地方。

但愿修改编辑模式：

1. 进入  > 基本配置（General Configuration） > 协同编辑（Collaborative editing）。
2. 选择 编辑模式（Change mode）。
3. 选择一个模式，而后选择 修改（Change）。

修改编辑模式实际上是不重要的，一些修改可能会致使你的用户丢失他们的草稿，所以针对某个模式，你最好须要知道修改将会致使那些问题。

有下面的模式可用：

协同编辑可以让项目小组中的协同合做达到下一个高度。这个页面对相关协同编辑中的问题进行了讨论，可以提供给你全部但愿了解的内容。 进入 Collaborative editing 页面来得到项目小组是如何进行实时的协同工做的，这些协同工做包括在软件需求，会议记录，历史查看和任何你任务须要进行协同工做的地方。 关于 Synchrony 协同编辑是经过 Synchrony 进行的，这个可以实时的同步数据。Synchrony 是一个可执行的进程，这个进程是在 Confluence 以外运行的，可是又是由 Confluence 自动进行管理的。在通常的状况下，这个进程是不须要 Confluence 的管理员进行手动管理的。 但愿检查 Synchrony 是否在运行，进入  > 基本配置（General Configuration） > 协同编辑（Collaborative editing）。 这里，你能够检查 Synchrony 的运行状态和当前的配置状况，包括当前的端口，数据库驱动和 Synchrony  使用的最大的 heap 大小。这些信息在你对 Synchrony 进行问题排除的时候很是有用。 Synchrony 在默认的状况下是运行在 8091 端口的，在一个内部的 Synchrony  代理意思是你不须要打开其余的端口。 修改编辑模式 编辑模式肯定了你站点全部用户使用协同编辑的体验，这个是你对协同编辑进行启用和关闭的地方。 但愿修改编辑模式： 进入  > 基本配置（General Configuration） > 协同编辑（Collaborative editing）。 选择 编辑模式（Change mode）。 选择一个模式，而后选择 修改（Change）。 修改编辑模式实际上是不重要的，一些修改可能会致使你的用户丢失他们的草稿，所以针对某个模式，你最好须要知道修改将会致使那些问题。 有下面的模式可用： 启用（On） 这个模式容许你的小组可用同时进行编辑和分享操做，同时实时的可以看到其余用户的修改。 这是推荐的编辑模式。 限制（Limited） 若是你须要对 Synchrony 进行问题排除的话，这个模式将会包含你用户分享草稿。建议仅仅在当你以为你的系统在编辑和发布的时候遇到问题了，选择这个模式。 你用户的编辑体验将会受限： 只有一个用户能够编辑一个共享的草稿，并且仅仅只有这个用户能够编辑。 你不能够在页面的历史中恢复到早期的版本。 你不能够移动页面。 你不能够在页面中进行行标注。 当 Synchrony 再次运行后，咱们推荐你将协同编辑设置回启用模式。 关闭（Off） 这个模式意味着你的小组仅仅能够编辑本身的页面草稿。Confluence 将会尝试在保存的时候合并有冲突的编辑。这个模式与 Confluence 5 编辑使用的模式相同。 这个模式在你不能在你的系统中成功运行 Synchrony 的时候有用，或者你决定协同编辑模式并不适用你的环境（例如，你如今正在审计需求，你不但愿页面被编辑，在这个状况下，协同编辑对你并不合适）。 在你将协同编辑模式修改成关闭的时候，你应该确保你的用户保存的全部草稿都已经被发布了。 最大编辑者的限制 咱们限制为最多 12 个用户能够同时对一个页面进行编辑。这个意味着当一个页面已经有 12 个用户正在编辑了，13 个用户是不能进入编辑界面的，直到 12 个用户中有一个用户已经离开了。 系统管理员可使用 Configuring System Properties 页面中描述的配置来增长或者减小这个限制。当你以为在多个用户进行协同编辑的时候遇到了性能问题，你应该考虑下降容许协同编辑的用户数量。 审计的考虑 咱们知道一些客户对审计是主要考虑的方面。咱们不能保证在协同编辑的时候具备审计，审查功能。全部页面的修改当前附加到用户发布页面的属性中而不是用户的特定修改。 若是这个对你来讲是一个问题的话，咱们建议你在你的站点中关闭协同编辑。 在未发布的草稿中没有版本历史 咱们如今保存了在系统编辑中的全部时间的编辑，可是咱们不会保存没有发布修改的的版本。当你恢复到早期页面的版本的时候，你仅仅能够恢复到一个已经存在的发布版本中。当你恢复到前一个版本的时候，全部未发布的的修改都会丢失。 匿名用修改的内容是否可见 当你为匿名用户赋予 添加（Add ）页面权限的时候有其余的一些事情你须要注意（和全局权限的 可使用（Can use））。 当一个为发布页面是由匿名用户建立的时候，关闭一个编辑或者发布一个页面的时候你不会收到警告。这个可能会致使登陆的用户的编辑会被中断和打扰。 他们本身的修改是能够在页面中可见，可是一般警告对话框将不会出现，若是是没有登陆用户作的修改的话。 针对登陆的用户和匿名用户都有未发布的修改，这个对话框将会显示，可是仅仅是登陆的用户才能看到对话框。全部用户的修改（包括匿名用户）将会被包括进来，当你从对话框中查看修改的内容进行查看的话。 修改你的 Synchrony 配置 你不能经过 Confluence UI 修改 Synchrony 的配置。配置的修改是经过系统属性进行修改的。在绝大部分状况下，你不须要对默认的配置进行修改。 修改 Synchrony 运行的端口... 在默认状况下 Synchrony 运行在 8091 端口。若是这个端口在你的系统中已经被其余应用占用了，你可以使用 synchrony.port 系统属性来将端口修改到其余可用的端口上。 若是你使用的是 Confluence 6.0.3 及其早期的版本，你须要使用 reza.port 来替代 synchrony.port。 请可参考 Configuring System Properties 页面中的内容来得到如何进行修改的帮助。 针对 Confluence 数据库中，运行 Synchrony 的方式有些不一样。请参考 Configuring Synchrony for Data Center 页面中的内容来得到更多信息。 修改 Synchrony 的最大 heap 值 在默认状况下 Synchrony 的最大 heap 大小被设置为 1 GB。 若是你遇到了与 Synchrony 有关的内存溢出的错误，你能够经过修改 synchrony.memory.max 属性来肯定 Synchrony 使用的内存大小。 若是你使用的是 Confluence 6.0.3 及其早期的版本，你须要使用 reza.memory.max 来替代 synchrony.memory.max。 请可参考 Configuring System Properties 页面中的内容来得到如何进行修改的帮助。 针对 Confluence 数据库中，运行 Synchrony 的方式有些不一样。请参考 Configuring Synchrony for Data Center 页面中的内容来得到更多信息。 请参考 Recognized System Properties 页面中的内容来得到全部有关 Synchrony 的系统属性。 若是你须要针对 Synchrony 虚拟机传递其余的参数，建立一个名为 synchrony-args.properties 的属性文件。这个文件位于 Confluence 的 home 目录中，而后在这个文件中输入你但愿传递进去的参数，每行一个参数。 property1=value1 property2=value2 这个将会添加 -Dproperty1=value1 -Dproperty2=value2  到 Synchrony 命令行中。这个功能只能在 Confluence 6.0.2 及其后续版本中有效。 你不能使用这个方法传递在系统数据中已经有的值，例如端口， Xmx 或 Xss 等。请参考 Configuring System Properties 页面中的内容来得到全部的属性列表。 代理和 SSL 的考虑 对于你如何链接  Synchrony 是与你的环境有关的。咱们知道绝大部分的 Confluence 站点是运行在反向代理后面的，同时还使用了 SSL。这里是帮助你在你环境中识别正确的配置的一些信息和一些针对你环境须要作的一些协同合做方面的修改。 SSL Synchrony 运行在一个独立的 JVM，这个并不须要支持直接的 HTTPS 链接。若是你没有使用反向代理，SSL 应该在 Tomcat 中定义，若是你使用了方向代理或者负载均衡。那么 SSL 应该在你的反向代理和负载均衡中进行配置和定义。 Proxies 在下面的图表中，咱们使用 Confluence 运行的环境下一般的代理和反向代理配置，同时 Confluence 也运行在 /confluence 上下文路径，（例如， www.mysite.com/confluence）。若是你的 Confluence 没有使用上下文，那么这个概念和配置也是同样的（例如，www.myconfluence.com）。 下面的配置只是特定于 Confluence 服务器，若是你使用的是数据中心，请参考 Configuring Synchrony for Data Center 页面中的内容来得到更多信息。 没有反向代理 若是你没有在 Confluence 中使用反向代理，那么你的会经过 Confluence 的内部 Synchrony 代理链接到 Synchrony。若是使用了 SSL 的话，那么这个是经过 Tomcat 决定的。这个是默认的配置，针对这个状况你在启用协同编辑的时候不须要进行任何进一步的修改。 使用一个反向代理 若是你的 Confluence 是运行在一个反向代理后面的话，你须要经过 Confluence 内部 Synchrony 代理来链接 Synchrony 。这个是反向代理的默认设置，若是你不但愿开发 8091 端口的话，这个也是一个很好的选择。SSL 应该经过你的额反向代理服务器来配置和肯定。 针对 Synchrony 配置你不须要作任何进一步的反向代理配置，可是在最好的状况下，你的反向代理应该支持 WebSocket 链接（你须要在你的代理中手动启动这个）。 为了告诉 Confluence 你但愿使用内部代理，设置 synchrony.proxy.enabled system property 中的配置设置为 true。（这个是可选的，可是这个能够避免 Confluence 在经过内部代理以前来经过 /synchrony 来找到 synchrony）。 若是 Synchrony 不能访经过 /synchrony-proxy 进行访问，咱们将会自动的尝试  /confluence/synchrony-proxy （/confluence 是你 Confluence 的上下文）。 Synchrony  使用一个反向代理目录 若是你的 Confluence  是运行在一个反向代理的后面，可是你在经过 Confluence 的内部 Synchrony 代理进行链接的时候遇到了问题或者没法链接的状况，你能够选择链接目录到 Synchrony。这个是最佳的设置，可是不须要你环境作一些改变。你须要打开 8091 端口，同时添加 /synchrony  到你的反向代理配置中。SSL 仍是经过你反向代理服务器决定和定义的，Synchrony 还不能接受 HTTPS 的链接。 若是 Synchrony 不能访经过 /synchrony-proxy 进行访问，咱们将会自动的长沙  /confluence/synchrony-proxy （/confluence 是你 Confluence 的上下文）。 下面的一些指南是有关反向代理的配置相关的一些文章。目录的顺序是很重要的，请查看咱们的一些示例。 Using Apache with mod_proxy Running Confluence behind NGINX with SSL Proxying Atlassian server applications with Apache HTTP Server (mod_proxy_http) Proxying Atlassian server applications with Microsoft Internet Information Services (IIS) How to configure Amazon Web Service Elastic Load Balancer with Confluence 6.0 XHR fallback 当一个经过经过 WebSocket 链接到 Confluence 的时候，咱们将会返回一个 XML HTTP Request （XHR），这个可以容许用户成功的对页面进行编辑。为了让用户得到最佳的编辑体验，咱们强烈建议你在你的环境中配置容许 WebSocket 链接。 XHR fallback 在默认的状况下是启用的，可是必要的话，能够经过 system property 进行禁用。你应该不须要对这些进行修改。 https://www.cwiki.us/display/CONF6ZH/Administering+Collaborative+Editing	这个模式容许你的小组可用同时进行编辑和分享操做，同时实时的可以看到其余用户的修改。 这是推荐的编辑模式。
限制（Limited）	若是你须要对 Synchrony 进行问题排除的话，这个模式将会包含你用户分享草稿。建议仅仅在当你以为你的系统在编辑和发布的时候遇到问题了，选择这个模式。 你用户的编辑体验将会受限： 只有一个用户能够编辑一个共享的草稿，并且仅仅只有这个用户能够编辑。 你不能够在页面的历史中恢复到早期的版本。 你不能够移动页面。 你不能够在页面中进行行标注。 当 Synchrony 再次运行后，咱们推荐你将协同编辑设置回启用模式。
关闭（Off）	这个模式意味着你的小组仅仅能够编辑本身的页面草稿。Confluence 将会尝试在保存的时候合并有冲突的编辑。这个模式与 Confluence 5 编辑使用的模式相同。 这个模式在你不能在你的系统中成功运行 Synchrony 的时候有用，或者你决定协同编辑模式并不适用你的环境（例如，你如今正在审计需求，你不但愿页面被编辑，在这个状况下，协同编辑对你并不合适）。 在你将协同编辑模式修改成关闭的时候，你应该确保你的用户保存的全部草稿都已经被发布了。

最大编辑者的限制

咱们限制为最多 12 个用户能够同时对一个页面进行编辑。这个意味着当一个页面已经有 12 个用户正在编辑了，13 个用户是不能进入编辑界面的，直到 12 个用户中有一个用户已经离开了。

系统管理员可使用 Configuring System Properties 页面中描述的配置来增长或者减小这个限制。当你以为在多个用户进行协同编辑的时候遇到了性能问题，你应该考虑下降容许协同编辑的用户数量。

审计的考虑

咱们知道一些客户对审计是主要考虑的方面。咱们不能保证在协同编辑的时候具备审计，审查功能。全部页面的修改当前附加到用户发布页面的属性中而不是用户的特定修改。

若是这个对你来讲是一个问题的话，咱们建议你在你的站点中关闭协同编辑。

在未发布的草稿中没有版本历史

咱们如今保存了在系统编辑中的全部时间的编辑，可是咱们不会保存没有发布修改的的版本。当你恢复到早期页面的版本的时候，你仅仅能够恢复到一个已经存在的发布版本中。当你恢复到前一个版本的时候，全部未发布的的修改都会丢失。

匿名用修改的内容是否可见

当你为匿名用户赋予 添加（Add ）页面权限的时候有其余的一些事情你须要注意（和全局权限的 可使用（Can use））。

当一个为发布页面是由匿名用户建立的时候，关闭一个编辑或者发布一个页面的时候你不会收到警告。这个可能会致使登陆的用户的编辑会被中断和打扰。

他们本身的修改是能够在页面中可见，可是一般警告对话框将不会出现，若是是没有登陆用户作的修改的话。

针对登陆的用户和匿名用户都有未发布的修改，这个对话框将会显示，可是仅仅是登陆的用户才能看到对话框。全部用户的修改（包括匿名用户）将会被包括进来，当你从对话框中查看修改的内容进行查看的话。

修改你的 Synchrony 配置

你不能经过 Confluence UI 修改 Synchrony 的配置。配置的修改是经过系统属性进行修改的。在绝大部分状况下，你不须要对默认的配置进行修改。

修改 Synchrony 运行的端口...

在默认状况下 Synchrony 运行在 8091 端口。若是这个端口在你的系统中已经被其余应用占用了，你可以使用 synchrony.port 系统属性来将端口修改到其余可用的端口上。

若是你使用的是 Confluence 6.0.3 及其早期的版本，你须要使用 reza.port 来替代 synchrony.port。

请可参考 Configuring System Properties 页面中的内容来得到如何进行修改的帮助。

针对 Confluence 数据库中，运行 Synchrony 的方式有些不一样。请参考 Configuring Synchrony for Data Center 页面中的内容来得到更多信息。

修改 Synchrony 的最大 heap 值

在默认状况下 Synchrony 的最大 heap 大小被设置为 1 GB。

若是你遇到了与 Synchrony 有关的内存溢出的错误，你能够经过修改 synchrony.memory.max 属性来肯定 Synchrony 使用的内存大小。

若是你使用的是 Confluence 6.0.3 及其早期的版本，你须要使用 reza.memory.max 来替代 synchrony.memory.max。

请可参考 Configuring System Properties 页面中的内容来得到如何进行修改的帮助。

针对 Confluence 数据库中，运行 Synchrony 的方式有些不一样。请参考 Configuring Synchrony for Data Center 页面中的内容来得到更多信息。

请参考 Recognized System Properties 页面中的内容来得到全部有关 Synchrony 的系统属性。

若是你须要针对 Synchrony 虚拟机传递其余的参数，建立一个名为 synchrony-args.properties 的属性文件。这个文件位于 Confluence 的 home 目录中，而后在这个文件中输入你但愿传递进去的参数，每行一个参数。

property1=value1 property2=value2

这个将会添加 -Dproperty1=value1 -Dproperty2=value2  到 Synchrony 命令行中。这个功能只能在 Confluence 6.0.2 及其后续版本中有效。

你不能使用这个方法传递在系统数据中已经有的值，例如端口， Xmx 或 Xss 等。请参考 Configuring System Properties 页面中的内容来得到全部的属性列表。

代理和 SSL 的考虑

对于你如何链接  Synchrony 是与你的环境有关的。咱们知道绝大部分的 Confluence 站点是运行在反向代理后面的，同时还使用了 SSL。这里是帮助你在你环境中识别正确的配置的一些信息和一些针对你环境须要作的一些协同合做方面的修改。

SSL

Synchrony 运行在一个独立的 JVM，这个并不须要支持直接的 HTTPS 链接。若是你没有使用反向代理，SSL 应该在 Tomcat 中定义，若是你使用了方向代理或者负载均衡。那么 SSL 应该在你的反向代理和负载均衡中进行配置和定义。

Proxies

在下面的图表中，咱们使用 Confluence 运行的环境下一般的代理和反向代理配置，同时 Confluence 也运行在 /confluence 上下文路径，（例如， www.mysite.com/confluence）。若是你的 Confluence 没有使用上下文，那么这个概念和配置也是同样的（例如，www.myconfluence.com）。

下面的配置只是特定于 Confluence 服务器，若是你使用的是数据中心，请参考 Configuring Synchrony for Data Center 页面中的内容来得到更多信息。

没有反向代理

若是你没有在 Confluence 中使用反向代理，那么你的会经过 Confluence 的内部 Synchrony 代理链接到 Synchrony。若是使用了 SSL 的话，那么这个是经过 Tomcat 决定的。这个是默认的配置，针对这个状况你在启用协同编辑的时候不须要进行任何进一步的修改。

使用一个反向代理

若是你的 Confluence 是运行在一个反向代理后面的话，你须要经过 Confluence 内部 Synchrony 代理来链接 Synchrony 。这个是反向代理的默认设置，若是你不但愿开发 8091 端口的话，这个也是一个很好的选择。SSL 应该经过你的额反向代理服务器来配置和肯定。

针对 Synchrony 配置你不须要作任何进一步的反向代理配置，可是在最好的状况下，你的反向代理应该支持 WebSocket 链接（你须要在你的代理中手动启动这个）。

为了告诉 Confluence 你但愿使用内部代理，设置 synchrony.proxy.enabled system property 中的配置设置为 true。（这个是可选的，可是这个能够避免 Confluence 在经过内部代理以前来经过 /synchrony 来找到 synchrony）。

若是 Synchrony 不能访经过 /synchrony-proxy 进行访问，咱们将会自动的尝试  /confluence/synchrony-proxy （/confluence 是你 Confluence 的上下文）。

Synchrony  使用一个反向代理目录

若是你的 Confluence  是运行在一个反向代理的后面，可是你在经过 Confluence 的内部 Synchrony 代理进行链接的时候遇到了问题或者没法链接的状况，你能够选择链接目录到 Synchrony。这个是最佳的设置，可是不须要你环境作一些改变。你须要打开 8091 端口，同时添加 /synchrony  到你的反向代理配置中。SSL 仍是经过你反向代理服务器决定和定义的，Synchrony 还不能接受 HTTPS 的链接。

若是 Synchrony 不能访经过 /synchrony-proxy 进行访问，咱们将会自动的长沙  /confluence/synchrony-proxy （/confluence 是你 Confluence 的上下文）。

下面的一些指南是有关反向代理的配置相关的一些文章。目录的顺序是很重要的，请查看咱们的一些示例。

1. • Using Apache with mod_proxy
   • Running Confluence behind NGINX with SSL
   • Proxying Atlassian server applications with Apache HTTP Server (mod_proxy_http)
   • Proxying Atlassian server applications with Microsoft Internet Information Services (IIS)
   • How to configure Amazon Web Service Elastic Load Balancer with Confluence 6.0

XHR fallback

当一个经过经过 WebSocket 链接到 Confluence 的时候，咱们将会返回一个 XML HTTP Request （XHR），这个可以容许用户成功的对页面进行编辑。为了让用户得到最佳的编辑体验，咱们强烈建议你在你的环境中配置容许 WebSocket 链接。

XHR fallback 在默认的状况下是启用的，可是必要的话，能够经过 system property 进行禁用。你应该不须要对这些进行修改。

https://www.cwiki.us/display/CONF6ZH/Administering+Collaborative+Editing