Merge pull request #77 from hbs-rcs/ODBC

Odbc

docs/storage.md

@@ -241,7 +241,30 @@ one of the clients listed below.
 
     Alternatively, you can access MariaDB from Terminal after **first logging into the Grid** (see instructions on the [Start Here page](https://hbs-rcs.github.io/hbsgrid-docs/) and then typing: `mysql -h hostname -u username -p`. 
 
-    For all of the commands referenced above, replace the `username` with your username, the mariadbhost with the HBS host name in your `.my.cnf` file, and (if applicable) the `ssl-ca path` with the appropriate path. You will be prompted to provide your password . 
+    For all of the commands referenced above, replace the `username` with your username, the mariadbhost with the HBS host name in your `.my.cnf` file, and (if applicable) the `ssl-ca path` with the appropriate path. You will be prompted to provide your password. 
+
+=== "ODBC"  
+
+     Setting up an ODBC connection differs by whether you are connecting from the Grid (Linux), Mac, or Windows machine. Please see MariaDB's ODBC set-up [documentation](https://mariadb.com/kb/en/creating-a-data-source-with-mariadb-connectorodbc/) for more information and **note that if connecting from the Grid, the ODBC administration tool and appropriate ODBC drivers are already installed.** You will still need to ensure that you have a `.odbc.ini` configuration file saved in your home directory. An example `.odbc.ini` template is below
+
+```
+[ODBC Data Sources]
+rcs_mariadb = RCS_MariaDB_ODBC_connection
+
+[rcs_mariadb]
+driver = mariaDB
+server = HOSTNAME
+port = 3306
+database = jharvard
+user = jharvard
+password = PASSWORD
+sslmode = required
+sslca = PATH_TO_SSL_CERT
+```
+
+Once your `.odbc.ini` is ready, save it to your home directory and adjust file privileges to ensure no one else can read the file:
+
+`chmod 700 ~/.odbc.ini`
 
 **************************