205 lines
8.5 KiB
HTML
205 lines
8.5 KiB
HTML
<!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>
|