/** \page install Installation
You can use the %SQLDBC SDK for developing applications and interfaces written in C or C++.
This chapter describes how to install the %SQLDBC SDK software.

@par Installing the software using SDBINST

Download one of the MaxDB standard installation packages from <a href="http://dev.mysql.com/downloads/maxdb-<MAJOR_VERSION>.<MINOR_VERSION>.<FORMATED_CORRECTION_LEVEL>.html">here</a>.

The following operating systems are supported:

<table border=1>
   <tr>
<td>Microsoft Windows (x86)</td>
<td>maxdb-all-win-32bit-i386-<MAJOR_VERSION>_<MINOR_VERSION>_<FORMATED_CORRECTION_LEVEL>_<FORMATED_BUILD_PREFIX>.zip</td>
   </tr>
   <tr>
<td>Microsoft Windows (IA64)</td>
<td>maxdb-all-win-64bit-ia64-<MAJOR_VERSION>_<MINOR_VERSION>_<FORMATED_CORRECTION_LEVEL>_<FORMATED_BUILD_PREFIX>.zip</td>
   </tr>
   <tr>
<td>Linux (x86)</td>
<td>maxdb-all-linux-32bit-i386-<MAJOR_VERSION>_<MINOR_VERSION>_<FORMATED_CORRECTION_LEVEL>_<FORMATED_BUILD_PREFIX>.tgz</td>
   </tr>
   <tr>
<td>Linux (IA64)</td>
<td>maxdb-all-linux-64bit-ia64-<MAJOR_VERSION>_<MINOR_VERSION>_<FORMATED_CORRECTION_LEVEL>_<FORMATED_BUILD_PREFIX>.tgz</td>
   </tr>
   <tr>
<td>Sun Solaris (Sparc, 64-bit)</td>
<td>maxdb-all-sun-64bit-sparc-<MAJOR_VERSION>_<MINOR_VERSION>_<FORMATED_CORRECTION_LEVEL>_<FORMATED_BUILD_PREFIX>.tgz</td>
   </tr>
   <tr>
<td>HP-UX (HPPA, 64-bit)</td>
<td>maxdb-all-hpux-64bit-hppa-<MAJOR_VERSION>_<MINOR_VERSION>_<FORMATED_CORRECTION_LEVEL>_<FORMATED_BUILD_PREFIX>.tgz</td>
   </tr>
   <tr>
<td>HP-UX (IA64, 64-bit)</td>
<td>maxdb-all-hpux-64bit-ia64-<MAJOR_VERSION>_<MINOR_VERSION>_<FORMATED_CORRECTION_LEVEL>_<FORMATED_BUILD_PREFIX>.tgz</td>
   </tr>
   <tr>
<td>IBM AIX (PowerPC, 64-bit)</td>
<td>maxdb-all-aix5-64bit-ppc-<MAJOR_VERSION>_<MINOR_VERSION>_<FORMATED_CORRECTION_LEVEL>_<FORMATED_BUILD_PREFIX>.tgz</td>
   </tr>
   <tr>
<td>Tru64 (Alpha, 64-bit)</td>
<td>maxdb-all-true64-64bit-alpha-<MAJOR_VERSION>_<MINOR_VERSION>_<FORMATED_CORRECTION_LEVEL>_<FORMATED_BUILD_PREFIX>.tgz</td>
   </tr>
</table>

Unpack the downloaded file.

Change to the directory to which you have unpacked the installation
package.

Install the components 'Base' and 'Database Connectivity' using the following commands:

              <i>./SDBINST -package Base</i>

              <i>./SDBINST -package "Database Connectivity"</i>

The Base component is required for %SQLDBC SDK. If you have already installed any MaxDB component, you can skip the first command.

@par Installing the software from a tarball

Download the latest version of the %SQLDBC SDK from <a href="http://dev.mysql.com">here</a>. 

Select the %SQLDBC package that matches your operating system architecture.

<table border=1>
   <tr>
<td>Microsoft Windows (x86)</td>
<td>maxdb-sqldbc-win-32bit-i386-<MAJOR_VERSION>_<MINOR_VERSION>_<FORMATED_CORRECTION_LEVEL>_<FORMATED_BUILD_PREFIX>.zip</td>
   </tr>
   <tr>
<td>Microsoft Windows (IA64)</td>
<td>maxdb-sqldbc-win-64bit-ia64-<MAJOR_VERSION>_<MINOR_VERSION>_<FORMATED_CORRECTION_LEVEL>_<FORMATED_BUILD_PREFIX>.zip</td>
   </tr>
   <tr>
<td>Linux (x86)</td>
<td>maxdb-sqldbc-linux-32bit-i386-<MAJOR_VERSION>_<MINOR_VERSION>_<FORMATED_CORRECTION_LEVEL>_<FORMATED_BUILD_PREFIX>.tgz</td>
   </tr>
   <tr>
<td>Linux (IA64)</td>
<td>maxdb-sqldbc-linux-64bit-ia64-<MAJOR_VERSION>_<MINOR_VERSION>_<FORMATED_CORRECTION_LEVEL>_<FORMATED_BUILD_PREFIX>.tgz</td>
   </tr>
   <tr>
<td>Sun Solaris (Sparc, 64-bit)</td>
<td>maxdb-sqldbc-sun-64bit-sparc-<MAJOR_VERSION>_<MINOR_VERSION>_<FORMATED_CORRECTION_LEVEL>_<FORMATED_BUILD_PREFIX>.tgz</td>
   </tr>
   <tr>
<td>HP-UX (HPPA, 64-bit)</td>
<td>maxdb-sqldbc-hpux-64bit-hppa-<MAJOR_VERSION>_<MINOR_VERSION>_<FORMATED_CORRECTION_LEVEL>_<FORMATED_BUILD_PREFIX>.tgz</td>
   </tr>
   <tr>
<td>HP-UX (IA64, 64-bit)</td>
<td>maxdb-sqldbc-hpux-64bit-ia64-<MAJOR_VERSION>_<MINOR_VERSION>_<FORMATED_CORRECTION_LEVEL>_<FORMATED_BUILD_PREFIX>.tgz</td>
   </tr>
   <tr>
<td>IBM AIX (PowerPC, 64-bit)</td>
<td>maxdb-sqldbc-aix5-64bit-ppc-<MAJOR_VERSION>_<MINOR_VERSION>_<FORMATED_CORRECTION_LEVEL>_<FORMATED_BUILD_PREFIX>.tgz</td>
   </tr>
   <tr>
<td>Tru64 (Alpha, 64-bit)</td>
<td>maxdb-sqldbc-true64-64bit-alpha-<MAJOR_VERSION>_<MINOR_VERSION>_<FORMATED_CORRECTION_LEVEL>_<FORMATED_BUILD_PREFIX>.tgz</td>
   </tr>
</table>

Unpack the tarball to a local directory of your choice using the following command:

             tar -xvzf \<archive_name\>

@par  Creating a MaxDB database instance

You will need a MaxDB database instance. Please refer to the MaxDB documentation for details on how to install the MaxDB software and how to create a MaxDB database instance.

The MaxDB software and documentation can be found at the <a href="http://www.mysql.com/maxdb">MaxDB by MySQL homepage</a>.

@par  Files Installed

The %SQLDBC SDK consists of the following files

On Microsoft Windows
<table border=1>
<tr>
<td>\<indep_prog\>/pgm/libSQLDBC.dll</td>
<td>The %SQLDBC shared C++ runtime library</td>
</tr>
<tr>
<td>pgm/libSQLDBC_C.dll</td>
<td>The %SQLDBC shared C support runtime library</td>
</tr>
<tr>
<td>bin/sqldbc_cons.exe</td>
<td>%SQLDBC console for tracing and debugging</td>
</tr>
<tr>
<td>sdk/sqldbc/lib/libSQLDBC.lib</td>
<td>The %SQLDBC C++ import library</td>
</tr>
<tr>
<td>sdk/sqldbc/lib/libSQLDBC_C.lib</td>
<td>The %SQLDBC C support import library</td>
</tr>
<tr>
<td>sdk/sqldbc/incl/SQLDBC.h</td>
<td>The %SQLDBC SDK C++ header file</td>
</tr>
<tr>
<td>sdk/sqldbc/incl/SQLDBC_C.h</td>
<td>The %SQLDBC SDK native C support header file</td>
</tr>
<tr>
<td>sdk/sqldbc/incl/SQLDBC_Types.h</td>
<td>The %SQLDBC SDK type definition header file</td>
</tr>
</table>

On UNIX/LINUX
<table border=1>
<tr>
<td>\<indep_prog\>/pgm/libSQLDBC.so</td>
<td>The %SQLDBC shared C++ runtime library</td>
</tr>
<tr>
<td>pgm/libSQLDBC_C.so</td>
<td>The %SQLDBC shared C support runtime library</td>
</tr>
<tr>
<td>bin/sqldbc_cons</td>
<td>%SQLDBC console for tracing and debugging</td>
</tr>
<tr>
<td>sdk/sqldbc/incl/SQLDBC.h</td>
<td>The %SQLDBC SDK C++ header file</td>
</tr>
<tr>
<td>sdk/sqldbc/incl/SQLDBC_C.h</td>
<td>The %SQLDBC SDK native C support header file</td>
</tr>
<tr>
<td>sdk/sqldbc/incl/SQLDBC_Types.h</td>
<td>The %SQLDBC SDK type definition header file</td>
</tr>
</table>

@par Testing your installation

If your MaxDB instance has been created and is running, you can test the %SQLDBC SDK by making
 your first %SQLDBC application. 

Make sure that a C/C++ compiler, for example gcc, is installed on your system.

The Example section describes how to build the @link examples Hello World example@endlink
application.

        
*/
