Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
ardi-collab:administrative_topics [2019/02/20 01:35]
optrix 		ardi-collab:administrative_topics [2019/08/21 02:02] (current)
optrix
Line 12: Line 12:
 ===Install Collaboration Services=== ===Install Collaboration Services===
  
-The collaboration services ​are provided by Python, so you will need to ensure ​that Python 2.7 is installed on the collaboration services machine (this is installed as part of your ARDI server ​installation).+The collaboration services ​installer is designed for systems ​that already include ​the ARDI server. ​
  
-You will also need several Python modules - most notably ​**Twisted**. This is again included with your ARDI server installation.+To install on an ARDI server, you simply ​need to run the **ARDI Collaboration Services** installer.
  
-You will then need to run the **ARDI Collaboration Services** installer.+This will install ​the required files and start a collaboration service on port 450. 
  
-Finally, you will need to register collaboration as a service in Windows. This is done via NSSM, which can be downloaded or is again included with the ARDI server installation. ​+==Non-ARDI Servers== 
 + 
 +For servers that do **not** have ARDI installed, you will need to install an up-to-date copy of Python 2.7, plus the modules **Twisted** and **Autobahn**. 
 + 
 +While it is possible to deploy the collaboration service on a standalone VM, **Python 2.7** and several modules such as **Twisted** and **Autobahn** are required.  
 + 
 +These can either ​be downloaded ​as installers, loaded from //python wheels//, ​or installed via PIP 
 + 
 +<​code>​ 
 +pip install twisted autobahn 
 +</​code>​
  
 ====Install & Configure the Collaboration Addin==== ====Install & Configure the Collaboration Addin====
Line 30: Line 40:
  
 For example, if you have **Plant Alpha** and **Plant Beta** as two separate databases but only want to deploy a single Collaboration server, those users can be given a default group of '​Alpha'​ and '​Beta',​ respectively. For example, if you have **Plant Alpha** and **Plant Beta** as two separate databases but only want to deploy a single Collaboration server, those users can be given a default group of '​Alpha'​ and '​Beta',​ respectively.
 +
 +====Open Firewall Ports====
 +
 +By default, the Collaboration Server uses ports 450 (Mumble Control TCP Protocol), 451 (REST TCP Protocol) and 1229 (Voice UDP Protocol).
 +
 +Clients PC-based clients usually require access to port 450. Mobile clients (and PC-based clients that are unable to access port 450) will attempt to access the REST service on port 451 if 450 is unavailable.
 +
 +The ARDI server itself needs to be able to access the REST protocol (port 451). If this port is blocked between the ARDI server and the Collaboration server, a significant slowdown of web services will occur.
 +
 +If you are thinking of running on non-standard ports or would like to run additional instances of the collaboration server for different sites, see the [[Non-Standard Ports]] documentation.