Create a LAN-Based Network Folder
To configure Network Folders, prohibit their creation on certain paths, then add the folder paths as Network Folders and give users and groups permission to access them.
Beginning with FileCloud 23.241, TONIDOCLOUD_ENABLE_NETWORK_SHARE_MOUNTS is enabled by default.
The TONIDOCLOUD_ENABLE_NETWORK_SHARE_MOUNTS command was added in FileCloud 22.1, and was disabled by default.
Prior to FileCloud 22.1, no configuration file setting was required for enabling or disabling Network Folders.
Block locations from mounting as share paths
The TONIDOCLOUD_NETWORK_FOLDER_MOUNT_PATH_BLOCK_LIST command has been added in FileCloud 22.1. In FileCloud versions prior to this, C:/xampp was not permitted to be mounted as a Network Folder, but no configuration file setting existed for manually blocking specific paths.
By default, the xampp path in Windows and the /var/www/html path in Linux are not permitted to be mounted as Network Folders. You may add any other paths that you do not want mounted as Network Folders.
- Open cloudconfig.php.
- Windows Location : C:\xampp\htdocs\config\cloudconfig.php
- Linux Location : /var/www/html/config/cloudconfig.php
Find the command for blocking locations, or If it does not exist, create it.
In Windows it should appear as:define("TONIDOCLOUD_NETWORK_FOLDER_MOUNT_PATH_BLOCK_LIST", 'C:/xampp|c$/xampp');
In Linux it should appear as:
define("TONIDOCLOUD_NETWORK_FOLDER_MOUNT_PATH_BLOCK_LIST", '/var/www/html');
Add any locations that you do not want to be shared, for example:
define("TONIDOCLOUD_NETWORK_FOLDER_MOUNT_PATH_BLOCK_LIST", 'C:/xampp|c$/xampp,C:/PatientRecords');
Create a Network Folder
To create a Network Folder:
- Login to the FileCloud Admin Portal.
- Navigate to Network Folders in left navigation panel.
- Click Add to launch the New Network Folder dialog box.
- Select Local Area Network from the dropdown.
- Enter the name of the network share. This will be the name shown to the user to access this network share resource. For example, "Training Docs". This can have only alpha numeric characters.
- Select whether you want to use Normal mount paths or Smart mount paths. Read more about Smart mounts.
For Normal mount paths: select the remote folder to use as the network share
The FileCloud Web Server, fcorchestrator, cron, and Document Preview services must run as accounts with full permissions on that folder. See Web Server Permissions for Network Shares
Note: When using UNC paths (Paths like \\computername\sharename) set FileCloud to run as service and set the log-on account for the service to the admin user that has access to that UNC share path.
Otherwise the network share cannot be added.
When adding Network Shares to FileCloud Server in a Windows Environment please note that File Paths can't be greater than 260 characters, due to a PHP limitation. If you want to find out if you have files with a path greater than 260 you can use a 3rd party tool like Path Length Checker, which will read all the files from a specific location and show you which files are passing this restriction, you can visit the following link and download the tool:
Network Folders function to give FileCloud users who are assigned to them access to their content; when you enter the Mount Path, please be careful to avoid entering:
- an internal mount path that exposes internal secure documents related to servers and configurations.
- an internal mount path that contains documents required to remain inaccessible to users given Network Folder permissions through FileCloud.
- Assigned Permissions specifies that FileCloud's permissions are applied to restrict user access.
"NTFS" permissions specifies that the existing NTFS permissions are used to restrict user access. See more information about setting Network Folders with NTFS Permissions. - Once the Network Folder is created, you can assign users and groups to this folder.
Click Add User Access to include users; click Add Group Access to add groups. - Click Finish to create the folder.
Granting access to Network Folder
After the network share is created, you may add and remove user access to it.
The network share access can be granted to Full users, Guest users or User Groups.
FileCloud licensing doesn't allow adding External users to network shares. To add External users to a network share, the folder has to be shared by another user directly to the External user and not by the admin.
To grant access to a share, the following steps should be performed
- Click Network Folders in the left navigation menu to display the list of available network shares
- Click the Edit button for a network share entry to add user or group access
- Click Manage Users or Manage Groups at the bottom of the Network Folder Details panel.
- Set the appropriate Access level
The access level for a user or group can be
Access | Description |
---|---|
Full Access | This allows the user to read, write and share the contents of the share. Note that for a user to be able to sync a network folder, the user must have Full access. |
Read Access | The user can only read (no write and share) the contents |
NTFS Access | The permissions are extracted from the actual Windows NTFS permissions and user actions are restricted based on those permissions. |
Notifications for Network Folders
By default, notifications are enabled for network folders. This means that all users who have access to a network folder and have notifications enabled receive notifications about all actions on the folder.
However, since multiple users may have access to the same network folder, users may receive notifications about actions that don't interest or don't apply to them.
There are various ways you can limit their access to these notifications. First disable notifications for the folder, and then override the setting only for notifications that you want to permit.
- Disable notifications for the folder:
- Click Network Folders in the left navigation menu to display the list of network folders
- Click the Edit button for the network folder.
The Network Folder Details dialog box opens. - Check the Disable Notifications box.
- Click Update.
- Do one of the following:
- Leave all notifications about actions in the folder disabled.
By default, admins and users can override this setting. An admin can enable notifications about the folder for specific users, or users can enable their own notifications for the folder.
If you do not want users to be able to override this setting, you must disable file change notifications in Settings > Misc > Notifications. See Notifications for File Changes for help. - Enable notifications about the folder for specific users.
This is useful if you want to limit the users who receive notifications about a network folder to those you have shared it with.
See the various options for setting users' notifications in the section Managing User-Defined Notifications. Allow users to enable their own notifications about the folder.
See the options users have for setting their own notifications in the section Notifications.
- Leave all notifications about actions in the folder disabled.
Configuring Network Folders Behavior
You can configure some of the behaviors of Network Folders by using the settings below found in Settings->Storage tab.
Function | Description |
---|---|
Network Folders Display Name | This label will be displayed in the User portal when the user logs into their account. Please Note: Once setup, don't change it as this will affect existing sync apps that have started syncing. Existing sync apps will continue to sync to the older name and only new network shares configured via Sync will use the new name. |
User can share Network Folder | This setting controls whether or not a network share location can be shared by an user |
Sync Network Folder | This setting controls whether or not a network share location can be synced by a user using sync client for offline access. You can disable offline sync for individual network folders as well. See Sync Network Folders for Offline Access for more information about syncing network folders. |
Max File Size Limit | Limits file size when uploading in Web clients. By default, this setting is not honored in Sync and Drive. It could affect folders that are renamed in Sync, since they are deleted and reuploaded during rename operations. Use 0 to allow uploading of files of unlimited sizes. |
Number of old versions to keep for each file | Enables versioning of files in network location. To maintain no versions enter 0. |
Skip Versioning for files Greater than | The file size limit in bytes beyond which the versioning will not be applied |
Skip Names | This is a regex filter which can be used to exclude files that match the regex expression from file listing. Example of a Regular Expression that skips some names from displaying is /(sub.*|copy.*)/ This skips all files which start with "sub" or "copy" |
Enable Access Based Enumeration for NTFS | When browsing network folders with NTFS permissions, folders that users don't have access to (no permissions) are hidden from view. |
Store Deleted Files in Network Folder | Enable this to store deleted files from network folders in a special deleted items folder |
Do not store deleted files greater than | Files greater than this size specified in bytes do not get stored in Deleted Files. |
Enabled Indexed Search | To enable indexing of network folders to allow fast searching. See this topic for more information. |
Offline Access to Network Folders
FileCloud Sync app can provide offline access to Network Folders by allowing users to download files from Network Folders automatically similar to how synced folders work.
To enable Offline Access, you need to enable the Sync Network Folder option in Settings->Storage->Network Storage Settings.
See how to configure Offline Access to Network Shares in the FileCloud Sync app.
You can disable offline sync of certain Network Folders. Edit a network folder and enable the checkbox to Disable Offline sync.
Sharing Restrictions on Network Folders
To restrict sharing on network folder, following steps should be performed.
- Navigate to Network Folders in the Administration panel and Click on the Edit button for the respective Network Folder.
- In the Network Folder Details dialog box, set Sharing to Shares not allowed.
Click Update, now the Network Folder is restricted to be shared.
The following are the option available to set Sharing for Network Folder:
Sharing Options | Notes |
---|---|
Allow All Shares | Allow public and private sharing of the Network Folder |
Allow Private Shares Only | Allow only private sharing of the Network Folder |
Shares Not Allowed | Restrict both public and private sharing for Network Folder |
Disabling Network Folders
To disable Network Folders:
- Open cloudconfig.php.
- Windows Location : C:\xampp\htdocs\config\cloudconfig.php
- Linux Location : /var/www/html/config/cloudconfig.php
Find the following command, or if it does not exist, create it:
define("TONIDOCLOUD_ENABLE_NETWORK_SHARE_MOUNTS", true);
- Change the value true to false.
- To re-enable Network Folders, change the setting back to true.
Miscellaneous: ._cloud Folder
Network folders at times will create a ._cloud sub folders for various reasons that include:-
- Store previous versions of Files
- Store the deleted files under that Network Folder
- Storing the image thumbnails.
There is no option to automatically delete the ._cloud folder. However, the previous versions of the files can be deleted by the user and the stored deleted files can be emptied by the admin by using the Clear All Deleted Files in the screenshot above.Even if thumbnails are deleted, they will be recreated once the image file is accessed again through FileCloud interface.