Changes for page Offline Scanner

Last modified by jklein on 2025/10/28 10:30
From version 1.1
edited by Steffi F
on 2025/05/12 07:03
Change comment: There is no comment for this version
To version 3.1
edited by jklein
on 2025/10/28 10:29
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.SF
1 +XWiki.jklein
Content
... ... @@ -1,91 +1,136 @@
1 1  {{aagon.floatingbox/}}
2 2  
3 -The Offline Scanner allows you to inventory PCs that are not connected to the network. After installing the ACMP Console, the executable file for the Offline Scanner is located in the directory //%PROGRAMFILES(x86)%\Aagon\ACMP Console\Bin\ACMPOfflineScanner//.
3 +The offline scanners can be used to inventory Windows and Unix clients that are not connected to the network. In general a system-specific scanner will be executed on the client that should be inventoried.
4 +The found data is stored in a results file. This file can be added to the ACMP Console using the import function, and the client's inventory data is then available.
4 4  
5 -When the ACMP Console is open, you can open this directory by clicking //Offline Clients// on the ribbon bar and then clicking //Copy Offline Scanner//.
6 += Run Windows offline scanner =
6 6  
7 -{{figure}}
8 -[[image:65_First Steps im ACMP_Offline Scanner_1696.png||alt="Offline Scanner kopieren.png" data-xwiki-image-style-alignment="center"]]
8 +The execution file for the offline scanner for Windows clients is located in the directory //%PROGRAMFILES(x86)%\Aagon\ACMP Console\Bin\ACMPOfflineScanner//. With the ACMP Console open, you can open this directory by clicking the //Offline Scanner Copy// button in the ribbon bar.
9 9  
10 -{{figureCaption}}
11 -Copy Offline Scanner
12 -{{/figureCaption}}
13 -{{/figure}}
10 +[[Copy Offline Scanner>>image:65_First Steps im ACMP_Offline Scanner_1696.png||alt="“Copy" data-xwiki-image-style-alignment="“center”"]]
14 14  
15 -Now copy all files listed in this directory to a USB stick, for example.
16 -When you start ACMPOfflineScanner.exe, the configuration of the offline scanner is displayed first. You can specify which scanners are to be executed, where the scan data is to be stored, and whether this directory is to be displayed after the scan. If you do not customize the target directory for the scan data, a directory will be created next to the exe file and the scan data will be stored there. When you start the ACMP Offline Scanner, all scanners are activated. The configuration data is stored in the OfflineScannerSettings.xml file.
12 +To run the Offline Scanner, the entire file directory must be available on the Windows client which you want to be inventoried. To do this, proceed as follows:
17 17  
18 -{{figure}}
19 -[[image:64_First Steps im ACMP_Offline Scanner_439.png||alt="Offline Scanner konfigurieren.png" data-xwiki-image-style-alignment="center"]]
14 +1. Make the file directory available on the client (e.g., via USB stick or share in another network that is accessible to the client).
15 +1. Run the //ACMPOfflineScanner.exe// file.
16 +1. Configure the execution of the offline scanner. You can specify which scanners should be run and where the scan data should be stored. You can also specify whether this directory should be displayed after the scan. If you do not customize the target directory for the scan data, a directory will be created next to the .exe-file and the scan data will be stored there. The configuration data is stored in the file //OfflineScannerSettings.xml//. [[image:64_First Steps im ACMP_Offline Scanner_439.png||alt="“Configure" data-xwiki-image-style-alignment="center" height="300" width="288"]]
17 +1. Click Scan to start the scan. You can see the scan progress in the progress bar.
20 20  
21 -{{figureCaption}}
22 -Configure Offline Scanner
23 -{{/figureCaption}}
24 -{{/figure}}
25 -
26 -Once you have finished the configuration, start the ACMP Offline Scanner by clicking Scan. The progress bar shows you where the offline scanner is currently located. Once the scan is complete, you will receive a message.
27 -
28 28  {{aagon.infobox}}
29 -Please note that all data stored by the File Scanners will be deleted if you delete or deactivate a Client that is already being managed.
20 +Please note that all data stored by the file scanners will be deleted if you delete or deactivate a client that is already being managed.
30 30  {{/aagon.infobox}}
31 31  
32 -An *.aos file is now located in the previously selected directory. The name of this file corresponds to the computer name on which the ACMP Offline Scanner was executed.
23 +There is now an *.aos file in the previously selected directory. The name of this file corresponds to the computer name on which the Offline Scanner was executed. You must now make this data available again on a client that has an ACMP Console. In the next step, you can import this file with the scan data into the ACMP Console.
33 33  
34 -To import the offline scan data into the ACMP Console, select //Copy Offline Scanner// in the ribbon bar.
25 +== Configuration of the included scanners ==
35 35  
36 -{{figure}}
37 -[[image:65a_First Steps im ACMP_Offline Scanner_1696.png||alt="Offline Scanner importieren.png" data-xwiki-image-style-alignment="center"]]
27 +The scanners available in the Windows Offline Scanner and descriptions of their configurations are listed below:
38 38  
39 -{{figureCaption}}
40 -Import Offline Scanner
41 -{{/figureCaption}}
42 -{{/figure}}
29 +|(% style="width:186px" %)**Scanner**|(% style="width:1177px" %)**Description**
30 +|(% style="width:186px" %)System Scanner|(% style="width:1177px" %)The System Scanner cannot be deactivated. It scans the client's hardware and also reads the computer name.
31 +|(% style="width:186px" %)Software Scanner
32 +(optional)|(% style="width:1177px" %)The Software Scanner scans the installed software. It distinguishes between the following types of already installed software:(((
33 +* Software installed with a client command
34 +* Software installed via MSI
35 +* Software installed via setup
36 +* Packages installed via Windows Store
43 43  
38 +All installations are displayed in the client details.
39 +)))
40 +|(% style="width:186px" %)Security Scanner
41 +(optional)|(% style="width:1177px" %) The Security Scanner scans the system for antivirus software and displays it in the Client Details.
42 +|(% style="width:186px" %)Windows Update Scanner
43 +(optional)|(% style="width:1177px" %)The Windows Update Scanner scans the status of the Windows installation.
44 +It displays Windows updates that are already installed and Windows updates that are still available in the Client Details.
45 +|(% style="width:186px" %)File Scanner
46 +(optional)|(% style="width:1177px" %)The File Scanner scans the system for executable files.
47 +It thus supplements the data collected by the Software Scanner on installed software and lays the foundation for license management.
48 +|(% style="width:186px" %)Hyper-V Scanner
49 +(optional)|(% style="width:1177px" %)The Hyper-V Scanner scans the system for existing instances of Hyper-V.
50 +If a corresponding connection is detected, it is displayed in the Client Details.{{aagon.infobox}}Please note that the Hyper-V Scanner is only available from Windows Server 2012 onwards.{{/aagon.infobox}}
51 +|(% style="width:186px" %)Select Destination|(% style="width:1177px" %)Here you can select the location where the scan data should be saved. If you do not make any adjustments, the data will be saved in a new directory next to the exe. The file name corresponds to the computer name.
52 +|(% style="width:186px" %)Show destination in explorer after scan|(% style="width:1177px" %)Specify whether you want the storage location of the scan data to be displayed in Windows Explorer after the scan is complete.
44 44  
45 -Navigate to the storage location of the *.aos file and open it. You can view the inventory data of the Client via Queries.
54 +== Windows Offline Scanner - Parameters ==
46 46  
47 -= Aufruf des Offline Scanners über die Kommandozeile =
56 +The Windows Offline Scanner can also be used via the command line. The following parameters are available:
48 48  
49 -Es ist möglich, den ACMP Offline Scanner über die Kommandozeile aufzurufen. Hierfür stehen die folgenden Parameter zur Verfügung:
58 +|(% style="width:220px" %)**Parameter**|(% style="width:1143px" %)**Description**
59 +|(% style="width:220px" %)/s or /silent|(% style="width:1143px" %)The ACMP Offline Scanner is executed in silent mode.
60 +|(% style="width:220px" %)/help or /?|(% style="width:1143px" %)Call up help
61 +|(% style="width:220px" %)/ScanDataFolder|(% style="width:1143px" %)Specify the path for saving the scan data.
62 +|(% style="width:220px" %) |(% style="width:1143px" %)Example: /ScanDataFolder=“Path”
63 +|(% style="width:220px" %) |(% style="width:1143px" %)If this parameter is not set, the directory //ScanData// is created next to the exe file, in which the scan data is stored. This parameter requires /s. Example: /ScanDataFolder=“Path”
64 +|(% style="width:220px" %)/SkipSoftware|(% style="width:1143px" %)If this parameter is specified, the software scanner will not be executed. This parameter requires /s.
65 +|(% style="width:220px" %)/SkipUpdate|(% style="width:1143px" %)If this parameter is specified, the Windows Update scanner will not be executed. This parameter requires /s.
66 +|(% style="width:220px" %)/SkipSecurity|(% style="width:1143px" %)With this specification, the Security Scanner is not executed. This parameter requires /s.
67 +|(% style="width:220px" %)/SkipFiles|(% style="width:1143px" %) With this specification, the file scanner is not executed. This parameter requires /s.
68 +|(% style="width:220px" %)/SkipVirtualization|(% style="width:1143px" %)With this specification, the Hyper-V scanner is not executed. This parameter requires /s.
69 +|(% style="width:220px" %) |(% style="width:1143px" %){{aagon.infobox}}Please note that the Hyper-V scanner is only available from Windows Server 2012 onwards.{{/aagon.infobox}}
50 50  
51 -|(% style="width:220px" %)**Parameter**|(% style="width:1143px" %)**Beschreibung**
52 -|(% style="width:220px" %)/s oder /silent|(% style="width:1143px" %)Der ACMP Offline Scanner wird im Silent-Mode ausgeführt.
53 -|(% style="width:220px" %)/help oder /?|(% style="width:1143px" %)Aufruf der Hilfe
54 -|(% style="width:220px" %)/ScanDataFolder|(% style="width:1143px" %)Angabe des Pfades zum Speichern der Scan Daten.
55 -|(% style="width:220px" %) |(% style="width:1143px" %)Beispiel: /ScanDataFolder="Pfad"
56 -|(% style="width:220px" %) |(% style="width:1143px" %)Wird dieser Parameter nicht gesetzt, wird neben der exe-Datei das Verzeichnis //ScanData// angelegt, in dem die Scan Daten abgelegt werden. Dieser Parameter setzt /s voraus. Beispiel: /ScanDataFolder="Pfad"
57 -|(% style="width:220px" %)/SkipSoftware|(% style="width:1143px" %)Bei dieser Angabe wird der Software Scanner nicht ausgeführt. Dieser Parameter setzt /s voraus.
58 -|(% style="width:220px" %)/SkipUpdate|(% style="width:1143px" %)Bei dieser Angabe wird der Windows Update Scanner nicht ausgeführt. Dieser Parameter setzt /s voraus.
59 -|(% style="width:220px" %)/SkipSecurity|(% style="width:1143px" %)Bei dieser Angabe wird der Security Scanner nicht ausgeführt. Dieser Parameter setzt /s voraus.
60 -|(% style="width:220px" %)/SkipFiles|(% style="width:1143px" %)Bei dieser Angabe wird der File Scanner nicht ausgeführt. Dieser Parameter setzt /s voraus.
61 -|(% style="width:220px" %)/SkipVirtualization|(% style="width:1143px" %)Bei dieser Angabe wird der Hyper-V Scanner nicht ausgeführt. Dieser Parameter setzt /s voraus.
62 -|(% style="width:220px" %) |(% style="width:1143px" %){{aagon.infobox}}Beachten Sie, dass Ihnen der Hyper-V Scanner erst ab Windows Server 2012 zur Verfügung steht.{{/aagon.infobox}}
71 += Run Unix Offline Scanner =
63 63  
64 -= Konfiguration Offline Scanner =
73 +The execution files for the offline scanner for Unix clients are located in the directory //%PROGRAMFILES(x86)%\Aagon\ACMP Server\Clients\Unix Offline Scanner 1.11.2//. There are several subdirectories for specific Linux and MacOS operating systems.
65 65  
66 -Nachfolgend sind die verschiedenen Scanner sowie die Beschreibungen zu den Konfigurationen gelistet:
75 +To run the Unix Offline Scanner, the appropriate file directory must be available on the Unix client to be inventoried. To do this, proceed as follows:
67 67  
68 -|(% style="width:186px" %)**Scanner**|(% style="width:1177px" %)**Beschreibung**
69 -|(% style="width:186px" %)System Scanner|(% style="width:1177px" %)Der System Scanner kann nicht deaktiviert werden. Er scannt die Hardware des Clients, ebenso wird der Computername ausgelesen.
70 -|(% style="width:186px" %)Software Scanner
71 -(optional)|(% style="width:1177px" %)Der Software Scanner scannt die installierte Software. Hierbei wird zwischen den folgenden Typen bereits installierter Software unterschieden:(((
72 -* Software, die mit einem Client Command installiert wurde
73 -* per MSI installierte Software
74 -* per Setup installierte Software
75 -* per Windows Store installierte Pakete
77 +1. Make the required file directory available on the client (e.g., via USB stick or share in another network accessible to the client).
78 +1. If necessary, adjust the configuration file //appsettings.json//.
79 +1. Make the file executable using the following Bash command {{code language="bash"}}chmod +x ./Aagon.UnixOfflineScanner{{/code}}.
80 +1. Run the Unix Offline Scanner using the following Bash command: {{code language="bash"}}sudo ./Aagon.UnixOfflineScanner{{/code}}.
76 76  
77 -Alle Installationen werden Ihnen in den Client Details angezeigt.
78 -)))
79 -|(% style="width:186px" %)Security Scanner
80 -(optional)|(% style="width:1177px" %)Der Security Scanner scannt auf dem System nach Antiviren Software und zeigt diese in den Client Details an.
81 -|(% style="width:186px" %)Windows Update Scanner
82 -(optional)|(% style="width:1177px" %)Der Windows Update Scanner scannt den Status der Windows Installation.
83 -Hierbei werden in den Client Details bereits installierte Windows Updates und noch verfügbare Windows Updates angezeigt.
84 -|(% style="width:186px" %)File Scanner
85 -(optional)|(% style="width:1177px" %)Der File Scanner scannt das System nach ausführbaren Dateien.
86 -Er ergänzt somit die mit dem Software Scanner erfassten Daten zu installierter Software und legt so den Grundstein für Lizenzmanagement.
87 -|(% style="width:186px" %)Hyper-V Scanner
88 -(optional)|(% style="width:1177px" %)Der Hyper-V Scanner scannt das System nach vorhandenen Instanzen von Hyper-V.
89 -Wird eine entsprechende Verbindung erkannt, wird diese in den Client Details angezeigt.{{aagon.infobox}}Beachten Sie, dass Ihnen der Hyper-V Scanner erst ab Windows Server 2012 zur Verfügung steht.{{/aagon.infobox}}
90 -|(% style="width:186px" %)Select Destination|(% style="width:1177px" %)Hier wählen Sie aus, an welchem Speicherort die Scandaten gespeichert werden sollen. Wenn Sie keine Anpassungen vornehmen, werden die Daten in einem neuen Verzeichnis neben der exe gespeichert. Der Dateiname entspricht hierbei dem Rechnernamen.
91 -|(% style="width:186px" %)Show destination in explorer after scan|(% style="width:1177px" %)Legen Sie fest, ob Ihnen nach Abschluss des Scans der Speicherort der Scandaten im Windows Explorer angezeigt werden soll.
82 +There is now an *.aos file in the directory. You must now make this data available again on a client that has an ACMP console. In the next step, you can import this file with the scan data into the ACMP console.
83 +
84 +== Unix Offline Scanner - Parameters ==
85 +
86 +The following parameters are available for advanced configuration of the Unix Offline Scanner:
87 +
88 +|=(% style="width: 251px;" %) Parameter |=(% style="width: 933px;" %) Description |
89 +|(% style="width:251px" %)~-~-EnableLogging|(% style="width:933px" %)Enables logging|
90 +|(% style="width:251px" %)~-~-LoggingPath ‘path’|(% style="width:933px" %)Target directory for log files|
91 +
92 +|(% style="width:251px" %)~-~-GeneratedXmlPath ‘path’|(% style="width:933px" %)Destination directory for generated XML files|
93 +|(% style="width:251px" %)~-~-MaxLogFileSize ‘val’|(% style="width:933px" %)Maximum log file size in MB|
94 +|(% style="width:251px" %)~-~-MaxNumberOfLogFiles ‘val’|(% style="width:933px" %)Maximum number of log files to keep|
95 +
96 +|(% style="width:251px" %)~-~-ExecuteScannersInParallel|(% style="width:933px" %)Enable parallelization of data collection|
97 +
98 +|(% style="width:251px" %)DisableScanner ‘list’|(% style="width:933px" %)(((
99 +List of scanners to be disabled
100 +
101 +Available scanners:
102 +
103 +* Client
104 +* Bios
105 +* Cpu
106 +* Mainboard
107 +* Machine
108 +* Memory
109 +* OperatingSystem
110 +* HardDrive
111 +* LogicalDrive
112 +* Network
113 +* Software
114 +* PowerSupply
115 +* Monitor
116 +* Printer
117 +)))|
118 +|(% style="width:251px" %)Config ‘path’|(% style="width:933px" %)Path to a configuration file{{aagon.infobox}}The specified path overrides all other settings. {{/aagon.infobox}}|
119 +|(% style="width:251px" %)ShowScannerList|(% style="width:933px" %)Displays the list of available scanners. |
120 +|(% style="width:251px" %)help, /?|(% style="width:933px" %)Display help.
121 +
122 +
123 += Importing scan data into the ACMP Console =
124 +
125 +You can now import the scan data into the ACMP Console:
126 +
127 +1. Select the //Query Actions// tab in the ribbon bar.
128 +1. Click on the //Import// button.
129 +[[image:65a_First Steps im ACMP_Offline Scanner_1696.png||alt="“Import" data-xwiki-image-label="Import scan file"]]
130 +1. Navigate to the location of the *.aos file and select it.
131 +
132 +The file with the scan data will now be imported. Once this is complete, you can view the client's inventory data via queries.
133 +
134 +{{aagon.infobox}}
135 +When importing scan data from the Unix Offline Scanner, no software scan data is currently available.
136 +{{/aagon.infobox}}
© Aagon GmbH 2026
Besuchen Sie unsere Aagon-Community