MicroStrategy ONE

ODBC Driver for MySQL for Linux

The ODBC driver for MySQL is not a MicroStrategy-branded driver. The following steps show how to configure the ODBC driver for MySQL, which is certified for the Linux operating system.

You must modify the odbc.ini file to create the DSN for MySQL.

The third-party product(s) discussed in the procedure below is manufactured by vendors independent of MicroStrategy. MicroStrategy makes no warranty, express, implied or otherwise, regarding this product, including its performance or reliability.

To configure ODBC driver for MySQL

Begin by installing the 64-bit ODBC Driver for MySQL for the Linux operating system, found at the hyperlink http://dev.mysql.com/downloads/connector/odbc/. This site is valid as of the release of this manual. For information on installation, refer to the product documentation provided by the database vendor.

  • Ensure that the driver files are installed to the /usr/lib directory.
  • For exact version numbers of MySQL drivers certified with MicroStrategy, refer to the MicroStrategy General Information Readme.

The following set of instructions are divided into two sections: how to define the location of driver files and how to modify the odbc.ini file.

To Define the Location of the Driver Files

  1. In a Linux console window, browse to HOME_PATH, where HOME_PATH is the directory you specified as the Home Directory during installation. Browse to the folder env.
  2. Add Write privileges to the ODBC.sh file by entering the following command:
    chmod u+w ODBC.sh
  3. Edit the ODBC.sh file and provide the location of the directory where the MySQL driver is installed. Within the ODBC.sh file, the following definition is included:

    MYSQL_PATH='<MYSQL_PATH>'

    Replace this <MYSQL_PATH> placeholder with the location of where the MySQL driver is installed.

    Do not modify any other occurrences of <MYSQL_PATH> within odbc.sh.

  4. Save the ODBC.sh file and remove Write privileges from the file by entering the following command:

    chmod a-w ODBC.sh

To Modify the odbc.ini File

  1. In a Linux console window, browse to HOME_PATH where HOME_PATH is the specified home directory during installation.
  2. Open the odbc.ini.example file and search for the section that starts with [MySQL].
  3. Open the MicroStrategy odbc.ini file.
  4. Copy and paste the contents from the odbc.ini.example file for your MySQL ODBC driver. You should paste the contents of the DSN exactly as they appear in the example file.
  5. Make the following changes to the copied sample file:

    • Modify the <MYSQL_ODBC_DIR> placeholder in the driver location to match the location of the installed MySQL ODBC Driver.
    • Change the database, server name, user name, password, and any other relevant parameters to match the information for your database. For information on the available parameters, refer to your third-party MySQL driver documentation. This can often be found along with the driver installation.

    Ensure that there is no white space between the equals sign (=) which separates the parameter and its value.

  6. Save the odbc.ini file.

You can test a connection to your MySQL database with the MicroStrategy DB Query Tool.

This completes the steps to create a DSN and configure an ODBC driver for MySQL. To create a database instance and database connection, see Creating a database instance and Creating a database connection.