Changes for page Offline Scanner

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

From 1.1 to 2.1 From 3.1 to 4.1

From version 2.1

edited by Steffi F
on 2025/05/12 08:07

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

Raw
Rendered

Summary

Page properties (2 modified, 0 added, 0 removed)

Details

Page properties

Author

@@ -1,1 +1,1 @@
--XWiki.SF
++XWiki.jklein

Content

@@ -1,95 +1,136 @@
  {{aagon.floatingbox/}}
--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//.
++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.
++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.
--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//.
++= Run Windows offline scanner =
--{{figure}}
--[[image:65_First Steps im ACMP_Offline Scanner_1696.png||alt="Offline Scanner kopieren.png" data-xwiki-image-style-alignment="center"]]
++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.
--{{figureCaption}}
--Copy Offline Scanner
--{{/figureCaption}}
--{{/figure}}
++[[Copy Offline Scanner>>image:65_First Steps im ACMP_Offline Scanner_1696.png||alt="“Copy" data-xwiki-image-style-alignment="“center”"]]
--Now copy all files listed in this directory to a USB stick, for example.
--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.
++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:
--{{figure}}
--[[image:64_First Steps im ACMP_Offline Scanner_439.png||alt="Offline Scanner konfigurieren.png" data-xwiki-image-style-alignment="center"]]
++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).
++1. Run the //ACMPOfflineScanner.exe// file.
++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"]]
++1. Click Scan to start the scan. You can see the scan progress in the progress bar.
--{{figureCaption}}
--Configure Offline Scanner
--{{/figureCaption}}
--{{/figure}}
--
--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.
--
  {{aagon.infobox}}
--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.
++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.
  {{/aagon.infobox}}
--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.
++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.
--To import the offline scan data into the ACMP Console, select //Copy Offline Scanner// in the ribbon bar.
++== Configuration of the included scanners ==
--{{figure}}
--[[image:65a_First Steps im ACMP_Offline Scanner_1696.png||alt="Offline Scanner importieren.png" data-xwiki-image-style-alignment="center"]]
++The scanners available in the Windows Offline Scanner and descriptions of their configurations are listed below:
--{{figureCaption}}
--Import Offline Scanner
--{{/figureCaption}}
--{{/figure}}
--
--
--Navigate to the storage location of the *.aos file and open it. You can view the inventory data of the Client via Queries.
--
--= Calling the offline scanner via the command line =
--
--It is possible to call the ACMP Offline Scanner via the command line. The following parameters are available for this purpose:
--
--|(% style="width:220px" %)**Parameter**|(% style="width:1143px" %)**Description**
--|(% style="width:220px" %)/s or /silent|(% style="width:1143px" %)The ACMP Offline Scanner is performed in silent mode.
--|(% style="width:220px" %)/help or /?|(% style="width:1143px" %)Access to the Online-Help
--|(% style="width:220px" %)/ScanDataFolder|(% style="width:1143px" %)Specify the path for saving the scan data.
--|(% style="width:220px" %) |(% style="width:1143px" %)Example: /ScanDataFolder="Pfad"
--|(% 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”
--)))
--|(% style="width:220px" %)/SkipSoftware|(% style="width:1143px" %)If this parameter is specified, the software scanner is not executed. This parameter requires /s.
--|(% style="width:220px" %)/SkipUpdate|(% style="width:1143px" %)With this specification, the Windows Update scanner is not executed. This parameter requires /s.
--|(% style="width:220px" %)/SkipSecurity|(% style="width:1143px" %)If this parameter is specified, the Security Scanner is not executed. This parameter requires /s.
--|(% style="width:220px" %)/SkipFiles|(% style="width:1143px" %)If this parameter is specified, the file scanner is not executed. This parameter requires /s.
--|(% style="width:220px" %)/SkipVirtualization|(% style="width:1143px" %)With this specification, the Hyper-V Scanner is not executed. This parameter requires /s.
--|(% 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}}
--
--= Offline Scanner configuration =
--
--The various scanners and descriptions of their configurations are listed below:
--
  |(% style="width:186px" %)**Scanner**|(% style="width:1177px" %)**Description**
