Installing Sparx Enterprise Architect on MacOS

installing-ea-on-mac.md

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

2. install XQuartz (X server)

brew cask install xquartz

3. install wine

brew install wine

4. install winetricks

brew install winetricks

5. install the MSXML and MSDAC componentes

winetricks msxml3
winetricks msxml4
winetricks mdac28

4. 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

2. In the Script Editor, export the file as an Application using the menu File > Export ... and selecting Application as the format.

3. 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

2. 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

2. (Optional) Uninstall the wine

brew uninstall wine

3. (Optional) Uninstall homebrew

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/uninstall)"

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?

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?

Hi Jaime Thanks for the link. I tried it and get errors: Reinhards-MacBook-Pro:/ reinhard$ brew tap AtticX/fonts Reinhards-MacBook-Pro:/ reinhard$ brew cask install font-caladea Error: Cask 'font-caladea' definition is invalid: Token '{:v1=>"font-caladea"}' in header line does not match the file name. Reinhards-MacBook-Pro:/ reinhard$ brew cask install font-carlito Error: Cask 'font-carlito' definition is invalid: Token '{:v1=>"font-carlito"}' in header line does not match the file name. Reinhards-MacBook-Pro:/ reinhard$ I’m currently using version 14 (trail version) of EA. With a model made in version 13. Any ideas? Thanks.

…

On 21 Jun 2019, at 15:34, Jaime Chavarriaga ***@***.***> wrote: In the additional steps, I use a Homebrew script <https://github.com/AtticX/homebrew-fonts> I made to install some fonts and avoid some errors. What version of EA are you using? — You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub <https://gist.github.com/b38b64197695a0f083e5df65cf96c4b9?email_source=notifications&email_token=AEGUDSPIPL4JIQIUBOXWZCTP3TKE7A5CNFSM4H2PUXAKYY3PNVWWK3TUL52HS4DFVNDWS43UINXW23LFNZ2KUY3PNVWWK3TUL5UWJTQAFUCEK#gistcomment-2950213>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AEGUDSP5XWJFYTDQROHI2XDP3TKE7ANCNFSM4H2PUXAA>. [ { ***@***.***": "http://schema.org", ***@***.***": "EmailMessage", "potentialAction": { ***@***.***": "ViewAction", "target": "https://gist.github.com/b38b64197695a0f083e5df65cf96c4b9?email_source=notifications\u0026email_token=AEGUDSPIPL4JIQIUBOXWZCTP3TKE7A5CNFSM4H2PUXAKYY3PNVWWK3TUL52HS4DFVNDWS43UINXW23LFNZ2KUY3PNVWWK3TUL5UWJTQAFUCEK#gistcomment-2950213", "url": "https://gist.github.com/b38b64197695a0f083e5df65cf96c4b9?email_source=notifications\u0026email_token=AEGUDSPIPL4JIQIUBOXWZCTP3TKE7A5CNFSM4H2PUXAKYY3PNVWWK3TUL52HS4DFVNDWS43UINXW23LFNZ2KUY3PNVWWK3TUL5UWJTQAFUCEK#gistcomment-2950213", "name": "View Gist" }, "description": "View this Gist on GitHub", "publisher": { ***@***.***": "Organization", "name": "GitHub", "url": "https://github.com" } } ]

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.

Okay, submitted. Thanks so far!

…

On 21 Jun 2019, at 16:05, Jaime Chavarriaga ***@***.***> wrote: 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 it downloads. Please submit an issue report to the homebrew-fonts repository <https://github.com/AtticX/homebrew-fonts>. — You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub <https://gist.github.com/b38b64197695a0f083e5df65cf96c4b9?email_source=notifications&email_token=AEGUDSMTKDY4I5DFXFYLA53P3TNZVA5CNFSM4H2PUXAKYY3PNVWWK3TUL52HS4DFVNDWS43UINXW23LFNZ2KUY3PNVWWK3TUL5UWJTQAFUCFS#gistcomment-2950233>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AEGUDSN7Z647W3PSSENJBMLP3TNZVANCNFSM4H2PUXAA>. [ { ***@***.***": "http://schema.org", ***@***.***": "EmailMessage", "potentialAction": { ***@***.***": "ViewAction", "target": "https://gist.github.com/b38b64197695a0f083e5df65cf96c4b9?email_source=notifications\u0026email_token=AEGUDSMTKDY4I5DFXFYLA53P3TNZVA5CNFSM4H2PUXAKYY3PNVWWK3TUL52HS4DFVNDWS43UINXW23LFNZ2KUY3PNVWWK3TUL5UWJTQAFUCFS#gistcomment-2950233", "url": "https://gist.github.com/b38b64197695a0f083e5df65cf96c4b9?email_source=notifications\u0026email_token=AEGUDSMTKDY4I5DFXFYLA53P3TNZVA5CNFSM4H2PUXAKYY3PNVWWK3TUL52HS4DFVNDWS43UINXW23LFNZ2KUY3PNVWWK3TUL5UWJTQAFUCFS#gistcomment-2950233", "name": "View Gist" }, "description": "View this Gist on GitHub", "publisher": { ***@***.***": "Organization", "name": "GitHub", "url": "https://github.com" } } ]

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.

Excellent!
Thank you!

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.

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

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

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"

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

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.

• https://github.com/Gcenx/wine-on-mac