INSTALL
$Id: INSTALL,v 1.5 2005/02/04 20:15:28 jason Exp $

L'anePOS 2005 (Early-release: 2005-Q1)
Copyright 2002-2005 Jason Burrell
Copyright 2000, 2001 Burrell Business Systems.
Contains portions of L'ane BMS, Copyright 1995-2001 Burrell Business Systems.

This software is distributed under the terms of the GPL. See COPYING.

=========
Overview
=========
This document gives a "quick and dirty" outline to setup a stand-alone
PC as a register in a L'anePOS system.

The following steps are required:
 1. Install and configure the hardware and your POSIX OS.
 2. Install the PostgreSQL server on the database server or "master"
    register.
 3. Install the required client packages on the registers via your OS's
    native method (RPM, DEB, Ports, etc).
 4. Change to the desired location for the L'anePOS installation (ie /opt).
 5. Un-tar the L'anePOS package (lane-0.YYYYMMDD.tgz).
 6. Create a user (ie register) on each register (the register runs as this
    user).
 7. Add an entry in PostgreSQL's pg_hba.conf for each terminal.
 8. Change to the "backOffice/utilities/installer/" directory and run the
    "./install.pl" script.

    This script will ask various questions about your setup and ATTEMPT
    to configure L'ane. It will create a site configuration file, install
    (via CPAN) any Perl modules your OS does not provide, and create or
    modify a L'ane dataset.

 9. Add one of the following lines to the registers' startup scripts

    Curses Retail Interface (Text console or terminal)
       openvt -c 9 -s su -l register sh -c '/opt/LanePOS/register/registerCurses 2> /dev/null'
           This runs registerCurses on vt9 (ctrl+alt+f9) in Linux
    Tk XML Interface (Requires an X11 Server)
       a. Create or modify an XML file for your register's layout.
       b. Render the register XML file
            (./renderXmlRegister-Tk sample-register.xml > my-register)
       c. After your X11 server is up, add the following to your startup script
          (make sure DISPLAY is set to your X11 server):
            su -l register /opt/LanePOS/register/xmlRegister/my-register


Those steps should be most of the required steps in a brief manner.
Visit the web site if you have questions: http://l-ane.net/ .