Getting Started with the CData ODBC Driver for RabbitMQ

---

This guide walks you through everything you need to get started with the CData ODBC Driver for RabbitMQ. You'll learn how to install and license the driver, configure your first connection, and explore next steps for working with RabbitMQ data in your applications.

Installation & Licensing

System Requirements

• Windows: Windows 10/11 or Windows Server 2016+
• Linux: Most modern distributions with UnixODBC

Installing the Driver

Windows Installation

1. Download the ODBC driver installer from your CData account or the evaluation download page.
2. Run the installer and follow the installation wizard.
3. The installer will guide you through the setup process and automatically register the driver with the system.
4. As part of the installation process, you will be prompted to input the license key in order to activate your license. You should have received your license key via email from the CData Orders Team. The license key looks like this: XXXX-XXXX-XXXX-XXXX-XXXX.
   • Note: If you are running a trial, just select the Trial Key option.
5. Both 32-bit and 64-bit drivers are included. Install both if you use applications with different architectures.

Linux Installation

1. Ensure UnixODBC is installed: sudo apt-get install unixodbc unixodbc-dev (Debian/Ubuntu) sudo yum install unixODBC unixODBC-devel (RHEL/CentOS)
2. Extract the driver package to /opt/cdata/
3. The driver will be automatically registered in /etc/odbcinst.ini

---

Activating Your License

You should have received your license key via email from the CData Orders Team. The license key looks like this: XXXX-XXXX-XXXX-XXXX-XXXX

Windows License Activation

Your license would typically be activated during installation. However, there are cases where you may need to activate it manually. The steps below walk you through manual activation:

1. Open the ODBC driver application from the Start menu.
2. Navigate to Help > Licensing
3. Enter your license key in the provided field.
4. Click Activate
5. You should see "Licensed" status confirming successful activation.

Linux License Activation

1. Navigate to the installation directory where you extracted the driver package. (i.e.cd /opt/cdata/cdata-odbc-driver-for-acumatica/bin/)
2. Create a license file by running the following command sudo ./install-license.sh
3. Replace with your actual license key.
4. To activate a trial, omit the input.

---

Common Licensing Questions

Can I use my license on multiple machines?
Yes, depending on your subscription tier. Check your order confirmation or contact your account representative for details. If you are unsure of who your account representative is, contact [email protected].

I lost my license key. How do I retrieve it?
Email [email protected] with your order number, and we'll resend your license key.

Can I transfer my license to a different machine?
Yes. When transferring the license to a different machine, you will need to submit a License Transfer Request on our site linked below:

https://www.cdata.com/lic/transfer/

After the License Transfer Request is submitted and successfully processed, an activation will be added to your Product Key and you will be able to activate the full license on the other machine. Once this process is finished, the license on the previous machine will be invalid.

For additional licensing questions, contact [email protected]. Viewing and upgrading your license can now be done through our self-service portal at portal.cdata.com.

---

Connection Configuration

Once your driver is installed and licensed, you're ready to configure a connection to RabbitMQ. The ODBC driver uses a DSN (Data Source Name) to store connection properties.

Creating a DSN

Windows: Using ODBC Data Source Administrator

1. Open the ODBC Data Source Administrator (64-bit)
   Note: Use the 64-bit version for 64-bit applications and the 32-bit version for 32-bit applications.
   • Search for "ODBC" in the Windows Start menu
   • Or navigate to: Control Panel > Administrative Tools > ODBC Data Sources
2. Click the System DSN or User DSN tab
   • System DSN: Available to all users on the machine (recommended for services)
   • User DSN: Available only to the current user
3. Select CData API Driver for ODBC from the list, or click Add to create a new data source.
4. Click OK or Finish to open the connection configuration dialog.

Linux: Editing Config Files (odbcinst.ini & odbc.ini)

1. Register the Driver by adding the section below to the odbcinst.ini file.
[CData API Driver for ODBC] Driver=/opt/cdata/cdata-odbc-driver-for-api/lib/libapiodbc.x64.so Description=CData API Driver for ODBC
2. Save the file.
3. Create the DSN by adding the entry below to the odbc.ini file:
[CData RabbitMQ Source] Driver=/opt/cdata/cdata-odbc-driver-for-api/lib/libapiodbc.x64.so ConnectionProperty1=Value1 ConnectionProperty2=Value2 Profile = C:\profiles\\RabbitMQ.apip AuthScheme = Basic URL = http://localhost:15672 User = guest Password = guest
4. Save the file.

---

Configuring Connection Properties

About RabbitMQ Management HTTP API

RabbitMQ is an open-source message broker that supports multiple messaging protocols. The RabbitMQ Management HTTP API provides HTTP-based access to management and monitoring data for a RabbitMQ server. The API exposes information about virtual hosts, exchanges, queues, bindings, connections, channels, consumers, users, permissions, policies, and cluster-wide statistics.

The Management plugin must be enabled on the RabbitMQ server for the HTTP API to be available. By default, the management interface listens on port 15672.

Using Basic Authentication

RabbitMQ Management HTTP API uses HTTP Basic authentication. You must supply the username and password of a RabbitMQ management user.

To enable access to the management API:

