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)"