Included in the tdbengine-package are install.bat (for Windows) or install.sh (for Linux). You can execute this program to perform the installation interactively. Indeed a little manual work always remaines to get the system up and running as a http-server and cgi-interpreter. The procedure is most easy by using apache, at least if it was installed in the standard directories. In this case the installation program performs everything on its own, though apache needs to be restarted manually afterwards.
Store tdbengine.tar.gz (Linux) or tdbengine.zip (Win32) in your own directory and unpack the archive there.
Now execute install.sh or install.bat:
./install.sh [RETURN] in Linux
./install.bat [RETURN] in Win95/98/NT
Now the installation program asks you for a directory, in which the tdbengine-package shall be installed. As preset values we have chosen:
(/sbin/tdbengine is often chosen by Linux users, while the tdbengine-package is regarded as a later-installed application). This directory must be available to all network users and they must have the rights for reading and executing programs. The write right must be granted also, when databases shall be modified or other files shall be created and written.
Do not use the directory .../cgi-bin/, which is the default directory of the web server for CGI-programs. The administrationtools of the server should be kept here. Under Linux you must login as supervisor (=root), because only then you can configure the http-server accordingly.
It is always advisable to distribute CGI-programs according its classes into different directories, so all Perl-programs in one directory and all tdbengine-programs in another. To hide the directory structure, the so-called aliases are defined. A wide-spread alias is /cgi-bin/ for the directory with the Perl-programs. In accordance with this let us use the alias /cgi-tdb/ for tdbengine-programs. Of course, you may choose whichever name you like.
The installation program performs the following:
The installation program creates within the installation directory the following directory structure:
bin for tdbengine and the log files
database for databases
doc for HTML-dokuments
The executable tdbengine is copied in the bin-directory. If you wish log files to be written, you need to grant the right for creating files.
The database and doc directories remain empty for the time being.
In the installation directory itself the programs
test (writes "Hello world...")
pdk (Program editor and compiler)
ddk (Database generator)
dmk (Database maintenance)
are installed and granted the necessary rights.
After the creation of the directories and the copying of the files the program asks you whether it should alter the configuration file "httpd.conf" itself. If you work with apache, you can simply set "Y" here and the installation program carries out the neccessary modifications.
Now you only need to adjust the http-server to use the modified configuration file. How to do this, please refer to the supplied documentation of apache.
If you work with another Web server, it needs to be configured that
a) .prg-files are accepted as CGI-scripts, and
b) the program starts tdbengine.exe (or under Linux: tdbengine) instead of the .prg-files.
Here the behavior is different depending on operating system and server software.
Internet Information Server (Win NT)
Under Windows NT you need to insert an entry into the registry. If you are not acquainted with this part of the operating system, please ask someone, who is really an expert, to set the configuration for you. Set
to the value \directory\bin\tdbengine.exe %1 %2 under the name .prg, pointing to the diretory, in which the program was copied by you previously. Now please reboot the computer, to let the modification come into effect.
Now you can start the IIS-administration and input as (extra) CGI directory, in which tdbengine.exe is placed. Then create a directory alias, e.g. /cgi-tdb. These alias names for directories are an effective mechanism to hide the directory structure of your computer against alien accesses.
sambar is quite a well-tempered http-server for Win95/98. Here you also need to link files with the extension .prg to tdbengine.exe. Most easily this is carried out by the Windows-Explorer. Find a prg-file and double click it. Now a dialog box appears, where Windows asks, with which program this file shall be associated. Insert the complete path to tdbengine.exe here and check the box "open always with this program". That's all. In the sambar configuration you can insert the script alias in the directory of the tdbengine.
After the installation go to the URL: http://localhost/cgi-tdb/test.prg in your browser
If the message "Hello world..." appears on your screen, the CGI programming can be started. Otherwise you have no choice but to repeat the installation and configuration step by step.