--|(% style="width:186px" %)System Scanner|(% style="width:1177px" %)The System Scanner cannot be disabled. It scans the hardware of the Client and also reads the computer name.
++|(% 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.
  |(% style="width:186px" %)Software Scanner
--(optional)|(% style="width:1177px" %)(((
--The software scanner scans the installed software. It distinguishes between the following types of software that are already installed:
--
--* Software that was installed with a Client Command
++(optional)|(% style="width:1177px" %)The Software Scanner scans the installed software. It distinguishes between the following types of already installed software:(((
++* Software installed with a client command
  * Software installed via MSI
  * Software installed via setup
  * Packages installed via Windows Store
--All installations are displayed in the Client Details.
++All installations are displayed in the client details.
  )))
  |(% style="width:186px" %)Security Scanner
--(optional)|(% style="width:1177px" %)The Security Scanner scans the system for antivirus software and displays it in the Client Details.
++(optional)|(% style="width:1177px" %) The Security Scanner scans the system for antivirus software and displays it in the Client Details.
  |(% style="width:186px" %)Windows Update Scanner
  (optional)|(% style="width:1177px" %)The Windows Update Scanner scans the status of the Windows installation.
--The Client Details display shows Windows Updates that are already installed and Windows Updates that are still available.
++It displays Windows updates that are already installed and Windows updates that are still available in the Client Details.
  |(% style="width:186px" %)File Scanner
  (optional)|(% style="width:1177px" %)The File Scanner scans the system for executable files.
--It supplements the data collected by the software scanner on installed software, laying the foundation for license management.
++It thus supplements the data collected by the Software Scanner on installed software and lays the foundation for license management.
  |(% style="width:186px" %)Hyper-V Scanner
  (optional)|(% style="width:1177px" %)The Hyper-V Scanner scans the system for existing instances of Hyper-V.
  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}}
--|(% style="width:186px" %)Select Destination|(% style="width:1177px" %)Here you can select the storage location for the scan data. If you do not make any adjustments, the data will be stored in a new directory next to the exe file. The file name corresponds to the machine name.
++|(% 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.
  |(% 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.
++
++== Windows Offline Scanner - Parameters ==
++
++The Windows Offline Scanner can also be used via the command line. The following parameters are available:
++
++|(% style="width:220px" %)**Parameter**|(% style="width:1143px" %)**Description**
++|(% style="width:220px" %)/s or /silent|(% style="width:1143px" %)The ACMP Offline Scanner is executed in silent mode.
++|(% style="width:220px" %)/help or /?|(% style="width:1143px" %)Call up help
++|(% style="width:220px" %)/ScanDataFolder|(% style="width:1143px" %)Specify the path for saving the scan data.
++|(% style="width:220px" %) |(% style="width:1143px" %)Example: /ScanDataFolder=“Path”
++|(% 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”
++|(% style="width:220px" %)/SkipSoftware|(% style="width:1143px" %)If this parameter is specified, the software scanner will not be executed. This parameter requires /s.
++|(% style="width:220px" %)/SkipUpdate|(% style="width:1143px" %)If this parameter is specified, the Windows Update scanner will not be executed. This parameter requires /s.
++|(% style="width:220px" %)/SkipSecurity|(% style="width:1143px" %)With this specification, the Security Scanner is not executed. This parameter requires /s.
++|(% style="width:220px" %)/SkipFiles|(% style="width:1143px" %) With this specification, the file scanner is not executed. This parameter requires /s.
++|(% style="width:220px" %)/SkipVirtualization|(% style="width:1143px" %)With this specification, the Hyper-V scanner is not executed. This parameter requires /s.
++|(% 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}}
++
++= Run Unix Offline Scanner =
++
++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.
++
++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:
++
++1. Make the required file directory available on the client (e.g., via USB stick or share in another network accessible to the client).
++1. If necessary, adjust the configuration file //appsettings.json//.
++1. Make the file executable using the following Bash command {{code language="bash"}}chmod +x ./Aagon.UnixOfflineScanner{{/code}}.
++1. Run the Unix Offline Scanner using the following Bash command: {{code language="bash"}}sudo ./Aagon.UnixOfflineScanner{{/code}}.
++
++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.
++
++== Unix Offline Scanner - Parameters ==
++
++The following parameters are available for advanced configuration of the Unix Offline Scanner:
++
++|=(% style="width: 251px;" %) Parameter |=(% style="width: 933px;" %) Description |
++|(% style="width:251px" %)~-~-EnableLogging|(% style="width:933px" %)Enables logging|
++|(% style="width:251px" %)~-~-LoggingPath ‘path’|(% style="width:933px" %)Target directory for log files|
++
++|(% style="width:251px" %)~-~-GeneratedXmlPath ‘path’|(% style="width:933px" %)Destination directory for generated XML files|
++|(% style="width:251px" %)~-~-MaxLogFileSize ‘val’|(% style="width:933px" %)Maximum log file size in MB|
++|(% style="width:251px" %)~-~-MaxNumberOfLogFiles ‘val’|(% style="width:933px" %)Maximum number of log files to keep|
++
++|(% style="width:251px" %)~-~-ExecuteScannersInParallel|(% style="width:933px" %)Enable parallelization of data collection|
++
++|(% style="width:251px" %)DisableScanner ‘list’|(% style="width:933px" %)(((
++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}}|
++|(% style="width:251px" %)ShowScannerList|(% style="width:933px" %)Displays the list of available scanners. |
++|(% style="width:251px" %)help, /?|(% style="width:933px" %)Display help.
++
++
++= Importing scan data into the ACMP Console =
++
++You can now import the scan data into the ACMP Console:
++
++1. Select the //Query Actions// tab in the ribbon bar.
++1. Click on the //Import// button.
++[[image:65a_First Steps im ACMP_Offline Scanner_1696.png||alt="“Import" data-xwiki-image-label="Import scan file"]]
++1. Navigate to the location of the *.aos file and select it.
++
++The file with the scan data will now be imported. Once this is complete, you can view the client's inventory data via queries.
++
++{{aagon.infobox}}
++When importing scan data from the Unix Offline Scanner, no software scan data is currently available.
++{{/aagon.infobox}}