Copyright (c) 2005 - 2018 Franz, Incorporated

Last updated 10 April 2018 at 08:04

• Documentation Index
  • Release Notes
  • Quick Start
  • Introduction
  • Setup and Configuration
    • Download
    • Server Installation
    • Server Configuration and Control
    • WebView
    • Database Upgrading
  • Server Management
    • Performance Tuning
    • Deleting Duplicate Triples
    • Purging Deleted Triples
    • Auditing
    • Replication
    • Point-in-Time Recovery
    • Transaction Log Archiving
    • Security Overview
    • Security Implementation
  • Tools
    • agtool
    • Data Loading
    • Data Export
    • Backup and Restore
    • Querying
    • RDFS++
    • Materializer
  • Details
    • AllegroGraph Indices
    • Full-text Indices
    • Encoded IDs
    • Connection Pooling
    • N-dimensional Geospatial Overview
    • 2-D Geospatial
    • Temporal
    • Social Network
    • JavaScript
    • Datatypes
    • Data Conversion (Rapper)
    • Stored Procedures
    • Triple Attributes
  • Querying
    • SPARQL documentation summary
    • SPARQL Reference
    • SPIN
    • SPARQL Magic Properties
    • Prolog
  • 3rd-party tools
    • Solr text Indices
    • MongoDB integration
    • TopBraid Composer Plugin
    • Cloudera
  • Client APIs
    • Gruff
    • REST/HTTP interface
    • HTTP reference
    • Javadocs (Sesame and Jena)
    • Python API
    • Lisp Reference
    • JavaScript
  • Tutorials
    • N-dimensional Geospatial
    • SPARQL Tutorial
    • Java Sesame
    • Java Jena
    • Python Sesame
    • Lisp
    • Prolog
    • More...
  • Other
    • Suggested Reading
    • Conferences and Seminars
    • Source Code on Github
    • Community Resources
    • Amazon EC2
    • Copyrights
    • Change History
  • Franz, Inc.

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.

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

3. 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.

cl-user(1): (sys:update-allegro) 

4. When the download is finished, exit Lisp and you will need to rebuild the images to include the downloaded patches.

(exit) 

5. 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.

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.