GNADE User's Guide: GNADE, The GNat Ada Database Environment; Version 1.2.0; Document Revision $Revision: 1.26 $ | ||
---|---|---|
Prev | Next |
The GNADE project distribution is currently distributed only as development snapshot, which means the packages do not contains any binary files. There for before starting make sure that you have all required tools (see release notes ./doc/releasenotes).
The development package contains the sources for all platforms so far supported. GNADE support the two major platforms Windows NT and Unix/Linux. The following sections are describing the installation steps for both platforms.
After you obtained the source code from the net you need to install and compile it. This chapter describes this first steps of installing the environment onto your system.
The source code is normally distributed as compressed tar file. To unpack the distribution execute the command:
gunzip -c | tar xvf -This will unpack the directory tree of the development environment.
The GNADE environment may be configured to a certain extend. The file make.conf.in contains some parameters which might be adopted to the needs of your system.
After unpacking the distribution change into the top level directory of the GNADE release as shown below and run the configure script.
cd gnade-src-.... ./configure <database>For the supported data bases please check the README file in the gnade directory. If you don't have one of the supported data bases on your system then omit the database. As a result the samples code will be compiled except the code for native bindings, but the sample data base will not be available.
In order to allow the installation of the test database, most of the commonly known dbcs's require a data base user to be installed. This normally required certain DBA privileges. There for this step is expected to be done manual as shown below (The name of the user, the name of the data base is specified in make.conf.in).
su <dbcs root> make createuserThe user may be deleted by the command make removeuser.
In order to test the functionality of the data base you may create the test data base already at this point by the following commands:
make removedb make createdbThis will create a database gnade which contains at least the table EMPLOYEES which may be checked manually.
Mimer SQL: In case of Mimer SQL the user is created as root, but the make createdb command has to be executed as the same user which is used to run the test examples. If thus is not done, the examples will fail!
To build the GNADE executable enter the command below:
make allThis will build all components of the GNADE project and the test data base is this has not been done previously.
The development environment is self containing, which means as long as applications are developed in the directory where GNADE is installed and the make files are used, all components are taken from the GNADE lib directory. This method limits the use to one user. In order to make GNADE available to all users on your system you need to install the GNADE libraries. Installation is done as root by executing the directory ../gnuada/gnade the following command:
make install
This should install the libraries of the GNADE project in your system. Because this procedure depends on the type of your system please check and modify the following variables in make.conf.in before execution.
LIBINSTALL=/usr/local/lib/ada BININSTALL=/usr/bin