Chapter 2. Installation

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

2.1. Prerequisites

To begin installation, use your subscription to access AMQ distribution files and repositories.

Building applications on Red Hat Enterprise Linux requires the .NET Core 2.1 developer tools. For information about installing the tools, see the .NET Core 2.1 Getting Started Guide.

Building applications on Windows with AMQ .NET requires Visual Studio 2012 or later. Solution files built by Visual Studio 2012 and Visual Studio 2013 are supplied in the kit, and these files can be opened by any later version of Visual Studio.

2.2. Installing on Red Hat Enterprise Linux

Use the following steps to install the .NET Core SDK:

  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 JBOSS INTEGRATION AND AUTOMATION category.
  3. Click Red Hat AMQ Clients. The Software Downloads page opens.
  4. Download the AMQ .NET 2.5.0 .NET Core SDK .zip file.
  5. Use the unzip command to extract the file contents into a directory of your choosing:

    $ unzip amq-dotnet-2.5.0-core-sdk.zip
    Archive:  amq-dotnet-2.5.0-core-sdk.zip
       creating: amq-dotnet-2.5.0-core-sdk/
       creating: amq-dotnet-2.5.0-core-sdk/bin/
       creating: amq-dotnet-2.5.0-core-sdk/bin/netstandard2.0/
    [...]

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

2.3. Installing on Microsoft Windows

Use the following steps to install the Windows SDK:

  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 JBOSS INTEGRATION AND AUTOMATION category.
  3. Click Red Hat AMQ Clients. The Software Downloads page opens.
  4. Download the AMQ .NET 2.5.0 Windows SDK .zip file.
  5. Extract the file contents into a directory 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-2.5.0-sdk is created. This is the top-level directory of the SDK and is referred to as <install-dir> throughout this document.