The fileServersNG module replaces the file servers subsystem that ships as part of the standard Alfresco Content Management System with a new subsystem that is based on the JFileServer file server code, enabling support for the newer SMB v2 and SMB v3 protocols, and adding new features.
fileServersNG supports the File Explorer Menu for Alfresco Windows client application that adds custom actions to the File Explorer context menu when selecting files and folders on a fileServersNG mapped drive.
You can customise the context menu with your own actions by writing server side actions in Javascript.
Server actions have full access to services on the Alfresco server, and can instruct the client to display a message box, show a notification, open a URL and/or run an application after the action has been run.
For more details on how to setup the File Explorer Menu for Alfresco application, and details of how to write your own scripts, see the Wiki article here.
The fileServersNG add-on includes a feature to allow access to previous file versions for files that have the Versionable aspect. To access the previous file versions use the Windows Explorer right click Properties menu item and select the Previous Versions tab.
Property | Description |
---|---|
smb.enabled | Enable the fileServersNG SMB file server, true or false |
ftpng.enabled | Enable the fileServersNG FTP file server, true or false |
smb.dialects | List of enabled SMB dialects that the server will negotiate with the client. SMB1, SMB2 and or SMB3 |
smb.kerberos.realm | Kerberos realm, enables Kerberos authentication if set |
smb.kerberos.stripUsernameSuffix | Strips the suffix from the Kerberos authenticated user name that includes the realm, when matching to the Alfresco user account, true or false |
smb.kerberos.loginEntryName | Entry to use within the Java login configuration, default FileServerSMB |
smb.kerberos.debug | Enable Kerberos authentication debug output, true or false |
smb.kerberos.config | Path to the Kerberos configuration file, eg. /kerberos/alfresco_krb5.conf |
smb.login.config | Path to the Java login configuration file, eg. /kerberos/alfresco_login.config |
smb.disableNTLM | Disable NTLM authentication, true or false |
smb.disallowNTLMv1 | Do not allow the weaker NTLM v1 authentication, true or false |
smb.useSPNEGO | Use SPNEGO within the authentication phase, true or false. This will be forced to true when SMB2 and/or SMB3 dialects are enabled. |
smb.maxPacketSize | Maximum packet size to negotiate with the client when using SMB2 or SMB3. Can be specified as 'n' bytes, 'nK' kilobytes or 'nM' megabytes. The default setting is 2M. |
smb.requireSigning | Require the client to use packet signing for SMB2 |
smb.enablePostClose | Enable the experimental feature available in fileServersNG-v61 and fileServersNG-v5 that allows the file close response to be sent by the protocol layer then perform file close processing within Alfresco. This can speed up the response in particular for versioned files where it can take some time to check if the file is actually a new version. Value true or false. |
smb.sessionDebug | Enable SMB debug output, see the Wiki document for the full list of debug levels |
smb.AESProvider | Sets the JCE provider name to be used by the SMB3 AES/GCM encryption/decryption. To use hardware accelerated encryption/decryption use the value 'SunJCE'. The default setting will cause the software based encryption/decryption code from the BouncyCastle JCE provider to be used. To force use of the BouncyCastle JCE provider use a value of 'BC'. |
smb.linkUrlHostName | Host name to be used when generating .lnk files for link file/folder nodes. If not specified the value of the smb.serverName property is used |
smb.clientAPI.enabled | Enable the client API interface that is used by the File Explorer Menu for Alfresco client application to add a right click context menu to the Windows File Explorer application with Alfresco specific actions. Value true or false. See the File Explorer Menu for Alfresco Wiki page for more details. |
smb.clientAPI.shareBaseURL | The URL for the Share web application. This value is used by server side actions triggered by the client API to build Share URLs that can be used to open particular pages on the client side. |
smb.clientAPI.scriptsDir | The path to the server side action scripts that are used by the fileServersNG client API implementation. The folder should include the server side scripts as well as the scripts.toml file that configures the server side actions. See the File Explorer Menu for Alfresco Wiki page for more details. |
smb.clientAPI.debug | Enable debug output for the client API processing on the server. Value true or false. |
smb.clientAPI.menu_title | Set the top level File Explorer context menu title to be used by the client side application. The default value is Alfresco Drive. |
smb.clientAPI.menu_description | Sets the top level File Explorer context menu description to be used by the client side application. The default value is Alfresco Drive File Explorer menu. |
smb.clientAPI.menu_icon | Sets the icon to be used by the top level File Explorer context menu. The default icon is the FileSysOrgAlfresco icon. For the list of available icons see the File Explorer Menu for Alfresco Wiki page. |