Frequently Asked Questions

Performance/Memory

LemonTree is slow, what can I do to improve performance?

Hardware

LemonTree needs strong hardware to quickly load, diff and merge models. We recommend a recent middle-class CPU (i5, Ryzen, Xeon E3 at the time of writing), paired with a large amount of RAM (16+GB in Dual Channel configuration). LemonTree parallelizes its most demanding tasks, so these are the most important metrics for LemonTree to run fast:

1. Number of physical cores
2. Speed of those cores
3. Available memory
4. Memory bandwidth

Processing Power

Enterprise Architect uses a legacy version of Microsoft Access to store the data for .eap(x) models. Both reading and writing models needs to utilize appropriate drivers to interact with the .eap(x) models, which are notoriously slow.

This puts a natural limit on any performance improvements we can include in LemonTree.

Unfortunately, this also means that better hardware can only improve performance up to a point. Don't expect big performance gains from server class hardware.

Memory

LemonTree needs to load representations of up to 3 different models into memory to efficiently perform both the diff and merge. These representations LemonTree are built to ensure maximum processing speed, and may require significantly more RAM than the required disk space of the model. If your computer can supply the necessary RAM to do so, this does not have an adverse effect on the performance of LemonTree.

However, once the memory usage of a computer approaches the hardware maximum, a process known as memory swapping sets in. Parts of the current RAM are written to the harddisk so they can be re-used, and the data is retrieved from the harddisk. While this technique provides additional RAM, the switch itself is excessively slow. As such, once a LemonTree diff/merge requires memory swapping to be used, it will still complete, but it will take a multiple of the otherwise required time.

LemonTree Version

We're always looking for ways to improve the performance of LemonTree. As such, it's a good idea to always keep your version of LemonTree up-to-date to ensure optimal performance.
More details on the development of performance and memory consumption of different LemonTree versions can be found here:

Performance and Memory

Installation

Is a silent install possible and can I exclude optional features during the silent install?

The silent install and the exclusion of optional features is possible. In our example, we install LemonTree 3.1.0 without the EA-Addin feature. Open the command prompt with the key combination [Windows] + [R] and the command "cmd". msiexec /i LemonTreev3.1.0.msi ADDLOCAL="all" REMOVE="EAAddinFeature" With this command, the UI will still show, but the optional feature "Addin for Enterprise Architect" is excluded

To use this within a silent install (no UI) the /q ensures unattended installation. msiexec /i LemonTreev3.1.0.msi ADDLOCAL="all" REMOVE="EAAddinFeature" /q

Functionality

Does LemonTree support diffing/merging my entire model?

Due to the complexity of data of the various model types supported by LemonTree, and LemonTree's mechanism of accessing this data (by reading the stored data directly), there is unfortunately no way to accurately judge if all data stored in your model will be correctly diffed/merged.
We are currently working on a comprehensive evaluation of this topic, but the results are still unfinished.
For now, we are maintaining a list of Enterprise Architect features which are not supported by LemonTree, which you can find here:

EA Features not supported by LemonTree

LemonTree is reporting that my model has inconsistencies. What happened? What can I do?

This is a complex topic, unfortunately, but we'll do our best to help. Please see the separate page on this topic:

Inconsistencies

My model has a lot of changes related to DIAGRAMIMAGEMAP elements. What happened? What can I do?

These DIAGRAMIMAGEMAP elements are cached copies of diagrams in your model. They are created for Enterprise Architects Cloud solution. EA is not able to render diagrams directly in the cloud and thus caches image copies into the model. This is a setting that can be configured for each model via the Cloud section of Model settings, which can be found in the “Configure” tab.

See https://sparxsystems.com/enterprise_architect_user_guide/16.1/modeling_fundamentals/cloud_page.html

As a workaround we suggest to disable this option in the Cloud settings and clearing the cache when asked. This way any operation can be performed with a reduced model size and without those elements flooding your session. Once you are done, this setting can be enabled again. There is also the option to regenerate the whole cache via “Batch create Diagrams cache”.

Text in the Tree Browser is partially cut off. How do I see the whole text?

The GUI of LemonTree is a HTML-GUI. So the features of HTML are available.

Use "Shift" and the mouse-wheel to scroll horizontally.

During merging .EAP or .EAPX files I am running into an lock count exceeded Error message. What can I do?

We recommend switching to .QEAX file format. You can transform your model to .QEAX file format, do the merge and then transform, if needed, to .EAP or .EAPX file format again.

Alternatively you can increase the MaxLocksPerFile to 70.000 or higher. This should allow the useage of .EAP and .EAPX files. For that you can use the registry file that should set both 3.x and 4.0 Jet values to 70.000 automatically.

Increase MaxLocks registry file download

Or you do it manually and set the value MaxLocksPerFile twice to 70.000. HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Jet\4.0\Engines\Jet 3.x HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Jet\4.0\Engines\Jet 4.0

WMF and EMF pictures are not supported anymore. How can I check if this is relevant for my model?

You can check if this is relevant for your model using the following SQL queries.

select * from t_image where type like "%Metafile%"

select * from t_stereotypes WHERE Metafile IS NOT NULL AND MFEnabled = 1

How to deal with packages that have different GUIDs in t_object and t_package?

If LT shows duplicate packages and/or shows model inconsistencies like this: Base| Warning|Element is a package in t_object without matching entry in t_package.|{546E2F35-CA55-422e-BA32-42D74EDB8C43}|52000000

