
Preamble

NoSQL is tailored to the Linux O.S. but it should work
with most Unix systems, provided that the following
other programs are available:

  Perl 5

  nawk compatible awk (mawk / gawk). mawk is small and fast, so it
  is recommended.


Installation :

  >>>>>> UPGRADE NOTES <<<<<<

  If you are upgrading from a previous version of NoSQL, make sure
  you read file README.1ST before continuing.

  >>>>>>>>>>>>><<<<<<<<<<<<<<

  Untar the package in a work directory, then 'cd' into the latter
  and run :

			  ./configure 
              make
              make install

  The 'configure' program takes a number of options.
  Typing './configure --help' will explain them all.


                          -----------------

Setting the environment:

To use NoSQL from the shell command line I recommend you set the
'nosql' front-end shell function with the command :

                . /usr/local/lib/nosql/sh/nosqlmain

where '/usr/local/lib' must be replaced with your actual NoSQL
installation path. This can be done from your shell ~/.profile or
any other shell initialization file. Please refer to the man page
of your shell for details. If you do not run the above command,
you can still use NoSQL seemlessly but you will be using the 'nosql'
executable wrapper, which is less efficient.

If you have Kenneth Almquist's 'ash' installed (a bare-bones, faster
alternative of the standard Unix Bourne shell /bin/sh), then to improve
the speed of NoSQL you can make your AWK use it for system()'s and
pipes. Suppose your AWK is /usr/bin/mawk end your shell is /bin/ash
(a fairly common case, especially on Debian GNU/Linux), then you can
do something like this:

1) Create the following hard link: 

   ln /bin/ash /bin/ah

2) Modify AWK to make it use /bin/ah as opposed to /bin/sh, and
   write the modifyed AWK to /usr/local/bin/nsq-mawk :

   sed 's/\/bin\/sh/\/bin\/ah/g' /usr/bin/mawk \
     > /usr/local/bin/nsq-mawk

   chmod 755 /usr/local/bin/nsq-mawk

3) Set the NSQAWK variable in either the system-wide nosql.conf or the
   per-user $HOME/.nosql.conf files to point to the modified AWK.
   Please refer to the NoSQL documentation for more on these 
   configuration files.

