README for the HP Neoview ODBC Drivers for UNIX HP Part Number: 621038-001 Published: July 2010 Edition: HP Neoview Release 2.5 and subsequent updates.
© Copyright 2010 Hewlett-Packard Development Company, L.P. Legal Notice Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor’s standard commercial license. The information contained herein is subject to change without notice.
Table of Contents Checking Version Compatibility............................................................................................................5 Getting the Version of an Installed Client Product...........................................................................5 Installation of the Neoview ODBC Drivers for UNIX............................................................................6 Installation Package................................................................................
Checking Version Compatibility Before installing the client product, you must check that the product is compatible with the version of the Neoview release installed on the Neoview platform. For all client products, refer to the Neoview Client and Platform Compatibility Reference for version compatibility information. This document is available at http://www.hp.com/go/neoviewdocs.
2. Use the nm command to return this version information: _###HPODBC__x.y.z_ • • • is a three-character or seven-character identifier for the SPR, for example N27 or N25_AAX. x.y.z is the version number (for example, 2.4.3 for driver Release 2.4, Update 3). is the date, where yy is the year, mm is the month, and dd is the day (for example, 060419).
NOTE: These instructions do not necessarily apply to updates earlier than the client update number shown on the title page of this document. • • • Installation Package Installation Requirements Installation Instructions Installation Package The HP Neoview UNIX driver software is available in these downloadable distribution files: Distribution File File Contents Supported Platform HP_Neoview_ODBC_Linux_Driver_Vx.y.z_ nnnnnn_nnn.tar.gz libhpodbc_l.so. libhpodbc_drvr_l.so. libhpsecClient.
Distribution File 8 File Contents Supported Platform HP_Neoview_ODBC_HP-UX_Itanium_Driver_Vx.y.z_ libhpodbc_i.sl. libhpodbc_drvr_i.sl. nnnnnn_nnn.tar.gz libhpsecClient. libicudataNv44..441 libicuucNv44..441 MXODSN MD5SUM sql.h sqlext.h sqltypes.h hpsqlext.h install.h connect_test.cpp HP-UX IA-64 HP_Neoview_ODBC_HP-UX_Itanium_Driver_64_Vx.y.z_ libhpodbc_i64.sl. libhpodbc_i64_drvr.sl. nnnnnn_nnn.tar.gz libhpsecClient64. libicudataNv44..441 libicuucNv44..
Distribution File File Contents Supported Platform HP_Neoview_ODBC_IBM_AIX_Driver_Vx.y.z_ nnnnnn_nnn.tar.gz libhpodbc.a..gcc libhpodbc.a..xlc libhpodbc_drvr.a..gcc libhpodbc_drvr.a..xlc libhpsecClient. libicudataNv44..441 libicuucNv44..441 MXODSN MD5SUM sql.h sqlext.h sqltypes.h hpsqlext.h install.h connect_test.cpp IBM AIX® HP_Neoview_ODBC_IBM_AIX_Driver_64_Vx.y.z_ libhpodbc64.a..gcc libhpodbc64.a..xlc nnnnnn_nnn.tar.gz libhpodbc64_drvr.a..gcc libhpodbc64_drvr.a..
release version. The client product version includes the major Neoview release number, x.y, and the client update number, z. The client update number is 0 the first time that the client product is issued for a major Neoview release, such as Release 2.5. The update number then increases by one for each update of the client product for the major Neoview release. For example, V2.5.0 is the first release of the client product for Neoview Release 2.5, and V2.5.1 is the first client update for Neoview Release 2.
5. 6. 7. Follow the instructions to download the driver, and select a driver that is compatible with the client operating system. Move the distribution file into the temporary directory on the client workstation: Client Operating System Distribution File x86_Linux HP_Neoview_ODBC_Linux_Driver_Vx.y.z_nnnnnn_nnn.tar.gz x86_64 Linux HP_Neoview_ODBC_Linux_Driver_64_Vx.y.z_nnnnnn_nnn.tar.gz IA-64 Linux HP_Neoview_ODBC_Linux_Driver_IA64_Vx.y.z_nnnnnn_nnn.tar.
8. 9. Extract the installation and product files. A directory called PkgTmp is created. Client Operating System tar Command x86_Linux tar –xvf HP_Neoview_ODBC_Linux_Driver_Vx.y.z_nnnnnn_nnn.tar x86_64 Linux tar –xvf HP_Neoview_ODBC_Linux_Driver_64_Vx.y.z_nnnnnn_nnn.tar IA-64 Linux tar –xvf HP_Neoview_ODBC_Linux_Driver_IA64_Vx.y.z_nnnnnn_nnn.tar HP-UX (IA-64) tar –xvf HP_Neoview_ODBC_HP-UX_Itanium_Driver_Vx.y.z_nnnnnn_nnn.
Setting Up the Client Environment If you selected default options during installation, ensure that: • The include (*.h) files are in the /usr/include/hpodbc directory. • An MXODSN file is in the /etc/hpodbc directory. By default, the MXODSN file in the package will be installed as /etc/hpodbc/ MXODSN.template. Rename it to MXODSN, and make necessary changes to the file before using the driver. • The libraries are located in the /usr/lib directory.
2. Compile the sample program. These are the 64-bit drivers: • 64-bit driver for HP-UX(IA-64) • x86_64 Linux • IA-64 Linux • HP-UX PA-RISC drivers • 64-bit driver for IBM AIX The rest are are 32-bit drivers. Be sure to compile your applications accordingly. Client OS Compile Command x86 Linux g++ connect_test.cpp -L/usr/lib -I/usr/include/hpodbc -lhpodbc \ -o connect_test NOTE: This Linux driver is a 32-bit driver.
Client OS Compile Command IA-64 Linux g++ connect_test.cpp -L/usr/lib -I/usr/include/hpobdc \ -lhpodbc -o connect_test NOTE: On IA-64 Linux, you will occasionally see warning messages like “unaligned access to 0xa00000020065805f, ip=0xa0000001002a48d1.” This warning can be ignored. To disable these warning messages, enter: prctl --unaligned=silent This command turns off all unaligned access warnings for that session. For more information, see http://kbase.redhat.com/faq/FAQ_105_9111.shtm.
Client OS Compile Command IBM AIX® g++ -maix32 connect_test.cpp -L/usr/lib -I/usr/include/hpodbc \ -lhpodbc -o connect_test or, if the xlc/xlc++ compiled HP ODBC library is installed: xlc++ -q32 connect_test.cpp -L/usr/lib -I/usr/include/hpodbc \ -lhpodbc -o connect_test IBM AIX® 64 bit g++ -maix64 connect_test.cpp -L/usr/lib -I/usr/include/hpodbc \ -lhpodbc64 -o connect_test or, if the xlc/xlc++ compiled HP ODBC library is installed: xlc++ -q64 connect_test.