4.4 Installing LispWorks for Linux

4.4.1 Main installation and patches

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

4.4.2 Installing over previous versions

You can install LispWorks 8.0 in the same location as LispWorks 7.1 or previous versions.

4.4.3 Information for Beta testers

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

See 4.9 Uninstalling LispWorks for Linux for instructions.

4.4.4 Installation from the binary RPM file (x86 and x86_64 only)

For installation on ARM and ARM64, see 4.4.5 Installation from the tar files.

We recommend that you use RPM 4.3 or later (however see below for problems with --prefix argument with some versions of RPM). The distribution files are also provided in tar format in case you do not have a suitable version of RPM or are using another distribution of Linux.

If you already have LispWorks 8.0 Beta installed, please uninstall it before installing this product. See 4.9 Uninstalling LispWorks for Linux.

Some versions of RPM may cause problems (eg. RPM 3.0). If you get the following message when using the --prefix argument:

rpm: only one of --prefix or --relocate may be used

try upgrading to RPM 3.0.2 or greater.

Installation of LispWorks for Linux from the RPM file must be done while you are logged on as root.

4.4.4.1 Installation directories

By default 32-bit LispWorks is installed in /usr/lib/LispWorks and a symbolic link to the executable is placed in /usr/bin/lispworks-8-0-0-x86-linux. Similarly, 64-bit LispWorks is installed in /usr/lib64/LispWorks and a symbolic link to the executable is placed in /usr/bin/lispworks-8-0-0-amd64-linux. However, the RPM is relocatable, and the --prefix option can be used to allow the installation of LispWorks in a non-default directory. The default prefix is /usr.

Note: RPM version 4.2 has a bug which can hinder secondary installations (CLIM, Common SQL, LispWorks ORB or KnowledgeWorks) in a user-specified directory. See 11.4.2 RPM_INSTALL_PREFIX not set for a workaround.

Note: the Personal Edition installs by default in /usr/lib/LispWorksPersonal. Do not attempt to to install different editions in the same location, since some filenames coincide and uninstallation may break.

4.4.4.2 Selecting the correct RPM files

The main RPM file in the LispWorks distribution is named using the following pattern:

lispworks-8.0-n.arch.rpm

The integer n denotes a build number and will be same in all files in your distribution. The string arch will be either i386 for 32-bit LispWorks or x86_64 for 64-bit LispWorks. The text below assumes 32-bit LispWorks.

Note: For the Personal Edition, use lispworks-personal-8.0-*.i386.rpm wherever lispworks-8.0-*.i386.rpm is mentioned in this document. See 1.1.1 Personal Edition for more information specific to the Personal Edition.

4.4.4.3 Installing or upgrading LispWorks for Linux

To install or upgrade LispWorks from the RPM file, perform the following steps as root:

1. Follow the instructions under 4.2 License agreement.
2. Locate the RPM installation file lispworks-8.0-n.i386.rpm.
3. Install or upgrade LispWorks in the standard RPM way, for example:

   rpm --install lispworks-8.0-n.i386.rpm
   

   This command installs LispWorks in /usr/lib/LispWorks. A command line of the form:

   rpm --install --prefix <directory> lispworks-8.0-n.i386.rpm
   

   installs LispWorks in <directory>.

The directory name must be an absolute pathname. Relative pathnames and pathnames including shell-expanded characters such as . and ~ do not work.

Note: LispWorks needs to be able find its library at run time and therefore the LispWorks installation should not be moved around piecemeal. If you simply want to run LispWorks from somewhere more convenient, then consider adding a symbolic link.

See 4.6 Running LispWorks for instructions on entering your license details.

4.4.4.4 Installing CLIM 2.0

The following module is packaged as a separate RPM file for installation after the main lispworks package. It is available in LispWorks Professional and Enterprise Editions only.

Install this module if required by substituting the above filename into the same commands you used to install the main lispworks package.

If you used a --prefix argument when installing LispWorks, then use the same prefix for this module.

4.4.4.5 Installing loadable Enterprise Edition modules

The following modules are packaged as separate RPM files for installation after the main lispworks package.

Install these modules as described in 4.4.4.4 Installing CLIM 2.0.

4.4.4.6 Documentation and saving space

Documentation in HTML and PDF format is provided with all editions. PostScript format is available to download. To obtain copies of the printable manuals, see 4.8 Printable LispWorks documentation.

Documentation is installed by default in the lib/8-0-0-0/manual sub-directory of the LispWorks installation directory.

Using RPM, you can save space by choosing not to install the documentation. For example, use the following command (all on one line):

rpm --install --excludedocs --prefix <directory> lispworks-8.0-n.i386.rpm

To install the documentation at a later stage, you need to use the --replacepkgs option:

rpm --install --prefix <directory> --replacepkgs lispworks-8.0-n.i386.rpm

4.4.4.7 Installing Patches

After completing the main RPM installation of LispWorks and any modules, ensure you install the latest patches from the RPM file available for download at www.lispworks.com/downloads/patch-selection.html . Patch installation instructions are in the README file accompanying the patch download.

4.4.5 Installation from the tar files

The LispWorks distribution is also provided as tar files compressed using gzip for use if you do not have an appropriate version of RPM to unpack the RPM binary file. The gzipped files for LispWorks are as follows:

Note: The gzipped files for the LispWorks Personal Edition have similar names.

To install from these files:

1. Follow the instructions under 4.2 License agreement.
2. Use cd to change directory to the location of the downloaded files before running the installation script.
3. Run the installation script lwl-install.sh (or lwlper-install.sh for the Personal Edition). as root if the directory specified by the installation directory requires it (the default does).

This script takes --prefix and --excludedocs arguments like rpm to control the installation directory and amount of documentation installed.

For example, to install the Personal Edition and documentation in the default location (/usr/local/lib/LispWorksPersonal) would use:

sh lwlper-install.sh

Or, to install 32-bit LispWorks in /usr/lispworks, without documentation you would use:

sh lwl-install.sh --excludedocs --prefix /usr/lispworks

Note: the default location under /usr/local is appropriate for this unmanaged (non-RPM) installation.

See 4.6 Running LispWorks for how to enter your license details.

4.4.5.1 Installing Patches

After completing the main tar installation of LispWorks, ensure you install the latest patches from the tar archive available for download at www.lispworks.com/downloads/patch-selection.html . Patch installation instructions are in the README file accompanying the patch download.