Chapter 2. Installation

This chapter guides you through the steps to install AMQ .NET in your environment.

2.1. Prerequisites

  • You must have a subscription to access AMQ release files and repositories.
  • To use AMQ .NET on Red Hat Enterprise Linux, you must install the the .NET Core 3.1 developer tools. For information, see the .NET Core 3.1 getting started guide.
  • To build programs using AMQ .NET on Microsoft Windows, you must install Visual Studio.

2.2. Installing on Red Hat Enterprise Linux

Procedure

  1. Open a browser and log in to the Red Hat Customer Portal Product Downloads page at access.redhat.com/downloads.
  2. Locate the Red Hat AMQ Clients entry in the INTEGRATION AND AUTOMATION category.
  3. Click Red Hat AMQ Clients. The Software Downloads page opens.
  4. Download the AMQ Clients 2.7.0 .NET Core .zip file.
  5. Use the unzip command to extract the file contents into a directory of your choosing.

    $ unzip amq-clients-2.7.0-dotnet-core.zip

    When you extract the contents of the .zip file, a directory named amq-clients-2.7.0-dotnet-core is created. This is the top-level directory of the installation and is referred to as <install-dir> throughout this document.

  6. Use a text editor to create the file $HOME/.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>/nupkg"/>
      </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 <install-dir>/nupkg directory to an existing package source location.

2.3. Installing on Microsoft Windows

Procedure

  1. Open a browser and log in to the Red Hat Customer Portal Product Downloads page at access.redhat.com/downloads.
  2. Locate the Red Hat AMQ Clients entry in the INTEGRATION AND AUTOMATION category.
  3. Click Red Hat AMQ Clients. The Software Downloads page opens.
  4. Download the AMQ Clients 2.7.0 .NET .zip file.
  5. 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-clients-2.7.0-dotnet is created. This is the top-level directory of the installation and is referred to as <install-dir> throughout this document.