You can proceed and remove the 'empty' package, or abort the merge open the model with the duplicate package in EA and run the integrity check with the option Package Structure enabled.

The package in question should show up in the check and can be fixed with the Recover/Clean option.

Licensing

I have troubles installing the RLM License Server for Floating licenses. What can I do?

Take a look at the RLM License Server FAQs or on the detailed installation guide Installation of Floating License Server.

Version Control Systems

Which GIT server to choose and how to connect it with LemonTree?

LemonTree is only installed on the GIT client and only needs to be configured there.

It is irrelevant which Git server (i.e. Github, BitBucket, DevOps, GitLab, etc.) is used, the decisive factor is the VCS client.

That's why LemonTree is so versatile because there is no dependency on a server, but only one VCS client has to be configured with LemonTree.

Which VCS client to choose and how to connect it with LemonTree?

The easiest way is to use TortoiseGit or SmartGit(recommended) and install those tools before LemonTree.

If LemonTree is then installed it will be automatically entered in the VCS client as diff and merge tool and from then on you work with git, as usual, i.e. clone project, add EA project, commit and push.

To integrating LemonTree into other VCS clients check VCS-Integration section or contact us.

Are there any recommendations on how to setup my git repository?

Yes, we recommend to enable LFS for all EA model types via .gitattributes and add *.ldb to your .gitignore. This minimizes potential problems with bigger models and ensures no temporary EA files are being pushed to your repository.

*.eap filter=lfs diff=LemonTree merge=LemonTree binary
*.eapx filter=lfs diff=LemonTree merge=LemonTree binary
*.qea filter=lfs diff=LemonTree merge=LemonTree binary
*.qeax filter=lfs diff=LemonTree merge=LemonTree binary

*.ldb

Miscellaneous

Where do I find the logfiles of LemonTree?

Logfiles can be downloaded via the burger menu.

Alternatively they can also be found directly in %appdata%\LieberLieber\LemonTree\logs

If you've discovered any irregularities, please don't hesitate to report an issue. Details can be found here:

Report an Issue

Why can't I use LemonTree Components with the new QEA file format?

QEA is meant as a single user personal file format, meaning the internal SQLite database is locked during EA runtime.

As a result we opted to just support QEAX for our Components workflow.

QEAX support everything else that QEA can do and converting is as simple as changing the file extension.

Which formats are supported by LemonTree?

LemonTree can use the following formats for the diff and merge:

All types of EA repositories (except Cloud Repositories and Firebird)

• EAP/EAPX
• QEA/QEAX
• OLEDB / ODBC
• Native drivers (from EA 16)
• MPMS Format (LemonTree Format used for LemonTree Components)
• MMS files (OpenMBEE format)
• Magic Draw Files

Unfortunately, XMI files from EA or baselines or RAS components cannot be compared with LemonTree.

The LemonTree Components are ideal for working with LemonTree at package level and managing them as reusable parts. Similar to XMI exports, the components are an extract from a model, which can be imported and synchronized in another model. This allows you to cover similar functions as with the RAS.

Which Database does LemonTree support offically?

We officialy support and actively test LemonTree with MSSQL, MySQL and MariaDB. Besides those we support most of the common database types, with one noteable Exception being PostgreSQL.

Does LemonTree work with encrypted EA connection strings?

No, LemonTree does not support encrypted connection strings.

Why do I receive a merge window when I publish components?

The component has already been published and changes have been made. If you publish again, LemonTree is called for the merge. To be more precise; The base version of the model is different from the one in the folder and the current version of the model (which was changed local) is different and published. LemonTree is called for the merge and does this automatically if the same elements in the model have not been changed.

How to solve the Error - Missing (0x80040154)?

Open the command prompt with the key combination [Windows] + [R] and the command "cmd". Run the following commands wiht admin rights:

C:\Windows\Microsoft.NET\Framework\v4.0.30319\regasm "C:\Program Files\LieberLieber\LemonTree\Proxy\LemonTree.EAAddin.Proxy.dll" /unregister
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\regasm "C:\Program Files\LieberLieber\LemonTree\Proxy\LemonTree.EAAddin.Proxy.dll" /unregister
C:\Windows\Microsoft.NET\Framework\v4.0.30319\regasm "C:\Program Files\LieberLieber\LemonTree\Proxy\LemonTree.EAAddin.Proxy.dll" /codebase
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\regasm "C:\Program Files\LieberLieber\LemonTree\Proxy\LemonTree.EAAddin.Proxy.dll" /codebase

In the case the solution above does not work the next step would be to check it out via EA Installation Inspector. Since you have a lot of Addins the output might be hard to interpret but we would like to see the entries of the LemonTree.EAAddin.

Link to tool: EA Installation Inspector Please send screenshots to support@lieberlieber.com

What to do if the Addin doesn't show up at all?

Try the steps above, especially running the regasm commands. If that doesn't help and your are using only the 64-Bit version of EA you can also try to add the following entries to your registry:

[HKEY_LOCAL_MACHINE\SOFTWARE\Sparx Systems\EAAddins\LemonTree.EAAddin]
@="LemonTree.EaAddin.Proxy.LemonTreeEAAddinProxy"

[HKEY_LOCAL_MACHINE\SOFTWARE\Sparx Systems\EAAddins64\LemonTree.EAAddin]
@="LemonTree.EaAddin.Proxy.LemonTreeEAAddinProxy"

What is the repository in the component's context?

The repository is the collection of mpms files - basically, the folder(s) configured to publish and import. (The folder(s) where all mpms files are collected.)