Chapter 2. Installation This chapter guides you through the steps to install Red Hat build of Apache Qpid Proton DotNet in your environment. 2.1. Prerequisites You must have a subscription to access AMQ release files and repositories. To use Red Hat build of Apache Qpid Proton DotNet on Red Hat Enterprise Linux, you must install the the .NET 6.0 developer tools. For information, see the Getting started with .NET on RHEL 9 and Getting started with .NET on RHEL 8 . To build programs using Red Hat build of Apache Qpid Proton DotNet on Microsoft Windows, you must install Visual Studio. 2.2. Installing on Red Hat Enterprise Linux Procedure Open a browser and log in to the Red Hat Customer Portal Product Downloads page at https://access.redhat.com/downloads Locate the Red Hat AMQ Clients entry in the INTEGRATION AND AUTOMATION category. Click Red Hat AMQ Clients . The Software Downloads page opens. Download the amq-qpid-dotnet-1.0.0.M9 .zip file. Use the unzip command to extract the file contents into a directory of your choosing. USD unzip amq-qpid-dotnet-1.0.0.M9.zip When you extract the contents of the .zip file, a directory named amq-dotnet-1.0.0-M9 is created. This is the top-level directory of the installation and is referred to as <install-dir> throughout this document. Use a text editor to create the file USDHOME/.nuget/NuGet/NuGet.Config and add the following content: <?xml version="1.0" encoding="utf-8"?> <configuration> <packageSources> <add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3"/> <add key="amq-clients" value=" <install-dir> /lib"/> </packageSources> </configuration> If you already have a NuGet.Config file, add the amq-clients line to it. Alternatively, you can move the .nupkg file inside the nupkg directory to an existing package source location. 2.3. Installing on Microsoft Windows Procedure Open a browser and log in to the Red Hat Customer Portal Product Downloads page at https://access.redhat.com/downloads Locate the Red Hat AMQ Clients entry in the INTEGRATION AND AUTOMATION category. Click Red Hat AMQ Clients . The Software Downloads page opens. Download the amq-qpid-proton-dotnet-1.0.0-M9 .zip file. Extract the file contents into a directory of your choosing by right-clicking on the zip file and selecting Extract All . When you extract the contents of the .zip file, a directory named amq-dotnet-1.0.0-M9 is created. This is the top-level directory of the installation and is referred to as <install-dir> throughout this document. 2.4. Adding the client to your .NET application Using the dotnet CLI you can add a reference to the Red Hat build of Apache Qpid Proton DotNet client to your application which will also download release binaries from the Nuget gallery. The following command should be run (with the appropriate version updated) in the location where your project file is saved. dotnet add package Apache.Qpid.Proton.Client --version 1.0.0-M9 Following this command your csproj file should be updated to contain a reference to to the proton-dotnet client library and should look similar to the following example: <ItemGroup> <PackageReference Include="Apache.Qpid.Proton.Client" Version="1.0.0-M9" /> </ItemGroup> Users can manually add this reference as well and use the dotnet restore command to fetch the artifacts from the Nuget gallery. 2.5. Installing the examples Use the git clone command to clone the source repository to a local directory named qpid-proton-dotnet : USD git clone https://github.com/apache/qpid-proton-dotnet.git Change to the qpid-proton-dotnet directory and use the git checkout command to checkout the commit associated with this release: USD cd qpid-proton-dotnet USD git checkout 1.0.0-M9 The resulting local directory is referred to as <source-dir> in this guide.

Commands:
unzip amq-qpid-dotnet-1.0.0.M9.zip
<?xml version="1.0" encoding="utf-8"?> <configuration> <packageSources> <add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3"/> <add key="amq-clients" value=" <install-dir> /lib"/> </packageSources> </configuration>
dotnet add package Apache.Qpid.Proton.Client --version 1.0.0-M9
<ItemGroup> <PackageReference Include="Apache.Qpid.Proton.Client" Version="1.0.0-M9" /> </ItemGroup>
git clone https://github.com/apache/qpid-proton-dotnet.git
cd qpid-proton-dotnet git checkout 1.0.0-M9