# Instalacja i wdrożenie usługi eAgent

Usługa agenta to kluczowy komponent systemu, który monitoruje urządzenia, zbiera dane o ich stanie i umożliwia zdalne zarządzanie nimi. W tym artykule znajdziesz szczegółową instrukcję dotyczącą pobierania, instalacji oraz konfiguracji usługi agenta na komputerach z systemami Windows. Dowiesz się również, jak prawidłowo usunąć agenta, jeśli zajdzie taka potrzeba. Ten przewodnik jest szczególnie pomocny dla nowych użytkowników, którzy po raz pierwszy instalują agenta na swoich urządzeniach.

***

## **Pobieranie usługi**

<div align="center" data-full-width="false"><img src="https://1156024472-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdzip3GyvGq5q5J3qckWN%2Fuploads%2FVP85buogRc2pUoTOeDfU%2F0.png?alt=media" alt="" width="375"></div>

1. Zaloguj się do systemu i przejdź do zakładki **Komputery**.
2. Wybierz **+ Dodaj komputer**.
3. Wybierz instalacja.
4. Kliknij odpowiedni przycisk **Pobierz agenta**:

   * **Windows**: Plik \*.exe.

   <figure><img src="https://1156024472-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdzip3GyvGq5q5J3qckWN%2Fuploads%2Fz6mmzesDVW45RMeM77Em%2Fimage.png?alt=media&#x26;token=2bf47e0e-1f28-4251-abe4-721a8c6b0304" alt="" width="375"><figcaption></figcaption></figure>

***

## **Instalacja agenta w systemie Windows**

### Instalacja z pliku .exe

* Pobierz instalator **.exe** z zakładki **+ Dodaj komputer**.&#x20;

{% hint style="info" %}
Poświadczenia **nie są wymagane do instalacji - są opcjonalne** i potrzebne tylko w indywidualnych przypadkach. Standardowo pobieramy instalator bez poświadczeń.

Można podać poświadczenia użytkownika, jeśli agent ma być uruchamiany z określonymi uprawnieniami, na przykład, gdy instalator ma być przekazany osobie bez uprawnień administratora i ma ona wykonać instalację samodzielnie. W takiej sytuacji generowany jest instalator z zaszyfrowanymi poświadczeniami, które są wykorzystywane wyłącznie na potrzeby instalacji. Eliminuje to konieczność ręcznego podniesienia uprawnień albo osobistego instalowania agenta takiemu użytkownikowi.

![](https://1156024472-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdzip3GyvGq5q5J3qckWN%2Fuploads%2F93kYFI89QrZyRB1wgBDx%2Fimage.png?alt=media\&token=5f4a428c-e930-42db-8800-9b17e90b650b)
{% endhint %}

* Uruchom instalator.
* Po zakończeniu instalacji usługa automatycznie nawiązuje komunikację z serwerem i rozpocznie zbieranie danych.&#x20;

{% hint style="info" %}
Połączenie realizowane jest wykorzystując do tego dozwolony, standardowy port wyjściowy. Przy domyślnej konfiguracji zapory systemu Windows nie są wymagane żadne dodatkowe działania ani reguły firewall.\
Jeżeli jednak w środowisku wprowadzono niestandardowe ograniczenia lub własne reguły zapory, warto zweryfikować, czy ruch wychodzący agenta nie jest blokowany. W przypadku problemów z komunikacją to właśnie tam najczęściej leży przyczyna.
{% endhint %}

{% hint style="danger" %}
Problem z instalacją może wynikać z niepoprawnych poświadczeń. Instalator wymaga danych **użytkownika z uprawnieniami administratora do komputera**, na którym instalowany jest agent. Warto sprawdzić, czy wszystko zostało wpisane we właściwym formacie:

* Jeśli to konto domenowe, **trzeba podać domenę**.
* Jeśli to konto lokalne, format powinien wyglądać tak: **.\nazwa\_użytkownika** lub **nazwa\_komputera\nazwa\_użytkownika**.
  {% endhint %}

***

## **Potwierdzenie wdrożenia agenta**

Po zakończeniu instalacji:

* Dane urządzeń będą przesyłane do systemu i widoczne w panelu głównym.
* Administratorzy mogą monitorować urządzenia, konfigurować alerty i przypisywać urządzenia do użytkowników.

<figure><img src="https://1156024472-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdzip3GyvGq5q5J3qckWN%2Fuploads%2F7sfCTs8fY7QpNouVncgE%2Fimage.png?alt=media&#x26;token=628d52cc-74c9-4221-ac25-1f42fddbee4c" alt="" width="375"><figcaption></figcaption></figure>

***

## **Odinstalowywanie usługi agenta**

### Windows

1. W zakładce **+ Dodaj komputer** wybierz **Odinstaluj**.
2. System wygeneruje skrypt, który należy uruchomić na komputerze.
3. Postepuj zgodnie z instrukcją.
4. Po uruchomieniu skryptu agent zostanie odinstalowany z systemu, a jego dane przestaną być przesyłane do systemu.

<figure><img src="https://1156024472-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdzip3GyvGq5q5J3qckWN%2Fuploads%2FOuhXZNDAMh3K7IJKYaSx%2Fimage.png?alt=media&#x26;token=239233a2-a8c2-41b9-95d2-41505bf7df53" alt="" width="375"><figcaption></figcaption></figure>

#### **Odinstalowywanie eAgenta**

{% tabs %}
{% tab title="Skrypt" %}
Aby odinstalować eAgenta należy:

1. Uruchomić CMD jako administrator
2. Wywołać polecenie:

```
msiexec.exe /x {8725779B-83EE-4B60-B5E1-247A05A17777}
```

{% endtab %}

{% tab title="Plik .bat" %}
Jeśli inne metody nie zadziałają należy utworzyć plik .bat z zawartością:

```
taskkill /f /im eAgentInternal.exe
taskkill /f /im eAgentPm.exe
net stop agent2
msiexec.exe /q /x {8725779B-83EE-4B60-B5E1-247A05A17775}
msiexec.exe /q /x {8725779B-83EE-4B60-B5E1-247A05A17776}
msiexec.exe /q /x {8725779B-83EE-4B60-B5E1-247A05A17777}
sc delete agent2
RD /S /Q "C:\Program Files (x86)\Btc"
```

Plik należy wykonać jako administrator.
{% endtab %}
{% endtabs %}

***

{% hint style="info" %}
W przypadku problemów z instalacją agenta lub jego działaniem, eAuditor zapewnia:

* [**Filmy instruktażowe**](https://eaclouddoc.eauditor.eu/system/samouczki-wideo)
* [**Wsparcie techniczne**](https://eaclouddoc.eauditor.eu/rozpoczecie-pracy/gdzie-szukac-pomocy-technicznej)
  {% endhint %}

***
