# 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>