This section explains how to install LispWorks, having already mounted the CD-ROM. If you have not done this, refer to The CD-ROM. It also describes how you obtain keys to run LispWorks 7.0.
When you extract files made with the
tar command, they are written into the current directory, and if there are any directories packed up in the tar file, they will be written to the current directory too. For this reason it is best to
cd to the correct directory before extracting anything.
Consider who is going to use LispWorks before you decide where to put the extracted files. Once installed and configured, the executable Lisp image should be somewhere in the UNIX file system likely to be on its users' search path. A suitable place might be
The run time directory structure (basically, everything except the image file) should be somewhere publicly readable:
/usr/lib/lispworks, by default. If there is not enough room in any of the normal publicly accessible locations, you could put a symbolic link there pointing to an installation directory in a partition with more disk space.
tar -xof /mount-point/filename
tar -xof /cdrom/lw_70/lw70-sparc.tar
in the current working directory, where hostname is the name of the host.
keyfilein the current working directory, where hostname is the name of the host.
config/keyfile.hostname, where hostname is the name of the host on which the image is to execute. The
configdirectory is expected by default to be located at
/usr/lib/lispworks/lib/7-0-0-0/config(see If you are using the keyfile system.
config/keyfile, where the
configdirectory is as above.
config is an indirect subdirectory of the directory specified by the LispWorks variable
*lispworks-directory*. Note that until you have configured and saved your image, as described later in this section, this variable is set to
/usr/lib/lispworks. When starting the generic image, you must therefore ensure that the keyfile is either in your current directory or in
Each key should be placed on a separate line in the file. There should be no leading white space on a line before the start of a key. Characters after the key but on the same line as it are ignored, so may be used for comments. Indeed it is helpful to comment each line with the name of the product that key enables.
A single key allows you to use a particular major version of LispWorks (in this case 5), on one host machine, until the expiry date of one license, where relevant. To run LispWorks on a different machine you will need another key.
To find out your machine's ID, try to start up the LispWorks image. LispWorks spots that there is no valid key available, and prints a message saying so, along with the ID you need to let us know. In any case, Lisp Support will be able to provide assistance in determining the identifier of a specific machine. We will also retain a copy of the key supplied.
Once you have the key, write it into a file in one of the places listed in Where LispWorks looks for keyfiles, and start up the LispWorks image.
LispWorks Release Notes and Installation Guide - 2 Mar 2015