Warning, /RDBC/INSTALL is written in an unsupported language. File is not indexed.
0001
0002
0003 Build and installation steps for RDBC.
0004
0005 ======================================================================
0006
0007
0008 ______________________________________________________________________
0009
0010
0011 Table of Contents
0012
0013
0014 1. Software requirements
0015
0016 1.1 ROOT
0017 1.2 ODBC Driver Manager
0018 1.3 Drivers
0019
0020 2. Installation
0021
0022 2.1 UNIX
0023 2.1.1 Configuration
0024 2.1.2 Compilation
0025 2.1.3 Installing
0026
0027 2.2 RedHat Linux (creating RPMs)
0028
0029 3. Testing
0030
0031 4. Documentation
0032
0033 ______________________________________________________________________
0034
0035
0036 1. Software requirements
0037
0038
0039 1.1. ROOT
0040
0041 To compile RDBC, you need to have installed ROOT <http://root.cern.ch>
0042 version 3.00 or better.
0043
0044
0045 o Define the variable ROOTSYS pointing to the directory where you
0046 unpacked the ROOT distribution:
0047
0048
0049 export ROOTSYS=<pathname>/root (in bash or ksh)
0050 setenv ROOTSYS <pathname>/root (in csh or tcsh)
0051
0052
0053 o Add ROOTSYS/bin to your PATH and $ROOTSYS/lib to LD_LIBRARY_PATH:
0054
0055 in bash or ksh:
0056
0057 export PATH=$ROOTSYS/bin:$PATH
0058 export LD_LIBRARY_PATH=$ROOTSYS/lib:$LD_LIBRARY_PATH
0059
0060 in csh or tcsh:
0061
0062 setenv PATH ${ROOTSYS}/bin:${PATH}
0063 setenv LD_LIBRARY_PATH ${ROOTSYS}/lib:${LD_LIBRARY_PATH}
0064 rehash
0065
0066 o try running root:
0067
0068 all shells:
0069
0070 root
0071
0072
0073 1.2. ODBC Driver Manager
0074
0075 The ODBC Driver Manager is the software layer between applications and
0076 ODBC drivers. You must have one installed in order to use this
0077 library. The free choices on UNIX are:
0078
0079
0080 o unixODBC <http://www.unixodbc.org/>. Version 1.8.4 or later is
0081 recommended.
0082
0083 unixODBC RPMs can be downloaded from
0084 <http://grapeape.codingapes.com/unixODBC.xml>
0085
0086 Note: you need to download at least
0087 unixODBC-xxx.rpm and unixODBC-devel-xxx.rpm
0088
0089 o iODBC <http://www.iodbc.org/>. Version 2.50.3 or later is
0090 recommended.
0091
0092
0093 1.3. Drivers
0094
0095 To actually use RDBC, you will need one or more ODBC drivers.
0096 Examples of free database engines with ODBC drivers are:
0097
0098
0099 o MySQL <http://www.mysql.com/downloads/api-myodbc.html>
0100
0101 MyODBC RPMs built specifically to work with unixODBC can be downloaded from:
0102 <http://grapeape.codingapes.com/myodbc.xml>
0103
0104
0105 MyODBC RPMs built specifically to work with iODBC can be downloaded from:
0106 <http://www.mysql.com/Downloads/MyODBC/>
0107
0108 o PostgreSQL <http://www.postgresql.org/>
0109
0110
0111 MyODBC (the MySQL ODBC driver version 2.50.23 or later is known to
0112 work fine with both iODBC and unixODBC).
0113
0114 If you can't find an ODBC driver for the RDBMS you need to access, you
0115 can probably buy a solution from Openlink Software
0116
0117 <http://www.openlinksw.com/>
0118
0119 or Merant <http://www.merant.com/>.
0120
0121
0122
0123 2. Installation
0124
0125 2.1. UNIX
0126
0127 The following information applies for installing RDBC on unices.
0128
0129
0130 2.1.1. Configuration
0131
0132 First, you need to configure RDBC for your system. Go into the
0133 source directory and do
0134
0135
0136 $ ./configure
0137
0138
0139 o If you are using iODBC:
0140
0141 If your iODBC is not installed in it's default location - /usr/local,
0142 you might have to use
0143
0144
0145 --with-iodbc=DIR
0146
0147
0148 or if the iODBC headers aren't residing in DIR/include, you can also use
0149
0150
0151 --with-iodbc-includes=INCDIR
0152
0153
0154 Same goes for libraries - if they aren't in DIR/lib, use
0155
0156
0157 --with-iodbc-libs=LIBDIR
0158
0159
0160
0161 o If you are using unixODBC:
0162
0163 To make configure look for unixODBC instead of iODBC, use
0164
0165
0166 --with-odbc=DIR
0167
0168
0169 Where DIR is where unixODBC is installed.
0170 Works the same as above, except it looks for standard ODBC headers and
0171 libraries instead of the iODBC ones. This should be used with for
0172 example unixODBC and Intersolv.
0173
0174 And (as usual), if the unixODBC headers and libraries aren't located
0175 in DIR/include and DIR/lib, use
0176
0177
0178 --with-odbc-libs=LIBDIR
0179 --with-odbc-includes=INCDIR
0180
0181
0182 o By default $ROOTSYS directory is used for installation.
0183
0184 If you wish to install RDBC in a location other than $ROOTSYS,
0185 add --prefix=PREFIX to the ./configure arguments.
0186
0187
0188 o You can control the ODBC version libodbc++/RDBC uses by specifying:
0189 --with-odbc-version=ODBCVER, where ODBCVER should be a four-digit
0190 hexadecimal value. For example 0x0250 means ODBC 2.50.
0191
0192 o Configuration examples:
0193
0194 In most cases you only need to specify which driver manager
0195 installed in your system, e.g.
0196
0197
0198 $ ./configure --with-odbc
0199
0200 or
0201
0202 $ ./configure --with-iodbc
0203
0204 or
0205
0206 $ ./configure --with-odbc --prefix=~/tmp/RDBC
0207
0208
0209 2.1.2. Compilation
0210
0211 Just type
0212
0213
0214 $ gmake
0215
0216
0217
0218 2.1.3. Installing RDBC
0219
0220 If you have write privileges in PREFIX, just do
0221
0222
0223 $ gmake install
0224
0225
0226
0227 Otherwise, you'll have to use
0228
0229
0230 $ su root -c 'gmake install'
0231
0232
0233 2.1. RedHat Linux
0234
0235 You probably will wish to install RDBC in your system by using RPMs.
0236 To create or rebuid RDBC RPM you can :
0237
0238 download the source RPM, e.g RDBC-[version]-1.src.rpm
0239 $ rpm --rebuild RDBC-[version]-1.src.rpm
0240
0241 or create it by executing gmake
0242
0243 $ gmake rpm
0244
0245
0246 3. Testing RDBC
0247
0248 If it all goes well, you can try a couple of the test macros in
0249 macros/ or PREFIX/macros/RDBC/. Check also macros/README.RDBC.
0250
0251
0252 4. Documentation
0253
0254 If RDBC library compiled well to generate HTML documentation just do;
0255
0256 $ gmake html
0257
0258
0259 ______________________________________________________________________
0260
0261
0262 Visit RDBC home: <http://www.phenix.bnl.gov/WWW/publish/onuchin/RDBC/>
0263
0264
0265 ______________________________________________________________________
0266
0267 Valeriy Onuchin <onuchin@sirius.ihep.su>
0268 IHEP, Protvino, Moscow region, Russia
0269
0270 $Id: INSTALL,v 1.1.1.1 2004/02/18 20:58:02 dave Exp $
