Přeskočit na hlavní obsah

Instalace agenta pro správu aktiv (AM Agent)

Technické požadavky​

  • Microsoft Windows
  • Microsoft .NET Framework 4.8 nebo vyšší - pro instalaci agenta

Montáž​

Tip

Before you start installing the Agent, read the Scan method setection page, which will tell you more about using the Agent.

Instalace může být provedena pouze uživatelem s oprávněním správce počítače.

  1. Na stanicích, na kterých chcete nainstalovat agenta, spusťte AlvaoAssetAgent.msi.
  2. Průvodce instalací se otevře na obrazovce. Na straně Settings, zadejte instalační parametry. Postupujte podle pokynů v průvodci.

Pokud instalace proběhla správně, na disku je složka C:\Program Files\ALVAO\Asset Management Agent složka, kde jsou uloženy spustitelné soubory agenta. Systémová služba s názvem ALVAO Asset Agent X.X musí v systému existovat.

Instalační parametry​

  • APIURL - adresa REST API.
  • AUTHCODE - ověřovací kód agenta.

Příklad nastavení parametrů v tiché instalaci - kód agenta autentizace je 1234:

msiexec /i AlvaoAssetAgent.msi /quiet APIURL="https://contoso.onalvao.com/AlvaoRestApi" AUTHCODE="1234"
Varování

Pro úspěšnou instalaci je nezbytné spustit skript s právy správce

Tip

You can also change the Agent settings additionally by running the Agent as an application (usually C:\Program Files (x86)\ALVAO\Asset Management Agent\Agent.exe) and using the Settings option.

Poznámka

Pokud máte nějaké problémy s nainstalovaným agentem, může to pomoci vyřešit soubor se záznamem, který agent vygeneruje při spuštění. Generování protokolu je ve výchozím nastavení zakázáno. Můžete ji zapnout spuštěním AMAgent.exe z adresáře aplikace. Na první stránce vyberte Nastavení a na další stránce zkontrolujte možnost Vygenerovat log soubor. Nastavte detail protokolu na detail. Protokol služby pak bude uložen v souboru agsvc.log.

Varování

Pokud nastavíte detail logového souboru na podrobné, agent vygeneruje velké množství dat do souboru protokolu a rychlost skenování bude velmi zpomalena. Nastavení na podrobné je proto doporučeno pouze pro řešení problémů a není doporučeno vůbec pro použití při běžném provozu.

Poznámka

Pokud chcete použít agenta na operačních systémech Windows 95/98/ME, musíte nainstalovat Agent verze 5.0!!! - více informací naleznete v manuálu pro verzi 5.0 (ep.chm), který naleznete v nainstalované počítačové záznamy 5.0. Také na Windows 2000 musíte používat agenta 5.10 a nižší. Pro Windows XP musíte použít Agent 10.0.

Instalace prostřednictvím GPO​

If you install Agent via GPO on a 32-bit OS, use the following ADMX 32b file and ADML 32b file to set up communication with Alvao REST API. Place the ADML file in the localization files folder (e.g., en-US folder for Windows in English).

Automatická aktualizace​

The agent checks for new version on the Alvao Server on its start, or restart, and then once a day.

Poznámka

Při diagnostikování možných problémů s automatickou aktualizací v agentovi, zapněte podrobné log. Při aktualizaci, Agent nejprve stáhne nový instalační balíček do podsložky Aktualizace složky, kde je Agent nainstalován (obvykle C:\Program Soubory (x86)\ALVAO\Asset Management Agent). Ve stejné složce po instalaci najdete protokol instalace AMAgent_MSI_upgrade.log.

Nastavuji autonomního agenta​

In the basic configuration, the agent contacts the Alvao REST API every 2 hours to determine if it should perform a computer discovery. Pokud se agentovi nepodařilo odeslat objev, pokusí se znovu po 15 minutách. Tyto hodnoty lze změnit vytvořením hodnot v registru počítače, na kterém je agent nainstalován:

