# Konfiguracja agenta

## Aktywacja (przydzielanie licencji)

{% stepper %}
{% step %}
Zaloguj się do konsoli **Xopero ONE Management Service** (**XMS**).
{% endstep %}

{% step %}
Kliknij przycisk **Aktywuj agenta** w górnym menu.

<figure><img src="https://1873867500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwg6DDqlTFok8F9zv6rqa%2Fuploads%2Fn1h4FFx7yPM5BqMSLAjm%2Fimage.png?alt=media&#x26;token=eaa0fc77-9b13-40c4-a7c3-23231aae7ecc" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Pojawi się pasek boczny z listą dostępnych agentów — możesz zobaczyć podstawowe informacje, takie jak typ urządzenia, nazwa, adres IP i system operacyjny.
{% endstep %}

{% step %}
Wybierz urządzenie, które chcesz aktywować (możesz wybrać wiele urządzeń, jeśli przydzielasz im ten sam typ licencji) i naciśnij przycisk **Aktywuj**, aby kontynuować.
{% endstep %}

{% step %}
Następnie wybierz typ licencji, który chcesz przypisać wybranym urządzeniom i kliknij **Przypisz licencję** aby potwierdzić swój wybór.
{% endstep %}

{% step %}
Gdy licencja zostanie poprawnie przypisana, twoje urządzenia będą widoczne w zakładce **Urządzenia**.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
W systemie **Xopero ONE**, licencje local worker, cloud worker, oraz feature worker są <mark style="color:$success;">**bezpłatne**</mark>. Te licencje pozwalają na wykonywanie określonych operacji, z wyjątkiem tworzenia kopii zapasowej samego urządzenia — dlatego urządzenia z tymi licencjami pojawiają się w zakładce **Ustawienia** > **Zaawansowane** > **Workers**.
{% endhint %}

***

## Konfiguracja

{% hint style="danger" %}
Aby modyfikować plik `config.json`, <mark style="color:red;">**musisz zatrzymać**</mark> usługę **Xopero ONE Backup\&Recovery Agent**. Po wprowadzeniu zmian uruchom ponownie usługę (może być także konieczne odświeżenie zmian w panelu **Management Service**).
{% endhint %}

Domyslnie, plik `config.json`, znajduje się w następujących lokalizacjach:

1. Dla **Windows**: `C:\Program Files\Xopero ONE Backup&Recovery Agent`
2. Dla **Linux**: `/opt/XoperoONEBackupAgent/`

💡Możesz edytować plik `config.json` za pomocą prostego edytora tekstu (np. **Notatnik**, **Notepad++**).

### <mark style="background-color:blue;">Adres Management Service</mark> <a href="#management_service_address" id="management_service_address"></a>

Adres **Xopero ONE** **Management Service** (**XMS**) z którym łączy się agent, jest kluczowy zarówno podczas instalacji, jak i konfiguracji. Jeśli adres IP lub protokół (http/https) **Management Service (XMS)** się zmieni, status agenta zmieni się na offline. Aby ponownie nawiązać połączenie, zaktualizuj wartość `ServiceUrl` w pliku konfiguracyjnym na zaktualizowany adres.

<figure><img src="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/LlYDT8UWwsU41CoDnAtE/notepad%20%20json%20configuration1.png" alt="notepad  json configuration1"><figcaption></figcaption></figure>

***

### <mark style="background-color:blue;">LogLevel</mark> <a href="#log_level" id="log_level"></a>

Domyślnie, wartość `LogLevel` jest ustawiona na `Information`. Możesz ją zmienić na jedną z poniższych:&#x20;

1. `Trace`
2. `Debug`
3. `Information`
4. `Warning`
5. `Error`
6. `Critical`
7. `None`

<figure><img src="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/YQeJoOxUs9VTXOK5XwWU/notepad%20%20json%20configuration2.png" alt="notepad  json configuration2"><figcaption></figcaption></figure>

***

### <mark style="background-color:blue;">Domyślna ścieżka logów</mark> <a href="#default_log_path" id="default_log_path"></a>

Domyślnie logi aplikacji są przechowywane w następującym katalogu:\
`C:\ProgramData\Xopero ONE\Xopero ONE Backup&Recovery Agent\Logs`\
Aby zmienić lokalizację, zmodyfikuj parametr `AppDataFolder`.

{% hint style="warning" %}
Zwróć uwagę, że poprawny format wartości `AppDataFolder` zawiera <mark style="color:red;">**podwójny ukośnik**</mark> po literze dysku (np. `D:\\`).
{% endhint %}

<figure><img src="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/GfugT3kLL80DkgunKBZB/notepad%20%20json%20configuration3.png" alt="notepad  json configuration3"><figcaption></figcaption></figure>

***

### <mark style="background-color:blue;">Nazwa urządzenia</mark> <a href="#device_name" id="device_name"></a>

Nazwa urządzenia domyślnie odpowiada nazwie systemu. Aby ją spersonalizować, zmodyfikuj parametr `OverriddenHostName`.

{% hint style="warning" %}
Zwróć uwagę, że niestandardowa nazwa musi być wprowadzona w cudzysłowie (np. `"TESTNAME"`).
{% endhint %}

<figure><img src="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/ipqUzeZV4tws4tnoLb3E/notepad%20%20json%20configuration4.png" alt="notepad  json configuration4"><figcaption></figcaption></figure>

***

### <mark style="background-color:blue;">Liczba ponowień prób</mark>

Jeśli zadanie tworzenia kopii zapasowej bazy danych kończy się błędem **DV0249 - "Nie można odczytać danych kopii zapasowej"**, najpierw rozwiąż wszelkie problemy ze stabilnością połączenia po swojej stronie. Jeśli problem będzie się powtarzał, możesz zwiększyć liczbę ponowień prób w aplikacji **Xopero ONE** — aby to zrobić, wystarczy edytować parametr `MaxRetriesCount`, zmieniając jego domyślną wartość z **2** na wyższą, np. **20**.

<figure><img src="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/4sf1d9o7fkQBDUWxyIEu/config%20json.png" alt="MaxRetriesCount config json"><figcaption></figcaption></figure>

***

### <mark style="background-color:blue;">Virtual appliance</mark> <a href="#virtual_appliance" id="virtual_appliance"></a>

**VMware** virtual appliance jest maszyną opartą na systemie **Linux** z uruchomioną usługą agenta. Możesz modyfikować jej ustawienia edytując plik `config.json`.

Aby skonfigurować limit czasu tworzenia migawki (snapshot), znajdź sekcję **VMware** na dole pliku i dostosuj parametr `SnapshotCreationTimeout` do swoich potrzeb.

<figure><img src="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/wv94kZyEDsHiUyll3qVL/notepad%20json%20configuration5.png" alt="notepad  json configuration5"><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://helpcenter.xopero.com/xopero-one-en/pl/wdrozenie-i-konfiguracja/xopero-one-agent/konfiguracja-agenta.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.