README

   1 Introduction
   2 ------------
   3 CSQL is a fast, multi-threaded SQL main memory database engine. It is a free software, licensed with the GNU GENERAL PUBLIC LICENSE http://www.gnu.org/
   4 It aids in the development of high performance, fault-resilent applications requiring concurrent access to the shared data.
   5
   6 Check www.databasecache.com for more details about its usage.
   7
   8 Platforms Supported
   9 -------------------
  10 Linux and Solaris
  11
  12 Compilers Supported
  13 -------------------
  14 g++ in linux,
  15 CC in solaris
  16
  17 Compiling the source
  18 --------------------
  19 Go to the root directory and enter the following commands.
  20
  21 $./configure --prefix=`pwd`/install
  22
  23 Note: in src/sql/Makefile, change "YACC = bison -y" to "YACC = yacc -vd"
  24
  25 $make
  26 $make install
  27
  28 This will create "install" directory under the current directory and places all the executables created in bin directory and libraries in lib directory.
  29
  30 Available Documentation
  31 -----------------------
  32 1.User Manual is available under the docs directory
  33 2.HTML API Reference for DB API under the docs/html directory (Refer next section)
  34 3.DB API example programs under the examples directory
  35
  36 Generating API Reference
  37 ------------------------
  38 Go to the root directory and enter
  39 $doxygen
  40
  41 This will create "docs/html" directory under which API Reference html files are stored. Refer index.html in that directory.
  42
  43 Starting the Server
  44 -------------------
  45 Note: kernel.shmmax should be set to more than 500 MB before starting the server
  46
  47 In linux for setting 1GB enter
  48 $sysctl -w kernel.shmmax=1000000000
  49
  50 You should find csqlserver executable under the bin directory of the installation.
  51 Change csql.conf file under the installation root directory if necessary.
  52 Set the CSQL_CONFIG_FILE environment variable to absolute path of csql.conf file.
  53
  54 $export CSQL_CONFIG_FILE=/tmp/csql.conf
  55
  56 Start the server using csqlserver executable
  57 $./csqlserver
  58
  59 This starts the server and creates the database file.
  60
  61 Shutting down the Server
  62 ------------------------
  63 Pressing Ctrl-C on the terminal where csqlserver is running, is safe and will stop the server gracefully by removing the database file.
  64