INSTALL
上传用户:dgyhgb
上传日期:2007-01-07
资源大小:676k
文件大小:7k
源码类别:

SQL Server

开发平台:

Unix_Linux

  1. GNU SQL Server Installation Guide
  2. Copyright (c) 1996 Free Software Foundation, Inc
  3. Developed at Institute for System Programming of Russian Academy of Science
  4.    Permission is granted to anyone to make or distribute verbatim copies
  5.    of this document as received, in any medium, provided that the
  6.    copyright notice and permission notice are preserved,
  7.    and that the distributor grants the recipient permission
  8.    for further redistribution as permitted by this notice.
  9.    Permission is granted to distribute modified versions
  10.    of this document, or of portions of it,
  11.    under the above conditions, provided also that they
  12.    carry prominent notices stating who last changed them,
  13.    and that any new or changed statements about the activities
  14.    of the Free Software Foundation are approved by the Foundation.
  15. BUILDING AND INSTALLATION:
  16. (This is for a Unix or Unix-like system.)
  17. 1) INTRODUCTION. Make sure your system has enough swapping space
  18. allocated to handle a program whose code and data exceed 10M bytes.
  19. Building GSS requires about 60 Mb of disk space (including the GSS
  20. sources).  Once installed, GSS occupies about 15 Mb for code and Doc-s
  21. in the file system where it is installed. You need there also additional
  22. space for database itself. We expect you need to have ~70M to install
  23. package
  24. 2) CONFIGURATION. In the top directory of the GSS distribution, run the
  25.   program `configure' as follows:
  26.     ./configure CONFIGURATION-NAME [--OPTION[=VALUE]] ...
  27. The CONFIGURATION-NAME argument should be a configuration name given
  28. in `./etc/MACHINES'.  If omitted, `configure' will try to guess your
  29. system type; if it cannot, you must find the appropriate configuration
  30. name in `./etc/MACHINES' and specify it explicitly. We RECOMMEND to
  31. allow configure to guess your case.
  32. The `--prefix=PREFIXDIR' option specifies where the installation process
  33. should put GSS and its data files.  This defaults to `/usr/local'.
  34. All files, required for GSS to run, go to subtree
  35. 'share/gnusql/version/configuration' unless you set 'dbhome' variable of
  36. makefile to another directory. In the directory:
  37. - server components stored in 'bin' subdirectory
  38. - client libraries and utilities in 'client' subdirectory
  39. - 'doc' subdirectory contains man's pages and info tutorial
  40.   respectively
  41. - 'db' subdirectory is intended to contain database segments, logs and is
  42.   a working space.
  43. - other sets of directories which are created empty are intended to store
  44.  database backups and log
  45. The Installation process also gives symbolic Links to
  46. - all of client executables as well as SQL server administrator
  47.   in PREFIXDIR/bin (unless the `--exec-prefix' option of configure
  48.   or 'bindir' variable of make says otherwise).
  49. - the client runtime library in PREFIXDIR/lib (make's 'libdir' variable)
  50. - man files in PREFIXDIR/man (make's 'mandir' variable)
  51. - info files in PREFIXDIR/info (make's 'infodir' variable)
  52. The `--enable-DEBUG' option specifies whether you need you need to 
  53. compile debugging features of server. In this case configuration
  54. will check for the debugger and some of it's possible 'graphical'
  55. environment (at least xterm). The compiled programs will ask you
  56. interactively if you want to start the debugger.
  57. The `--enable-PROFILE' option turns on the compiler and linker options for
  58. the profiling server and runtime library code. It will require you to use
  59. the same option with your own embedded SQL program.
  60. The `--help' will show you the list of possible options. A detailed
  61. description can be found in the 'configure' manual.
  62. For example, the command
  63.     ./configure sparc-sun-solaris2.4 --enable-DEBUG
  64. configures GSS to build for a SPARCstation running Solaris2.4, with
  65. support for the server's debug (automatic debugger start for desired
  66. subprocesses and other related stuff).
  67. `configure' doesn't do any compilation or installation
  68. itself.  It just creates the files that influence those things:
  69. `./Makefile', `src/.../makefile', `test/makefile',
  70. and `./src/include/config.h'.  For details on exactly what it 
  71. does, see the section called `CONFIGURATION BY HAND', below.
  72. When it is done, `configure' creates a shell script `config.status'
  73. which, when run, recreates the same configuration.  If `configure'
  74. exits with an error after disturbing the status quo, it removes
  75. `config.status'.  `configure' also creates a file `config.cache'
  76. that saves the results of its tests to make reconfiguring faster,
  77. and a file `config.log' containing compiler output (useful mainly
  78. for debugging `configure').  You can give `configure' the option
  79. `--cache-file=FILE' to use the results of the tests in FILE instead
  80. of `config.cache'.  Set FILE to `/dev/null' to disable caching, for
  81. debugging `configure'.
  82. The work of `configure' can be done by editing various files in the
  83. distribution, but using `configure' is supposed to be simpler.  See
  84. the section called "CONFIGURATION BY HAND" below if you want to do the
  85. configuration yourself.
  86. 3) BUILDING. Run `make' in the top directory of the GSS distribution 
  87. to finish building GSS in the standard way.  The final executable and
  88. initialized database will be created at 'sqlser' subdirectory.
  89. Or you can "INSTALL" the executable and the other GSS related data
  90. into their installed locations, with `make install'.  By default, 
  91. GSS's files are installed in the directories listed above. At that time
  92. you can change package installation directory giving 'make-VAR=you_own_way' as
  93. one of make arguments. 'make-VAR' should be one of make variables
  94. described above.
  95. Remember that you must specify any variable values you need each time
  96. you run `make' in the top directory.  If you run `make' once to build
  97. GSS, test it, and then run `make' again to install the files, you
  98. must provide the same variable settings each time.  To make the
  99. settings persist, you can edit them into the `Makefile' in the top
  100. directory, but be aware that running the `configure' program erases
  101. `Makefile' and rebuilds it from `Makefile.in'.
  102. CONFIGURATION BY HAND
  103.    To be filled later
  104. ( We strongly recommend to use configure. If you prefer to do it manually
  105.   we can only suggest you read the 'Autoconf' and 'configure' manuals
  106.   and consult 'configure.in'. And we would like to have your comments,
  107.  and any questions.)
  108. BUILDING GNU SQL Server BY HAND
  109.    To be filled later
  110. INSTALLATION BY HAND
  111. The steps below are done by running `make install' in the main
  112. directory of the GSS distribution.
  113. Strictly speaking, 'sqlser' subdirectory of the building tree is copied to
  114. a given place and symbolic links are created in all defaults directories 
  115. After that we recommend you identify the server as a separate user and
  116. change all files owner id to it.
  117. USING GSS
  118. To start SERVER you need to run 'gsqls' from 'dbhome' directory. If you 
  119. want to run it in background, you have to redirect output streams to log.
  120. To compile a client program you need to run 'gsqlc'. It finds the server
  121. checking option '-hHOSTNAME', environment variable 'GSSHOST' and, finally,
  122. 'localhost'. Programs containing pure SQL code (SQL scheme declarations)
  123. should have '.sql' extension. SQL embedded to C programs should have '.ec'
  124. extension. Being compiled your code will be transformed to C code, which
  125. memorizes connected host. Options '-lgss' tells linker to use the runtime
  126. library.
  127.  
  128. PROBLEMS
  129. See the file PROBLEMS in this directory for a list of various
  130. problems sometimes encountered, and what to do about them.