Název hodnotyTypVýchozí hodnota
ScheduleUpdateIntervalMinutesREG_DWORD120
DetectionUploadRetryIntervalMinutesREG_DWORD15
  • 32 bitový OS: SOFTWARE\ALC\ALVAO správa majetku\Agent
  • 64 bitový OS: SOFTWARE\Wow6432Node\ALC\ALVAO Správa majetku\Agent

Diagnosing issues​

Text výjimky nebo chybový kód agenta pomůže při diagnostice. It can be found as follows:

  1. Spustit instalační soubor adresáře agenta AMAgent.exe .
  2. Okno se zobrazí tam, kde zvolíte možnost Nastavení. a stiskněte tlačítko Další.
  3. Na záložce Obecně Povolte možnost Zapsat log do souboru a vyberte Stav a chyby pro detail.
  4. Potvrďte změnu nastavení pomocí OK.
  5. Restartovat službu agenta. The Agent immediately tries to connect to the Alvao REST API.
  6. V instalačním adresáři agenta najděte agsvc.log a otevřete jej například v poznámkovém pále.
  7. Look for the line [CheckDetectSchedule] calling WS end with error: ... in the log. Buď následuje text výjimky nebo chybový kód.

Exception returned by Alvao REST API, e.g., authentication error, computer not in DB, etc.

Kód chyby může indikovat problém s zabezpečenou komunikací. V tomto případě by měl být uveden číselný chybový kód. Details of the error can then be found on the Microsoft learn site. Pokud je chyba ve sdělení, bude to obvykle 12xxx kód, který lze nalézt na této stránce.

Příkazová řádka​

Agent vám umožňuje spustit z příkazového řádku s zadanými parametry. V této kapitole naleznete podrobný popis všech parametrů příkazové řádky.

Parametry:

  • /dd - okamžité naskenování zařízení na počítači, kde běží agent. (funguje pouze společně s parametrem /df)
  • /dsw - okamžité skenování softwaru na počítači, kde je spuštěn agent. S tímto přepínačem se provádí kompletní skenování, včetně souborů na všech pevných discích bez výjimek. (funguje pouze společně s parametrem /df)
  • /dssw - okamžitě naskenujte software na počítači, kde běží agent. S tímto přepínačem se provádí normální skenování softwaru. (funguje pouze společně s parametrem /df)
  • /df - provádí vybrané typy skenování (parametr /dd, /dsw, /dssw) a uloží výsledné soubory do adresáře z místa, kde agent běží, nebo do složky zadané po /f.
  • /f [path] - výstupní složka, kde budou uloženy soubory skenované (parametr /df). Pokud tento parametr není specifikován, je použita cesta zadaná v nastavení agenta (Nastavení po spuštění zástupce z menu Start Windows).
  • /l [file] - agent vygeneruje protokol do souboru určeného za parametrem.
  • /v [number] - Detail logování bude nastaven na zadanou úroveň (funguje pouze s parametrem /l). Úroveň: 0 = Stav a chyby, 1 = Normální, 2 = Plné.
  • /s - agent začne tajně, tzn. na obrazovce se nezobrazí žádné informační okno.
  • /h - zobrazí se okno nápovědy pro parametry příkazové řádky.
Tip

Pokud chcete provést kompletní skenování softwaru a přeskočit některé disky nebo cesty, musíte spustit agenta bez příkazové řádky a v průvodci nastavit parametry skenování softwaru.

Příklad​

Chceme spustit agenta, aby okamžitě provedl skenování zařízení a normální skenování softwaru a uložil soubory do složky D:\Sskenování.

AMAgent /dd /dssw /df /f D:\Scan
Poznámka

Používáte-li agenta k vytvoření skenovaných souborů, názvy souborů budou automaticky vytvořeny jménem počítače a přidáním přípony _SW pro skenování softwaru a _HW pro skenování zařízení.

Například: pro počítač s názvem STANDAPC, agent vytvoří soubory STANDAPC_SW.cxm a STANDAPC_HW.cxm.