8.3 Moving the LispWorks image and library

The LispWorks image must be able to find its library. The default library location is contained in the Lisp variable *lispworks-directory*, but if that does not locate the library, LispWorks also can locate its library by a fallback mechanism which detects a numbered subdirectory lib/7-1-0-0 alongside the image.

There are three distinct ways to arrange your LispWorks files. Choose 1, 2 or 3, of which 1 and 2 are the simplest options:

1. Put the LispWorks distribution in /usr/lib/lispworks. You will then have the LispWorks image at top-level in the /usr/lib/lispworks directory, and subdirectories /usr/lib/lispworks/lib/7-1-0-0.

You can move the LispWorks image wherever you prefer, because the value of *lispworks-directory* in the supplied image is the pathname #P"/usr/lib/lispworks/".

2. Keep the LispWorks installation intact, as unpacked from the archive supplied. You can move it, but only move the entire installation as a whole. Then LispWorks will find its library by the fallback mechanism mentioned above. In this case again you do not need to change *lispworks-directory*.

Note: this only works if you do not move the image away from the top-level of the installation directory.

3. Put the library elsewhere than /usr/lib/lispworks/ (call it /path/to/lwlibrary/) and move the LispWorks image file away from the top-level of the installation directory.

In this case you need to take action to allow LispWorks to find its library. You should either make a symbolic link /usr/lib/lispworks/lib, or configure the LispWorks image with:

(setf *lispworks-directory* #P"/path/to/lwlibrary/")

See Configuring the LispWorks image below for more information about configuring LispWorks. You will need to install your license key first.

LispWorks Release Notes and Installation Guide - 19 Oct 2017