Alfresco Benchmark Load Users

This project provides the creation of a large number of users in Alfresco, using multiple email domains. The user's details are record in a local data mirror for reuse by subsequent tests.

More information on the Alfresco Community Site -> Running Benchmark Applications: Alfresco Sign Up

• Videos related to the Benchmark Framework 2.0
• A video showing the creation of users and the user data mirror.

Get the code

Git:

git clone https://github.com/Alfresco/alfresco-bm-load-users.git
cd alfresco-bm-load-users

Subversion:

svn checkout https://github.com/Alfresco/alfresco-bm-load-users.git
cd alfresco-bm-load-users

Prerequisites

Use the Benchmark Testing with Alfresco page for version compatibility.

    Java 1.7.0_51 or later
    MongoDB 2.6.3 or later installed and running on port 27017 on some server: mongo-host
    A compatible version of the Benchmark Server running on a Tomcat7 at port 9080: bmserver-host
    Alfresco with /alfresco available: alfresco-host

Use Maven

1. Build

    mvn clean install

2. We will kick off 2 drivers with this test. Start Driver 1 as follows:

    $ mvn tomcat7:run -Dmongo.config.host=localhost
         …
    INFO: Starting ProtocolHandler ["http-bio-9082"]

To run the Driver server from maven we again use the tomcat7-maven-plugin. For more information about the Tomcat plugin configuration see the project file. It kicks off an embedded Apache Tomcat instance with the Sign Up test suite web application deployed. To kick off a second Driver just use a different console window and supply a different port number:

    $ alfresco-benchmark-signup$ mvn tomcat7:run -Dmongo.config.host=localhost -Dbm.tomcat.port=9083
        ...
    INFO: Starting ProtocolHandler ["http-bio-9083"]

3. Access benchmark server UI

    Browse to http://localhost:9080/alfresco-bm-manager

4. Create a Test

    Click [+] if not presented with "Create Test" options.  
    Fill in test details:   
        - Test Name: MyFirstTest01  
        - Test Description: Getting started 
        - Test Definition: alfresco-benchmark-tests-ent-signup-xxx
    Click "Ok".

5. Edit test properties

    It is a requirement that all test runs get told where to store the generated results.   
    Change property "mongo.test.host" to your mongo-host (e.g 127.0.0.1:27017)
    Click: "MyFirstTest01" on top left

6. Create a Test Run

    Click [+] if not presented with "Create Test Run" options.  
    Fill in test run details:   
        - Test run name: 01     
    Click "Ok".

7. Start the Test Run

    Click "Play" button next to Test Run "01".  
    The progress bar will auto-refresh as the test run completion estimate changes.

8. Download results

    At any time - usually when the test run completes - click through on the test run.  
    Click the download button and open the CSV file in a spreadsheet.

Release bm-load-users project

Please use this guide for the release process.

Contributing guide

Please use this guide to make a contribution to the project.