Installing, Updating, and Removing the Monitoring Agent on Linux

Installing the Monitoring Agent

Updating the Monitoring Agent

Removing the Monitoring Agent

# Installing, Updating, and Removing the Monitoring Agent on Linux

This section describes the installation and configuration of the monitoring agent on workstations running Linux.



The monitoring agent is compatible with Linux distributions that use the DEB or RPM package formats.

Features of event recording by the agent on Linux are described on the [Known Issues and Limitations#Linux OS](../5.known_issues_and_limitations/1.known_issues_and_limitations.md) page.

## Installing the Monitoring Agent



For some Linux distributions, if you work via remote access (RDP), you must enable the `record` extension in *xorg* parameters. To do this, you need to:

1. In the file */etc/X11/fly-dm/fly-dmrc*, add `+extension RECORD` to the `ServerArgsLocal=` variable:

    ```
    ServerArgsLocal=... +extension RECORD
    ```

1. Add `/usr/libexec/OperavixAgent/agent_inspector` and `/usr/libexec/OperavixAgent/agent_service` to the */etc/X11/trusted* file.
1. Add the following section to the file */etc/X11/xrdp/xorg.conf*:

    ```
    Section "Extensions"
        Option "RECORD" "Enable"
    EndSection
    ```

1. Reboot the computer.

[!NOTE] When installing, the installer must not be located in the user directory. For example, you can create a folder */opt/repo*, place the installer there, and run it from that directory.



On Debian-based systems, install with:

```
# apt install /opt/repo/agent.deb
```



On RPM-based systems, install with:

```
# apt-get install /opt/repo/agent.rpm
```



If the above command does not work for the RPM-based system:

```
# rpm --nosignature --nodigest -iv /tmp/agent_setup.rpm
```

[!NOTE] The path to *agent_setup.rpm* is shown as an example and may vary depending on your settings.

## Updating the Monitoring Agent

[!NOTE] When updating, the installer must not be located in the user directory. For example, you can create a folder */opt/repo*, place the installer there, and run it from that directory.

[!IMPORTANT] The agent will not update if its current version is newer than or matches the update version.



On Debian-based systems, update with:

```
# apt install /opt/repo/agent.deb
```


On RPM-based systems, update with:

```
# apt-get install /opt/repo/agent.rpm
```



If the above command does not work for the RPM-based system:

```
# rpm --nosignature --nodigest -iv /tmp/agent_setup.rpm
```

## Removing the Monitoring Agent

[!NOTE] For removal, use the standard package manager of the corresponding operating system. The `operavix-agent` parameter in all commands is the package name.



On Debian-based systems, remove with:

```
# apt remove operavix-agent
```



On RPM-based systems, remove with:

```
# apt-get remove operavix-agent
```



If the above command does not work for the RPM-based system:

```
# rpm --nosignature --nodigest -e operavix-agent
```

Instructions for installing, updating, and removing the monitoring agent on Linux

Starting and Stopping the Monitoring Agent

Monitoring Agent Configurator

What Is Operavix

Quick Installation of the Operavix Server Component

Monitoring Agent

JS Tracker (Customer Journey Tracking)

Quick Installation

Quick System Setup

Building a Custom Dashboard

Template-Based Reports for Data Analysis

First Dashboard

What’s Next?

Quick Start 

Functional Architecture

Network Interaction of System Components

Description of the System Functioning

System Integration with External Automated Systems

Technical Requirements for Server and Hardware Equipment

Architectural Scheme of the Operavix Application

Network Scheme of the Operavix Application

Glossary

Description of the Operavix System 

Installing, Configuring, and Removing the Operavix Application on Windows

Installing the Operavix Application on Linux

Updating Operavix on Windows

Updating Operavix on Linux

Updating Operavix

Cluster Mode Setup

Migrating the Operavix Server from Windows to Linux

Installing the Automation Module on a Separate Server

Installing and Running the AI Agent

Installing and Running the Webhook Agent

Instructions for Installing, Updating, and Removing the System

License Key

Beta Version Functionality

System Licensing

Working with Databases

Working with the System

System Configuration Files

Prometheus Metrics

Access Roles

Working with GraphQL

Managing System Users

System Emails to Users

Embedding Operavix Dashboards

Differences Between Operavix on Linux and Windows Operating Systems

Administration 

Installing and Removing the ClickHouse DBMS

Updating the ClickHouse DBMS

Connecting the Application to the ClickHouse Analytical DBMS

Creating User Accounts in ClickHouse

Setting up a ClickHouse DBMS Cluster in Docker with Replication Support

ClickHouse 

User Data Collection by Monitoring Agent

Obtaining The Monitoring Agent Distribution

Installing, Updating, and Removing the Monitoring Agent on Windows

Managing the Monitoring Agent

Monitoring Logs

Storing Monitoring Agent Logs

Collecting Screenshots with the Monitoring Agent

Export and Import of User Activity

Activity Archiving

Working with Damaged Monitoring Archives

Data Storage Structure in ClickHouse

Monitoring 

Signing In to the System

How to Recover Your Password

Home Page

Filtering

Navigation in the System

Workspaces

Personal Profile

System Settings

Users

Departments

Bulk Actions

Adding API Keys

Keytab File Creation for the Kerberos Authentication in Active Directory

Configuring Authentication Using OpenID Connect and Keycloak

Configuring SAML Authentication in Keycloak

Adding Authentication

About the system

The Monitoring Section

The Connections Section

Data Storages

System Tables

System Settings 

Automation Agents

Execution Log

Control Panel

Configuring an SMB Connection

Connections

Automation Blocks

Trigger Blocks

Working with Files

Working with Services

Working with LLM

Tools

Event Processing

Editing a Script

Query and Code Editor

Script Testing and Publishing

Running a Script

Script Example

Automation 

Custom Integrations 

System Events

JS Tracker 

Access Settings for Workspaces

Adding and Configuring Tables

Replacing Tables

Adding and Configuring Processes

Global Workspace Indicators

Display Rules

Configuring the Data Model

Packages

General

Configuring Access to Dashboards

Click to Filter

Table Report Export

Browse mode

Edit Mode

Views

Dimensions and Measures

Widget Basic Settings

Widget Display Settings

Widget Filtering Settings

Widget List

Widgets

Sorting

Markdown Usage Rules

Variables

Global Dashboard Indicators

Running Script from Dashboard

Go to URL

Run Script

Open View

Update Variable

Click Actions

Input Methods

Displaying Monitoring Screenshots in a Dashboard

Formula Editor

Functions for Formulas

The process Function

View Configuration in YAML

Widget Configuration in YAML

Dimensions and Measures in YAML

Process-Based Dimensions and Measures in YAML

Data Formats and Formatting in YAML

YAML Editor

Dashboards

Report Example

Business Intelligence 

OperavixAI

Package Creation Guide

Marketplace 

Template-Based Dashboards

Configuring Depersonalization Of User Data When Deleted In AD

Activating LDAPS

Synchronized Attributes Between the System and AD

Getting Information About AD Security Groups Using A GraphQL Request

Configuring User Synchronization with Active Directory

User Synchronization 

Audit Mechanism Description

System Status Monitoring

Implemented Information Security Protection Measures in the System

Audit Logs

Docker Containers

Mutual Authentication Between Application Server and ClickHouse

For Security Administrator 

Known Issues

Known Issues and Limitations 

Frequently Asked Questions

.css-wsrjzs{display:inline;margin-right:12px;}@media screen and (max-width: 691px){.css-wsrjzs{display:inline-block;margin-right:0;}}Installing, Updating, and Removing the Monitoring Agent on Linux

Installing the Monitoring Agent

Updating the Monitoring Agent

Removing the Monitoring Agent

Installing, Updating, and Removing the Monitoring Agent on Linux