Wiki source code of Offline Scanner

Last modified by jklein on 2025/10/28 10:30

version	line-number	content
1.1	1	{{aagon.floatingbox/}}
	2
20.1	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.
1.1	5
20.1	6	= Run Windows offline scanner =
15.4	7
20.1	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.
15.4	9
20.1	10	[[Copy Offline Scanner>>image:65_First Steps im ACMP_Offline Scanner_1696.png\|\|alt="“Copy" data-xwiki-image-style-alignment="“center”"]]
15.4	11
20.1	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:
15.4	13
20.1	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.
15.4	18
17.1	19	{{aagon.infobox}}
20.1	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.
17.1	21	{{/aagon.infobox}}
15.4	22
20.1	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>>doc:\|\|anchor="HImportingscandataintotheACMPConsole"]].
17.1	24
20.1	25	== Configuration of the included scanners ==
1.1	26
20.1	27	The scanners available in the Windows Offline Scanner and descriptions of their configurations are listed below:
1.1	28
20.1	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.
1.1	31	\|(% style="width:186px" %)Software Scanner
20.1	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
1.1	37
20.1	38	All installations are displayed in the client details.
1.1	39	)))
	40	\|(% style="width:186px" %)Security Scanner
20.1	41	(optional)\|(% style="width:1177px" %) The Security Scanner scans the system for antivirus software and displays it in the Client Details.
1.1	42	\|(% style="width:186px" %)Windows Update Scanner
20.1	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.
1.1	45	\|(% style="width:186px" %)File Scanner
20.1	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.
1.1	48	\|(% style="width:186px" %)Hyper-V Scanner
20.1	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.
17.1	53
20.1	54	== Windows Offline Scanner - Parameters ==
17.1	55
20.1	56	The Windows Offline Scanner can also be used via the command line. The following parameters are available:
17.1	57
20.1	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}}
17.1	70
20.1	71	= Run Unix Offline Scanner =
17.1	72
20.1	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.
17.1	74
20.1	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:
17.1	76
20.1	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}}.
17.1	81
20.1	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>>doc:\|\|anchor="HImportingscandataintotheACMPConsole"]].
18.1	83
20.1	84	== Unix Offline Scanner - Parameters ==
18.1	85
20.1	86	The following parameters are available for advanced configuration of the Unix Offline Scanner:
18.1	87
20.1	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
18.1	100
20.1	101	Available scanners:
18.1	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	)))\|
20.1	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
18.1	122
20.1	123	= Importing scan data into the ACMP Console =
18.1	124
20.1	125	You can now import the scan data into the ACMP Console:
18.1	126
20.1	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.
18.1	131
20.1	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}}