Got a question about Modelio? Find the answer here.

icon whatis


If you have a question about how to use Modelio and how to use it, the Modelio FAQ is the best place to start looking for an answer.


The questions published in our FAQ have been submitted by users and developers alike. Try our forums if you have a question that's not addressed here.


You try to launch Modelio on Ubuntu and you receive the following error : "An error has occurred. See the log file /$modelio_installation_directory/workspace/.metadata/.log".
First of all, check that Java is installed on your system. Please note that from version 3.3, Modelio requires Java 8. Older versions of Modelio require Java 7.
For Modelio 3.3 (and earlier versions), you have to check that Java 8 is installed on your system and set as default version.
If you don't have Java 8, you need to install it. In a shell command, use the following commands:

$ sudo add-apt-repository ppa:webupd8team/java
$ sudo apt-get update
$ sudo apt-get install oracle-java8-installer

Verify the java version. In a shell command, type "java -version". It should return java version "1.8.0_xx".
If it does not return Java 8 we suggest you to install a packaging for configuring Java Environment:

$ sudo apt-get install oracle-java8-set-default

Once Java 8 is set as default, Modelio should run.

It seems that this problem occurs on Ubuntu since the version 13.10. To workaround this problem, on your terminal, before running Modelio, set the UBUNTU_MENUPROXY environment to the value '0': env UBUNTU_MENUPROXY=0 ./modelio

Modelio 3 is compatible with MacOS X (10.8.5 and above). To function properly, Modelio requires the JDK (not only JRE). Before Modelio 3.3, it requires the JDK 1.7. From Modelio 3.3, it requires the JDK 1.8.
From MacOS X 10.7.3, it is possible to install JDK 7 on the system (How to install JDK 7 for Mac).

For previous versions of MacOS X, JDK 7 is not officially supported but it is possible to force the installation of JDK 7:

  1. Download JDK 7
  2. Install Pacifist (shareware software)

  3. Open the .dmg with pacifist (right click open with...)

  4. Run the .pkg from within pacifist (this overcomes the restriction that JDK7 cannot be installed on less than OSX 10.7)

  5. Change the order of preferred JREs in /Applications/Utilities/Java Preferences.app - drag JDK10.7 to the top of the list

  6. Open a new command window

  7. $./modelio

Please note that this is a workaround and it is not an official solution. We cannot guarantee that Modelio works correctly with this configuration.

Thanks to Illustrious (on the forum) for this workaround.

In Windows, the Modelio log file is located in the Modelio installation directory, at the same level as the modelio.exe file.

In Linux, the Modelio log file is located in the .modelio folder.

-nl $language lets you change the language Modelio is run in. Currently you can run Modelio in English (en) or in French (fr).

-workspace "$path" lets your specify the path of the Modelio workspace.

- consoleLog is used to display a window that shows all the message sent to the Modelio log file.

- vmargs -Xmx512M is used to define the size of the VM memory.

If you run into an OutOfMemoryError type error when using Modelio, this means that the amount of memory allocated to the associated VM (virtual machine) is not sufficient for processing. You can increase the amount of memory  y adding the -vmargs argument to the properties of the Modelio shortcut.

For example, to specify 512 MB of memory, add the following argument to the properties of the Modelio shortcut:

[previous arguments] -vmargs -Xmx512M [other arguments]

To save a diagram as an image in PNG or JPEG format, use the "Save diagram in a file" command in the tool bar on the top left of a diagram.

Models can be exchanged between Modelio and other tools used XMI. Modelio provides a features that enables models in the following formats to be exchanged: UML/EMF 3.0.0, OMG 2.1.1, OMG 2.2 and OMG 2.3.

To zoom in or zoom out in a diagram, just hold down the Ctrl key and roll the mouse wheel forward or backwards as you wish.

Yes, it is possible to decorate any diagram's background with a specific image, such as a company logo. Just open the diagram in question and left-click in the background. In the "Symbol" view, you'll see a "Fill image" field, in which you can enter a path to an image file. The specified image will then be applied to the diagram.

To decorate several diagrams quickly, you can define a style using the style editor. Set the "Fill image" property for diagram to the image of your choice, and then use that particular style for your diagram (or any style derived from it).

Note that the image will be stretched to fit the diagram's "Page size", which is another property of the style of a diagram.

To change the background colour of all your diagrams without having to manually modify each one, modify the "Background color" for the type of diagram concerned. The background color of all diagrams of this type in your project will then automatically be changed.

To automate processing in Modelio, create a Java module or Jython macro, which will use the Java API provided by Modelio.

Modelio is a practical implementation of the UML and BPMN standards. If you look at the Modelio metamodel and know the standards, you will immediately understand the metamodel.Differences may exist where there exist failures in the standards, or elements that need to change. Because we participate in and follow UML standardization and UML RTF, we are well aware of such problems.We also introduce shortcuts or facilities to make modeling easier and more comfortable for end users. BPMN/UML is an example of this (two standards within the OMG that are not connected although there are commonalities). In addition, the core Modelio infrastructure supports only single inheritance, and writing the UML metamodel using single inheritance only actually clarifies the metamodel.

Compliance is the key when it comes to interoperability: XMI support. Modelio is one of the tools that participates in the OMG's Model Interchange Working Group (MIWG), which ensures that XMI model exchange works peer to peer with the main UML modeling tools. Modelio fully supports the standard UML XMI exchange.

No. Modelio uses its own modeling infrastructure, whose principles are similar to those of EMF (metameta core leve, metamodel definition, generic services supporting a metamodel, generic model handling API, ...). This architecture has been continually improving since its first use in Objecteering in 1996. It is robust, can handle a large number of end users, and provides a unique model element identification mechanism, meaning that a move to EMF would not present any advantages.

To run Modelio in a different language, just edit your Modelio shortcut and add the "-nl XX" argument at the end of the command line, where "XX" is the language code of the language in question. You can use this argument to run Modelio in any language it supports. If you try to run Modelio in a language which is not supported, it will run in English by default. If the language of your choice isn't yet supported, why not get involved in the Modelio community by working on a translation?

Modules can be deployed in an existing project at any time. To do this, simply run the "MDA / Install a module" command in the toolbar and then select the module(s) of your choice in the explorer.

Modelio is licensed under a GPL license. Any software including Modelio source code must be distributed under the GPL license (not commercial). However, you can develop your own module to adapt Modelio diagrams to your target, to generate tests or to couple to your generation environment. As the module runtime is under Apache license, you can distribute the module you develop using your commercial license and your distribution schema.

Open source modules come from the Modelio community. They can be licensed under APL or GPL licenses (or any open source licence that can integrate Apache licensed module runtime - in other words, almost all of them), depending on the wishes of the authors. However, module authors are free to license their modules however they choose. Modules can have a commercial distribution, either sold at a given price or free (no cost but under commercial license).

This is more a question for Modeliosoft than for the Modelio community, but the answer is yes you can. Modeliosoft solutions are based on the Modelio core and both can be used alongside one another without any problems. Just make sure that you are using the open source version recommended by Modeliosoft.

^ Back to Top