How To Install and Configure the Lite Edition ODBC Drivers for Microsoft SQL Server (Linux)

Pre-Installation Guide

  1. You need to know a variety of information pertaining to your Microsoft SQL Server DBMS:
    • Microsoft SQL Server instance name: The name of the Microsoft SQL Server instance.
    • Microsoft SQL Server listen port: The port number on which the Microsoft SQL Server is listening.
    • Microsoft SQL Server database name: The name of the database within the Microsoft SQL Server.
    • Microsoft SQL Server database server hostname or IP address: The hostname or IP address of the server where the Microsoft SQL Server is running.

Installation Guide

  1. The installation files ship as an installation shell script, a driver and admin .taz file, and a license .lic file. The installation shell script should be ftp'd in ascii. The rest of the files should be ftp'd in binary, where applicable.
  2. Downloads these documents, and place them in your desired installation folder.
  3. Start the installation process by opening the installation directory using cd, and running sh install.sh.
  4. You must choose a TCP port on which to run your HTTP-based iODBC Data Sources Administrator. The default is 8000. You will need to know this port number and your local machine's IP address or hostname to access your Admistrator in a Web browser. This is how you call it: http://machine:portnumber
  5. Log File? enables you to rename and relocate your Administrative Assistant's log file. It is best to go with the default.
  6. You can choose to log all requests. This is not diagnostic-level odbc tracing or connection logging. The default is no.
  7. You can change the iODBC Data Source Administrator's default username from "admin." This is the name that you will need to login to OpenLink's HTTP-based iODBC Data Sources Administrator.
  8. You can change the iODBC Data Source Administrator's default password from "admin."
  9. The installation is complete.

Configuration Guide

  1. Prerequisites:
    • You MUST be proficient in using a Unix shell.
    • You MUST be proficient in using a Unix editor such as vi.
    • You MUST be in possession of relevant database connectivity details such as Database name, Username, password, etc.
  2. Open the file <OPENLINK_INSTALL>/bin/odbc.ini with a suitable text editor such as vi.
  3. Locate and edit the sample OpenLink SQL Server ODBC data source (DSN) created during the installation process and edit as follows: 
          [sqlserver]
      Driver            = <OPENLINK_INSTALL>/lib/sql_mt_lu.so
      ServerType        = SQLServer 2000
      Options           = -H sqlserver.hostname -P 1433
      Database          = database
      UserName          = sa
      Password          = **********
      FetchBufferSize   = 99
      ReadOnly          = no
      DeferLongFetch    = no
      JetFix            = no
      Description       =
  4. Use the iodbctest tool which is packaged with the HTTP-based OpenLink ODBC Administrator as follows: 
          # cd <OPENLINK_INSTALL>
      # . ./openLink.sh
      # iodbctest sqlserver
    iODBC Demonstration program
    This program shows an interactive SQL processor
    Driver Manager: 03.52.0507.0105
    Driver: 06.02.1217 OpenLink Generic ODBC Driver (sql_mt_lt.so)

    SQL>
  5. You should now be able to issue SQL statements directly against the target database.

Additional Information:
The bitness of the ODBC Driver for MySQL is determined by the bitness of your ODBC client application.
That is, if your ODBC client application is 32-bit then the Generic ODBC Driver component MUST also be 32-bit.