Skip to content

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:

Import

Export

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)