Do you have an error code?
If not, use the following list of problems on this page to read about possible causes and resolutions.
Folders downloaded as ZIP (> 4GB) do not open properly in Windows. When a folder or multiple files are downloaded from web UI, they will be downloaded as a zip archive. If the total size of the zip files is greater than 4 GB, then the zip will be malformed.
This is a PHP on Windows limitation.
Limit the total size of the zip folder to be less than 4 GB
Folders downloaded as ZIP (> 4GB) do not open properly in LINUX. When a folder or multiple files are downloaded from web UI, they will be downloaded as a zip archive. If the total size of the zip files is greater than 4 GB, then the zip will be malformed.
This is a known issue with PHP.
To support ZIP files larger than 4 GB:
1. Open the configuration file:
2. Add the following line:
define("TONIDOCLOUD_ZIP_IMPL", "ZIP64" );
This workaround only resolves the issue on Linux. Switching to this ZIP implementation on Windows does not allow support of zip archives larger than 4 GB.
File names with the following characters won't upload using web browser.
This is a known issue with PHP.
Use one of the following recommendations:
This issue applies only to:
When you are opening a file or uploading a file to your FileCloud folder, you might get an error that the file path is too long or you may be unable to upload the file.
Sample Error Message:
The file path is too long. Please specify a shorter file name or save to a location that has a shorter path.
There is a known limitation in Windows (version) that path lengths cannot exceed 260 characters long.
For more information, read the Microsoft Windows documentation on:
Naming Files, Paths, and Namespaces
To fix this problem you need to edit a registry key.
This solution only works if you are running FileCloud on Windows Server 2016.
There are no known resolutions for running FileCloud on any other version of Widows Server 2016.
You may still be able to upload the file directly using the FileCloud user portal. This will also sync the file properly.
If you want to correct the issue occurring when:
Then you need to edit the Windows server registry. The FileSystem value has the LongPathsEnabled variable set to 0 by default. To correct this issue you must change it to 1.
This resolution of editing a registry key has been tested and works for the following FileCloud access mode:
FileCloud User Web Portal
This resolution has not been fully tested for the following FileCloud editions:
To edit the registry:
5. On LongPathsEnabled, right-click and then select Modify.
6. In the Edit DWORD Value window, in Value Data, replace the 0 with 1.
7. To save your changes, click OK.
8. Restart the server.
Figure 1. Navigating in Registry Editor
The multiple ways Unicode uses to represent a visually indistinguishable glyph using different but equivalent representations can cause many sorts of unexpected behaviors.
These behaviors are normally seen in the following situations:
For example, if a given file in FileCloud is stored in NFC form and edited and re-uploaded from Mac OSX, that file gets uploaded as NFD, leading to two visually indistinguishable files being stored by FileCloud in a single folder.
There are some special considerations when working with Unicode strings. Unicode can have multiple ways to represent a visually indistinguishable glyph using different but equivalent representation for example there are many different Unicode forms (NFC, NFD, NFKD, NFKC) to represent Unicode strings.
Refer to WikiPedia for more detailed information.
This can cause non-trivial and complex issues when working with File System Objects (like files and folders) in FileCloud across filesystems.
|Operating System||Standard Normalization||Details|
|Windows||NFC  but others work||Windows can work with all 4 forms Unicode normalization and therefore can have four different versions of same visually similar file name â?.txt in a single folder|
|Mac OSX||NFD (closest form)||Mac OSX represents all files/folders in NFD form. Only a single file can exist with a given unicode string (irrespective of normalization)|
Starting with FileCloud 12.0, there are some functional changes that help handle this situation.
|Client||Normalization Form||Automatic Conversion||Notes|
|Web Browser||Uploads any Form||File names and Folder Names automatically converted to NFC.|
Can be disabled using a config option.
|Sync App||Uploads only NFC format.||None|
|Drive App||Uploads any Form||None|
|iOS Image Uploads||Uploads NFD Form||None|
|iOS Sync||Uploads only NFC format||None|
|Android||Uploads any Form||None|
|Outlook & Office Add-On (from 12.0)||Uploads only NFC format||None|
Any kind of Normalization behavior on the server requires the php_intl extension to be installed and active on your server. Upgrading to the latest 12.0 release components will provide the "intl" extension and this can be checked in the Admin->Checks page.
To control whether any automatic conversion to NFC is done or not:
4. Save the changes.
5. Restart the server.
You can obtain a script from Technical support called:
This script can convert existing files or folder names to NFC normalization form.
To run the conversion script:
2. To use the PATH variable, which refers to FileCloud paths, look for a line similar to /USERNAME. This is the place where all files and folders are used for a specific username. (e.g. /john)
All current versions of files in a user account become unusable.
In some situations, a user may face data loss due to:
To download the Update Settings tool:
Unzip the contents of the download zip file onto the folder WWWROOT/resources/backup
Where WWWROOT is
|Linux||/var/www or /var/www/html depending on the Linux distro|
The zip contains one script file:
|prevversionexporter.php||Tool to be used for exporting previous versions of all user files|
Table 1. Tool Options
|-u||name of the user account whose files are to be exported|
|-d||destination path where the files are to be stored|
|-h||site url for which files are to be exported|
|-r||flag to export files. Without this flag, only a simulation will be done|
|-p||specify a particular managed storage path to export|
|-a||flag to export "All Previous Versions". Without this flag only the latest of the available previous versions will be exported|
From a Linux command shell, type the following commands.
In the above command:
-u : User account for which previous file versions are to be exported <Required>
-d : Directory to which the files are to be exported <Required>
-h : Host name for which export needs to be performed (needed in case of multisite installations) <Optional>
-r: Use the flag to actually export the files. Running without this flag only will simulate the export. <Optional>
In a windows command shell, type the following commands.
Sometimes, Upload fails with message "Storage Error"
This is caused because the Storage path that is set in the admin portal doesn't have Web (www-data) Permissions
Change the permission of the Storage Path (eg. . /opt/fileclouddata)
Use the following command to change the permission of the storage path
chown -R www-data directory/filename