1. Ensure the RabbitMQ Management plugin is enabled on your server (rabbitmq-plugins enable rabbitmq_management).
2. Use an existing management user or create one with the appropriate management tag (management, policymaker, monitoring, or administrator).
3. Note the full base URL of your RabbitMQ Management HTTP API (e.g., http://localhost:15672).

After configuring your RabbitMQ server, set the following connection properties to connect:

• AuthScheme: Set this to Basic.
• URL: Set this to the base URL of your RabbitMQ Management HTTP API (e.g., http://localhost:15672).
• User: Set this to your RabbitMQ management username (e.g., guest).
• Password: Set this to your RabbitMQ management password.

Example connection string:

Profile=C:\profiles\RabbitMQ.apip;AuthScheme=Basic;URL=http://localhost:15672;User=guest;Password=guest;

Available Tables

The RabbitMQ profile provides access to the following tables:

• Overview - Cluster-wide statistics and information about the RabbitMQ node
• Nodes - Information about individual nodes in the RabbitMQ cluster
• NodeMemory - Detailed memory usage breakdown for a specific cluster node
• Connections - List of all open AMQP connections to the broker
• Channels - List of all open AMQP channels across all connections
• Consumers - List of all consumers registered across all queues
• Exchanges - List of exchanges declared across all virtual hosts
• Queues - List of queues declared across all virtual hosts
• Bindings - List of all bindings between exchanges and queues
• VirtualHosts - List of virtual hosts configured on the broker
• VhostPermissions - User permissions within a specific virtual host
• Users - List of all RabbitMQ users
• Permissions - Permission records for all users across all virtual hosts
• TopicPermissions - Topic-level permission records for all users
• Policies - List of policies applied to queues and exchanges in virtual hosts
• OperatorPolicies - List of operator policies applied to queues in virtual hosts
• Parameters - List of component parameters (e.g., federation, shovel) per virtual host
• GlobalParameters - List of global parameters that apply across all virtual hosts
• VhostLimits - Resource limits configured for specific virtual hosts
• UserLimits - Resource limits configured for specific users
• FeatureFlags - List of feature flags and their enabled/disabled state on the node
• DeprecatedFeatures - List of deprecated features and their usage state
• AuthAttempts - Authentication attempt statistics for the node
• ClusterName - The name of the RabbitMQ cluster
• WhoAmI - Information about the currently authenticated management user
• ExchangeBindingsSource - Bindings for which a specific exchange is the source
• ExchangeBindingsDestination - Bindings for which a specific exchange is the destination
• QueueBindings - Bindings for a specific queue within a virtual host

---

Testing Your Connection

1. After entering your connection properties, click Test Connection.
2. A successful test confirms:
   • Authentication credentials are correct.
   • Network connectivity is established.
   • Required permissions are in place.
3. If the test fails, the error message will indicate what needs to be corrected.
4. Click OK to save your DSN.

---

Common Connection Issues

Authentication Failed

Solution: Verify your credentials are current. For OAuth applications, you may need to authorize CData in your application's security settings. Contact [email protected] for authorization assistance.

Cannot Reach Server

Solution: Check firewall & proxy settings. Contact [email protected] for specific port requirements.

Table Not Found

Solution: Verify database and schema names. Use the Data Model tab in the DSN configuration to browse available tables.

Driver Not Found (Linux)

Solution: Verify the driver is correctly registered in odbcinst.ini. Contact [email protected] for further assistance.

For additional connection troubleshooting, contact [email protected] with your specific error message.

---

What's Next

Now that you have installed, licensed, and configured the driver, here are some scenarios you can use to explore our ODBC Drivers:

---

Get Support

If you need assistance at any point:

• Technical Support: [email protected]
• Community Forum: CData Community Site
• Help Documentation: Installed locally and available online

---

FAQs

Installation & Licensing

• Do I need administrator rights to install the driver?
  Yes, administrator rights are required for system-wide installation on Windows and Linux.
• Can I install both 32-bit and 64-bit drivers on the same machine?
  Yes, both versions are installed by default.

Connecting

• What's the difference between System DSN and User DSN?
  System DSNs are available to all users on a machine and are required for services. User DSNs are only available to the user who created them.
• Can I use a DSN-less connection string instead of creating a DSN?
  Yes. Many applications support DSN-less connection strings. See the connection string example below:

  Driver={CData API Driver for ODBC};RequiredConnectionProperty1=Value1;RequiredConnectionProperty2=Value2;

• How do I connect to multiple RabbitMQ accounts?
  Create separate DSNs for each account, each with its own authentication credentials.
• Can I connect through a proxy server?
  Yes. Configure proxy settings in your DSN connection properties. Refer to the Firewall & Proxy section in the help documentation for proxy configuration.

Performance & Troubleshooting

• Why are my queries slow?
  Check the following:
  • Use caching for infrequently changing data. Refer to the Caching Data section in the help documentation for further details.
  • Add filters (WHERE clauses) to reduce result set size.
  • Contact [email protected] for query optimization assistance.
• How do I enable logging for troubleshooting?
  Add the following to your DSN:
  • Logfile: /path/to/logfile.log
  • Verbosity: 3

  Be prepared to securely upload the log file upon request when reaching out to [email protected] for troubleshooting analysis.

• What ports does the driver need access to?
  This depends on your data source. Most cloud applications use HTTPS (port 443). Contact [email protected] for specific firewall requirements.
• Can I use the driver in a Linux container or Docker?
  Yes. Install the driver in your container image and configure your DSN in the container's /etc/odbc.ini file.

General

• Where can I find the complete list of supported SQL operations?
  Refer to the SQL Compliance chapter in the help documentation for complete SQL reference.
• How often is the driver updated?
  CData releases major version updates for our drivers annually. Check your account portal or contact [email protected] for the latest version.
• Where can I find code examples for my programming language?
  Check the Using ODBC section of the help documentation for language-specific examples (Python, PHP, C#, etc.).

For questions not covered in this FAQ, contact [email protected].