Starting SyncDocs in Troubleshooting Mode
If your issue is still not resolved, start
SyncDocs in Troubleshooting mode. On Mac OS X, double click the file
Troubleshoot.command in the same directory where SyncDocs is.
On Windows, double click the file "Troubleshoot.bat". On Linux, double click
the file "troubleshoot.sh" or change directories to that path in a terminal
window and execute it.
Once in Troubleshooting mode, SyncDocs will print logging messages to a new
Terminal or Command Prompt window (or to the same window if you've executed
it directly). These will help us resolve your issue.
If you're having a problem downloading files, then attempt to do that and
copy and paste the output into an e-mail. Send it to the address in the
"Contact Me" link in the top right corner of this page.
If nothing is printed when you attempt to download files (or whatever it is
that isn't working) please indicate that in your report.
The SyncDocs server never shows up in the list on my mobile device.
Bonjour can take up to 10 seconds to resolve. If you are trying different
things to get it to work make sure you allow enough time for the resolve at
each step.
- Some users have reported problems with the iPhone client when it's plugged
in via USB. If you are not using USB tethering, try disconnecting the iPhone
or iPod Touch from USB.
- One or more firewalls may be preventing you from connecting. See
the next section for more information about configuring your
firewall(s).
- Make sure the Bonjour name you're using doesn't have any periods in it.
- Take a look at the Bonjour demo, or click the
Setup button and either:
- Use Bonjour as the Zeroconf Implementation (if it's available).
- If there is no Zeroconf Implementation option, select "Bind to all addresses".
- If there is no Zeroconf Implementation option, verify that your wireless address is the one shown. If you're not sure, see the network interface help page.
- Make sure the computer running the SyncDocs server is on the same wireless
network as the mobile device, and make sure the Wi-Fi symbol shows up on your
iPhone or iPod Touch.
- For advanced network administrators that have a multilayered network,
make sure the mobile device and computer running the SyncDocs server are
on a directly connected network. Bonjour uses UDP broadcasting on port 5353
for name resolution. If broadcasting is bridged correctly, the SyncDocs server
can be on a wired network and/or a different network.
- If your problem is still not resolved, you may wish to try using Bonjour
instead of JmDNS. If there is no "Zeroconf Implementation" option in the
Setup,
install Bonjour for Windows.
It may install as part of iTunes, and comes with Mac OS X. If Bonjour is
installed but doesn't show up in the Setup dialog, you may need to reinstall
it. Bonjour will put the classes needed for Java in all the JDK/JRE folders
it can find when it is installed. If you install Bonjour and then Java,
Bonjour will have had no opportunity to find the new installation and put the
required classes in the right place. If you upgrade to a new version of Java,
the Bonjour classes may not be in the new Java JRE/JDK directory. If either of
these have happened, uninstall and reinstall Bonjour.
When I suspend or hibernate my computer and then wake it up
the SyncDocs server doesn't show up in the list on my mobile device.
Java isn't notified on suspend, hibernate, or wake. In order to work around
this oversight, try one of the following options (all of them should work,
but you may like one option better than the others):
- After waking, click "Setup" in the main SyncDocs window, change the
Bonjour name to something else, click "OK", wait 10 seconds, and try
again.
- Run SyncDocs only when you are actually using it to transfer files.
- Quit the program (and wait for it to finish quitting) before you put your
MacBook into sleep mode.
It seems to take forever to upload or download files.
If it works, but takes a very long time (or files larger than 50 MB don't
finish) try turning off Bluetooth. If that doesn't work, the next thing to
check is your firewall settings.
Hardware Router or General OS Settings
- Make sure your router is not filtering port 5353, which is the Bonjour
port.
Mac OS X 10.4.11
- On the Mac that you will be syncing with, open the Sharing item in the System Preferences Control Panel: System Preferences>Sharing
- Click on the Firewall tab and then click on the "New" button.
- In the window that opens, click on the drop-down menu, and select "Other"
- Now in the box "TCP Port Number(s)" enter the same port number that is in the SyncDocs Setup. For the Description, type "SyncDocs". Click "OK"
- With the Firewall turned on, make sure that the SyncDocs item box is
checked.
Mac OS X 10.5
- Start SyncDocs. SyncDocs will automatically select an unused port (with a
preference for the port that was last used).
- In System Preferences (the Dock icon with gears), click Security (under
Personal).
- Click on the Firewall tab.
- Click "Set access for specific services and applications" for the most
secure available setting.
- Click the "+" button.
- A dialog opens where you can select the application you want to add.
If you're not sure where SyncDocs is, type Command-Space to activate Spotlight,
and type "SyncDocs" (without the quotes), then Command-Click the SyncDocs
application in the list. A Finder window with SyncDocs will appear.
- Drag the SyncDocs application into the Security dialog.
- Click the "Add" button.
- Close the Security dialog.
Mac OS X 10.6
- There are problems with the firewall in Mac OS X 10.6. They have not
been resolved in 10.6.1. We are working with Apple to resolve the issue. No
timeline has been given to us regarding a solution. Some users have reported
that running SyncDocs
in troubleshooting mode
resolves the firewall issue.
If you have a secondary firewall protecting you from the Internet, turning
off the firewall completely is one solution. There are other solutions, but
they don't work for a majority of users.
I tried to send files to my mobile device but it says that it didn't find any files.
Make sure you have files that the application supports showing up in the main
window of SyncDocs. See the screenshots for
how it should look. In this case, SyncDocs is ready to serve a "mm" file, or
FreeMind mindmap file, to the next application that supports that file type.
Mac OS X users, please make sure the file has an extension that is supported
by the receiving application. Also make sure you are connecting to the right
server by changing the Bonjour name that SyncDocs uses to something different
from other web servers on your network. The Bonjour name can be changed by
clicking the "Setup" button.
I tried to send files from my mobile device to SyncDocs, but I can't find them.
Make sure you're running at least version 0.3.4 of SyncDocs. That version
introduced a "Show Downloads" button which will open a Finder window,
Explorer window, or whatever is appropriate for your platform to the downloads
directory. Make sure you are connecting to the right
server by changing the Bonjour name that SyncDocs uses to something different
from other web servers on your network. The Bonjour name can be changed by
clicking the "Setup" button.
