# Inventory Agent

As part of the 'Getting Started,' you will be asked to install the inventory agent. All you must do is click 'Start' on the Quick Tutorial displayed for the selected agent.  You can also install the agent from the 'Infraon Configuration' module.

## **What you see on the screen**

This page provides a comprehensive view of the agents currently installed on various devices within the IT infrastructure. It is a central hub for monitoring agent health and managing their configurations.

![A screenshot of a computer AI-generated content may be incorrect.](https://content.gitbook.com/content/E4mkwSP8a1BSD9BFNFav/blobs/eIpPFIootZPUzemhw9To/Unknown%20image)

Inventory Agent **| Basic Details**

<table><thead><tr><th width="160.20001220703125">Label</th><th width="235.4000244140625">Action</th><th>Description / Example</th></tr></thead><tbody><tr><td><strong>Name</strong></td><td>View agent details</td><td>Displays the agent’s name and associated IP addresses. Selecting the row or clicking the details icon opens complete agent information.</td></tr><tr><td><strong>Last Heartbeat</strong></td><td>View heartbeat status</td><td>Shows when the agent last communicated with the platform.<br><br><strong>Example:</strong> 22 seconds ago, 2 months ago, etc.</td></tr><tr><td><strong>CPU</strong></td><td>View system usage</td><td>Displays the device's current CPU utilization where the agent is installed.<br><br><strong>Example:</strong> 8%.</td></tr><tr><td><strong>Memory</strong></td><td>View system usage</td><td>Shows memory utilization of the device.<br><br><strong>Example:</strong> 81.03%.</td></tr><tr><td><strong>Load</strong></td><td>View system load indicator.</td><td>Displays the agent load or performance status (Low, Medium, High).<br><br><strong>Example:</strong> Medium.</td></tr><tr><td><strong>Version</strong></td><td>View agent version</td><td>Displays the installed agent version and release date.<br><br><strong>Example:</strong> 1.0.7 (20251117).</td></tr><tr><td><strong>Description</strong></td><td>View or edit notes</td><td>Shows additional notes or description added for the agent.</td></tr><tr><td><strong>Actions</strong></td><td></td><td></td></tr><tr><td><strong>Edit</strong></td><td>Modify agent details</td><td>Opens the edit form to update name, description, or mapping details.</td></tr><tr><td><strong>Details</strong></td><td>Open agent information</td><td>Opens a detailed view showing system information, installed components, battery details, and agent properties.</td></tr><tr><td><strong>Rescan</strong></td><td>Trigger immediate data refresh.</td><td>Initiates a rescan for collecting updated data from the device, including CPU, memory, load, and battery information.</td></tr><tr><td><strong>Install RDP / RDP Agent Running</strong></td><td>Install or verify the RDP agent.</td><td>If the RDP agent is not installed, clicking initiates installation. If installed, it displays running status. Allows remote access, file transfer, and session management.</td></tr><tr><td><strong>Redirect to Asset</strong></td><td>Open the corresponding asset record</td><td>Navigates to the associated asset page in the Asset Management module.</td></tr><tr><td><strong>Delete</strong></td><td>Remove agent entry</td><td>Deletes the agent record from the Inventory Agent listing.</td></tr></tbody></table>

When the user clicks the **Details** icon, a detailed information panel opens.The following table describes each section and field displayed.

![A screenshot of a computer AI-generated content may be incorrect.](https://content.gitbook.com/content/E4mkwSP8a1BSD9BFNFav/blobs/ZzzMlnEKM6ub606lTazQ/Unknown%20image)

Inventory Agent **| Details Page**

<table><thead><tr><th width="154.60003662109375">Label</th><th width="124.79998779296875">Action</th><th>Description / Example</th></tr></thead><tbody><tr><td><strong>Organization ID</strong></td><td>View</td><td>Displays the unique organization identifier assigned to the agent.<br><br><strong>Example:</strong> 132356506XXXXX7775040.</td></tr><tr><td><strong>Agent ID</strong></td><td>View</td><td>Unique system-generated ID for the installed agent.<br><br><strong>Example:</strong> 5753EAF56201419C98XXXXX13D3321907.</td></tr><tr><td><strong>Agent Version</strong></td><td>View</td><td>Shows the installed Inventory Agent version.<br><br><strong>Example:</strong> 1.0.7.</td></tr><tr><td><strong>Agent Build</strong></td><td>View</td><td>Displays the agent's build number.<br><br><strong>Example:</strong> 20251117.</td></tr><tr><td><strong>Installation Directory</strong></td><td>View</td><td>Shows the directory path where the agent is installed.<br><br><strong>Example:</strong> C:\Program Files\Infraon Corp\InfraonAgent.</td></tr><tr><td><strong>Agent Uptime</strong></td><td>View</td><td>Displays the time elapsed since the agent last restarted.<br><br><strong>Example:</strong> Up since 12/9/2025 4:57:32 PM.</td></tr><tr><td><strong>Utilization</strong></td><td></td><td></td></tr><tr><td><strong>CPU</strong></td><td>View usage</td><td>Real-time CPU utilization of the device.<br><br><strong>Example:</strong> 8%.</td></tr><tr><td><strong>Disk</strong></td><td>View usage</td><td>Current disk usage percentage.<br><br><strong>Example:</strong> 85.31%.</td></tr><tr><td><strong>Memory</strong></td><td>View usage</td><td>Current memory utilization.<br><br><strong>Example:</strong> 81.03%.</td></tr><tr><td><strong>Battery Info</strong></td><td>View laptop battery status.</td><td>Shows battery percentage and condition if the device is a laptop.<br><br><strong>Example:</strong> 54%. Hidden for non-laptop devices.</td></tr><tr><td><strong>System Info</strong></td><td></td><td></td></tr><tr><td><strong>Operating System</strong></td><td>View</td><td>Displays OS name and edition.<br><br><strong>Example:</strong> Microsoft Windows 11 Pro.</td></tr><tr><td><strong>System Uptime</strong></td><td>View</td><td>Indicates the duration the system has been running since the last shutdown or restart.</td></tr><tr><td><strong>Total Physical Memory</strong></td><td>View</td><td>RAM on the device is installed.<br><br><strong>Example:</strong> 14.83 GB.</td></tr><tr><td><strong>Free Physical Memory</strong></td><td>View</td><td>Available RAM.<br><br><strong>Example:</strong> 2.81 GB.</td></tr><tr><td><strong>Total Disk Size</strong></td><td>View</td><td>Total disk storage capacity.<br><br><strong>Example:</strong> 475.48 GB.</td></tr><tr><td><strong>Free Disk Size</strong></td><td>View</td><td>Available free disk space.<br><br><strong>Example:</strong> 69.84 GB.</td></tr><tr><td><strong>Network Interface Information</strong></td><td>Expand/Collapse</td><td>Displays detailed network configuration of the device, including host name, DNS values, IP routing, adapters, MAC addresses, and media state.</td></tr></tbody></table>

### **Bulk Edit**

Bulk Edit **| Basic Details**

<table data-header-hidden><thead><tr><th width="170.5999755859375" valign="top"></th><th width="191.20001220703125" valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top"><strong>Label</strong></td><td valign="top"><strong>Action</strong></td><td valign="top"><strong>Description / Example</strong></td></tr><tr><td valign="top"><strong>Enable Inventory Scan</strong></td><td valign="top">Select agents and click Enable Inventory Scan</td><td valign="top">Enables inventory scanning for selected agents to collect hardware and software details.</td></tr><tr><td valign="top"><strong>Disable Inventory Scan</strong></td><td valign="top">Select agents and click Disable Inventory Scan</td><td valign="top">Disables inventory scanning for selected agents, stopping data collection.</td></tr><tr><td valign="top"><strong>Rescan</strong></td><td valign="top">Select agents and click Rescan</td><td valign="top">Triggers an immediate inventory scan on selected agents to refresh asset data.</td></tr><tr><td valign="top"><strong>Install RDP Agent</strong></td><td valign="top">Select agents and click Install RDP Agent</td><td valign="top">Installs the RDP agent to enable remote access and session management for selected agents.</td></tr><tr><td valign="top"><strong>Uninstall RDP Agent</strong></td><td valign="top">Select agents and click Uninstall RDP Agent</td><td valign="top">Removes the RDP agent from selected agents, disabling remote access capability.</td></tr><tr><td valign="top"><strong>Enable Polling</strong></td><td valign="top">Select agents and click Enable Polling</td><td valign="top">Enables periodic polling to monitor system metrics, including CPU, memory, and status.</td></tr><tr><td valign="top"><strong>Disable Polling</strong></td><td valign="top">Select agents and click Disable Polling</td><td valign="top">Disables periodic polling for selected agents, stopping real-time monitoring updates.</td></tr><tr><td valign="top"><strong>Install Patch Management Agent</strong></td><td valign="top">Select agents and click Install Patch Management Agent</td><td valign="top">Installs the patch management agent on selected systems to enable centralized patch deployment.</td></tr><tr><td valign="top"><strong>Install Log Agent</strong></td><td valign="top">Select agents and click Install Log Agent</td><td valign="top">Installs the log agent to collect and forward logs for monitoring and analysis.</td></tr><tr><td valign="top"><strong>Uninstall Log Agent</strong></td><td valign="top">Select agents and click Uninstall Log Agent</td><td valign="top">Removes the log agent from selected systems, stopping log collection.</td></tr><tr><td valign="top"><strong>Start Log Agent</strong></td><td valign="top">Select agents and click Start Log Agent</td><td valign="top">Starts the log agent service to begin collecting and monitoring logs.</td></tr><tr><td valign="top"><strong>Stop Log Agent</strong></td><td valign="top">Select agents and click Stop Log Agent</td><td valign="top">Stops the log agent service, pausing log collection on selected agents.</td></tr><tr><td valign="top"><strong>Shut Down</strong></td><td valign="top">Select one or more agents → Click More → Click Shut Down</td><td valign="top"><p>Sends a shutdown command to the selected devices through the Inventory Agent. A details panel displays the execution status with categories such as successful devices, offline devices, unsupported OS, and agent update required.</p><p> </p><p>Only supported for Windows devices with the required agent version.</p></td></tr><tr><td valign="top"><strong>Restart</strong></td><td valign="top">Select one or more agents → Click More → Click Restart</td><td valign="top"><p>Sends a restart command to the selected devices through the Inventory Agent. A details panel shows execution results, including successful, offline, unsupported, and agent-update-required devices.</p><p> </p><p>Action is executed only for eligible devices based on status, OS, and agent version.</p></td></tr></tbody></table>

From the **Inventory Agent** page, users can select multiple Infraon Inventory Agents and trigger the installation of the **Patch Management Agent** across all selected systems in a single action.

![](https://content.gitbook.com/content/E4mkwSP8a1BSD9BFNFav/blobs/m2pwP2ldnrkp4VuQrQHt/Unknown%20image)

This enables bulk deployment of the patch agent without requiring individual asset-level installation.

### **Instructions to install the Inventory Agent**

Inventory agent can be installed on the following devices:

* **Windows Agent** - The inventory agent supports all Windows desktops/laptops, not Windows Servers. The agent can be installed on each device individually or in bulk through the Active Directory.
* **Mac OS Agent** - It supports all Mac versions. The agent supports devices with both Intel-based chips and M-series chips.
* **Ubuntu(Linux)** - Supports all Ubuntu desktops/laptops and servers.

The steps in installing an inventory agent are as follows:

#### Windows Device

* Go to Infraon Configuration -> Bots -> Agents.
* Click the 'Download Agent' icon.
* Download the Windows Agent.
* The agent is downloaded to your device as an MSI file.
* Copy the Agent API token displayed on this page. Use it when the agent is installed.
* Double-click on the downloaded MSI file to initiate installation.
* Paste the Agent API token in the 'Organization Key' field and follow the prompts to finish the installation of the agent on your device.
* Add the HTTP or HTTPS proxy server details if a proxy server is used to access the internet.
* Provide the administrator's username and password to install the Infraon agent with admin privileges. If not provided, the Infraon agent will be installed on the local account with default privileges.
* Once the agent is installed, ensure that the URL <https://instance01.wss.infraon.app/>' is added to the whitelist.

#### Mac OS

* Go to Infraon Configuration -> Bots -> Agents.
* Click the 'Download Agent' icon.
* Download the Mac Agent.
* The agent is downloaded as a package onto your device. The package includes the PKG file and the API token.
* Double-click on the downloaded file to initiate installation. Provide your device credentials to confirm.
* Once the agent is installed, ensure that the URL <https://instance01.wss.infraon.app/>' is added to the whitelist.

#### Ubuntu

* Go to Infraon Configuration -> Bots -> Agents.
* Click the 'Download Agent' icon.
* Download the Ubuntu Agent.
* Your agent has been downloaded as a DEB file. Open the Command center. Type 'sudo dpkg—i InfraonAgent.deb' to initiate installation. Copy the 'Agent Token' from Infraon. Paste this code when the command center prompts for 'Organization Key'.

Type 'y'(yes) to install missing dependencies.

Your agent has been successfully installed. To view installation logs, use the command 'journalctl—u infraonagent.service'.Ensure that the URL '<https://instance01.wss.infraon.app/>' is added to the whitelist.