Skip to content

Latest commit

 

History

History
99 lines (63 loc) · 3.48 KB

desktop_fedora_setup.md

File metadata and controls

99 lines (63 loc) · 3.48 KB
Raw

This document is known to be outdated

How to build the samples in Fedora

The following procedure describes the process of building and running the Event Hubs SDK samples (send and send_batch) in a Fedora desktop environment. The samples enable your Fedora machine to act as a device that can connect to an Azure Event Hub.

Requirements

A computer running the Fedora OS.

Create an Event Hub

To run the sample applications you will need an Event Hub to which they can send messages.

To configure an Event Hub, see Create an Event Hub. Be sure to make a note of the Event Hub name and the SendRule and ReceiveRule connection strings; you will need them to complete building the samples.

Download the Azure Event Hubs SDK and prerequisites

  1. Open a terminal window in Fedora.

  2. Install the prerequisite packages by issuing the following commands in a terminal window:

sudo dnf check-update -y
sudo dnf install -y libcurl-devel openssl-devel libuuid-devel uuid-devel gcc-c++ make cmake git
  1. Download the SDK to the machine by issuing the following command in your terminal window:
git clone --recursive https://github.com/Azure/azure-event-hubs.git

You will be prompted for your GitHub username and password -- if you have two-factor authentication enabled for your account, you'll need to generate and then use a personal access token in place of your password.

  1. Verify that you now have a copy of our source code under the directory ~/azure-event-hubs.

Update the send and send_batch samples

Before performing these steps, you'll need the following prerequisite information:

  • Event Hub name.
  • Event Hub SendRule connection string.

Now, configure the sample:

  1. On your Ubuntu machine, open the file ~/azure-event-hubs/c/eventhub_client/samples/send/send.c in a text editor.

  2. Scroll down to locate the connection information.

  3. Replace the placeholder value for the connectionString variable with your SendRule Event Hub connection string. Replace the placeholder value for the eventHubPath variable with your Event Hub name.

  4. Save your changes.

  5. Repeat the previous steps, but for step 1 open the file ~/azure-event-hubs/c/eventhub_client/samples/send_batch/send_batch.c.

Build the samples

You can now build the SDK samples using the following command:

~/azure-event-hubs/c/build_all/linux/build.sh

Run the samples

  1. Run the send sample by issuing the following command:
~/azure-event-hubs/c/eventhub_client/samples/send/linux/send
  1. Run the send_batch sample by issuing the following command:
~/azure-event-hubs/c/eventhub_client/samples/send_batch/linux/send_batch
  1. For each sample, verify that the sample output messages show Successful. If not, then you may have incorrectly pasted the Event Hub connection information.

Note: The tools folder in this repository includes the CSharp_ConsumeEventsFromEventHub C# Windows application that can receive messages from an Event Hub. This is useful to help you verify that the samples are sending messages correctly to the Event Hub.