Skip navigation links
21.2.2.3 Installing Connector/NET from the source code »
Section Navigation      [Toggle]

21.2.2.2. Installing Connector/NET on Unix with Mono

There is no installer available for installing the Connector/NET component on your Unix installation. Before installing, please ensure that you have a working Mono project installation. You can test whether your system has Mono installed by typing: 

shell> mono --version

The version of the Mono JIT compiler will be displayed.

To compile C# source code you will also need to make sure a Mono C# compiler, is installed. Note that there are two Mono C# compilers available, mcs, which accesses the 1.0-profile libraries, and gmcs, which acesses the 2.0-profile libraries.

To install Connector/NET on Unix/Mono:

  1. Download the mysql-connector-net-version-noinstall.zip and extract the contents to a directory of your choice, for example: ~/connector-net/.

  2. In the directory where you unzipped the connector to, change into the bin directory. Ensure the file MySql.Data.dll is present.

  3. You must register the Connector/NET component, MySql.Data, in the Global Assembly Cache (GAC). In the current directory enter the gacutil command: 

    root-shell> gacutil /i MySql.Data.dll

    This will register MySql.Data into the GAC. You can check this by listing the contents of /usr/lib/mono/gac, where you will find MySql.Data if the registration has been successful.

You are now ready to compile your application. You must ensure that when you compile your application you include the Connector/NET component using the -r: command-line option. For example: 

shell> gmcs -r:System.dll -r:System.Data.dll -r:MySql.Data.dll HelloWorld.cs

Note, the assemblies that need to be referenced will depend on the requirements of the application, but applications using Connector/NET will need to provide -r:MySql.Data as a minimum.

You can further check your installation by running the compiled program, for example: 

shell> mono HelloWorld.exe

User Comments

Posted by Dale E. Moore on November 5 2006 12:02am[Delete] [Edit]

For my Fedora Core 6 system I used the following.

1. http://dev.mysql.com/downloads/connector/net/1.0.html "Windows Source and Binaries, no installer (ZIP) 1.0.7 (GA)"

2. # cp /home/dalem/Desktop/mysql-connector-net/bin/mono-1.0/release/MySql.Data.dll /usr/lib/mono/1.0/
# chcon -u system_u -t lib_t /usr/lib/mono/1.0/MySql.Data.dll

3. # pushd /usr/lib/mono/1.0/
# gacutil /i MySql.Data.dll
MySql.Data installed into the gac (/usr/lib/mono/gac)

Then tested with http://www.mono-project.com/MySQL.

Posted by Jeremy Hatcher on June 11 2009 5:25pm[Delete] [Edit]

OpenSuse 11.1 story:

After downloading .NET connector 6.0.3 my directory didn't contain MySql.Data.dll ... but it DID contain mysql.data.dll. I went through all of the motions on the instruction page (substituting lowercase for upper) to no avail.

Finally, I renamed mysql.data.dll to MySql.Data.dll and went through the motions again -> VOILA. Only problem is that then the installed package looks for mysql.data.dll.

The gist of this is, #>cp mysql.data.dll MySql.Data.dll
#>gacutil -i MySql.Data.dll

You may also need to copy mysql.data.dll to /usr/lib/mono/<version>

Milo

Posted by Jack Torrance on November 20 2009 5:53pm[Delete] [Edit]

Thanks a lot Jeremy, I was trying to make it work using mysql.data.dll but no success.
Finally, renaming to MySql.Data.dll and installing it made it work.

Add your own comment.