This code repository is no longer being actively managed by the Data To Insight Center at Indiana University Bloomington. Neither the center nor its principals assume responsibility for vulnerabilities that the code may have acquired over time.
See Wiki for description of the tool and a video showing its use. Data MatchMaker is a product of the NSF funded Sustainable Environments Actionable Data (SEAD) project under grant #OCI0940824. Data MatchMaker is available as open source under an Apache 2.0 license. Data MatchMaker is an improved and new version of the Matchmaker functionality available at https://github.com/Data-to-Insight-Center/Matchmaker.
Tomcat version 6 or above
Java 1.8
Maven 3
- Checkout the Data MatchMaker repository
git clone https://github.com/Data-to-Insight-Center/Data-MatchMaker.git
- Add Research Object, Repository and People profile templates to the source
Data-MatchMaker/src/main/resources/edu/indiana/d2i/matchmaker/profile
Sample profiles templates are already available in the source at https://github.com/Data-to-Insight-Center/Data-MatchMaker/tree/master/src/main/resources/edu/indiana/d2i/matchmaker/profile
You can define your own profile templates according to your application. Data MatchMaker will use these templates as a schema at runtime and will expect runtime profiles to be compatible with this schema.
- Build the module
cd Data-MatchMaker
mvn clean install -DskipTests
- Copy the .war file to tomcat/webapps folder
cp target/matchmaker-1.0.0.war CATALINA_HOME/webapps/mm.war
- Unzip mm.war
unzip CATALINA_HOME/webapps/mm.war -d CATALINA_HOME/webapps/mm
- Configure Data MatchMaker to retrieve people and repository profiles
This can be done in two ways;
-
Enable Data MatchMaker to retrieve profiles from a directory
Copy the Repositories and People profiles to mm/WEB-INF/classes/edu/indiana/d2i/matchmaker/profile/ directory. These are runtime profiles and those should be compatible with the templates added in Step 2. You can override the template files in the 'profile' directory if needed at this stage.
cp repositories.json person.json CATALINA_HOME/webapps/mm/WEB-INF/classes/edu/indiana/d2i/matchmaker/profile/Set parameters in mm/WEB-INF/classes/edu/indiana/d2i/matchmaker/util/matchmaker.properties configuration file to retrieve People and Repository profiles from a directory
cached.profile.repositories=../profile/repositories.json cached.profile.person=../profile/person.json -
Enable Data MatchMaker to retrieve profiles from an external REST API
Set parameters in mm/WEB-INF/classes/edu/indiana/d2i/matchmaker/util/matchmaker.properties configuration file to retrieve People and Repository profiles from an external REST API. Make sure you set "cached.profile.repositories" and "cached.profile.person" properties to empty values as we don't read profiles from local file system.
repo.list.rest.url=http://localhost:8082/sead-pdt/repositories repo.profile.rest.url=http://localhost:8082/sead-pdt/repositories repo.identifier=orgidentifier people.list.rest.url=http://localhost:8082/sead-pdt/people/list people.profile.rest.url=http://localhost:8082/sead-pdt/people people.identifier=@id'repo.list.rest.url' should list the repository profiles as a list of json objects and each json object should have the 'repo.identifier' field which can be used to get full profile information for each repository by appending that identifier to the 'repo.profile.rest.url'. Similarly 'people.list.rest.url' should list the people profiles as a list of json objects and each json object should have the 'people.identifier' field which can be used to get full profile information for each person by appending that identifier to the 'people.profile.rest.url'.
Please see the following documentation for more details about these REST endpoints;
https://github.com/Data-to-Insight-Center/PDT/wiki/Repository-Service https://github.com/Data-to-Insight-Center/PDT/wiki/People-Service
- Start tomcat
-
Configure and install Data MatchMaker as a web application by following the above steps.
-
Send a POST request to http://<host>:<port>/mm/mm/rest with the following request as the POST body
{
"@context": [
"https://w3id.org/ore/context"
],
"Rights Holder": "https://sead2-beta.ncsa.illinois.edu/api/users/568acec7f26f437b16cafac4",
"Aggregation": {
"Uploaded By": "https://sead2-beta.ncsa.illinois.edu/api/users/568acec7f26f437b16cafac4",
"Title": "test_dataset1 - new-cur-obj-test",
"Creation Date": "04-03-2016",
"similarTo": "https://sead2-beta.ncsa.illinois.edu/datasets/56966fc4e4b01d13f5ced4a5",
"Creator": ["0000-0001-9351-557X"],
"Abstract": ["Its a simple test"],
"Identifier": "https://sead2-beta.ncsa.illinois.edu/spaces/curations/56da04d7e4b09d159f672258",
"Publishing Project": "https://sead2-beta.ncsa.illinois.edu/spaces/56966fa6e4b01d13f5ced4a3",
"@id": "https://sead2-beta.ncsa.illinois.edu/api/curations/56da04d7e4b09d159f672258/ore#aggregation"
},
"Preferences": {
"Purpose": "Testing-Only",
"Repository": null
},
"Aggregation Statistics": {
"Data Mimetypes": [
"image/png",
"text/plain"
],
"Number of Datasets": 2,
"Number of Collections": 1,
"Max Dataset Size": "18317",
"Total Size": "11000000",
"Max Collection Depth": "2"
}
}
The result would be;
[
{
"orgidentifier": "sda",
"Per Rule Scores": [
{
"Score": 1,
"Message": "Total size is acceptable (<= 1000000000)",
"Attribute Type": "Critical",
"Rule Name": "Maximum Total Size"
},
{
"Score": 1,
"Message": "Collection depth is acceptable (<= 4)",
"Attribute Type": "Critical",
"Rule Name": "Maximum Collection Depth"
}
],
"Total": 2,
"repositoryName": "IU SEAD Cloud",
"Result": "Percentage of total attributes matched : 100.00% | Percentage of critical attributes matched : 100.00%"
},
{
"orgidentifier": "ideals",
"Per Rule Scores": [
{
"Score": 1,
"Message": "Total size is acceptable (<= 10000000000)",
"Attribute Type": "Critical",
"Rule Name": "Maximum Total Size"
},
{
"Score": -1,
"Message": "Collection depth is not acceptable (<= 1)",
"Attribute Type": "Critical",
"Rule Name": "Maximum Collection Depth"
}
],
"Total": 0,
"repositoryName": "IDEALS",
"Result": "Percentage of total attributes matched : 50.00% | Percentage of critical attributes matched : 50.00%"
},
{
"orgidentifier": "bob",
"Per Rule Scores": [
{
"Score": 1,
"Message": "Total size is acceptable (<= 10000000)",
"Attribute Type": "Critical",
"Rule Name": "Maximum Total Size"
},
{
"Score": 1,
"Message": "Collection depth is acceptable (<= 10)",
"Attribute Type": "Critical",
"Rule Name": "Maximum Collection Depth"
}
],
"Total": 2,
"repositoryName": "SEAD NDS Labs Publisher (Proof-of-Concept)",
"Result": "Percentage of total attributes matched : 100.00% | Percentage of critical attributes matched : 100.00%"
},
{
"orgidentifier": "openicpsr",
"Per Rule Scores": [
{
"Score": 1,
"Message": "Total size is acceptable (<= 10000000000)",
"Attribute Type": "Critical",
"Rule Name": "Maximum Total Size"
},
{
"Score": -1,
"Message": "Collection depth is not acceptable (<= 1)",
"Attribute Type": "Critical",
"Rule Name": "Maximum Collection Depth"
}
],
"Total": 0,
"repositoryName": "Inter-university Consortium for Political and Social Research",
"Result": "Percentage of total attributes matched : 50.00% | Percentage of critical attributes matched : 50.00%"
}
]
Documentation on command line executin of the Data MatchMaker is available at https://github.com/Data-to-Insight-Center/Data-MatchMaker/tree/master/samples.
-
Configure and install Data MatchMaker as a web application by following the above steps.
-
Web UI of the Data MatchMaker is available at http://<host>:<port>/mm/crud-table.html. There you can view the rules, edit rules and send requests with Research Object profiles to get matched repositories.