How to build and deploy the fileServersNG subsystem

From FileSys.Org Wiki
Revision as of 16:19, 2 January 2019 by Tommygonk (talk | contribs)

fileServersNG is a replacement for the Alfresco file servers subsystem that uses the JFileServer code, and optionally JFileServer Enterprise add-on, to provide the file server capabilities for Alfresco. The fileServersNG subsystem is built as an AMP (Alfresco Module Package) that can then be deployed into an Alfresco Content Management Server setup.

The fileServerNG subsystem contains the JFileServer Enterprise add-on but requires a licence key to enable the additional functionality. With no valid licence key the file server subsystem will use the standard JFileServer protocols and functionality.

Building the fileServersNG AMP

For Alfresco version 4.x and 5.x use the fileServersNG-v5 project to build the AMP.

One way to get the Alfresco version is to login using Share, click on the Alfresco logo at the bottom of the page, in the popup window you should see the Alfresco version, for example '5.2.f'.

  • Edit the pom.xml

In the fileServersNG-v5 project folder edit the pom.xml file, set the <alfresco.platform.version> to match your Alfresco version.

  • Build the AMP file

Using the command :-

mvn clean package

This should generate the AMP file in the target/ folder with the name fileServersNG-v5-1.x.x.amp.

Deploying the fileServersNG Subsystem

  • Copy the fileServersNG-v5.1.x.x.amp file to the alfresco/amps folder
  • Register the AMP using the following command
java -jar /alfresco/bin/alfresco-mmt.jar install <path-to-fileServersNG-amp-file> <path-to-alfresco-war-file> [-nobackup] [-force]

Where <path-to-fileServersNG-amp-file> is the path to the fileServersNG-v5-1.x.x.amp file in the alfresco/amps folder, and <path-to-alfresco-war-file> is the path to the original Alfresco WAR file that was deployed to the web server. If you used the Alfresco installer this would usually be the tomcat/webapps/alfresco.war file.

  • Update your Alfresco configuration

Usually done via the alfresco-global.properties file. Disable the original file servers subsystem using :-

cifs.enabled=false
ftp.enabled=false

Enable and configure the fileServersNG subsystem, for example :-

smb.enabled=true
ftpng.enabled=true

smb.tcpipSMB.port=1445
smb.dialects=SMB1
smb.sessionDebug=Negotiate,Socket

ftp.port=1121
ftp.sessionDebug=State,PktType

Additional Setup For The JFileServer Enterprise Add-On

The JFileServer Enterprise add-on requires a valid licence key to enable it. Create the folder for the licence file at tomcat/shared/classes/license. Copy your JFileServer licence file, named jfileserver.lic, into the tomcat/shared/classes/license folder.

With the JFileServer Enterprise add-on the smb.dialects setting can also include SMB2 and SMB3 to enable the SMB2 protocol and SMB3 encryption. Use a comma delimited list of the SMB dialects to enable.