Requirements & Installation

Requirements

Windows

The Logic Server API supports:

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

Linux

• Gnu C/C++
• Java
• Web servers (JSP, Servlets, CGI)
• Any Unix development tool that can call a shared object (.so)

Solaris

• Sun Visual Workshop C/C++, Gnu C/C++
• Java
• Web servers (JSP, Servlets, CGI)
• Any Unix development tool that can call a shared object (.so)

HP/UX

Amzi! Prolog + Logic Server runs on HP/UX 11 or later, and is available only by special request at this time. Installation requires approximately 3mb of disk space. The Logic Server works with any compatible compiler including:

• Gnu C/C++
• Java
• Web servers (JSP, Servlets, CGI)
• Any Unix development tool that can call a shared object (.so)

Installation Instructions

Amzi! Prolog + Logic Server is distributed as a packed archive file (.exe, .zip or .tgz). The archives contain full pathnames for each file. This means that when you extract the files, the entire directory structure will be created (below the current directory) with each file in its proper subdirectory. Because the top-level directory name and executable program and library names include the major release number, you can run multiple releases of Amzi! Prolog+Logic Server at the same time without naming conflicts.

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

Double-click on the .exe file to run a full installation. This will install Amzi! into the directory of your choice and perform steps 1 through 6 below. You need to run steps 7 to 9, if applicable.

1. Create an icon on the start menu or a shortcut on your desktop for the Amzi! IDE. There are two versions to choose from. One is a full Unicode development environment (with a Unicode program editor) and the other is a Multi-byte Character Set (MBCS) environment. Both support traditional ASCII characters as well. The Unicode environment can only be used with Windows NT/2000/XP. It's executable is amzi\bin\wideW.exe. The MBCS IDE can be used with either Windows NT/2000/XP or Windows 95/98. It's executable is amzi\bin\wideA.exe.
2. Add install_dir\amzi\bin on your PATH where install_dir is the directory you unzipped Amzi! into.
3. Add the environment variable AMZI_DIR=install_dir\amzi.
4. If you are going to rebuild source code, add the environment variable AMZI_DEV_DIR=install_dir\amzi.
5. Java users, add install_dir\amzi\lsapis\java20 on your CLASSPATH.
6. C/C++ users, add install_dir\amzi\lib to your LIB environment variable and install_dir\amzi\include to your INCLUDE environment variable.
7. Delphi users, see the instructions for installing the component.
8. Standard/Professional License users, choose File/Unlock in the IDE or run unlock.exe in amzi\bin (see below).

Unix

1. Gunzip the archive by typing 'gunzip amziN-N-N_linux.tgz'
2. Extract the file by typing 'tar -xvf amziN-N-N_linux.tar' to extract the files.
3. Add install_dir/amzi/bin onto your path, where install_dir is the directory you installed Amzi! into. Alternatively, create links to the executables from a directory on your path.
4. Add the environment variable AMZI_DIR=install_dir/amzi.
5. Standard/Professional License users, run unlock in amzi\bin (see below).
6. If you are going to rebuild source code, add the environment variable AMZI_DEV_DIR=install_dir/amzi.
7. Add install_dir/amzi/lib to the LD_LIBRARY_PATH environment variable. Alternatively, create links to the .so and .lsx files from a directory in your load library path.

Unlocking Instructions

Customers who purchase a paid license to Amzi! Prolog + Logic Server will receive a serial number and unlock code. By entering this information into the product, additional features are enabled. In the initial 6.2 release, the Professional License adds the ability to initiate multiple, simultaneous Logic Servers and to load compiled code from memory. These features are usually needed by high-end server applications.

To unlock the software change directory to the install_dir/amzi/bin directory and run the unlock program. Enter the registration details exactly as they were e-mailed to you. Note, you must have write access to all the files in the amzi/bin directory. Windows users can also select the File/Unlock in the IDE to enter the registration details.

After unlocking, recompile and relink any programs that need to make use of the newly enabled features.

Un-Install Instructions

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

To remove Amzi! from your computer manually:

1. Delete the amzi directory tree.
2. Delete the AMZI_DIR, AMZI_DEV_DIR environment variables and remove it from your PATH, LIB and INCLUDE environment variables.
3. 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
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
    amzi.dll - Amzi! windows DLL (Windows)
    amzijni.dll - Java 2.0 interface DLL (Windows)
    amzinet.dll - .NET interface DLL (Windows)
    alnk.dll - IDE linker (Windows)
    aodbc.lsx - ODBC extended predicates (Windows)
    aosutils.lsx - Operating system dependent extended predicates (Windows)
    asock.lsx - Sockets interface LSX (Windows)
    wideA.exe - Windows IDE (MBCS interface for Win95)
    wideW.exe - Windows IDE (Unicode interface for WinNT)
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.plm - Cross referencing library
    date_time.plm - Date/time predicates
    list.plm - List library predicates
    misc.plm - Miscellaneous predicates
    probe.plm - Performance monitoring library
    xml.plm - XML parsing library
docs - HTML documentation (see src if it's not here).
    amzidoc.htm - Master HTML document, points to all others
include - amzi.h C/C++ header file.
    amzi.h - 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)
    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
    internet - Internet samples
    dotnet - .NET samples
    servlet - Java servlets
    java - Java samples
    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.