How to Run Stand-Alone IPF Applications

All the applications that IPF produce get pushed to ipf-releases in Nexus. The runnable jars will be available as an artifact with a suffix of runnable in the Nexus repository for each version of the application you need. For example if you want to fetch the ODS ingestion runnable jar for version 2.1.2 you would find it at this link: nexus.ipf.iconsolutions.com/repository/ipf-releases/com/iconsolutions/ipf/ods/ods-ingestion-app/2.1.2/ods-ingestion-app-2.1.2-runnable.jar

When building an IPF application using the scaffolder projects both the container and runnable will be generated in the pom.xml.

If you want to generate the runnable you will need to invoke the runnable profile as follows:

All IPF runnable jars are produced as Spring Boot applications. To run an IPF application, taking the ODS ingestion jar above as an example, you would execute the following:

If you are overriding any of the default configuration for the applications then, in this example, the configuration file for the application, application.conf, would live in the config folder as defined by :config. We then leverage the Spring Boot PropertiesLauncher to load the properties into the application.

Currently, our docker images are already instrumented with the cinnamon agent jar for connector metrics reporting. This was not possible when producing the runnable jar as we are not in control of the deployment, which is up to the client. More information on connector metrics is available here.

To enable cinnamon metrics on runnable jars you would need to download the correct version of the cinnamon jar. The correct version to download will be in the BOM under the property cinnamon.version. The jar will also be inside the runnable jar itself and can be extracted from the jar. Add the javaagent when running the java program as follows: