Summary

This article is a guide to how you should approach issues that appear when FilmHUB attempts to transfer a file package. We try to cover as many aspects as possible but there might still be errors that are not directly recognisable by FilmHUB and has to be identified by FilmHUB service personnel.

Included in your subscription contract is office hours debugging of failing transfers and updates to software to remedy these issues when possible.

IMPORTANT NOTE: We cannot make FilmHUB solve issues that are out of our control, this includes misconfiguration of the software, errors in your software/operating system/drivers or hardware errors such as failing disks/network/controllers.

Transfers cannot be submitted

The most common cause is user lacking permission to download or upload to the specific location and usually happens when submitting a job through CLI or API:

- Users; Will be presented sparse information regarding what is causing the error, reach out to your contact at organization/domain and have them troubleshoot. As an employee/admin they can then view the job audit logs (ADMIN>LOGS>Job) to track the submit event and find full information about why job could not be submitted.

- Employees/Admins; Will be told the cause of error making it possible for you to either configure FilmHUB to allow transfer or adjust your transfer job parameters. Usually it is a misspelling when submitting jobs through CLI/API or a share has been removed whilst you were submitting the job.

Job warning and error codes

From here on, FilmHUB attempts to give feedback on why a transfer cannot be finalised.

The software can detect most of the common errors that occurs, they listed as either job warning codes or job error codes and each have a number identification assigned. They are included in log messages as a suffix on the form W#Jnnn for warnings and E#Jnnn for errors, and are described in detail in separate support articles:

- Job warning codes (link).

- Job error codes (link).

If no log message are presented or have no code attached, FilmHUB service personnel attempts to teach FilmHUB about the issue and include it in the next upgrade cycle. Please help us map these issues for us to make FilmHUB a better software experience - making it easy for all users out there to find and remedy transfer issues!

Transfer does not start

This can occur due to many reasons, here follows a listing of issues sorted depending on how commonly they occur:

The remote client is offline

Description: This is the most common cause of sitting duck transfers - FilmHUB relies on both parties in transfer to be online and enabled in order for a transfer to launch. This error is usually displayed when hovering job or when viewing the job and looks like this: “No clients are online. (W#J050)”. To find out last time client was online, go to ADMIN>CLIENTS and record the “last checkin” entry for specific client.

Solution: Make sure remote client transfer party is online, functioning and having network (Internet or LAN/VPN) connectivity as required depending on your setup.

The remote client is disabled

Description: You can disable a certain client, and the user can disable its client for a reason. Again FilmHUB relies on both parties in transfer to be online and enabled in order for a transfer to launch, this issue is usually displayed when hovering job or when viewing the job and looks like this: “No clients are online. (W#J050)”.

Solution: Make sure user enable their client to have transfer commence.

The FilmHUB trial period has ended

Description:

Note: Affects trial licensed FilmHUB domain only.

When the FilmHUB trial ends, no transfer jobs will be executed until the trial is extended or a valid permanent subscription license is made active. The message “FilmHUB demo license as expired. (W#J066)” should be displayed on job. This is an global issue and should be displayed as a top bar notification in your UI.

Solution: For information on how to obtain a FilmHUB license, please head over to filmhubsoftare.com/pricing.

The server is offline

Description: At the same time, the server party (or server parties if it is a site-site transfer) has to be online and enabled for transfers to happen. An offline server is usually displayed as a global issue and should be clearly displayed as a top bar notification in your UI.

Solution: Go to ADMIN>SERVERS to locate the offline or disabled server and remedy the issue, usually it involves enabling the server or restarting it and making sure it has network connectivity (Internet or LAN/VPI depending on your setup).

The user is disabled

Description: No transfers will happen if the user is disabled, this includes the admin user that installed the server software.

Solution: Check that remote user is enabled and the user of server (or servers if a site-site transfer) is enabled.

The share is offline

Code: W#J052

Description: If an involved root share is offline, transfer will not start. This include an explicit standard or user share, or if the parent root share is offline.

A root share turns offline of the server cannot find its folder and usually is caused by a dismounted local or network filesystem.

Solution: Check your server and make sure the storage is available at the configured path known by FilmHUB. If changed/relocated, edit share (ADMIN>SHARES) and browse new path.

The share is disabled

Code: W#J052

Description: If an involved share is disabled, transfer will not start. This applies both to standard or user share involved, or if the parent root share is disabled (recall that shares are descendants of root shares and depending on their availability).

Solution: Enable the share and/or root share to have the transfer happen.

The involved site is disabled

Code: W#J052

Description: (Site-hq/site-site transfers only) If the site involved in transfer is disabled, no transfers will happen.

Solution: Enable site(s) to enable transfers to have the transfer happen.

A free channel/port cannot be allocated

Description: Each ongoing p2p(point-to-point) transfer in or out from a server on your premises occupies one channel/port. For example having the default port range 45190-45209 range configured means that 20 concurrent high speed transfers can happen between server and desktop apps or server and other (site) server. This does not include web transfers, they do not require p2p channels.

Solution: Either configure a wider port range or wait for other transfers to finish.

Transfer failures

Failing transfers is most commonly due to a missing source file or destination storage having space/write issues. To troubleshoot the failure - get more information about the issues, follow these procedures:

UI (desktop app or web app):

- Hover the job and a description of the issue should be presented.

- A blue "Log" button is presented at job, press it to bring up the log for troubleshooting.

- View the job and double-click the failed task/file in list, this will bring up the detailed transfer log for deeper troubleshooting.

CLI (command line):

- List job(s) by issuing: ‘filmhubcli job find’, a description of issue should be presented.

Here follows a listing of issues sorted depending on how commonly they occur:

Missing source file(s)

Code: E#J001

Description: FilmHUB states that one or more file(s) are missing.

Solution: Try to bring the file/directory back if it is intended to be there. Otherwise exclude the tasks (files) in GUI and retry the job for rest of files in package to complete.

Network connection lost

Code: E#J008

Description: FilmHUB states: An network communication error occurred during transfer. This happens to a transfer that has been going on for a while and suddenly the network drops out.

Solution: Make sure the network/Internet connection is stable and not are disconnected during transfer. A good starting point is to have a ping running during transfer in combination with doing trace routes to find out where to route is cut off.

Files cannot be written

Code(s): E#J053, E#J055, E#J056, E#J057

Description: Usually this is due to destination disk being full or the system user FilmHUB is running as on server or client end has insufficient write permissions on the disk or volume.

Solutions:

• Check disk space on receiving end, free up space if necessary,
• Make sure files can be written to the disk, is it locked due to filesystem corruption or is on other readonly state?
• Check the system user FilmHUB process is running as, can this user create the required folders and/or write files files were it needs to?

Firewalls are blocking connections or scrambles the connection during transfer

Code(s): E#J003, E#J004, E#J009, E#J010

Description: This is usually due to a change in configuration in firewall block one or more ports configured in FilmHUB for WAN transfers.

Solutions:

• Edit the server and reconfigure the ports once more - make sure FilmHUB can make the TCP connections from WAN side as required.
• If transferring from a computer inside the same network (behind same router) as server is located, some firewalls might scramble the traffic. In this case you need to make IP overrides at server towards client for traffic to pass smoothly.
• Too many transfers are happening, configure more ports (channels) for FilmHUB to use. Some clients might have restricted outgoing ports, make sure to configure a couple of low ports like 443:TCP to get those transfers goind.