The ODBTP client/server package requires the installation of a Win32 service, and a C client library. While the service can only be installed on a Win32 host, the client library can be installed on both non-Win32 and Win32 hosts.

Unpacking the Distribution Files
Win32 Service Installation
Client Library Installation (UNIX)
Client Library Installation (Win32)
PHP Extension Installation (UNIX-Static)
PHP Extension Installation (UNIX-Shared)
PHP Extension Installation (Win32)
PHP Extension Installation (NetWare)
Installing PHP Extension with MSSQL Support
 
 

Unpacking the Distribution Files

1. Download the odbtp-1.1.4.tar.gz file.
2. Run zcat odbtp-1.1.4.tar.gz | tar xf -

Win32 Service Installation

1. Create a directory on the Windows host where the service program files will reside, i.e., md odbtp.
2. Copy the files odbtpctl.exe, odbtpsrv.exe and odbtpsrv.ini files from the winservice directory into the directory created in step 1.
3. Open a command prompt (cmd) window on the Windows host.
4. Change to the directory to which the service program files were copied, i.e., cd odbtp.
5. Run the following commands to install and start the service:

      odbtpctl install
   odbtpctl start
   

Client Library Installation (UNIX)

1. Run configure --help to view available configuration options.
2. configure [options]
3. make
4. make install

Client Library Installation (Win32)

1. Open a Windows Explorer window and go to the folder containing the ODBTP distribution files.
2. Double-click on the libodbtp.dsw file.
3. Use the Build | Set Active Configuration menu option to select the libodbtp - Win32 Release project configuration.
4. Use the Build | Build menu option to build the project.
5. Copy odbtp.h to an "include" directory that can be accessed by projects that will be built with the ODBTP client library.
6. Copy libodbtp.lib from Release to a "lib" directory that can be accessed by projects that will be built with the ODBTP client library.

PHP Extension Installation (UNIX-Static)

1. Copy the directory odbtp and all its contents from php/ext into <php source distribution directory>/ext.
2. Change to the PHP source distribution directory.
3. Run the command buildconf to rebuild the configure script.
4. Run configure --with-odbtp {other configure options].
5. Run make and then make install.

PHP Extension Installation (UNIX-Shared)

1. Change to the directory php/ext.
2. Open the file Makefile in an editor, such as vi, and change the value of PHP_INCROOT, if necessary.
3. Run make.
4. Copy the file php_odbtp.so to a location where it can be loaded in a PHP script with the dl() function.

PHP Extension Installation (Win32)

1. Copy the file php_odbtp.dll from the applicable php-x.x.x directory under php/bin_win32 into the directory where the other Win32 PHP extensions are located.
2. Edit the php.ini file and add the line extension=php_odbtp.dll where the other Win32 extensions are specified.
3. Restart the web server used with PHP so that the extension can be loaded.

PHP Extension Installation (NetWare)

1. Copy the file php_odbtp.nlm from the applicable php-x.x.x directory under php/bin_netware into the directory where the other NetWare PHP extensions are located; usually this is sys:/php4/ext, or sys:/php5/ext.
2. Edit the php.ini file and add the line extension=php_odbtp.nlm where the other NetWare extensions are specified.
3. Restart the web server used with PHP so that the extension can be loaded.

Installing PHP Extension with MSSQL Support

For UNIX-static installation, use --with-odbtp-mssql instead of --with-odbtp.

For UNIX-shared installation, uncomment the line that includes -DODBTP_MSSQL among the settings for MODULE_CFLAGS in the Makefile.

For Win32 installations, use php_odbtp_mssql.dll instead of php_odbtp.dll.

For NetWare installations, use php_odbtp_mssql.nlw instead of php_odbtp.nlw.