Allegro Common Lisp (ACL) Initialization

This document supports the AllegroGraph Lisp Client Quick Start guide with additional information about initializing Allegro Common Lisp before running the AllegroGraph Lisp Client.

We presume that you have installed Allegro Common Lisp 10.0 and are about to run it for the first time. ACL will require initialization, which consists of downloading and compiling updates from Franz.com.

  1. You may need administrator privileges to perform the updates described below. If so, log in appropriately.

  2. Run Allegro Common Lisp. You must run a modern case-sensitive Lisp (mlisp or mlisp.exe) or a modern case-sensitive Lisp with the Integrate Development Environment (allegro or allegro.exe). AllegroGraph will not work with ANSI, case-insensitive Lisp.

  3. UNIX % [path of Allegro CL directory]/mlisp WINDOWS choose executable from acl10.0 item on Start/App menu

  4. In the resulting Lisp listener window, update the Allegro CL software. This will open a network connection to Franz.com to download patch files. On Windows, there is also a menu item to download patches. This is where you may need administrator privileges.
  5. cl-user(1): (sys:update-allegro) 
  6. When the download is finished, exit Lisp and you will need to rebuild the images to include the downloaded patches.
  7. (exit) 
  8. On UNIX, navigate to the Allegro CL installation directory and run the update.sh script. On Windows, choose update.exe without downloading patches. This rebuilds Allegro CL with the latest updates. Again, you may need administrator privileges for this step.
  9. UNIX: % [path of Allegro CL installation]/update.sh  
    

To run the AllegroGraph Direct Lisp Client, you must start the AllegroGraph server and Allegro CL under the same user account and on the same machine. You cannot run the Lisp Client as root.

If you installed AllegroGraph using the "rpm" method, the configuration script asked you for the name of a user account to store as the "RunAs" parameter of the agraph.cfg file. You will need to run Allegro CL using this same account.

If you installed AllegroGraph using the "tar.gz" method, simply start AllegroGraph server and Allegro CL from the same non-administrator account.

In either case, now is the time to log in as a non-adminstrator.

You can run a remote Lisp client but not all the examples in Quick Start will work for the remote client.

You may return to the AllegroGraph Lisp Client Quick Start guide and proceed by starting Lisp and the Interactive Development Environment.