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
- Open a browser and log in to the Red Hat Customer Portal Product Downloads page at 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 Clients 2.8.0 .NET Core .zip file.
Use the
unzip
command to extract the file contents into a directory of your choosing.$ unzip amq-clients-2.8.0-dotnet-core.zip
When you extract the contents of the .zip file, a directory named
amq-clients-2.8.0-dotnet-core
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
$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 theamq-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
- Open a browser and log in to the Red Hat Customer Portal Product Downloads page at 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 Clients 2.8.0 .NET .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-clients-2.8.0-dotnet
is created. This is the top-level directory of the installation and is referred to as <install-dir>
throughout this document.