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

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 the 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 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 please check the Licensing or contact support@lieberlieber.com.

Logging

Lemontree Automation logs to the console by default. This output can be redirected to a file, methods here differ on the console used but usually the > operator is used.

Every command can be extended with a --verbosity option to set the logging level. Allowed values are:

  • quiet (default)
  • minimal
  • normal
  • detailed
  • diagnostic

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)