Getting Started
LemonTree.Connect.Automation is CLI-based version of LemonTree.Connect, which allows an automated import and export of elements and relationships between Jama Connect and Enterprise Architect, to be deployed on build agents for the integration in build pipelines such as Jenkins, TeamCity, Azure DevOps, GitHub Actions or similar tools.
How to Install LemonTree.Connect.Automation
There are few general ways to setup LemonTree.Connect.Automation. We recommend a zipped deployment for most use cases.
Zipped Deployment
You can download the latest version from our server via
Invoke-WebRequest -Uri https://nexus.lieberlieber.com/repository/lemontree-release/LemonTree.Automation/LemonTree.Connect.Jama.Automation_latest.zip -outfile "lta.zip"
Just extract to a folder of your choice and you are ready to go.
Zipped Linux Deployment
Download and unzip on a Linux Machine and run
Invoke-WebRequest -Uri https://nexus.lieberlieber.com/repository/lemontree-release/LemonTree.Automation/LemonTree.Connect.Jama.Automation_latest.zip -outfile "lta.zip"
Just extract to a folder of your choice and you are ready to go.
Licensing
Direct license deployment
To get more details how to use a license please refer to the license section.
Remote deployment
Another approach is to supply the license with each command. Just add --license command with the path to your .lic file. In our example repositories we typically store the "License Text" in a Secret and create the .lic file on the fly when we execute the build script.
--license C:\Path\To\your\License.lic
Floating license
Last option is to utilize a central rlm server adding your license(s) to it. This way your agents only request their license during runtime managing check-out and -in automatically. You still need a .lic file locally but with only one line.
HOST (Hostname) ANY (Port)
For more information see Licensing Floating.
Basic Functionality
LemonTree.Connect.Automation supports two main functionalities by commands:
Import: Imports elements from Jama Connect based on a 'Package' guidExport: Exports elements to Jama Connect based on a 'Package' guid
Also there is always the possibility to get more information with the command
help: Display more information on a specific command