Building from Source

This page explains how to build the executable jar file from source code using maven. The jar file can be used as a library as well as a standalone executable.

Prerequisites

• Maven correctly installed (http://maven.apache.org/)
• The following projects are checked out:
  • org.opentosca.model.staticresources
  • org.opentosca.model.tosca
  • org.opentosca.yamlconverter.main
  • org.opentosca.yamlconverter.yamlmodel

Build process

1. Step

The first step is to make sure you have the following two artifacts installed in your local repository:

1. org.opentosca.model.staticresources
2. org.opentosca.model.tosca

This can be done by going into each subdirectory and executing mvn install on the command line. You need to install these artifacts in this specific order, as org.opentosca.model.staticresources is needed by org.opentosca.model.tosca

2. Step

Now that everything is prepared all you need to do is to execute mvn install in the main directory for the parent pom.

Two artifacts are going to be generated in /org.opentosca.yamlconverter.main/target:

• org.opentosca.yamlconverter.main-X.Y.jar
• org.opentosca.yamlconverter.main-X.Y-jar-with-dependencies.jar

The jar file with the dependencies can be used as a library and standalone executable. The jar file without the dependencies can be used if there are conflicts with the used resources.

Execution

Just execute java -jar org.opentosca.yamlconverter.main-X.Y-jar-with-dependencies.jar on your command line.

Note: The yaml converter does not have a gui. Everything needs to be done within the console ui.

Troubleshooting

If there are failing tests, append -DskipTests to the maven command. E.g. mvn install -DskipTests