This topic contains instructions to install the unixODBC Driver Manager.

Important noteImportant

See if another driver manager is installed on your computer, before you install the unixODBC Driver Manager. Installing the unixODBC Driver Manager could cause a failure of an existing Driver Manager.

Using the Installation Script

To install the driver manager:

  1. Make sure that you have root permission.

  2. Go to the directory where the Microsoft SQL Server ODBC Driver download placed the file called sqlncli-11.0.1790.0.tar.gz (make sure that you have the *.tar.gz file that matches your version of Red Hat Enterprise Linux). Run the following command to extract the files: tar xvzf sqlncli-11.0.1790.0.tar.gz.

  3. Change to the sqlncli-11.0.1790.0 directory and there you should see a file called build_dm.sh. You can run build_dm.sh to install the unixODBC Driver Manager.

  4. Execute the following command to see a list of the available options: ./build_dm.sh --help.

  5. When you are ready to install, and if your computer can access an external site via FTP, execute the following command: ./build_dm.sh.

    If your computer cannot access an external site via FTP, you will need to copy unixODBC-2.3.0.tar.gz to the computer where you are installing the unixODBC Driver Manager. You can get unixODBC-2.3.0.tar.gz by going to http://www.unixodbc.org/, clicking the Download link on the left side of the page, and saving the file unixODBC-2.3.0.tar.gz to your computer. In this scenario, execute the following command to begin the unixODBC Driver Manager installation with build_dm.sh: ./build_dm.sh --download-url=file://unixODBC-2.3.0.tar.gz.

  6. Type YES to proceed with unpacking the files. This part of the process can take up to five minutes to complete.

  7. After the script stops running, follow the instructions on the screen to install the unixODBC Driver Manager.

You are now ready to install the driver. See Installing the Microsoft SQL Server ODBC Driver for Linux for more information.

Manual Installation

If the installation script is unable to complete, you may configure and build the proper driver manager yourself.

  1. Remove any older installed version of unixODBC (for example, unixODBC 2.2.11). On RedHat Enterprise Linux 5 or 6, you can do this by executing the following command: yum remove unixODBC.

  2. Go to http://www.unixodbc.org/ and click the Download link on the left side of the page..

  3. Click the Download link, on the next page, and save the file unixODBC-2.3.0.tar.gz to your computer.

  4. On your Linux computer, execute the command: tar xvzf unixODBC-2.3.0.tar.gz.

  5. Change to the unixODBC-2.3.0 directory.

  6. At a command prompt, execute the command: CPPFLAGS="-DSIZEOF_LONG_INT=8".

  7. At a command prompt, execute the command: export CPPFLAGS.

  8. At a command prompt, execute the command: "./configure --prefix=/usr --libdir=/usr/lib64 --sysconfdir=/etc --enable-gui=no --enable-drivers=no --enable-iconv --with-iconv-char-enc=UTF8 --with-iconv-ucode-enc=UTF16LE".

  9. At a command prompt (logged in as root), execute the command: make.

  10. At a command prompt (logged in as root), execute the command: make install.

You are now ready to install the driver. See Installing the Microsoft SQL Server ODBC Driver for Linux for more information.

See Also