Alfresco Bulk Filesystem Import Tool

post from my other blog at


get the tool


use the alfresco module managing tool



Installation Steps

The following steps describe how to download and install the Alfresco Bulk Filesystem Import Tool:

  1. Download the latest AMP file containing the tool from here
  2. Shutdown your Alfresco instance (use the .sh inside your alfreso install folder)
  3. Make a backup of the original alfresco.war file. On Tomcat, this is located in ${ALFRESCO_HOME}/tomcat/webapps
  4. Use the Alfresco Module Management Tool to install the AMP file obtained in step 1
  5. Restart Alfresco, watching the log carefully for errors

Running the MMT

Run the following command:

  java -jar alfresco-mmt-2.1.jar [args]

It is compatible with V2.0 WAR files and above.

MMT Commands

The MMT has a number of commands. Details of these are outlined below:


usage: install <AMPFileLocation> <WARFileLocation> [options]

valid options:

   -verbose   : enable verbose output
   -directory : indicates that the amp file location specified is a directory.
                All amp files found in the directory and its sub directories are installed.
   -force     : forces installation of AMP regardless of currently installed module version
   -preview   : previews installation of AMP without modifying WAR file
   -nobackup  : indicates that no backup should be made of the WAR


Stop Alfresco

:~/alfresco-4.0.d-1$ ./ stop

/home/ardian/alfresco-4.0.d-1/apache-tomcat/scripts/ : tomcat not running

/home/ardian/alfresco-4.0.d-1/mysql/scripts/ : mysql stopped


Check if alfresco is running


ardian@arbk-share:~/alfresco-4.0.d-1$ ps -ef | grep alfresco

ardian   18815 18168  0 11:06 pts/2    00:00:00 grep –color=auto alfresco


locate where the alfresco-mmt-2.1.jar is usually its under alfresco install dir in the bin/ 

For me its /alfresco-4.0.d-1/apps/alfresco


java -jar alfresco-mmt.jar install ~/alfresco-bulk-filesystem-import-1.1-ALF40.amp ~/alfresco-4.0.d-1/apache-tomcat/webapps/alfresco.war


list the modules


java -jar alfresco-mmt.jar list ~/alfresco-4.0.d-1/apache-tomcat/webapps/alfresco.war

Module ‘org.alfresco.extension.alfresco-bulk-filesystem-import’ installed in ‘/home/ardian/alfresco-4.0.d-1/apache-tomcat/webapps/alfresco.war’

   –    Title:        Alfresco Bulk Filesystem Import v1.1 (for Alfresco v4.0)

   –    Version:      1.1

   –    Install Date: Wed Jul 25 11:18:19 CEST 2012

   –    Description:   Alfresco Bulk Filesystem Import tool.  Provides high performance bulk loading of content from the server’s filesystem into Alfresco.


If you run Alfresco on Linux turn of CIFS: add this






export BULK=alfresco-bulk-filesystem-import-1.0.amp


java -jar $ALFRESCO_HOME/bin/alfresco-mmt.jar install $ALFRESCO_HOME/amps/$BULK $ALFRESCO_HOME/tomcat/webapps/alfresco.war -force -verbose









About ardian
I'm a young free/libre open source software/linux, enthusiast who has been working on promoting FLOSS in Kosovo. I'm helping my fellow peopel here in Kosovo in learning GNU/Linux. I helped run the first SFK09(Software Freedom Kosova 09) conference. I organised and talked in many locations in my country. I also have been learning and working on the OpenStreetMap project for Kosovo. I'm working on translating different software packages into Albanian.

2 Responses to Alfresco Bulk Filesystem Import Tool

  1. Screen Toys says:

    Do you mind if I quote a few of your articles as long as I provide credit and sources back
    to your blog?
    My blog is in the exact same area of interest as yours
    and my visitors would definitely benefit from some of the information you present here.
    Please let me know if this is okay with you.

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s


Get every new post delivered to your Inbox.

Join 722 other followers

%d bloggers like this: