Requirements & Installation

This document describes:

Requirements: Required operating system versions and development tools.
Installation Instructions: Installing Amzi! for the first time.
Updating to a New Version: Upgrading an existing installation to a new version without un-installing.
Unlocking the Software: Unlocking Amzi! and entering license information.
Unregistering and Transferring Your License (Windows): How to transfer your license to a new PC.
Uninstalling the Software: Removing Amzi! from your system.
Distribution Files: List of Amzi! distribution files.

Requirements

Windows

Amzi! Prolog + Logic Server for the PC requires one of Windows XP, Vista, Windows 7 or later (it might still run on earlier versions, but it is not tested on those platforms). Installation of the full Amzi! system, including the libraries for all the supported environments, requires approximately 18mb of disk space for the core system plus 260mb of space for the Amzi! Eclipse IDE and Java. The Eclipse IDE requires Java 1.4 or later.

The Logic Server API supports:

C and C++ (Microsoft and Borland)
Java
Delphi
Visual Basic
C#
Web servers (ASP.NET, JSP, Servlets, CGI)
.NET and ASP.NET (Version 1.0.3705.288 (Service Pack 2))
MS-Office: Access, Excel, Word
Any Windows development tool that can call a dynamic library (.dll)

Linux

Amzi! Prolog + Logic Server runs on Linux kernel 2.2.X or later. Installation requires approximately 18mb of disk space for the core system plus 260mb of space for the Amzi! Eclipse IDE and Java. The Eclipse IDE requires Java 1.4 or later.. The Logic Server works with any compatible compiler including:

Gnu C/C++ 3.2 or later and associated libraries
Gnu Fortran, et. al.
Java
Web servers (JSP, Servlets, CGI)
Any Unix development tool that can call a shared object (.so)

IBM AIX, Solaris, HP-UX, BSD and Other Platforms

Amzi! Prolog + Logic Server can be readily ported to any platform that supports C++, and might have already been ported for your environment. Let us know if you are interested.

Installation Instructions

Amzi! Prolog + Logic Server is distributed as a packed archive file or in an installation package. The full system will be installed in an 'amzi' directory with two subdirectories. One contains the core files, 'apls', and the other the IDE, 'ide', which is a version of Eclipse pre-setup for Prolog development. The two directories will look like:

amzi
   apls            Set AMZI_DIR to this directory for Logic Server development
      bin             Executables, put on your PATH to run command line utilities
      abin            Prolog binaries
      docs            Documentation
      ...             Other directories
   ide
      eclipse(.exe)   The IDE
      ...             Supporting directories for the IDE

To extract the files, put the archive(s) in your root or user directory or whatever directory you want to contain the directory tree. Then follow the appropriate instructions for your operating system.

Windows

Follow the install intructions for the installation program. The installation will also attempt to modify the environment variables as follows:

Add the environment variable AMZI_DIR=install_dir\amzi\apls.
Add %AMZI_DIR%\bin to the start of your PATH environment variable.

Note that the environment variables are not necessary for running the IDE, but are useful when you are building applications with the Logic Server, or trying to run Amzi! from the command line.

After installing the software you will have to activate it, using either the batch 'activate' command in the apls/bin directory, or from the File menu in the IDE.

Existing Eclipse Users

If you already have Eclipse and Java installed, then download and install just the core Amzi! download. When installed you will see a directory called apls...\eclipse_plugin. You can use the Eclipse facilities for adding a plug-in and point it to that directory. This will add the Amzi! Prolog plug-in to your current install.

Start Eclipse.
Select Help | Software Updates | Find & Install then click 'Search for New Features to Install'.
Click on 'New Local Site' and open your amzi/apls/eclipse_plug-in directory.
Select your new site containing the Amzi! Prolog + Logic Server IDE.Accept the defaults for the 'Edit Local Site' dialog.
Ensure that the new site is selected.Click 'Finish' and select the 'Amzi! Prolog + Logic Server IDE' option.
Click 'Install Now'.
Restart Eclipse.

Unix

Gunzip the archive by typing 'gunzip amzi_N-N-N_linux.tgz'
Extract the file by typing 'tar -xvf amzi_N-N-N_linux.tar' to extract the files.
Add the environment variable AMZI_DIR=install_dir/amzi/apls where install_dir is the directory you installed Amzi! into.
Add $AMZI_DIR/bin onto your path. Alternatively, create links to the executables from a directory on your path.
Add $AMZI_DIR/lib to the LD_LIBRARY_PATH environment variable.
Java users, add $AMZI_DIR/lsapis/java20 on your CLASSPATH.
C/C++ users, add $AMZI_DIR/lib to your LIB environment variable and $AMZI_DIR/include to your INCLUDE environment variable.

In order to run the Amzi! Eclipse IDE you need to install:

Eclipse (www.eclipse.org)
Java (java.sun.com). This can be installed in eclipse/jre or elsewhere on your system.

Next install the Amzi! Feature into Eclipse as follows:

Start Eclipse.
Select Help | Software Updates | Find & Install then click 'Search for New Features to Install'.
Click on 'New Local Site' and open your amzi/apls_N-N-N/eclipse_plugin directory.
Select your new site containing the Amzi! Prolog + Logic Server IDE.
Click 'Finish'.
Restart Eclipse as a user that can write to the eclipse directory tree to install the Amzi! documentation.

Updating to a New Version

First, do not install a new version of Amzi! if your maintenance has expired. In the Amzi! Eclipse IDE select Help | Amzi! Version or from the command-line type 'alis' to check your software maintenance and support status.

You can un-install the old version of Amzi!, or rename your old amzi directory and install a new clean copy.

You can revert to the previous version by simply changing the value of AMZI_DIR to point to the old directory.

Uninstalling the Software

Under Windows, to remove Amzi!, open the Control Panel and choose Add/Remove Programs. You may have to delete the amzi directory tree if you have modified any files within it (sources, samples, configs, workspace).

To remove Amzi! from your computer manually:

Delete the amzi directory tree.
Delete the AMZI_DIR environment variable and remove it from your PATH environment variable.
Windows users, delete the shortcuts from the Start / Programs menu.

Distribution Files

Amzi! Prolog + Logic Server as a compressed archive file that contains the following directory structure:

amzi/apls/
bin - executable files, and, under Windows, .dll and .lsx files.
    acmp.exe - command line compiler
    alis.exe - command line listener
    alnk.exe - command line linker
    arun.exe - command line runtime
    unlock.exe - command to unlock Amzi! features
    amzi.dll - Amzi! windows DLL (Windows)
    amzijni.dll - Java 2.0 interface DLL (Windows)
    amzinet.dll - .NET interface DLL (Windows)
    adebug.lsx - Remote debugger support (Windows)
    aodbc.lsx - ODBC extended predicates (Windows)
    aosutils.lsx - Operating system dependent extended predicates (Windows)
    asock.lsx - Sockets interface LSX (Windows)
abin - Prolog executable files.
    acmp.xpl - Compiler load module
    aidl.xpl - IDE listener load module
    alis.xpl - Listener load module
    acgi.plm - Prolog interface to CGI
    alib.plm - Prolog library of built-ins
    aodbc.plm - Prolog ODBC predicates
    asock.plm - Sockets interface Prolog predicates
    axrf.xpl - Cross referencing library
    date_time.plm - Date/time predicates
    debug64.plm - IDE source code debugger support (not 64-bits, just introduced at the 6-4 release level)
    list.plm - List library predicates
    misc.plm - Miscellaneous predicates
    xml.plm - XML parsing library
docs - HTML documentation (see src if it's not here).
    amzidoc.htm - Master HTML document, points to all others
eclipse_plugin - Files to install the Amzi! IDE into an existing copy of Eclipse
include - logicserver.h C/C++ header file.
    amzi.h - Deprecated C/C++ include file
lib - under Unix, .so and .lsx files.
    amzi.lib - Logic Server library for linking (Windows)
    amzib.lib - Borland version of Logic Server library (Windows)
    libamzi.so (Unix)
    libamzijni.so (Unix)
    libamzijide.so (Unix)
    libalnk.so (Unix)
    adebug.lsx - Remote debugger support (Unix)
    aosutils.lsx - Operating system dependent extended predicates (Unix)
    asock.lsx - Sockets interface LSX (Unix)
lsapis - Logic Server interfaces for other languages/tools.
     cgi - CGI executables
     delphi - Delphi component (Windows)
     java20 - amzi/ls class libraries and JNI interface
     vb - VB module (Windows)
samples - various samples, including HTML documentation.
    c - C samples chezray - An assortment of Ray Reeve's favorite programs
    cgi - CGI samples
    cpp - C++ samples
    delphi - Delphi samples
    dotnet - .NET samples
    internet - Internet samples
    java - Java samples (JSP, servlets, ASP.NET, .NET and CGI)
    lsx - Logic Server Extension samples
    odbc - ODBC samples
    prolog - Prolog samples
    sockets - Sockets samples
    vb - Visual Basic samples
src - source code for extensions and documentation.