# Instalacja w systemie Linux i MacOS

{% tabs %}
{% tab title="Linux" %}

<p align="center"><a href="#prerequisites" class="button primary" data-icon="circle-1">Wymagania wstępne</a>    <a href="#agent_setup" class="button primary" data-icon="circle-2">Instalacja</a></p>

## Wymagania wstępne

Przed instalacją agenta sprawdź, czy system spełnia wszystkie wymagania. Informacje na ten temat znajdziesz w poniższych artykułach

{% content-ref url="../../oprogramowanie-xopero-one/informacje-o-oprogramowaniu/wymagania-systemowe" %}
[wymagania-systemowe](https://helpcenter.xopero.com/xopero-one-en/pl/oprogramowanie-xopero-one/informacje-o-oprogramowaniu/wymagania-systemowe)
{% endcontent-ref %}

{% content-ref url="../../oprogramowanie-xopero-one/informacje-o-oprogramowaniu/obslugiwane-platformy" %}
[obslugiwane-platformy](https://helpcenter.xopero.com/xopero-one-en/pl/oprogramowanie-xopero-one/informacje-o-oprogramowaniu/obslugiwane-platformy)
{% endcontent-ref %}

***

## Instalacja <a href="#agent_setup" id="agent_setup"></a>

1. Pobierz instalator **agenta** (**skrypt bash**) na swój system **Linux** i nadaj uprawnienia do wykonywania właścicielowi pliku (użytkownikowi lub grupie) za pomocą polecenia `chmod`:

{% hint style="info" %}
Aby pobrać instalator, zaloguj się do **Xopero ONE Management Service** przez przeglądarkę, przejdź do **Ustawienia > Zaawansowane >** **Workers** i kliknij przycisk **Pobierz agenta**. Otworzy się okno pobierania — wybierz odpowiednią wersję agenta aby ją pobrać.
{% endhint %}

```bash
chmod +x xoperoclient.sh
```

<figure><img src="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/RFQfPQ9ZsGUuAkqM7gQ0/Granting%20permission%20for%20installer.png" alt="Granting permission for installer"><figcaption></figcaption></figure>

2. Następnie uruchom skrypt za pomocą polecenia:

```bash
./xoperoclient.sh or bash xoperoclient.sh
```

<figure><img src="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/ZrmDDUGJUVMT7qli9QxI/Running%20the%20installer.png" alt="Running the installer"><figcaption><p><em>Uruchamianie skryptu wraz z komendą <strong><code>sudo</code></strong></em></p></figcaption></figure>

{% hint style="warning" %}
Powyższy skrypt powinien być uruchomiony z **konta z uprawnieniami administracyjnymi** — z tego powodu może być konieczne użycie polecenia `sudo` (jak w powyższym przykładzie).
{% endhint %}

3. Zaakceptuj **Umowę Licencyjną Użytkownika Końcowego** (EULA), aby kontynuować.

<figure><img src="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/v4zkoQ08AyeZ1qOlSolJ/End-user%20agreement.png" alt="End-user agreement"><figcaption></figcaption></figure>

4. Wprowadź **adres IP** w polu **Address** (wraz z protokołem i portem) i kliknij OK, aby zakończyć instalację. Adres ten znajdziesz w **Xopero ONE Management Service** — system wyświetli go w momencie **rozpoczęcia pobierania** instalatora.

<figure><img src="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/EBKZ7wA4AXWJczVEDXbB/Xopero%20ONE%20service%20URL%20example.png" alt="Xopero ONE service URL example"><figcaption></figcaption></figure>

5. Teraz, gdy **agent Xopero ONE** jest zainstalowany, możesz go aktywować w panelu webowym **XMS** i rozpocząć ochronę danych.
   {% endtab %}

{% tab title="MacOS" %}

<p align="center"><a href="#installation-mac" class="button primary" data-icon="circle-1">Instalacja</a>    <a href="#unattended-installation" class="button primary" data-icon="circle-2">Instalacja nienadzorowana</a>    <a href="#permissions-configuration" class="button primary" data-icon="circle-3">Konfiguracja uprawnień</a></p>

## Instalacja <a href="#installation-mac" id="installation-mac"></a>

1. Pobierz kreator instalacji **agenta Xopero ONE** za pośrednictwem XMS[^1] i uruchom go.

{% hint style="info" %}
Aby pobrać instalator, zaloguj się do **Xopero ONE Management Service** przez przeglądarkę, przejdź do **Ustawienia > Zaawansowane >** **Workers** i kliknij przycisk **Pobierz agenta**. Otworzy się okno pobierania — wybierz odpowiednią wersję agenta aby ją pobrać.
{% endhint %}

2. Kliknij **Continue** aby rozpocząć.

<figure><img src="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/6ZeIheZCVkFAx5R0m0Yc/agentmac1.png" alt=""><figcaption></figcaption></figure>

3. Wybierz **Continue** w sekcji **Read Me**.

<figure><img src="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/Sr7zMCOSESE0LssfRugo/agentmac2.png" alt=""><figcaption></figcaption></figure>

4. Przeczytaj **Umowę Licencyjną** (**EULA**) i kliknij **Continue**, aby ją zaakceptować.

<figure><img src="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/F9K4GGq5HpvaBcJUhaay/agentmac3.png" alt=""><figcaption></figcaption></figure>

5. Kliknij **Agree** aby zaakceptować warunki licencji oprogramowania.

<figure><img src="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/FkbQpZPyEzkwV2WVmd57/agentmac4.png" alt=""><figcaption></figcaption></figure>

6. W razie potrzeby zmień katalog instalacyjny i kliknij **Install** aby rozpocząć instalację.

<figure><img src="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/5T3qqsAcXPbbiunSjK85/agentmac5.png" alt=""><figcaption></figcaption></figure>

7. Podczas procesu instalacji kreator poprosi o adres **XMS** — podaj go w tym kroku.

<figure><img src="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/0CzOAzDvH1VXfrcKMtJU/agentmac6.png" alt=""><figcaption></figcaption></figure>

8. Kliknij **OK**, aby potwierdzić konfigurację.
9. **Agent Xopero ONE** został pomyślnie zainstalowany — możesz zamknąć kreator instalacji.

<figure><img src="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/dZ1TXd0sRMsdEfCzziae/agentmac7.png" alt=""><figcaption></figcaption></figure>

***

## Instalacja nienadzorowana

Jeśli nie chcesz korzystać z kreatora instalacji, możesz wybrać opcję instalacji nienadzorowanej.

1. Pobierz plik `xoperoclient.pkg` na swoje urządzenie.

{% hint style="info" %}
Aby pobrać instalator, zaloguj się do **Xopero ONE Management Service** przez przeglądarkę, przejdź do **Ustawienia > Zaawansowane >** **Workers** i kliknij przycisk **Pobierz agenta**. Otworzy się okno pobierania — wybierz odpowiednią wersję agenta aby ją pobrać.
{% endhint %}

2. Uruchom następujące polecenie w terminalu macOS (**Aplikacje** > **Narzędzia** > **Terminal**):

{% code overflow="wrap" %}

```bash
sudo /bin/launchctl setenv "XOPERO_INSTALLER_SERVER_ADDRESS_CONFIG" "https://XMS_adress::28555>" && sudo installer -pkg <pkg_file_location> -target /; sudo /bin/launchctl unsetenv "XOPERO_INSTALLER_SERVER_ADDRESS_CONFIG"
```

{% endcode %}

> **‼️Przegląd polecenia:**
>
> {% code title="Ustawienie zmiennej środowiskowej z adresem IP oraz domyślnym portem XMS:" overflow="wrap" %}
>
> ```bash
> sudo /bin/launchctl setenv "XOPERO_INSTALLER_SERVER_ADDRESS_CONFIG" "https://<XMS_adress::28555>"
> ```
>
> {% endcode %}
>
> {% code title="Uruchomienie instalatora" overflow="wrap" %}
>
> ```bash
> sudo installer -pkg <pkg_file_location> -target /;
> ```
>
> {% endcode %}
>
> {% code title="Usunięcie zmiennej środowiskowej" overflow="wrap" %}
>
> ```bash
> sudo /bin/launchctl unsetenv "XOPERO_INSTALLER_SERVER_ADDRESS_CONFIG"
> ```
>
> {% endcode %}

***

## Konfiguracja uprawnień

Po instalacji należy w kilku krokach dodać niezbędne uprawnienia dla plików **Xopero**.

1. Kliknij ikonę **Mac** w lewym górnym rogu i wybierz **System preferences** z menu rozwijanego

<figure><img src="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/hqrInokOpsO2kloJA6Lj/image.png" alt=""><figcaption></figcaption></figure>

2. Przejdź do sekcji **Security & Privacy**.

<figure><img src="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/DaRIxwucJbqmtUmtmW8U/image.png" alt="" width="517"><figcaption></figcaption></figure>

3. Przejdź do karty **Privacy**, następnie wybierz **Full Disk Access** z menu po lewej stronie.

<figure><img src="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/bEAADv4SeTrFwzvJ54tv/image.png" alt="" width="515"><figcaption></figcaption></figure>

4. Dodaj **`Xopero.Device.App.app`** do listy.

<figure><img src="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/u47scOIXW57IMZybCcPh/image.png" alt=""><figcaption></figcaption></figure>

5. Nadaj uprawnienia aplikacji **`Xopero.Device.App.app`** aby ukończyć konfigurację.

<figure><img src="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/amsFP1mB3Zs1HVnk9VlY/image.png" alt="" width="563"><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

[^1]: Xopero ONE Management Service