All Manuals > LispWorks Release Notes and Installation Guide > 7 Installation on UNIX


7.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/6-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/6-1-0-0 .
  2. 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/" .

  3. 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* .
  4. Note: this only works if you do not move the image away from the top-level of the installation directory.

  5. 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.
  6. 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 - 23 Dec 2011