# Guacamole Pre-Requisites

#### Port Requirements:

<table><thead><tr><th width="200">Connection Type</th><th width="166">Provider/OS</th><th width="244">Port</th><th>Target</th></tr></thead><tbody><tr><td>IP Connect</td><td>Linux</td><td>22</td><td>VM</td></tr><tr><td>IP Connect</td><td>Windows</td><td>3389</td><td>VM</td></tr><tr><td>Console Connect</td><td>VCenter (Version lower then 7)</td><td>1000-9999, 50000-50999</td><td>Hosts</td></tr><tr><td>Console Connect</td><td>SPF</td><td>2179</td><td>Hosts</td></tr></tbody></table>

####

#### Guacamole pre-requisites for Virtual Machine / VM template  &#x20;

When setting up a base template in vCenter or VMM, please make sure to apply the settings below. This is mandatory to launch a VM through guacamole using Hybr.&#x20;

**IP Connect:**&#x20;

1. &#x20;**Linux:**
   1. &#x20;OpenSSH-server needs to be installed&#x20;
   2. &#x20;The virtual machine should have network attached&#x20;
   3. &#x20;Port 22 should be allowed in the firewall (SSH)&#x20;
   4. &#x20;The virtual machine should be accessible from the guacamole servers&#x20;
2. &#x20;**Windows:**&#x20;
   1. &#x20;RDP is enabled in the virtual machine&#x20;
   2. &#x20;RDP Port 3389 should be enabled
   3. &#x20;The Virtual Machine should be accessible from the guacamole servers
   4. &#x20;WDDM should be disabled
      1. &#x20;Windows 10 template requirements for Apache Guacamole
         1. Disable WDDM: <http://apache-guacamole-general-user-mailing-list.2363388.n4.nabble.com/Error-114-in-gaucd-td7242.html#a7267>
         2. Gpedit.msc -> Local Computer Policy -> Computer Configuration -> Administrative Templates -> Windows Components -> Remote Desktop Services -> Remote Session Environments -> Disable Use WDDM Graphics

**Console Connect:**

1. &#x20;**vCenter (Version lower than 7):**
   1. &#x20;Console Port Ranges for each host should be enabled in network
   2. &#x20;VNC protocol should be enabled for each host&#x20;
   3. &#x20;Host machines should be accessible from the guacamole server
   4. &#x20;Note: For existing workloads that were onboarded (Sync) to Hybr require a manual Sync operation in the Hybr admin portal.
      1. &#x20;For the Synced VMs after the port assignment, needs to restart the VM in order to console connect it.
2. &#x20;**SPF:**
   1. &#x20;RDP should be enabled in all the hosts of the VMM
   2. &#x20;Console port 2179 (default) should be allowed in firewall
   3. &#x20;Host machines should be accessible from the guacamole servers
   4. &#x20;Host credentials need to be entered in Hybr&#x20;

#### Reason: &#x20;

Without this setting on a VM template / Virtual machine, user will face error while connecting to a VM through guacamole using Hybr.

&#x20; Error: (You have been disconnected issue) segfault 0