Getting started
LemonTree.Connect.Automation is a CLI-based version of LemonTree.Connect, which allows an automated import and export of elements and relationships between Codebeamer and Enterprise Architect. It is meant 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
Zipped Deployment
You can download the latest version from our nexus server via
Invoke-WebRequest -Uri https://nexus.lieberlieber.com/repository/lemontree-release/LemonTree.Automation/LemonTree.Connect.Codebeamer.Automation_latest.zip -outfile "lta.zip"
Just extract to a folder of your choice and you are ready to go.
Basic Functionality
LemonTree.Connect.Automation supports the two main LemonTree.Connect functionalities:
Info
Please note that LemonTree.Connect.Automation for Codebeamer currently does not support OIDC.
Licensing
Only floating style licenses are available for LemonTree.Connect.Automation. To deliver this license to your agent you can either utilize a central rlm server or use our RLM Cloud service. 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 requester line.
HOST (Hostname) ANY (Port)
This file has to be either in the same working directory as your executable or be added to any command via --license argument.
If a folder is specified, the first found .lic license is used.
For more information on our licenses in general or to if you are interested in a trial please check Licensing or contact support@lieberlieber.com.
Logging
All commands can be extended with --extendedlog and --log option to ensure a specific path is being used for logging files.
Exit codes
The following exit codes can be produced by LemonTree.Connect.Automation:
Some consoles only use postive numbers between 0 and 255 as exit codes, in those cases -2 and -1 are converted to 254 or 255 respectively.
| Exit Code Windows | Exit Code Linux | Description |
|---|---|---|
| -3 | 253 | Password/Token are empty or incorrect |
| -2 | 254 | General Error handled during application execution (import and export) |
| -1 | 255 | Error during parsing of command line parameters. |
| 0 | 0 | Command completed successfully. |
| 1 | 1 | Error with license (see Chapter Licensing) |