## Pobieranie instalatora
1. Zaloguj się do **Xopero ONE Management Service** (**XMS**) przez przeglądarkę, przejdź do **Ustawienia** > **Zaawansowane** > **Workers** i kliknij przycisk **Pobierz agenta**.
2. Otworzy się okno pobierania — przewiń do sekcji **Serwer** i kliknij przycisk **Windows Server >**.
3. Wybierz **WS 2012** lub **WS 2008 R2** aby pobrać dedykowany instalator.
4. Pobieranie rozpocznie się automatycznie; dodatkowo w **XMS** pojawi się sekcja Instalacja z instrukcją krok po kroku.
5. W sekcji instalacji zobaczysz **adres wraz z portem** — zapisz go, ponieważ będzie on potrzebny podczas instalacji agenta.
6. Po zakończeniu pobierania, możesz przejść do procesu instalacji.
***
## Proces instalacji
1. Uruchom pobrany instalator. Kliknij **Next** aby rozpocząć proces instalacji.
2. Przeczytaj i zaakceptuj [**Umowę Licencyjną Użytkownika Końcowego**](#user-content-fn-1)[^1], następnie przejdź do kolejnego kroku.
3. Wybierz katalog instalacyjny dla klienta **Xopero ONE**.
4. Wklej wcześniej skopiowany adres w polu **Address** i kliknij **Next** aby kontynuować.
5. Kliknij **Install** aby rozpocząć instalację.
6. Po zakończeniu pracy kreatora kliknij przycisk **Finish**.
7. Możesz teraz aktywować swoje urządzenie w panelu **Xopero ONE Management Service**.
{% endtab %}
{% tab title="WS & WS 2012 R2+" %}
## Pobieranie instalatora
1. Zaloguj się do **Xopero ONE Management Service** (**XMS**) przez przeglądarkę, przejdź do **Ustawienia > Zaawansowane > Workers** i kliknij przycisk **Pobierz agenta**.
2. Otworzy się okno pobierania — przewiń do sekcji Serwer i kliknij przycisk **Windows Server>**.
3. Wybierz **WS 2012 R2 lub nowszy** aby pobrać dedykowany instalator.
4. Pobieranie rozpocznie się automatycznie; dodatkowo w **XMS** pojawi się sekcja Instalacja z instrukcją krok po kroku.
5. W sekcji instalacji zobaczysz **adres wraz z portem** — zapisz go, ponieważ będzie on potrzebny podczas instalacji agenta.
***
## Proces instalacji
1. Uruchom pobrany instalator. Kliknij **Next** aby rozpocząć proces instalacji.
2. Przeczytaj i zaakceptuj [**Umowę Licencyjną Użytkownika Końcowego**](#user-content-fn-1)[^1], następnie przejdź do kolejnego kroku.
3. Wybierz katalog instalacyjny dla klienta **Xopero ONE**.
4. Wklej wcześniej skopiowany adres w polu **Address** i kliknij **Next** aby kontynuować.
5. Kliknij **Install** aby rozpocząć instalację.
6. Po zakończeniu pracy kreatora kliknij przycisk **Finish**.
7. Możesz teraz aktywować swoje urządzenie w panelu **Xopero ONE Management Service**.
{% endtab %}
{% tab title="MSI (masowe wdrożenie)" %}
## Proces instalacji
1. Otwórz **Active Directory** i utwórz nową **Jednostkę Organizacyjną** (**OU**) na kontrolerze domeny w katalogu **Użytkownicy i komputery** usługi **Active Directory**.
2. Nadaj jednostce nazwę i potwierdź przyciskiem OK.
3. Przenieś wszystkie urządzenia, na których ma zostać zainstalowany **agent**, do nowo utworzonej **jednostki** (**OU**).
4. Utwórz folder sieciowy **dostępny dla wszystkich komputerów objętych instalacją** **agenta Xopero ONE** i umieść w nim instalator .msi.
{% hint style="info" %}
Instalator .msi pobierzesz w panelu **XMS**: **Ustawienia > Zaawansowane > Workers** > **Pobierz agenta** > **Urządzenia**.
{% endhint %}
5. Zmień uprawnienia dostępu do folderu: kliknij go prawym przyciskiem myszy > **Właściwości >** **Udostępnianie > Udostępnianie zaawansowane**.
6. Upewnij się, że pole ✅**Udostępnij ten folder** jest zaznaczone, a następnie kliknij **Zastosuj** aby zapisać zmiany.
7. Następnie kliknij przycisk **Uprawnienia** pod polem **Komentarze** i zmień uprawnienia użytkowników w następujący sposób:
> Dla administratorów domeny: **Pełna kontrola**\
> Dla uwierzytelnionych użytkowników: **Odczyt**
8. Otwórz **Zarządzanie zasadami grupy** (**GPO**), kliknij prawym przyciskiem myszy na swoje **OU** i wybierz opcję **Utwórz obiekt GPO w tej domenie i umieść tutaj łącze...** z menu kontekstowego.
9. Nadaj nazwę nowemu obiektowi i kliknij **OK**.
10. Kliknij prawym przyciskiem myszy na nową regułę i wybierz **Edytuj**.
11. Rozwiń **Konfiguracja komputera > Reguły > Ustawienia oprogramowania > Instalacja oprogramowania.** W sekcji **Instalacja oprogramowania**, kliknij prawym przyciskiem myszy w prawym oknie i wybierz **Nowy > Pakiet**.
12. Znajdź udostępniony folder w którym umieściłeś instalator **.msi,** następnie go zaznacz i otwórz.
13. W oknie **wdrażania oprogramowania** wybierz metodę **Zaawansowane** i kliknij **OK**.
14. W oknie właściwości agenta przejdź do karty **Modyfikacje**.
15. Utwórz plik **.mst** z dodatkową konfiguracją instalatora — możesz użyć programu **Orca** dostępnego jako część pakietu **Windows SDK**:
{% hint style="success" %}
Dowiedz się jak zainstalować **Orca** na [stronie edukacyjnej Microsoft Learn](https://learn.microsoft.com/pl-pl/windows/win32/msi/orca-exe).
{% endhint %}
1️⃣ W programie **Orca**, przejdź do **File** > **Open**, następnie znajdź i wybierz instalator **Xopero ONE** **agent** **.msi**.
2️⃣ Kliknij **Transform** i wybierz **New Transform** z menu kontekstowego. W tabeli **Property** znajdź wiersz **MANAGEMENT\_URL** i zmień jego wartość na **adres IP** [**XMS**](#user-content-fn-2)[^2] (format: **XMSIPaddress:port**, np. `https://123.4.5.6:28555`).
3️⃣ Opcjonalnie możesz edytować parametr:
> **APPDIR** — ścieżka instalacji **agenta Xopero ONE**
4️⃣ Kliknij **Transform** > **Generate transform** i zapisz plik **.mst** w uprzednio utworzonym udostępnionym folderze zawierającym instalator.
16. Wróć do okna **Właściwości Xopero ONE Backup\&Recovery Agent**, kliknij **Dodaj** i wskaż ścieżkę do pliku **.mst** zawierający adres **XMS** (parametr dla instalatora **MSI**). Potwierdź zmiany i kliknij **OK** aby zamknąć okno.
17. Gdy **GPO** odpowiedzialne za dystrybucję i wdrożenie instalatora **MSI** zostały poprawnie skonfigurowane, możesz wymusić aktualizację zasad na komputerach użytkowników, których dotyczy ta polityka w **Active Directory**— wystarczy uruchomić **CMD** i użyć następującej komendy:
```
gpupdate /force
```
18. Po ponownym uruchomieniu stacji roboczej, agent **Xopero ONE** zostanie automatycznie zainstalowany z parametrem wskazującym na adres **XMS**.
{% endtab %}
{% endtabs %}
[^1]: **End-User License Agreement**
[^2]: Xopero ONE Management Service
