Instructions how to get access to MSP3 tool and source code
Make sure you have the following tools before you want to run MSP3 tool
locally ( Recommended)
1. Apache Tomcat 7 ( Application Server )
2. Eclipse IDE ( INDIGO )
3. JDK 1.7
Install the Java RI version of Direct. See
Install Apache Directory Server and Apache Directory Studio. These are open source
tools that can be found online.
Create certificates off of one anchor that comply with the test data matrix found in
the test data matrix tab of the latest Mod Spec Phase 3 Test Package found here:
Using the test data matrix, load the certificates into either the LDAP servers (using
Apache Directory Server and Apache Directory Studio) or the DNS (using the Direct Reference
Implementation) . Install the anchor into your Direct RI for each domain that you created. Be
sure to update the config.xml file for the Direct RI to match whatever domains you are using.
Adding Maven Plugin.
From Eclipse → click on Help
... and Enter
Click on Maven Integration for Eclipse and Install.
Adding MSP3 Tool into Eclipse locally.
In Eclipse →
Click on → File
Import → Checkout Maven Projects from
Enter → URL →
Click → Finish
Now you will have MSP3 Tool in your local IDE
Once you install Maven will sync with the repository and will get all the dependencies required for MSP3 tool
and it might take up to 5 mins to index the dependencies.
Adding Server to local IDE →
: Select File(Top Left Window) → New → Other →
You will then see ...
: Select a Wizard:
Type in the box → server → Select the Server and Click Next [You will see bunch of different
: Under Apache: Select Tomcat v7.0 Server and click Next
Then you will the Window:
Tomcat Server (Specify the installation directory)
: Click Browse and point to the location where you downloaded (apache-tomcat-7.0.27)
and Click Finish.
In Eclipse you will then see Server ( in Package Explorer ) when you click that you will see the
folder (Tomcat v7.0 Server at Localhost-config)
Adding required configuration files for MSP3 tool .
Go to →
Tomcat Home Folder →
(Create folder name) direct →
Create two files
Download EML and Certs files
The files are located on this page under the “Test Team” area:
Go to →
Add the location of the Certificates that you downloaded to the above config.properties file. The
Email location is the path to where the raw messages are received by your Direct server.
In the same file (config.properties), add information about a gmail account that can be used to
send the response emails:
#Return Email Address Info
Run MSP3 tool locally on Tomcat →
Right click on the project →
Run as →
Run on Server → Tomcat 7
Go to your browser Enter
MSP3 TOOL Up and Running in your Local Environment