#********************************************************
# FILE NAME:     HOWTO_ODBC
#                : How To Install database for Web+ application
#                  on Unix/Linux/Solaris ... 
#
# Copyright (c) 2000 by talentsoft, inc.
# ALL RIGHTS RESERVED
#
# DESCRIPTION:
# Documentation:  How To Use ODBC connectivity 
# on Linux/Unix/FreeBSD 
# 
#
# NOTE:
#
# COMMENT:
#
#******************************************************
SERVER SIDE - Windows
---------------------
1. Upsize the Microsoft Access 'webpdb.mdb' file to MS SQL 6.5, 7 using Microsoft's upsizing tool
	Office 2000 Integration with SQL Server 7
	http://www.microsoft.com/SQL/productinfo/officeintegration.htm

	Migrating MS Access to SQL Server 7
	http://www.microsoft.com/sql/interopmigrate/accessmigration.htm

	Microsoft Access Upsizing Tools
	http://www.microsoft.com/accessdev/prodinfo/aut97dat.htm

2. Configure an ODBC data source for the MS SQL 7 database using the Windows ODBC Data Sources control panel

3. Install the Openlink Request Broker software on the Windows server
	Go to Openlink Software's Web site: http://www.openlinksw.com
	
4. Configure the Openlink Request Broker Database agent
	http://<yourhost>:8000
	Refer to Openlink's Support forum for help on setting this up


CLIENT SIDE - Linux
-------------------

1. Download the Openlink SDK from http://www.openlinksw.com and install
	Untar the downloaded file and copy the file 'oplodbc.so.1' into /usr/local/webplus/bin

2. After the install, the user will have to edit the /usr/local/webplus/bin/odbc.ini file
	Webplus_Examples = OpenLink Generic ODBC Driver
	
	[Webplus_Examples]  
	Host            = <type in the host name>
	UserName        = <type in the username, ex: 'sa'
	Password	= <type in the password, if any>	
	ServerType      = <type in the servertype, ex: 'SQLServer 7'
	Database	= <type in the database name, ex: 'webpdb'

3. Add a Datasource from the Web+ Server Manager
	Data Source Name: <type in the data source name. ex: 'Webplus_Examples'>
	DSN Type:	ODBC
	UserID:		<leave blank>
	Password:	<leave blank>
	Host:		<leave blank>
	Port:		<leave blank>

TESTING
-------
Now you can verify that WebPlus can connect to the MS SQL 7 database by going to Verify Web+ and click on Web+ User Authentication. You can also try the database integration examples, such as the Address Book example.

If that doesn't work, you may want to try a more low-level test using the 'odbctest' program included with the Openlink SDK. Refer to the Openlink documentation to find out how to use this utility.

Note: We have not yet tested Webplus with ODBC software other than those offered by Openlink, but since we have  compiled Webplus with iODBC, you should be able to use software from other vendors, such as Easysoft  (http://www.easysoft.com).
