Offline Scanner

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.

5

6

= Run Windows offline scanner =

7

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

10

[[Copy Offline Scanner>>image:65_First Steps im ACMP_Offline Scanner_1696.png||alt="“Copy" data-xwiki-image-style-alignment="“center”"]]

11

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:

13

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.

18

19

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.

21

22

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"]].

24

25

== Configuration of the included scanners ==

26

27

The scanners available in the Windows Offline Scanner and descriptions of their configurations are listed below:

28

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

37

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.

53

54

== Windows Offline Scanner - Parameters ==

55

56

The Windows Offline Scanner can also be used via the command line. The following parameters are available:

57

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}}

70

71

= Run Unix Offline Scanner =

72

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.

74

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:

76

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}}.

81

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"]].

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

Available scanners:

* Client

* Bios

* Cpu

* Mainboard

* Machine

* Memory

* OperatingSystem

* HardDrive

* LogicalDrive

* Network

* Software

* PowerSupply

* Monitor

* Printer

)))|

|(% 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

135

When importing scan data from the Unix Offline Scanner, no software scan data is currently available.

136

Wiki source code of Offline Scanner

Navigation

author	version	line-number	content
		1	{{aagon.floatingbox/}}
		2
		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.
		5
		6	= Run Windows offline scanner =
		7
		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
		10	[[Copy Offline Scanner>>image:65_First Steps im ACMP_Offline Scanner_1696.png\|\|alt="“Copy" data-xwiki-image-style-alignment="“center”"]]
		11
		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:
		13
		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.
		18
		19	{{aagon.infobox}}
		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.
		21	{{/aagon.infobox}}
		22
		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"]].
		24
		25	== Configuration of the included scanners ==
		26
		27	The scanners available in the Windows Offline Scanner and descriptions of their configurations are listed below:
		28
		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
		37
		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.
		53
		54	== Windows Offline Scanner - Parameters ==
		55
		56	The Windows Offline Scanner can also be used via the command line. The following parameters are available:
		57
		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}}
		70
		71	= Run Unix Offline Scanner =
		72
		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.
		74
		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:
		76
		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}}.
		81
		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"]].
		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}}