---
title: "Configuring InfraSense Active on a linux based machine"
canonical: "https://thoughtdata.refined.site/space/TUD/57705203/Configuring%20InfraSense%20Active%20on%20a%20linux%20based%20machine"
format: markdown
---
## Installing and configuring InfraSense compact agent on linux based machines

InfraSense compact agent is a sensor which monitors infrastructure related metrics on the system it is installed. InfraSense compact agent sensor collects and forwards data to a dedicated InfraSense sensor. One InfraSense sensor can be setup to receive data from multiple InfraSense compact agent sensors in your IT network. InfraSense compact agent sensor can not communicate directly with Enterprise360 and requires a dedicated InfraSense sensor along with it to work.

***Note****: In order to proceed with InfraSense compact agent sensor software installation on your target linux machine you would need a pre-configured InfraSense sensor already up and running first. Refer to installing InfraSense section if you have not completed the step.*

**Getting right InfraSense compact agent sensor binaries matching your linux/unix based OS**

InfraSense compact active sensor binaries varies according to your linux OS type and version. Make sure you have the right InfraSense compact agent binary matching your linux OS type and version before you begin the installation process

Binaries are available and supported for following linux distributions and versions

1. Fedora 31 and above
2. Centos/Redhat 8 and above
3. Ubuntu 20.04 and above

Contact your ThoughtData presales team to get the latest binaries and if you need binaries. For old versions you can request the ThoughtData presales team or by sending an email to info@thoughtdata.com.

**The below instructions are for Centos/Redhat OS Version 8 and above**

Download the InfraSense compact agent sensor binary on to your linux machine and login as root/super user

Run **"yum update -y" **to update all packages to latest versions from your respective linux distribution.

Install dependent libraries by running "**yum install -y procps net-tools iproute initscripts"**

Install InfraSense active. Example **"rpm -ivh td_infrasense_compact-2.16-1.el8.x86_64.rpm"**. Note the binary name and version number could be different in your case.

Go to **"cd /usr/local/thoughtdata/infrasense/etc"**

Edit the file ***"td_infrasense.conf"*** using the command ***"vi td_infrasense.conf"*** 

**Note**: The default path of InfraSense compact agent sensor software after installation is /usr/local/thoughtdata/infrasense/

Configure the IP address of the InfraSense for your InfraSense compact agent.

Edit the string **<your_infrasense_ip> **and replace it with your actual InfraSense IP

Optionally - If would like to provide a custom host name to identify this linux system, provide the hostname for the field **"infrasense_custom_hostname"**. In below example **"hw_sensor_td_test" **is the custom host name. Note that providing a custom host name over rides the Infrasense active to send custom host name rather than actual hostname of the system. This is only required, if you want to recognize the system with a different name than its actual OS hostname. If you do not intend to use custom hostname, leave the property to blank

Save and exit the file by pressing "Esc" ":" "wq"

![image](media://a7bcdffd-db40-4389-8434-fa546cb05068)

 Set InfraSense IP in InfraSense Active Agent

Go to **"cd /usr/local/thoughtdata/infrasense/bin"**

Start InfraSense active agent by running **"./start_is"**

Check if the InfraSense active agent is running, by running **"./ps"**

Checking logs of InfraSense compact agent sensor process. Run **"cat infrasense_compact.log*****" ***to check InfraSense compact agent related logs in case if you run into any issues

***Note:**** By default your InfraSense compact agent sensor is registered as a system service and starts automatically every time you restart your machine.*

Your InfraSense compact agent sensor software installation and configuration is now completed

**The below instructions are for Ubuntu OS Version 20.04 LTSR and above**

Download the InfraSense compact agent sensor binary on to your linux machine and login as root/super user

Run **"sudo apt-get update -y" **to update all packages to latest versions from your respective linux distribution.

Install dependent libraries by running **"sudo apt install** **-y procps net-tools iproute2"**

Install InfraSense active. Example **"dpkg -i td_infrasense_compact-2.16-1.20.04.x86_64.deb"**. Note the binary name and version number could be different in your case.

Go to **"cd /usr/local/thoughtdata/infrasense/etc"**

Edit the file ***"td_infrasense.conf"*** using the command ***"vi td_infrasense.conf"*** 

**Note**: The default path of InfraSense compact agent sensor software after installation is /usr/local/thoughtdata/infrasense/

Configure the IP address of the InfraSense for your InfraSense compact agent sensor.

Edit the string **<your_infrasense_ip> **and replace it with your actual InfraSense IP

Optionally - If would like to provide a custom host name to identify this linux system, provide the hostname for the field **"infrasense_custom_hostname"**. In below example **"hw_sensor_td_test" **is the custom host name. Note that providing a custom host name over rides the InfraSense compact agent sensor to send custom host name rather than actual hostname of the system. This is only required, if you want to recognize the system with a different name than its actual OS hostname. If you do not intend to use custom hostname, leave the property to blank

Save and exit the file by pressing "Esc" ":" "wq"

![image](media://a7bcdffd-db40-4389-8434-fa546cb05068)

 Set InfraSense IP in InfraSense Active Agent

Go to **"cd /usr/local/thoughtdata/infrasense/bin"**

Start InfraSense compact agent sensor by running **"./start_is"**

Check if the InfraSense compact agent sensor is running, by running **"./ps"**

Checking logs of InfraSense compact agent sensor process. Run **"cat infrasense_compact.log*****" ***to check InfraSense active related logs in case if you run into any issues

***Note:**** By default your InfraSense compact agent sensor is registered as a system service and starts automatically every time you restart your machine *

Your InfraSense compact agent sensor software installation and configuration is now completed