Skip to content

Instantly share code, notes, and snippets.

@JaimeChavarriaga
Last active October 3, 2024 11:01
Show Gist options
  • Save JaimeChavarriaga/b38b64197695a0f083e5df65cf96c4b9 to your computer and use it in GitHub Desktop.
Save JaimeChavarriaga/b38b64197695a0f083e5df65cf96c4b9 to your computer and use it in GitHub Desktop.
Installing Sparx Enterprise Architect on MacOS

Installing Sparx Enterprise Architect on MacOS

Installation

There is not a MacOS-native executable of Enterprise Architect on Mac. In order to run it, it is possible to use Wine, a software to run windows applications on Linux and Mac. Sparx has a webinar and a documentation page explaining how to install EA into Linux using Wine. However, these instructions do not provide a step-by-step guide for MacOS

The following are instructions to install EA on MacOs using Homebrew.

  1. install homebrew
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

after installing homebrew, chevk if the installation is complete

brew doctor

if you have not installed brew (or other apps) before, you need to install some tools required by homebrew

brew install git
xcode-select --install
  1. install XQuartz (X server)
brew cask install xquartz
  1. install wine
brew install wine
  1. install winetricks
brew install winetricks
  1. install the MSXML and MSDAC componentes
winetricks msxml3
winetricks msxml4
winetricks mdac28
  1. download the EA installer and install the enterprise architect
wine msiexec /i easetupfull.msi  # for the registered version
wine msiexec /i easetup.msi      # for the trial version

Run Enterprise Architect

  1. EA is installed in the .wine directory of the current user. You can run the EA using
cd ~/.wine/drive_c/Program\ Files\ \(x86\)/Sparx\ Systems/EA\ Trial
wine EA.exe

Creating a Dock Icon for Enterprise Architect

In order to add a Dock icon that lauches the EA, it is possible to create an AppleScript.

  1. Create a Script using the Script Editor located at /Applications/Utilities.
tell application "Terminal"
    do script "/usr/local/bin/wine ~/.wine/drive_c/Program\\ Files\\ \\(x86\\)/Sparx\\ Systems/EA\\ Trial/EA.exe"
end tell
  1. In the Script Editor, export the file as an Application using the menu File > Export ... and selecting Application as the format.

  2. Open the folder with the application file and drag it to the Dock.


(Optional) Additional installation Steps

Install Carlito and Caladea fonts

If you do not have installed MS Office or MS OneNote, you may need to install the Carlito and Caladea fonts as substitutes for the Calibri and Calisto. This will prevent differences on the visualization of the models.

  1. install carlito fonts
brew tap AtticX/fonts                  # you only have to do this once!
brew cask install font-caladea
brew cask install font-carlito

Install ODBC drivers

If you are using external databases as repositories for the models, you need to install the corresponding ObDC driver.

  1. Install the ODBC component
winetricks jet40
  1. Install the corresponding ODBC driver. First download the relevant installer and then run a command such as:
wine msiexec /i mysql-connector-odbc-3.51.25-win32.msi

The following are drivers that you can consider to download and use

RDBMS ODBC driver Download URL
MySQL 5.2.5 http://dev.mysql.com/downloads/connector/odbc/
Postgresql 9.05.0400 http://www.postgresql.org/ftp/odbc/versions/msi/

Uninstalling the Software

  1. Uninstall the EA software
wine uninstaller
  1. (Optional) Uninstall the wine
brew uninstall wine
  1. (Optional) Uninstall homebrew
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/uninstall)"
@ReinhardSt
Copy link

ReinhardSt commented Jun 21, 2019

Great guide! Works flawlessly.
But when EA is running there are many Font problems. E.g., Error: CreateOneFont(e), Error: GetNewFont2, etc.
Did you encounter these as well?
If yes, how did/do you fix these?

@JaimeChavarriaga
Copy link
Author

In the additional steps, I use a Homebrew script I made to install some fonts and avoid some errors.

  • What version of EA are you using?

@ReinhardSt
Copy link

ReinhardSt commented Jun 21, 2019 via email

@JaimeChavarriaga
Copy link
Author

JaimeChavarriaga commented Jun 21, 2019

Ok. The Homebrew recipe is trying to download some fonts, but these fonts have been updated. The version expected by the script is not the same that it is downloading. Please submit an issue report to the homebrew-fonts repository.

@ReinhardSt
Copy link

ReinhardSt commented Jun 21, 2019 via email

@roba87
Copy link

roba87 commented Jun 25, 2019

Hello, I made a installation according to your guide. Everything looks good, but in case of connection to server with connection string is there a error "2147467261". Do you have any ideas, what is wrong? Thank you for help.

@ErichGB
Copy link

ErichGB commented Aug 3, 2019

Excellent!
Thank you!

@MichaelKubovic
Copy link

For the failing cask font installation I've created PR AtticX/homebrew-fonts#3

Those fonts were not enough in my case. Starting EA with debug output WINEDEBUG=warn+all wine EA.exe revealed what fonts were missing in my case, causing the "CreateOneFont" errors.

0058:warn:font:OpenFontFace failed to map L"/Library/Fonts/Microsoft/Century Gothic"

I've sourced the font, copied over to /Library/Fonts/Microsoft and the problem disappeared.

@josefpolach
Copy link

Maybe add information that this does not apply for Catalina 10.15 and above.

@adityaditiket
Copy link

adityaditiket commented Feb 5, 2021

Successfully install on my mac 10.13.4 (17E199) high sierra. Having problem related 64 vs 32 bit compatibility issue. Following this instruction https://askubuntu.com/questions/177192/how-do-i-create-a-32-bit-wine-prefix and work as fine 👍

Make sure before following step by step above already configure wine as win 32 bit.

WINEARCH=win32 WINEPREFIX=~/.wine wine wineboot

if after restart wine, and still configured as 64 bit, then we need to remove all wine config

rm -r -f ~/.wine

then

WINEARCH=win32 WINEPREFIX=~/.wine wine wineboot

@niepiekm
Copy link

niepiekm commented Apr 21, 2023

Thank you for this writeup. I have one tip you may like.

If you change the script to the version below, no Terminal window is opened.

do shell script "/usr/local/bin/wine ~/.wine/drive_c/Program\\ Files\\ \\(x86\\)/Sparx\\ Systems/EA\\ Trial/EA.exe"

@asgilife
Copy link

asgilife commented Aug 5, 2023

I have not been able to install wine on M1 and M2 processors, what option is there for these processors?

@JaimeChavarriaga
Copy link
Author

I have not been able to install wine on M1 and M2 processors, what option is there for these processors?

Considering that the EA binary is for Windows, you need Wine or a Virtual Machine to run ir on Mac.

You may try some instructions to install Wine on M1 and M2.

@juanse01r
Copy link

Instale EA en mi mac pero no me permite importar directorios, sabes como puedo solucionarlo?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment