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

Instalace​

Tip

Než začnete agenta instalovat, přečtěte si stránku Nastavení metody skenování, kde se dozvíte více o používání agenta.

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 stránce Nastavení zadejte parametry instalace. 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 - ověřovací kód agenta 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

Nastavení agenta můžete také dodatečně změnit spuštěním agenta jako aplikace (obvykle C:\Program Files (x86)\ALVAO\Asset Management Agent\Agent.exe) a použitím možnosti Nastavení.

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​

Pokud instalujete agenta prostřednictvím objektu GPO na 32bitový operační systém, použijte následující soubor ADMX 32b a soubor ADML 32b k nastavení komunikace s rozhraním Alvao REST API. Pro 64bitový operační systém použijte soubor ADMX 64b a soubor ADML 64b. Umístěte soubor ADML do složky lokalizačních souborů (např. složka en-US pro systém Windows v angličtině).

Automatická aktualizace​

Agent kontroluje novou verzi serveru Alvao při jeho spuštění nebo restartu a dále jednou denně.

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 Update ve složce, kde je Agent nainstalován (obvykle C:\Program Files (x86)\ALVAO\Asset Management Agent). Ve stejné složce po instalaci najdete protokol instalace AMAgent_MSI_upgrade.log.

Nastavuji autonomního agenta​

V základní konfiguraci kontaktuje agent rozhraní Alvao REST API každé 2 hodiny, aby zjistil, zda má provést zjišťování počítače. 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

Diagnostika problémů​

Text výjimky nebo chybový kód agenta pomůže při diagnostice. Najdete ji takto:

  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 kartě Obecné povolte možnost Zapisovat protokol do souboru a pro detail vyberte možnost Stav a chyby.
  4. Potvrďte změnu nastavení pomocí OK.
  5. Restartovat službu agenta. Agent se okamžitě pokusí připojit k rozhraní 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. V protokolu hledejte řádek [CheckDetectSchedule] volání WS skončilo chybou: .... Buď následuje text výjimky nebo chybový kód.

Výjimka vrácená rozhraním Alvao REST API, např. chyba autentizace, počítač není v DB atd.

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. Podrobnosti o chybě pak naleznete na stránce 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.