Installation

Prerequisites

Hardware Sentry OpenTelemetry Collector requires Java Runtime Environment (JRE) version 11 or higher.

The OpenTelemetry Collector will use the $JAVA_HOME environment variable to determine that path to the JRE. If $JAVA_HOME is not set, it will use any java executable found in the $PATH.

To verify the version installed on a Linux system, run the following commands:

$JAVA_HOME/bin/java -version
java -version

On Windows, run the following commands:

%JAVA_HOME%\bin\java -version
java -version

If needed, you can download the latest versions of the Java Runtime Environment from Adoptium (formerly AdoptOpenJDK).

Windows or Linux?

Windows and Linux are equally supported to run Hardware Sentry OpenTelemetry Collector. However, the WMI protocol is implemented on Windows only. This means that you will need to run Hardware Sentry on Windows, to monitor another Windows system through WMI.

Please check the Hardware Connector Library documentation for more details on the required protocols, depending on the targeted platform, and whether you need WMI.

Note: The product does not support 32-bit systems.

On Linux

Download

From Sentry Software's Web site, download:

  • hws-otel-collector-1.0-linux-amd64.tar.gz

Install

Unzip and untar the content of hws-otel-collector-1.0-linux-amd64.tar.gz into a program directory, like /usr/local or /opt. There is no need to create a specific subdirectory for hws-otel-collector as the zip archive already contains an hws-otel-collector directory.

/ $ cd /usr/local
/usr/local $ sudo tar xf /tmp/hws-otel-collector-1.0-linux-amd64.tar.gz

Configure

There are 2 configuration files:

Before starting the OpenTelemetry Collector, make sure to configure ./config/otel-config.yaml, since a restart of the Collector is required to take into account its changes.

Start

You can start the Hardware Sentry OpenTelemetry Collector with the below command:

/usr/local/hws-otel-collector/bin/hws-otel

This will start the Hardware Sentry OpenTelemetry Collector with the default OpenTelemetry Collector configuration file: ./config/otel-config.yaml.

You can start the Hardware Sentry OpenTelemetry Collector with an alternate configuration file with the below command:

/usr/local/hws-otel-collector/bin/hws-otel --config <PATH>

hws-otel is just a shell script that ensures the OpenTelemetry Collector is run from its home directory. You can choose to execute the OpenTelemetry Collector binary directly with the below commands:

/$ cd /usr/local/hws-otel-collector
/usr/local/hws-otel-collector$ bin/hws-otel-collector --config config/my-otel-config.yaml

On Windows

Download

From Sentry Software's Web site, download:

  • hws-otel-collector-1.0-windows-amd64.zip

Install

Unzip the content of hws-otel-collector-1.0-windows-amd64.tar.gz into a program folder. There is no need to create a specific subfolder for hws-otel-collector as the zip archive already contains an hws-otel-collector folder.

Note: You will need administrative privileges to unzip into C:\Program Files.

Configure

There are 2 configuration files:

Before starting the OpenTelemetry Collector, make sure to configure ./config/otel-config.yaml, since a restart of the Collector is required to take into account its changes.

Start

Start Hardware Sentry OpenTelemetry Collector in CMD.EXE or Windows Terminal with elevated privilages (Run As Administrator).

c:
cd "Program Files"
cd hws-otel-collector
bin\hws-otel

This will start the Hardware Sentry OpenTelemetry Collector with the default OpenTelemetry Collector configuration file: .\config\otel-config.yaml.

You can start the Hardware Sentry OpenTelemetry Collector with an alternate configuration file with the below command:

"c:\Program Files\hws-otel-collector\bin\hws-otel" --config "c:\Program Files\hws-otel-collector\bin\hws-otel\config\my-otel-config.yaml"

Start As a Service

It is recommended to install and run the Hardware Sentry OpenTelemetry Collector as a Windows Service with NSSM.

Download and install the very latest version of NSSM so that it's available in your %PATH% (to make things easier).

Run the below command to create the service (assuming the product has been installed in c:\Program Files):

nssm install hws-otel "c:\Program Files\hws-otel-collector\bin\hws-otel-collector.exe" --config """c:\Program Files\hws-otel-collector\config\otel-config.yaml"""
nssm set hws-otel AppDirectory "c:\Program Files\hws-otel-collector"
nssm set hws-otel DisplayName "Hardware Sentry OpenTelemetry Collector"
nssm set hws-otel Start SERVICE_AUTO_START

The service will appear as below in services.msc:

Hardware Sentry OpenTelemetry Collector running as a service on Windows

Verify

To verify that Hardware Sentry OpenTelemetry Collector is properly running, read the Health Check section.

Ports and Firewalls

Hardware Sentry OpenTelemetry Collector opens several TCP ports for listening. None of these ports need to be open to the outside network, as they are used internally only.

Component Port Required
Hardware Sentry Exporter TCP/24375 Used internally only
OpenTelemetry Collector HealthCheck TCP/13133 Optional, if you need to verify the status of the collector
OpenTelemetry Collector Exporter TCP/8888 Used internally only
No results.