Prev | Next |
Installing Enterprise Architect under macOS
This page describes how to install and upgrade Enterprise Architect on macOS environments using Wine. This applies for Mac OS 10.8 - 10.14.
For installation on macOS 10.15 and later, see the Installing Enterprise Architect using CrossOver (macOS) Help topic.
Download and Install Wine
Go to the WineHQ website, https://www.winehq.org, and download the latest version of Wine that is available for the version of macOS that you are running. We recommend using a 'stable' version of Wine rather a 'development' version. Follow the instructions provided on the WineHQ website for installing Wine.
Download 'Winetricks'
Winetricks is a helper script that assists with the installation of a number of run-time libraries required by Enterprise Architect.
The web page https://wiki.winehq.org/Winetricks provides a link to the 'winetricks' file, which is currently:
https://raw.githubusercontent.com/Winetricks/winetricks/master/src/winetricks
Note: The 'Winetricks' web page can also be located by searching for 'winetricks' on the WineHQ website.
Step |
Action |
---|---|
1 |
Using an Internet browser, navigate to the web page: https://wiki.winehq.org/Winetricks |
2 |
Locate the file link https://raw.githubusercontent.com/Winetricks/winetricks/master/src/winetricks Right-click on the file link and save the file locally as '/Applications/winetricks'. |
3 |
If the file is saved as 'winetricks.txt', rename it as 'winetricks'. In a Terminal window, issue the command:
|
4 |
Change the permissions of 'winetricks' to make it executable. In a Terminal window, issue the command:
|
Use 'Winetricks' to Install Run-Time Libraries
Use the helper script ‘winetricks’ to install the run-time libraries MDAC28, MSXML3 and MSXML4, which are required by Enterprise Architect.
Step |
Action |
---|---|
1 |
On your Mac, use 'Finder' to open the 'Applications' folder. |
2 |
Double-click on 'Wine' (or 'Wine Stable') to open a Terminal window that is configured to use the Wine environment. |
3 |
In the Terminal window, issue these commands:
Note: If or when you apply Wine updates to your system at some later date, they might interfere with the mdac28 module, preventing it from running. To avoid any issues, it is good practice after installing Wine updates, to run this command:
|
Install Jet 4.0 Database Engine
By using the Jet 4.0 database engine, Enterprise Architect can access database files that employ Unicode character encoding.
To install 'jet40', we will use 'Winetricks'. However, we must first install 'Homebrew' - which is a Package Manager for macOS - and 'cabextract' - which is software for extracting files from Microsoft cabinet files.
Step |
Action |
---|---|
1 |
Install 'Homebrew' 'Homebrew' is an unofficial Package Manager for macOS. To install 'Homebrew', open a Terminal window and issue this command: ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" < /dev/null 2> /dev/null Note: It will take a few minutes to download and install all of the required components. |
2 |
Install 'cabextract' The 'cabextract' application is software that is employed by 'Winetricks' to extract files from Microsoft cabinet files. To install 'cabextract', open a Terminal window and issue the command:
|
3 |
Install Jet 4.0 Database Engine Using 'Finder', display the Applications folder. Double-click on 'Wine' (or 'Wine Stable') to open a Terminal window configured to use the Wine environment. In the Terminal window, issue the command:
|
Installing ODBC Drivers (Optional)
To connect directly to an Enterprise Architect project hosted on a third party DBMS, you will need to use an ODBC driver appropriate for the DB type. To install an ODBC driver, first download the relevant installer, then run the installer using Wine.
Once the ODBC driver is installed, you can configure the connection from the Enterprise Architect ribbon: 'Settings > User Tools > ODBC Data Sources'.
Note: For improved performance when accessing a remote DBMS over a WAN connection, you should consider using Sparx System's Cloud Server.
Step |
Action |
---|---|
1 |
Use 'Finder' to open the 'Applications' folder, then double-click on 'Wine' (or 'Wine Stable') to open a Terminal window configured to use the Wine environment. |
2 |
Run the installer by issuing a command similar to one of those provided here, substituting the name of the ODBC Driver installer that you want to run. For .msi files, use:
For .exe files, use:
|
Install Enterprise Architect Inside Wine
When you install applications using Wine, the applications will be installed in the '.wine' folder, within your home directory.
For Enterprise Architect, the default installation folder will be '.wine\drive_c\Program Files\Sparx Systems\EA'.
(If you chose to include support for 64 bit systems when you installed Wine, then 'Program Files (x86)' will be used instead of 'Program Files'.)
Step |
Action |
---|---|
1 |
Download the latest Enterprise Architect installer. |
2 |
Open a Terminal window configured to use the Wine environment. (This is where you will run the installation commands.)
|
3 |
Install Enterprise Architect by issuing one of these commands, which relate to the registered and trial installations respectively:
|
Install Carlito Font
We recommend installing the Carlito font, so that text in diagrams appears as it does in a native Windows installation. This also prevents the diagram from resizing unnecessarily.
By default, Enterprise Architect uses Microsoft's Calibri font, but this font is not available under macOS (or under Wine) unless you have previously installed a Microsoft product such as MS Office.
Step |
Action |
---|---|
1 |
Download the Carlito font files. - Carlito font can be downloaded from: 'https://fontlibrary.org/en/font/carlito' Note: The web page contains advertisements; to download the font files, click on the DOWNLOAD CARLITO button. |
2 |
The font files are packaged into ZIP files. Extract the font files from the ZIP archive. |
3 |
Use 'Font Book' to install the fonts, which will make them available for use in all applications.
|
Create an Alias On Your Desktop to Run Enterprise Architect
Step |
Action |
---|---|
1 |
Using 'Finder', open your 'home' folder. |
2 |
From the Finder menu, choose 'Go | Go to Folder...', then enter '.wine' in the dialog that opens. (Notice the 'dot' prefix in this folder name.) |
3 |
Navigate to 'drive_c\Program Files\Sparx Systems\EA'. (If you chose to include support for 64 bit systems when you installed Wine, then navigate to 'drive_c\Program Files (x86)\Sparx Systems\EA' instead.) |
4 |
Within this folder, locate the file 'EA.exe'. Right-click on 'EA.exe' and choose 'Make Alias'. Rename the alias as 'Enterprise Architect', then drag the alias onto your Desktop. Alternatively, drag 'EA.exe' onto the Dock. |
5 |
Launch Enterprise Architect by double-clicking the shortcut on the Desktop, or by clicking the shortcut in the Dock. |
Upgrading Enterprise Architect Using Wine
To upgrade Enterprise Architect to a new version, you must first uninstall your current version, before installing the new version.
Step |
Action |
---|---|
1 |
Download the latest Enterprise Architect installer. |
2 |
Open a Terminal window configured to use the Wine environment, then launch the Wine 'Uninstaller'.
|
3 |
Uninstall the existing version of Enterprise Architect.
|
4 |
Install the new version of Enterprise Architect.
|
Learn More
- System Requirements
- Installing Enterprise Architect using CrossOver (macOS)
- Using Enterprise Architect's Visual Execution Analyzer (VEA) With Wine
- Configuring Subversion for Enterprise Architect using Wine
- Installing Enterprise Architect Add-Ins Using Wine
- Configuring the MDG Link for Eclipse Add-In using Wine
- Configuring Enterprise Architect's Pro Cloud Server Using Wine