# Acronis

# Introduction

The script queries the status of Acronis Cloud backups via its API and generates Pandora FMS modules with that information, exporting them in XML format for automatic processing by the Pandora agent.

# Compatibility matrix

<table border="1" id="bkmrk-sistemas-donde-se-ha" style="border-collapse: collapse; width: 100%; height: 84px;"><tbody><tr style="height: 28px;"><td style="width: 50%; height: 28px;">**Systems where it has been tested**</td><td style="width: 50%; height: 28px;">Rocky 9

</td></tr><tr style="height: 28px;"><td style="width: 50%; height: 28px;">**Systems where it should work**</td><td style="width: 50%; height: 28px;">Any Linux system supported by PandoraFMS

</td></tr></tbody></table>

# Parameters

<table border="1" id="bkmrk-par%C3%A1metro-descripci%C3%B3" style="border-collapse: collapse; width: 100%; height: 408.284px;"><tbody><tr style="height: 29.7167px;"><td style="width: 50%; height: 29.7167px;">**Parameter**</td><td style="width: 50%; height: 29.7167px;">**Description**</td></tr><tr style="height: 29.7167px;"><td style="width: 50%; height: 29.7167px;">'-c', '--client'</td><td style="width: 50%; height: 29.7167px;">Acronis Client ID</td></tr><tr style="height: 29.7167px;"><td style="width: 50%; height: 29.7167px;">'-p', '--password'</td><td style="width: 50%; height: 29.7167px;">Acronis Secret </td></tr><tr style="height: 29.7167px;"><td style="width: 50%; height: 29.7167px;">'-u', '--url'</td><td style="width: 50%; height: 29.7167px;">Acronis API URL : https://es01-cloud.acronis.com</td></tr><tr style="height: 31px;"><td style="width: 50%; height: 31px;">--interval</td><td style="width: 50%; height: 31px;">Agent creation interval.</td></tr><tr><td style="width: 50%;">--transfer\_mode</td><td style="width: 50%;">Transfer mode. Local or tentacle are the available options (optional).</td></tr><tr style="height: 29.7167px;"><td style="width: 50%; height: 29.7167px;">--tentacle\_port</td><td style="width: 50%; height: 29.7167px;">Tentacle port. Default 41121 (optional)</td></tr><tr style="height: 29.7167px;"><td style="width: 50%; height: 29.7167px;">--tentacle\_address</td><td style="width: 50%; height: 29.7167px;">IP address of the tentacle server to send the data to (optional)</td></tr><tr style="height: 46.5167px;"><td style="width: 50%; height: 46.5167px;">--agent\_name</td><td style="width: 50%; height: 46.5167px;">To name the agent that will contain the custom query modules, default: “Acronis” (optional).</td></tr><tr style="height: 46.5167px;"><td style="width: 50%; height: 46.5167px;">--prefix</td><td style="width: 50%; height: 46.5167px;">Used to specify a prefix for modules and agents. (optional)</td></tr><tr style="height: 29.7167px;"><td style="width: 50%; height: 29.7167px;">--agent\_group</td><td style="width: 50%; height: 29.7167px;">Pandora FMS target group (optional)</td></tr><tr style="height: 46.5167px;"><td style="width: 50%; height: 46.5167px;">--data\_dir</td><td style="width: 50%; height: 46.5167px;">Pandora FMS data directory. By default, it is /var/spool/pandora/data\_in/ (optional)</td></tr></tbody></table>

# Pre requisites

Permissions required to use the Acronis API with the plugin

**The client (application) used by the plugin must have the following permissions:**

\- resource\_management:read  
\- policy\_management:read  
\- backup\_management:read

**To obtain these permissions, follow these steps:**

**1. Log in to the Acronis administration portal:**  
 https://cloud.acronis.com/

**2. Go to:**  
 Settings → Applications → Register Application

**3. Create a new application:**  
\- Type: Confidential  
\- Name: PandoraFMS-Acronis (for example)  
\- Redirect URI: leave blank

**4. Copy the generated `client\_id` and `client\_secret`.**

**5. Assign permissions to the application:**  
\- In the \*\*Permissions / Scopes\*\* section, check:  
```  
 resource\_management:read  
 policy\_management:read  
 backup\_management:read  
 ```

**6. Save the changes.**

Test access  
You can verify that authentication works with

```
curl -X POST https://<your-acronis-domain>/api/2/idp/token \
  -d “grant_type=client_credentials” \
  -d “client_id=<CLIENT_ID>” \
  -d “client_secret=<CLIENT_SECRET>”
```

# Manual execution

The plugin execution format is as follows:

```
./pandora_acronis.py -c < Acronis Client ID > -p < Acronis Client Secret > -u < Acronis API Base URL > 
[--data_dir < Path to Pandora data_in directory. Default: /var/spool/pandora/data_in/ >] 
[--prefix < Prefix for generated agents. Default: empty >] 
[--agent_name < Agent name. Default: Acronis >] 
[--agent_group < Agent group. Optional >] 
[--interval < Agent execution interval in seconds. Default: 300 >] 
[--transfer_mode < Transfer mode: tentacle or local. Default: tentacle >] 
[--tentacle_ip < Tentacle server IP. Default: 127.0.0.1 >] 
[--tentacle_port < Tentacle server port. Default: 41121 >] 
[-v | --verbose < Enable detailed output >]
```

For example :

```
./pandora_acronis \
  -c 1234567890abcdef1234567890abcdef \
  -p s3cr3tCl13ntKey987654321 \
  -u https://eu-cloud.acronis.com \
  --agent_group "Acronis_Backups" \
  --prefix "ACR_" \
  --interval 300 \
  --transfer_mode tentacle \
  --tentacle_ip 127.0.0.1 \
  --tentacle_port 41121
```

a

# Agents and modules generated by the plugin

The plugin will create an agent. The name of this agent is “Acronis” by default and can be configured with the “--agent\_name” parameter. A prefix can be added to the agent with the “--prefix” parameter.

The plugin will create a “generic\_proc” type module for each machine with its backup status and status information in the description.

# Configuration in PandoraFMS

**Installation from the console**

To register the plugin, go to the “register plugin” section from the console.

[![imagen.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-07/scaled-1680-/imagen.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-07/imagen.png)

We will allow you to select a file.

[![imagen.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-07/scaled-1680-/Rnvimagen.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-07/Rnvimagen.png)

Select the pspz2 file containing the plugin.

A message will appear indicating that it has been successfully installed.

[![Captura desde 2025-11-04 18-33-41.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-11/scaled-1680-/captura-desde-2025-11-04-18-33-41.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-11/captura-desde-2025-11-04-18-33-41.png)

Once the plugin is registered, we will see it in the plugins section.

[![servers_plugins.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-07/scaled-1680-/IAxservers-plugins.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-07/IAxservers-plugins.png)

The parameters section will display all the parameters contained in the plugin, which can be configured. The mandatory parameters are the client ID, secret, and URL (-c, -p, and -u).

[![Captura desde 2025-11-04 18-36-36.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-11/scaled-1680-/captura-desde-2025-11-04-18-36-36.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-11/captura-desde-2025-11-04-18-36-36.png)

Below, you can assign a value to each macro.

[![Captura desde 2025-11-04 18-45-59.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-11/scaled-1680-/captura-desde-2025-11-04-18-45-59.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-11/captura-desde-2025-11-04-18-45-59.png)  
  
Once configured, we will click on “update.”

[![Captura desde 2025-11-04 18-46-53.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-11/scaled-1680-/captura-desde-2025-11-04-18-46-53.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-11/captura-desde-2025-11-04-18-46-53.png)