<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN"> <html> <head> <meta HTTP-EQUIV="Content-Type" CONTENT="text/html;CHARSET=iso-8859-1"> <meta name="keywords" content="Virtual Screen, Open Source, Software" /> <meta name="description" content="Mouse and Keyboard Sharing" /> <link rel="stylesheet" type="text/css" href="synergy.css" media="screen" /> <title>Synergy Troubleshooting</title> </head> <body class="main"> <p> </p> <h3>Synergy Troubleshooting</h3> <h4>Problems</h4> <ol> <li><a href="#problem1">Cannot read configuration</a> <li><a href="#problem2">Connection forcefully rejected</a> <li><a href="#problem3">Connection timed out</a> <li><a href="#problem4">Cannot listen for clients</a> <li><a href="#problem5">Unknown screen name "XXX"</a> <li><a href="#problem6">Server refused client with name "XXX"</a> <br><a href="#problem6">A client with name "XXX" is not in the map</a> <li><a href="#problem7">Server already has a connected client with name "XXX"</a> <br><a href="#problem7">A client with name "XXX" is already connected</a> <li><a href="#problem8">Server has incompatible version</a> <li><a href="#problem9">The cursor goes to secondary screen but won't come back</a> </ol> <h4>Solutions</h4> <ol> <li><a name="problem1"></a><span class="fakelink">Cannot read configuration</span> <p> There's an error in the configuration file. This error is always accompanied by another message describing the problem. Use that message and the <a href="configuration.html">configuration documentation</a> to determine the fix. </p> <li><a name="problem2"></a><span class="fakelink">Connection forcefully rejected</span> <p> The client was able to contact the server computer but the server was not listening for clients. Possible reasons are: </p> <ul> <li>The client is using the wrong server <p> Make sure the client is using the hostname or IP address of the computer running the synergy server. </p> <li>Synergy isn't running on the server <p> Make sure the synergy server is running on the server computer. Make sure the server is ready to accept connections. If another program is using synergy's port (24800 by default) then synergy can't start unless you specify a different port. </p> <li>The client is using the wrong port <p> Synergy uses port 24800 by default but you can specify a different port. If you do use a different port you must use that port on the server and all clients. </p> </ul> <li><a name="problem3"></a><span class="fakelink">Connection timed out</span> <p> The most likely reasons for this are: </p> <ul> <li>A firewall <p> A firewall is a program or device that deliberately blocks network connections for security reasons. Typically, they'll silently drop packets they don't want rather than sending a rejection to the sender. This makes it more difficult for intruders to break in. </p><p> When synergy traffic hits a firewall and gets dropped, eventually the synergy client will give up waiting for a response and time out. To allow synergy traffic through first find all the firewalls on the network between and on the synergy client and server computers. </p><p> A firewall on the server or any network device between the server and any client should allow packets to TCP port 24800. (Port 24800 is the default; use whichever port you've selected.) You'll have to consult the manual for your operating system, device, or firewall software to find out how to do this. </p><p> Usually you'll won't need to adjust a firewall on client machines. That's because firewalls normally allow incoming traffic on any port they've initiated a connection on. The reasoning is, of course, if you started a conversation you probably want to hear the reply. </p> <li>The network is down or busy <p> Correct the network problem and try again. You might try <span class="code">ping</span> to see if the two computers can see each other on the network. </p> <li>The server is frozen <p> If the synergy server is running but locked up or very busy then the client may get this message. If the server is locked up then you'll probably have to restart it. If it's just very busy then the client should successfully connect automatically once the server settles down. </p> </ul> <li><a name="problem4"></a><span class="fakelink">Cannot listen for clients</span> <p> Synergy tried to start listening for clients but the network port is unavailable for some reason. Typical reasons are: </p> <ul> <li>No network devices <p> You must have a TCP/IP network device installed and enabled to use synergy. </p> <li>A synergy server is already running <p> Check that a synergy server isn't already running. </p> <li>Another program is using synergy's port <p> Only one program at a time can listen for connections on a given port. If the specific error is that the address is already in use and you've ruled out the other causes, then it's likely another program is already using synergy's port. By default synergy uses port 24800. Try having synergy use a different port number, like 24801 or 24900. Note that the server and all clients must use the same port number. Alternatively, find the other program and stop it or have it use another port. </p> </ul> <li><a name="problem5"></a><span class="fakelink">Unknown screen name "XXX"</span> <p> This error can be reported when reading the configuration; see <a href="#problem1">cannot read configuration</a>. If the configuration was read successfully and you get this error then it means that the server's screen is not in the configuration. All screens must be listed in the configuration. </p><p> A common reason for this is when you haven't used the system's hostname as its screen name. By default, synergy uses the hostname as the screen name. If you used a different screen name in the configuration then you must tell synergy what that name is. Let's say the hostname is <span class="code">frederick</span> but the configuration defines a screen named <span class="code">fred</span>. Then you must tell the server that its screen name is <span class="code">fred</span> by using the <span class="code">--name fred</span> command line option or setting the screen name in the advanced options dialog to <span class="code">fred</span>. </p><p> Alternatively, you can specify one name as an alias of another. See the <a href="configuration.html#aliases">configuration documentation</a> for details. </p><p> Another common reason for this is a mismatch between what you think the hostname is and what synergy thinks it is. Typically this is a problem with fully qualified domain names (FQDN). Perhaps you think your system is named <span class="code">fred</span> but synergy thinks it's <span class="code">fred.nowhere.com</span> or <span class="code">fred.local</span>. You can use either solution above to fix this. </p> <li><a name="problem6"></a><span class="fakelink">Server refused client with name "XXX"</span> <br><span class="fakelink">A client with name "XXX" is not in the map</span> <p> The client is using a screen name not in the server's configuration. This is essentially the same problem as <a href="#problem5">Unknown screen name "XXX"</a> and has the same solutions: specify another screen name or add an alias. </p> <li><a name="problem7"></a><span class="fakelink">Server already has a connected client with name "XXX"</span> <br><span class="fakelink">A client with name "XXX" is already connected</span> <p> This happens when: </p> <ul> <li>Two clients try use the same screen name <p> Each client must have a unique screen name. Configure at least one client to use a different screen name. </p> <li>One client reconnects without cleanly disconnecting <p> It's possible for a client to disconnect without the server knowing, usually by being disconnected from the network or possibly by going to sleep or even crashing. The server is left thinking the client is still connected so when the client reconnects the server will think this is a different client using the same name. Synergy will usually detect and correct this problem within a few seconds. If it doesn't then restart the server. </p> </ul> <li><a name="problem8"></a><span class="fakelink">Server has incompatible version</span> <p> You're using different versions of synergy on the client and server. You should use the same version on all systems. </p> <li><a name="problem9"></a><span class="fakelink">The cursor goes to secondary screen but won't come back</span> <p> This is <a href="faq.html#faq17">FAQ #17</a> and is also mentioned in the documentation for <a href="running.html#asymmetric">using synergy</a> and <a href="configuration.html#asymmetric">configuration</a>. </p> </ol> </body> </html>