Troubleshooting Collaborative Editing


How does Excellentable collaborative editing work?

  • Confluence Server connects to einstein.excellentable.net and establishes a secure connection.

  • On successful connection, it notifies confluence server to enable collaborative editing by providing a security token.
  • Users can then start editing Excellentable in their browser and their session would be automatically shared with other users when they open Excellentable in the Edit mode. It is being shared via Google firebase service on the user's browser.
  • To follow the steps on how to enable Collaborative editing, please refer to this page: How to enable Collaborative Editing
  • For more regarding Collaborative editing, please refer to this FAQ page: Collaborative editing services - FAQ's 


This page will help you to troubleshoot these issues with Collaborative Editing:

Supported Environments

Please ensure you have installed Excellentable on a supported environment to use Collaborative Editing.

Excellentable collaborative editing is currently supported in the Confluence Server versions.

Environment

Support

Confluence Server(6.1+)Supported as a BETA feature.
Confluence CloudComing Soon

Enabling Collaborative Editing for Excellentable application failed

When you  click on the switch to turn on "Collaborative Editing" feature of Excellentable, the switch toggles back to off and you see the error as shown in the below screenshot, check if the confluence server can connect to the Excellentable collaborative editing service(einstein.excellentable.net).

Capture 2017-09-06 at 16.22.31.png

Screen Shot 2017-09-18 at 11.47.00 AM.png


Resolution

Enabling Excellentable Collaborative Editing may fail from the UI if the confluence server cannot reach https://einstein.excellentable.net. This may be caused by firewall blocking connections from your confluence server to Excellentable collaborative editing service(einstein.excellentable.net). You'll need to open a firewall request for outbound connection to einstein.excellentable.net originating from your confluence server.

You can use below steps to validate that the Confluence server can connect to the Einstein server.

Validation

Connect to the confluence server using SSH and run the below command:

curl -w '%{http_code}' https://einstein.excellentable.net/

If you see a HTTP 403 response as shown below, your server is able to make connection to the service:

{"message":"Missing Authentication Token"}403

You will need to open the firewall port in order to enable an outbound connection from your confluence server to einstein.excellentable.net. Since einstein.excellentable.net is using "https", please open port number 443

Switch is on but It still opens in single user mode

Capture 2019-03-27 at 14.18.40.png

Before proceeding to below steps, please make sure that Collaborative Editing feature of Excellentable is enabled. You may have to contact Confluence administrator to verify this.

How to verify connection to Firebase

Below is the screenshot which shows that  Excellentable is being edited in single user mode. If you see a square user gravatar, it indicates that Excellentable opened in single user mode. A rounded user gravatar indicates that the Excellentable opened in Collaborative Editing mode.

on1.png

If you cannot see other users live in Excellentable in the Edit mode and Collaborative Editing feature of Excellentable is enabled, the browser may not be able to connect to the below servers. Collaborative editing cannot be performed if the browser cannot initiate connection to Google Firebase even if you have verified a connection to einstein.

Please ensure that your machine has access to Internet and below servers are not blocked in your network. 

 Please follow the steps below if your environment does not use a proxy server.

Connect from user system and run the below commands:

curl -L https://example-app-fd690.firebaseapp.com/

curl -L https://excellentable-co.firebaseio.com/

If you see the responses as shown below, respectively, the firewall is open and is able to make connection to the service:

React App
curl -L https://excellentable-co.firebaseio.com/


  
  
  
  
  Sign in - Google Accounts