Purpose: Inventory can be perhaps called the backbone of LANDESK. Almost everything relies on inventory. Remote Control, Provisioning, Reporting, and the list goes on and on. In fact some provisioning tasks cannot be launched without the ability for a mini scan to reach the core server and be processed in a timely manner. Remote Control may fail if the IP address in inventory is not up to date and these are just some examples. If there is one thing a LANDESK Admin should understand and keep working it would be inventory. This guide was written to help understand the basic way that inventory works and how to troubleshoot common problems. This is not an in-depth guide on everything that can go wrong with inventory but more the basic information that every administrator should know.
Flow: Although this document is going to cover core and client side inventory most of the flow happens on the core side. Inventory (like several other folders in LANDESK (alertqueue, brokerreq, sdstatus, vulscanresults)) are queue folders. That is...files arrive at the core and are distributed into these folders. Services on the core then watch these folders and process the files contained within. Since these are queues several problems can arise if the folders get backed up. The C:\Program Files\LANDESK\ManagementSuite\LDScan folder is the queue folder that this document is focusing on and we will first cover file types found in the folder as well as the sub-folders.
Services that watch the LDScan Folder:
- Management Planet Core Scan Processor (LANDesk Data Analytics or LDDA)
- LANDesk Inventory Server
File Types:
- MINI = This is an intermediary file type used by the Core Scan Processor (LDDA).
- MINIMP = This is a mini scan waiting for the Core Scan Processor (LDDA) to process
- MINISCN = This is a mini scan waiting for the Inventory Server to process.
- MP = This is a regular scan file waiting for the Core Scan Process (LDDA) to process
- SCN = This is a regular scan file waiting for the Inventory Server to process.
- TMP = This is a temporary file used when a client communicates to the core server.
Sub-folders:
- ErrorBigScan = Inventory has a default scan file size limit of 10mb. Any scan larger than this will end up in this folder instead of the database. The size can be increased in the Configure - Services - Inventory Tab - Advanced Settings button however the larger the size the more time it will take for the Inventory Server to enter the file into the database.
- ErrorScan = If the inventory has a problem with the scan received it will end up in this folder and a message in the OS Application Event Log will be generated.
- Storage = This is an optional folder that may or may not show up. By default the inventory server will remove all scans unless the option is turned on to keep them.
- ErrorTrans = These are scans that had a problem while transmitted to the core.
- Decomp = Scans related to encryption/compression
Process:
- Scans arrive at the core server. If LDDA is licensed and enabled on the core then the files will be MP, MINIMP, or MINI otherwise they will be MINISCN, or SCN.
- If LDDA is in use the Management Planet Core Scan Processor (LDDA) will pickup the files and run it's active rules on them.
- Once LDDA is done (or if it's not enabled) the file type will be changed to MINISCN or SCN.
- The Inventory Server picks up the files and enters them into the database.
Core Side Problems: Since the LDScan folder is a queue folder it's important to tell if the queue is completely stopped or working slowly. The folder (like all queue folders) should be empty or processing at a good speed at any given time. Troubleshooting steps will depend entirely on how the queue is working.
Technics for watching the LDScan folder:
- Using the right-click properties window over and over and over. This will produce a high number of files (as it includes sub-folders) but after repeated attempts at this you should be able to tell if the total number of files is going down consistently or never going down and going up instead.
- Clicking on a file in the LDScan folder. This option is available to newer OS's and will produce a total number at the bottom.
Complete Stoppage: The number of files in the LDScan folder is never going down or staying the same.
Troubleshooting possibilities:
- Restart the corresponding service. See the "File Types" section at the top of this document. As mentioned before there are two services that watch this folder to it depends on the file type as to which service gets restarted.
- "LANDesk Inventory Server"
- "Managed Planet Core Scan Processor"
- Check the event logs for errors
- Activate the core server using the "Core Server Activation" utility.
Slow Processing: The number of files is decreasing but at a slow rate.
- Just like the complete stoppage above look at the "File Types" section at the top of this article to see which service is at fault.
- Managed Planet Core Scan Processor
- Check for Web Rules that are running as Active. Active rules run for each inventory scan received. Some rules scrape the web and can be VERY costly in regards to CPU and memory. Some web rules are fine and are enabled by default (like: Lenovo Warranty Info, IBM Warranty Info, HP\Compaq Warranty Info, and Gateway Warranty Info) however others like Apple rules etc should not be run actively. Right click these rules and "Set Inactive" and then restart the Managed Planet Core Scan Processor service.
- Make sure the Advanced Inventory settings for "Do Delta" are not turned off. Full scans will make the Core Scan Processor run all of it's rules and slow the process down.
- Inventory Server
- The primary job of the Inventory Server is to process the scan files and insert them into the database. Therefore the service is generating SQL (primarily insert statements) and running them on the database server.
- Test the connection between the core and the database server. There are in-depth documents on doing this but most of the time a simple ping test will suffice.
- Analyze database performance. This may need to be done by a DBA and/or perhaps using a SQL Trace to analyze what tables are taking a long time to process. Generally as long as proper database maintenance is being performed this usually isn't a problem. Otherwise the database server may need to be upgraded.
- Large scans files. The default maximum scan file size is 10mb. The default size can be changed to allow for larger scans to process. The bigger the scan the longer it will take the Inventory Server to insert them into the database.
- The primary job of the Inventory Server is to process the scan files and insert them into the database. Therefore the service is generating SQL (primarily insert statements) and running them on the database server.
- Managed Planet Core Scan Processor
OS Application Event Log: The Inventory Server specifically will log errors and warnings regarding scans and other problems in this log. It is important to understand the events and what they mean.
- Out of sync scans: By default the Inventory Server will "flag" a machine as out of sync if it hasn't heard from the machine in more than 24 hours. This basically means that the next time the device sends in an inventory scan it will be a full scan. When experiencing problems and backups with inventory a large number of these log entries are normal as the inventory catches up over the next 1-2 days.
- Errors: There are many possible errors that the Inventory Server can log so without going into detail it would be best to search the community for the error in question. There is usually a document or discussion that explains the error in more detail and how to correct it.
- Blocked Inventory Items: The Inventory Server will flag unknown or unexpected information in a scan file and block the scan from being inserted into the database. That information is recorded on the core under Configure - Services - Inventory Server - Unknown Items. Most of these entries are normal and should be left as blocked as they may contain corrupt information that doesn't need to be in the database, however, when using Custom Data for example the information may need to be allowed.
Client Side Problems: Below are some ideas on different types of scans as well as the general process the Inventory Scanner goes through. Most of the time port blockage and name resolution are common issues but the following link can help as well. The link contains switches that can be passed to the Inventory Scanner and used in troubleshooting.
Type of scans:
- Full = Self-explanatory. A full hardware and software scan of the device.
- Delta = Changes. This scan will only contain the changes since the last full scan was performed. This is a default setting on the core server.
- Mini = A simple scan that contains basic information in order to communicate an IP address change on the device. These scans help keep the core server up to date on where the device is located on the network.
General Process: The first thing the Inventory Scanner on a device does is attempts to contact the Inventory Server on port 5007. (this will also involve name resolution as well). Assuming that connection is made the device will check/update it's copy of the ldappl3 file. The ldappl3 is a central configuration file maintained by the core that defines what the Inventory Scanner should scan for. After the check for ldappl3 is done the scanner will scan the device and communicate the scan up to the core server.
Generating and output scan and carrying it to the Core Server: Below are methods of generating and output scan on a device. To test communication and other issues with inventory it's helpful to manually move these scans to the core server and drop them into the LDScan folder. This can be done repeated times for troubleshooting as well.
- Macintosh
- Windows