All Manuals > LispWorks Release Notes and Installation Guide > 2 Installation on Mac OS X


2.4 Installing LispWorks for Macintosh

2.4.1 Main installation and patches

The LispWorks 7.0 installer contains each of the Editions. Additionally, there may be a patch installer which upgrades LispWorks to version 7.0.x. You need to complete the main installation before adding patches.

2.4.2 Information for Beta testers

Users of LispWorks 7.0 Beta should completely uninstall it (including any patches added to the beta installation) before installing LispWorks 7.0.

See Uninstalling LispWorks for Macintosh for instructions.

2.4.3 Information for users of previous versions

You can install LispWorks 7.0 in the same location as LispWorks 6.1 or previous versions. If you always choose the default install location, a new folder named LispWorks 7.0 (32-bit) or LispWorks 7.0 (64-bit) will be created alongside the other versions.

2.4.4 Use an administrator account

To install LispWorks in the default installation location under /Applications you must log on as an administrator.

However, a non-administrator may install LispWorks elsewhere.

2.4.5 Launch the LispWorks installer

Mount the disk image containing the 32-bit LispWorks or 64-bit LispWorks installer. These are called LispWorks70-32bit.dmg and LispWorks70-64bit.dmg respectively. Simply double-click on the .dmg file to mount it.

You will have downloaded these from the x86-darwin and amd64-darwin folders respectively.

To install LispWorks (32-bit) for Macintosh launch the LispWorks32bit_Installer application. To install LispWorks (64-bit) for Macintosh launch the LispWorks64bit_Installer application. .

Note: the Personal Edition installer is a pkg file. Open it to run the installer in the Mac OS X Installer application.

2.4.6 The Read Me

The Read Me presented next by the installer is a plain text version of this LispWorks Release Notes and Installation Guide .

2.4.7 The License Agreement

Check the license agreement, then click Continue . You will be asked if you agree to the license terms. Click the Accept button only if you accept the terms of the license. If you click Disagree , then the installer will not proceed.

2.4.8 Select Destination

All the files installed with LispWorks are placed in the LispWorks folder, which is named LispWorks 7.0 (32-bit), LispWorks 7.0 (64-bit) or LispWorks Personal 7.0 depending on which edition you are installing. By default, the LispWorks folder is placed in the main Applications folder but you can choose an alternative location during installation by clicking the Select Folder... button.

Click Continue after selecting a folder.

Note: The Applications folder may display in the Finder with a name localized for your language version of Mac OS X.

2.4.9 Choose your installation type

Choose the native Mac OS X GUI and/or the X11 GUI option.

Different executables and supporting files are supplied for the two GUI options. If you install just one of these and later decide to install the other, you can simply run the installer again. The native Mac OS X GUI

If you simply want to install LispWorks for the native Mac OS X GUI, and the documentation, choose Easy Install . The X11 GTK+ and Motif GUIs

If you want to use LispWorks with either of the alternative X11 GUIs, choose Custom Install and select the option "LispWorks with X11 IDE".

The default X11 GUI is GTK+. Motif is also available, but is deprecated. You can select Motif at runtime.

Note: to run LispWorks with an X11 GUI, you will need both of these installed:

If you use Open Motif, you will also need Imlib (but not Imlib2). Imlib version 1.9.13 or later is recommended.

None of these are required at the time you install LispWorks, however.

The X11 GUIs are not available for the Personal Edition. The Documentation

If you use Easy Install the documentation will be installed.

If you do not wish to install the documentation, use Custom Install and uncheck the "LispWorks Documentation" option.

2.4.10 Installing and entering license data

Now click Install .

Enter your serial number and license key when the installer asks for these details.

Your license key will be supplied to you in email from Lisp Support.

If you have problems with your LispWorks license key, send it to, showing the complete output after you enter it, preferably with a screenshot.

Note: the LispWorks Personal Edition installer does not ask you to enter license data.

2.4.11 Add LispWorks to the Dock

If you are installing the native Mac OS X LispWorks GUI, the installer asks if you wish to add LispWorks to the Mac OS X Dock. Click OK if you anticipate launching LispWorks frequently, or choose not to add LispWorks to the Dock by clicking Cancel .

Note: LispWorks may not be visible in the Dock until you restart the computer or log out and then log back in.

2.4.12 Finishing up

You should now see a message confirming that installation of LispWorks was successful. Click the Quit button.

Note: LispWorks needs to be able find its library at runtime and therefore the LispWorks installation should not be moved around piecemeal. If you must move it, move the entire LispWorks installation folder. If you simply want to run LispWorks from somewhere more convenient, then consider adding an alias.

2.4.13 Installing Patches

After completing the main installation of LispWorks, ensure you install the latest patches which are available for download at . Patch installation instructions are in the README file accompanying the patch download.

2.4.14 Obtaining X11 GTK+

LispWorks does not provide GTK+ libraries, so you need to install third-party libraries, such as

Note: you need the x11 gtk2 libraries, not GTK-OSX (Quartz).

2.4.15 Obtaining Open Motif and Imlib

LispWorks 7.0 for Macintosh on X11/Motif requires Open Motif 2.3 and Imlib.

The Open Motif library for 32-bit LispWorks is /usr/local/lib/libXm.4.dylib.

Lisp Support can supply suitable Motif and Imlib libraries if you need them.

Note: The Motif GUI is deprecated. A GTK+ GUI is available.

LispWorks Release Notes and Installation Guide - 2 Mar 2015