Adding database setup instructions on different platforms (#25952)

Author: maryamariyan

src/System.Data.Odbc/src/DatabaseSetupInstructions.md

@@ -0,0 +1,93 @@
+# Instructions on how to setup database
+
+## In Fedora 24 container:
+- `docker ps` shows _id of existing Fedora 24 container
+- `docker exec -it _id /bin/sh`
+- `dnf install findutils` need to install findutils for building corefx to add missing xargs
+- `find / -name libsqlite3odbc.so` to be used in odbcinst.ini
+- `odbcinst -j` to show version and location of ini files
+- `ldconfig -p | grep sqlite`
+- `ldconfig -p | grep odbc`
+- `dnf list | grep unixODBC`
+- `dnf install unixODBC.x86_64`
+- `dnf install unixODBC-devel.x86_64`
+- `dnf install sqliteodbc.x86_64`
+
+## Notes on commands used in Debian 8.2
+- followed [dockerfile](https://devdiv.visualstudio.com/DevDiv/_git/DotNetCore?path=%2Fdockerfiles%2Fdebian%2F8.2%2FDockerfile&version=GBmaster) instructions for debian 8.2
+- dependencies: libkrb5-dev, cmake
+
+Get the tag name from https://hub.docker.com/r/microsoft/dotnet-buildtools-prereqs/tags/ and use in docker run below
+- `docker run -it microsoft/dotnet-buildtools-prereqs:debian-8.2-SHA-YMD.. /bin/sh`
+- `docker images` shows _id for Debian 8.2 to use in command below
+- `docker exec -it _id /bin/sh`
+
+## Notes on commands used in Linux 14.04
+- not supported. Minimum required unixODBC version should be 2.3.1 but is lower
+
+## Notes on commands used in Linux 16.04
+- `sudo nano /etc/odbcinst.ini`
+- `sudo nano /usr/local/etc/odbcinst.ini`
+- `ls /usr/lib/x86_64-linux-gnu/odbc/`
+- `ls -a /usr/local/lib`
+- `sudo nano /usr/local/etc/odbc.ini`
+- `PATH=$PATH:/usr/lib/x86_64-linux-gnu-odbc/`
+- `cd ~/dl/unixODBC*/`
+- `./configure`
+- `make`
+- `sudo make install`
+- `sudo nano /usr/local/etc/odbc.ini` notes on onenote
+- `sudo nano /usr/local/etc/odbcinst.ini' notes on onenote
+- `ls -a /usr/local/lib`
+- `cd ../sqliteodbc-*/`
+- `./configure`
+- `sudo apt-get update`
+- `sudo apt-get install sqlite3`
+- `./configure`
+- `bundle install` bundle install may not be necessary
+- `sudo apt-get install sqlite3`
+- `sudo apt-get install libsqlite3-dev` unixodbc-dev, unixodbc-bin, and unixodbc may not be required
+- `make`
+- `make install`
+- `sudo make install`
+- `ls -a /usr/local/lib`
+
+## Notes on commands used in Mac 
+- `gunzip unixODBC-2.3.4.tar.gz` download unixodbc
+- `tar xvf unixODBC-2.3.4.tar`
+- `cd unix...`
+- `./configure`
+- `make`
+- `make install`
+- `/usr/local/bin/odbcinst` try out odbcinst using the command below
+- `sudo nano /etc/odbcinst.ini`
+
+```
+ [SQLite3]
+ Description=SQLite ODBC Driver
+ Driver=/usr/local/lib/libsqlite3odbc.so
+ Setup=/usr/local/lib/libsqlite3odbc.so
+ Threading=4
+```
+
+- `sudo nano find / -name odbcinst.ini`
+- `sudo nano /usr/local/etc/odbcinst.ini`
+
+```
+ [ODBC Drivers]
+ SQLite3 ODBC Driver=Installed
+ SQLite=Installed
+ [SQLite3 ODBC Driver]
+ Driver=/usr/local/lib/libsqlite3odbc.dylib
+ Setup=/usr/local/lib/libsqlite3odbc.dylib
+ [SQLite3]
+ Driver=/usr/local/lib/libsqlite3odbc.dylib
+ Setup=/usr/local/lib/libsqlite3odbc.dylib
+```
+
+- `ls -a /usr/local/lib/.`
+- `sudo nano /usr/local/etc/odbc/odbc.ini`
+
+## Notes on commands used in Windows7-10, 64 bit machine
+- odbc32.dll already available, just needs to install sqlite64.exe
+

src/System.Data.Odbc/src/System.Data.Odbc.csproj

@@ -168,6 +168,9 @@
     <Reference Include="System.Xml.ReaderWriter" />
     <Reference Include="System.Runtime.InteropServices.RuntimeInformation" />
   </ItemGroup>
+  <ItemGroup>
+    <None Include="DatabaseSetupInstructions.md" />
+  </ItemGroup>
   <Import Project="$([MSBuild]::GetDirectoryNameOfFileAbove($(MSBuildThisFileDirectory), dir.targets))\dir.targets" />
 </Project>