(DOCSP-17228): BI Connector quick wins (#338)

jwilliams-mongo · web-flow · commit b586c0ec90a1 · 2021-07-29T16:14:30.000-05:00
diff --git a/config/redirects b/config/redirects
@@ -41,3 +41,11 @@ raw: bi-connector/release-notes -> ${base}/master/release-notes/
 (v2.4-*]: bi-connector/${version}/tutorial/install-auth-plugin-c/ -> ${base}/${version}/reference/auth-plugin-c/
 (v2.4-*]: bi-connector/${version}/tutorial/install-auth-plugin-jdbc/ -> ${base}/${version}/reference/auth-plugin-jdbc/
 (v2.4-*]: bi-connector/${version}/client-dependencies/ -> ${base}/${version}/authentication/
+
+# quick wins changes https://jira.mongodb.org/browse/DOCSP-17228
+
+[*-v2.13]: bi-connector/${version}/reference/jdbc-driver/ -> ${base}/${version}/components/
+[*-v2.13]: bi-connector/${version}/connect/qlik/ -> ${base}/${version}/client-applications/
+[*-v2.13]: bi-connector/${version}/connect/microstrategy/ -> ${base}/${version}/client-applications/
+[*-v2.13]: bi-connector/${version}/connect/spotfire-cloud/ -> ${base}/${version}/client-applications/
+[*-v2.13]: bi-connector/${version}/connect/looker/ -> ${base}/${version}/client-applications/
diff --git a/source/client-applications.txt b/source/client-applications.txt
@@ -4,102 +4,20 @@ Connect BI Tools
 
 .. default-domain:: mongodb
 
-.. contents:: On this page
-   :local:
-   :backlinks: none
-   :depth: 1
-   :class: singlecol
-
-Certified Partner Tools
------------------------
-
-- `Tableau Desktop <https://www.tableau.com/products/desktop>`_
-
-- `Microsoft Power BI <https://powerbi.microsoft.com/en-us/>`_
-
-- `IBM Cognos Analytics <https://www.ibm.com/products/cognos-analytics>`_
-
-- `Qlik Sense <https://www.qlik.com/us/products/qlik-sense>`_
-
-- `Looker <https://looker.com/product/business-intelligence>`_
-
-.. note::
-
-   MongoDB supports using the |bi-short| with tools not listed above on 
-   a best-effort basis.
-
-   If you require a custom connector, request one using the 
-   `MongoDB Feedback Engine
-   <https://feedback.mongodb.com/forums/930952-connectors-bi-kafka-spark>`__.
-
-Connection Tutorials
---------------------
-
-You can connect to the |bi-short| using any of these Business
-Intelligence tools.
-
-.. card-group::
-   :columns: 2
-   :style: compact
-   :layout: carousel
-
-   .. card::
-      :cta: Microstrategy
-      :url: https://docs.mongodb.com/bi-connector/current/connect/microstrategy
-      :icon: /images/bi-connector/icons/microstrategy-logo.png
-      :icon-alt: Microstrategy icon
-
-   .. card::
-      :cta: Tableau Desktop
-      :url: https://docs.mongodb.com/bi-connector/current/connect/tableau
-      :icon: /images/bi-connector/icons/tableau-logo.png
-      :icon-alt: Tableau Desktop icon
-
-   .. card::
-      :cta: Microsoft PowerBI
-      :url: https://docs.mongodb.com/bi-connector/current/connect/powerbi
-      :icon: /images/bi-connector/icons/power-bi-logo.png
-      :icon-alt: Microsoft PowerBI icon
-
-   .. card::
-      :cta: QlikSense
-      :url: https://docs.mongodb.com/bi-connector/current/connect/qlik
-      :icon: /images/bi-connector/icons/qliksense-logo.png
-      :icon-alt: QlickSense icon
-
-   .. card::
-      :cta: Microsoft Excel
-      :url: https://docs.mongodb.com/bi-connector/current/connect/excel
-      :icon: /images/bi-connector/icons/excel-logo.png
-      :icon-alt: Microsoft Excel icon
-
-   .. card::
-      :cta: Spotfire Cloud
-      :url: https://docs.mongodb.com/bi-connector/current/connect/spotfire-cloud
-      :icon: /images/bi-connector/icons/spotfire-logo.png
-      :icon-alt: Spotfire Cloud icon
-
-   .. card::
-      :cta: MySQL Client
-      :url: https://docs.mongodb.com/bi-connector/current/connect/mysql
-      :icon: /images/bi-connector/icons/mysql-logo.png
-      :icon-alt: MySQL Client
-
-   .. card::
-      :cta: Looker
-      :url: https://docs.mongodb.com/bi-connector/current/connect/looker
-      :icon: /images/bi-connector/icons/looker-logo.png
-      :icon-alt: Looker icon
+After you install and configure the |bi-short|, you can use |odbc| and
+|jdbc| drivers to connect from many BI Tools and clients. The sections
+below provide basic instructions for connecting to |bi-short| using each
+tool.
 
+- :doc:`Tableau Desktop </connect/tableau>`
+- :doc:`Microsoft Power BI Desktop </connect/powerbi>`
+- :doc:`Microsoft Excel </connect/excel>`
+- :doc:`MySQL Client </connect/mysql>`
 
 .. toctree::
    :titlesonly:
 
-   /connect/excel
-   /connect/mysql
    /connect/tableau
-   /connect/qlik
-   /connect/microstrategy
    /connect/powerbi
-   /connect/spotfire-cloud
-   /connect/looker
+   /connect/excel
+   /connect/mysql
diff --git a/source/components.txt b/source/components.txt
@@ -45,3 +45,4 @@ The following tools are available for use with the |bi|:
    /reference/mongodrdl
    /reference/mongotranslate
    MongoDB ODBC Driver </reference/odbc-driver>
+   /reference/jdbc-driver
diff --git a/source/connect/powerbi.txt b/source/connect/powerbi.txt
@@ -13,7 +13,8 @@ Connect from Microsoft Power BI Desktop
    :class: singlecol
 
 This tutorial demonstrates how to connect to the |bi| using
-`Microsoft Power BI Desktop <https://powerbi.microsoft.com/>`_.
+`Microsoft Power BI Desktop 
+<https://powerbi.microsoft.com/en-us/desktop/>`_.
 
 .. include:: /includes/client-connection-prereqs.rst
 
diff --git a/source/images/bi-connector/components-all.jpg b/source/images/bi-connector/components-all.jpg
diff --git a/source/images/bi-connector/components-cloud.jpg b/source/images/bi-connector/components-cloud.jpg
diff --git a/source/images/bi-connector/components-onprem-bi-atlas.jpg b/source/images/bi-connector/components-onprem-bi-atlas.jpg
diff --git a/source/images/bi-connector/components-onprem.jpg b/source/images/bi-connector/components-onprem.jpg
diff --git a/source/includes/steps-local-quickstart.yaml b/source/includes/steps-local-quickstart.yaml
@@ -101,8 +101,7 @@ ref: start-sql-client
 level: 4
 stepnum: 4
 content: |
-  Most BI tools can import data from an ODBC DSN. There are
-  instructions for connecting with :doc:`several applications
-  </client-applications>` elsewhere in the |bi-short|
-  documentation.
+  To learn how to connect from your BI Tool, see 
+  :doc:`several applications </client-applications>`.
+  
 ...
diff --git a/source/local-quickstart.txt b/source/local-quickstart.txt
@@ -15,18 +15,21 @@ Quick Start Guide for Windows
 *Estimated Time to Complete: ~15 minutes*
 
 This guide provides step-by-step instructions to quickly set up the
-required components for the |bi-short| on your local system. This guide
-is recommended for users who would like to experiment
+required components for the |bi-short| on your local system using a
+|odbc| driver. 
+
+This guide is recommended for users who would like to experiment
 with the |bi-short| or create a local environment for development or
-testing.
+testing on Microsoft Windows.
 
 In this tutorial you will:
 
 - Start a local MongoDB :manual:`mongod </reference/program/mongod/>`
   process
 - Start a local |bi-short| :doc:`mongosqld </reference/mongosqld>`
   process
-- Create a :doc:`data source name </tutorial/create-system-dsn>` (DSN)
+- Install the |odbc| driver and create a 
+  :doc:`data source name </tutorial/create-system-dsn>` (DSN)
 - Connect with a BI tool of your choice
 
 Prerequisites
diff --git a/source/reference/jdbc-driver.txt b/source/reference/jdbc-driver.txt
@@ -0,0 +1,23 @@
+:noprevnext:
+
+.. _jdbc-driver:
+
+===========
+JDBC Driver
+===========
+
+.. default-domain:: mongodb
+
+
+The {+bi-full+} uses the `MySQL Connector/J
+<https://dev.mysql.com/doc/connector-j/5.1/en/connector-j-installing.html>`__
+for |jdbc| connectivity.
+
+You must use a MySQL Connector/J version from the 5.1.x series with the
+|bi-short|. The minimum supported version is `5.1.39 
+<https://mvnrepository.com/artifact/mysql/mysql-connector-java/5.1.39>`__.
+
+.. important::
+
+   You can't use MySQL Connector/J versions 6.x, 8.x, or later
+   with the |bi-short|.
diff --git a/source/what-is-the-bi-connector.txt b/source/what-is-the-bi-connector.txt
@@ -48,27 +48,27 @@ BI Connector
   Provides a relational schema and translates |sql|
   queries between your BI tool and MongoDB.
 
-ODBC data source name (DSN)
-  Holds authentication and connection configuration data.
+|jdbc| and |odbc| drivers
+  Provides a standard method to connect to the |bi-short| and MongoDB
+  databases from a BI Tool. Depending on what your BI Tool supports, you
+  can use |jdbc| and |odbc| drivers to connect to the |bi-short|.
 
-BI Tool Data visualization and analysis.
+BI Tool
+  Retrieve, visualize, and report on data from a database.
 
-Most BI tools can import data from a
-:doc:`DSN </tutorial/create-system-dsn>`. Configure a |dsn| to
-point to your |bi-short| instance. This provides you a wide range of
-BI tools and |sql| clients with a single data source configuration.
+Your BI Tool and Driver typically run on your local machine. Your
+database and your |bi-short| instance can run on your local machine,
+in a data center, or hosted in the cloud.
 
-Your BI tool and your |dsn| always run on your local desktop, but your
-database and your |bi-short| instance may be local, on premises, or
-hosted. The following sections describe possible configurations for a
+The following sections describe possible configurations for a
 BI system.
 
 Hosted Database and |bi-short|
 ------------------------------
 
 .. note::
 
-   If you don’t want to install and manage the |bi-short|, you can use
+   If you don't want to install and manage the |bi-short|, you can use
    {+atlas+}, our fully-managed database-as-a-service. Databases hosted
    on {+atlas+} natively support the |bi| and make it easy to start
    analyzing your data with your preferred BI tools. To get started,
