Oracle Client For Microsoft Tools Install Instructions
Oracle Client For Microsoft Tools Install Instructions
Alex Keh
This step-by-step tutorial guides how to install Oracle Client for Microsoft Tools (OCMT). OCMT is a
graphical installer that automates the install and configuration of Oracle Data Provider for .NET
(ODP.NET) to support Microsoft tool connections with Oracle on-premises and cloud databases, including
Oracle Autonomous Database. The Microsoft tools supported include:
• Power BI Desktop
• Power BI service
• Excel
• SQL Server Analysis Services
• SQL Server Data Tools
• SQL Server Integration Services
• SQL Server Reporting Services
• BizTalk Server
These instructions work for on-premises database and both dedicated and serverless ADB. The
instructions for on-premises database setup also apply to Oracle Database Cloud Services and Oracle
Exadata Cloud Service.
Prerequisites
Power BI Desktop, Power BI service, Excel, SQL Server Analysis Services, and BizTalk Server use unmanaged
ODP.NET to connect to Oracle database. If you use the 64-bit version of one of these products, you must use
the 64-bit OCMT to install 64-bit unmanaged ODP.NET. If you use the 32-bit Microsoft product version, you
must use the 32-bit OCMT to install 32-bit unmanaged ODP.NET.
SQL Server Data Tools, SQL Server Integration Services, and SQL Server Reporting Services use managed
ODP.NET. Managed ODP.NET works with both 32-bit and 64-bit apps, which allows you to use either 32-bit or
64-bit OCMT with any of these Microsoft products.
If using unmanaged ODP.NET, determine whether you are using 32-bit or 64-bit version of the Microsoft
product. Let’s use Power BI Desktop as an example. In Windows, start Power BI Desktop. On the menu, select
Help > About to see a window like the following:
1
In the above screen shot, we see this is 64-bit Power BI Desktop. That means 64-bit unmanaged ODP.NET must
be installed and configured for Power BI to connect to an Oracle Database. If 32-bit Power BI Desktop is being
used, then 32-bit unmanaged ODP.NET is required.
OCMT should download to your machine after clicking on the download link.
2
2. Find the OCMT executable on your machine.
3. Click the “Yes” button in the User Account Control screen. You should now see the introductory install
screen. Click the “Next” button.
The screen shots may differ slightly if you are using 32-bit vs 64-bit OCMT.
4. The OCMT Setup Type screen will appear. You will have two choices: Custom or Default.
3
If you choose Custom, you can decide whether to install and configure only managed ODP.NET, only
unmanaged ODP.NET, or both. If you choose Default, both managed and unmanaged ODP.NET will install
and be configured
5. If you chose Custom, you then see the Select Features screen.
4
Select whether you wish to install managed ODP.NET, unmanaged ODP.NET, or both. Click the “Next”
button.
6. On the Destination Location screen, enter the directory where to install ODP.NET.
5
Use the “Browse” button to specify the directory location. Click “Next” when completed.
7. On the Oracle Configuration File Directory screen, enter the location where ODP.NET can find its Oracle
Client configuration files, sqlnet.ora and tnsnames.ora, such as C:\network\admin.
You may use the “Browse” button to specify the directory location. Click “Next” when complete.
If you are connecting to Oracle Autonomous Database Serverless, download the database connection
credentials zip file from the Oracle Cloud Console and unzip the contents into this specified configuration
file directory. Next, open the sqlnet.ora file to update the WALLET_LOCATION’s DIRECTORY setting value
to the same specified configuration file directory.
8. The Oracle Client for Microsoft Tools is now ready to install. Click the “Install” button to proceed.
6
9. The ODP.NET install is now complete and configured for use on this machine. On the Wizard Complete
screen, you may review the client README. Click the “Finish” button to proceed.
7
Conclusion
Your Microsoft tools can now connect to Oracle databases. In the Microsoft tool, provide the database
credentials, such as username/password or Microsoft Entra ID (formerly Azure Active Directory), and Oracle
data source information, such as the net service name, Easy Connect Plus, or connect descriptor.
Oracle publishes step by step connectivity instructions for specific Microsoft tools on the OCMT web page.