- Port and firewall access
- Proxies and proxy support
- Antiviral and security software
- Troubleshooting connection issues
- Additional information
Port and firewall access
If you are experiencing problems with connection or job timeouts, firewalls and port access are two of the first items to look at.
To make sure you don’t have any firewall access issues, make sure that you have added outbound rules for app.box.com
, api.box.com
, and upload.box.com
.
Proxies and proxy support
Many IT environments include transparent or non-transparent proxies:
- A transparent proxy is deployed without raising the client machine awareness that they are using one. It intercepts outgoing SSL traffic via networking configuration and inserts itself in the middle.
- A non-transparent proxy requires setting configurations on the client machines; this includes the proxy server name or address and port. The client then sends outgoing SSL traffic via the non-transparent proxy. In either case the proxy certificate is installed in the client machine so there is secure communication between client and proxy, and proxy and destination server.
Box Shuttle works with most transparent and non-transparent proxies. When Shuttle starts, it reads in the available certificates from the Windows certificate store and adds those to its list of trusted certificates. In some instances where a strict proxy is in effect, you may need to add app.box.com
, api.box.com
, and upload.box.com
to the allowlist.
If you are experiencing connectivity issues that you think may be proxy or firewall related, the best resource is likely to be your IT department to resolve any issues that may be preventing the Windows agent from connecting.
Antiviral and security software
Anti-viral software and other security systems have in some instances also prevented the Windows app from starting or connecting. They should be evaluated in the normal course of troubleshooting.
Troubleshooting connection issues
Check admin permissions
Also ensure that the installing user is an admin for the Windows Agent installed in application mode. For Windows apps that will run in service mode, the user should be a local admin on the installing machine.
Reinstall Windows Agent
If a Windows Agent that has been connected for a while suddenly stops connecting, download the .msi
file again using the Shuttle UI. The latest .msi
file is always available in the Shuttle UI.
Even though the tasks for the Windows Agent update automatically and remotely, you should update the .msi
file every 8 weeks or so as a best practice.
You overwrite the old .msi
file with the new one, so you don’t have to uninstall the old agent.
Additional information
- Useful information on Windows error codes (for example code 5, code 65) These sometimes report to the event log in the job’s history. Sometimes knowing whether the code relates to a permission issue, network issue, or something else is useful in identifying why files won’t transfer over.
- This link addresses a scenario when URL drives don’t show up when the Windows Agent is run as an admin, but do show up when run as a non admin.