Confluence 6 協(xié)同編輯問題解決

昵稱16099352 2019-08-16

展開全文

協(xié)同編輯是 Synchrony 提供的，用于在編輯的時候?qū)崟r同步。在一般的情況下，這個進程是不需要 Confluence 的管理員進行手動管理的。

這個頁面將會幫助你 Confluence 安裝實例中 Synchrony 出現(xiàn)的問題進行問題解決。

第一步

檢查 Synchrony 是否在運行

為了檢查 Synchrony 是否在運行，進入 > 基本配置（General Configuration） > 協(xié)同編輯（Collaborative editing）。

請注意：如果你正在運行的 Confluence 數(shù)據(jù)中心模式，那么這個頁面將僅能告訴你如果當前連接到 Confluence 節(jié)點的的 Synchrony 的運行狀態(tài)。你可能需要第三方的監(jiān)控工具來幫助你監(jiān)控你的 Synchrony 集群。

檢查你可以編輯的頁面

如果在你對頁面進行編輯的時候看到了錯誤，但是 Synchrony 又是運行的，那么應該是你瀏覽器有某些東西阻止你連接到 Synchrony 。

最常見的問題是反向代理的錯誤配置。請查看頁面尾部的有關(guān)代理配置的問題解決或者進入 Administering Collaborative Editing 頁面找到有關(guān)可能的代理和 SSL 配置。

檢查日志

你可以在 <home-directory>/logs/atlassian-confluence.log 中找到有關(guān) Confluence 應用的日志。Synchrony 有關(guān)的日志你可以在 <home-directory>/logs/atlassian-synchrony.log 中找到。

重啟 Synchrony

進入 > 基本配置（General Configuration）> 協(xié)同編輯（Collaborative editing）然后選擇 重啟 Synchrony（Restart Synchrony）。

檢查 8091 端口是否可用

在默認的情況下 Synchrony 運行在 8091 端口。如果這個端口已經(jīng)被其他的應用占用的話，你可以使用 synchrony.port 系統(tǒng)屬性來將端口修改到其他未被占用的端口。

（如果你使用的是 Confluence 6.0.3 或者早期的版本，你需要使用 reza.port 來替代 synchrony.port。）

請查看 Configuring System Properties 頁面來找到如何對這些內(nèi)容進行修改。

針對 Confluence 數(shù)據(jù)中心模式，運行 Synchrony 的方式有所不同。請 Configuring Synchrony for Data Center 頁面中獲得有關(guān)配置的信息。

反向代理（Reverse proxy）問題

如果你已經(jīng)配置了方向代理，但是不能編輯頁面，你可以對下面的一些配置進行檢查：

進入 installation-directory>/econf/server.xml 然后檢查連接器的目錄。確定你已經(jīng)正確的配置了值 <protocol> 和 <proxyName>。請參考下面的示例來獲得更多的信息。
HTTP 連接需要在 <installation-directory>/conf/server.xml 文件中進行配置，盡管你已經(jīng)配置了 SSL 或者使用了 AJP 連接器。Synchrony 健康檢查程序?qū)褂?HTTP 端口進行檢查?？蛇x的，如果你不希望包含 http 連接器，你可以使用 synchrony.proxy.healthcheck.disabled 系統(tǒng)屬性來禁用健康檢查。
如果你正在使用 Apache，請確定你正在使用的是 Apache 2.4 （需要 WebSockets 的支持）同時所有需要的模塊都已經(jīng)被啟用了（mod-proxy, mod_rewrite, proxy_wstunnel）。
如果你正在使用的是 Apache 同時希望直接連接 Synchrony，在你的屬性配置文件中，請確定你已經(jīng)包含了 /synchrony 同時 Confluence 和 Synchrony 的順序和路徑是正確的。請參考下面的指南示例來獲得更多信息。

請參考 Administering Collaborative Editing 來找到更多有關(guān)可能的反向代理和 SSL 配置，然后請參考下面的鏈接來找到更多有關(guān) Synchrony 在反向代理中的配置。如果你想直接連接 Synchrony 的話：

正向代理（Forward proxy）問題

如果你正在使用的是正向代理或者外部代理，你需要添加 IP 到 Synchrony 到你的監(jiān)聽器中來確定你的配置能夠穿透代理。 See Troubleshooting Collaborative Editing for more info.

在默認的情況下，IP 地址為 127.0.0.1 或者是 synchrony.host 中的系統(tǒng)屬性配置，如果你在 Confluence 中自定義了 hostname 或者 IP 地址來 Synchrony 的話。

Websocket 問題

協(xié)同編輯最好是在 WebSocket 連接下進行配置。如果其中一個方面因為超時而不能建立連接，或者代理服務(wù)器的防火墻不允許 WebSocket 連接。那么編輯器將會嘗試通過一個 XML HTTP 請求（XHR）進行連接。

你可以使用 http:///echo.html 來進行快速的 HTML5 WebSocket 測試服務(wù)器的響應。

SSL 問題

Synchrony 不能接受直接的 HTTPS 連接，所以你需要下你的方向代理或者負載均衡配置 SSL。如果你使用的是 Tomcat，但是你沒有使用方向代理，那么你需要在你的 Tomcat 上配置 SSL。

內(nèi)存問題

如果你遇到了 Synchrony 有關(guān)內(nèi)存溢出，你可以修改 Synchrony 使用的 heap 大小，這個配置定義在 synchrony.memory.max 系統(tǒng)屬性中。

如果你使用的是 Confluence 6.3 或者早期的版本，你將需要使用 reza.memory.max 來替換 synchrony.memory.max。

請參考 Configuring System Properties 頁面中的內(nèi)容來找到如何對這個進行修改。

針對 Confluence 數(shù)據(jù)中心使用的 Synchrony 的方法與服務(wù)器環(huán)境下使用的方法有所不同。請參考 Configuring Synchrony for Data Center 頁面中的內(nèi)容來獲得有關(guān)的更多信息。

多 Synchrony 進程

如果你在編輯的時候立馬就在編輯上顯示了錯誤，但是 Confluence 報告的是 Synchrony 是運行的，你需要檢查只有一個 Synchrony 實例正在運行。

如果你有多個 Synchrony 進程正在運行，停止 Confluence，殺死掉多余的 Synchrony 進程后重啟 Confluence。

你可以通過每次都使用 stop-confluence.sh / stop-confluence.bat 來停止 Confluence，避免使用關(guān)閉 Tomcat 窗口的方式來停止 Confluence。

不兼容的瀏覽器擴展

有時候，第三方的一些瀏覽器插件將會對編輯器造成影響，例如 Grammarly，有時候也會導致協(xié)同編輯的功能不能正確的使用。請參考 Confluence Collaborative Editing blocks Grammarly Extension 頁面中的內(nèi)容來找到如何在你的站點中禁用 Grammarly 。

防火墻或者防病毒干擾

我們也遇到了一些有關(guān)防火墻或者防病毒軟件阻止服務(wù)器的一些訪問，這個將會導致編輯器出現(xiàn)一些莫名其妙的錯誤。你需要將 Confluence 添加到你的白名單或者信任的 URL 中，如果你遇到了防火墻相關(guān)的一些問題的話。請參考 Weird Page or Editor Behaviors with Kaspersky Internet Security 頁面中的內(nèi)容來獲得有關(guān)的一些信息。