Universal CMDB Software Version: 10.33 Inventory Tools User Guide Document Release Date: July 2017 Software Release Date: July 2017 Inventory Tools User Guide Legal Notices Disclaimer Certain versions of software and/or documents (“Material”) accessible here may contain branding from Hewlett-Packard Company (now HP Inc.) and Hewlett Packard Enterprise Company. As of September 1, 2017, the Material is now offered by Micro Focus, a separately owned and operated company. Any reference to the HP and Hewlett Packard Enterprise/HPE marks is historical in nature, and the HP and Hewlett Packard Enterprise/HPE marks are the property of their respective owners. Warranty The only warranties for products and services of Micro Focus and its affiliates and licensors (“Micro Focus”) are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. Micro Focus shall not be liable for technical or editorial errors or omissions contained herein. The information contained herein is subject to change without notice. Restricted Rights Legend Confidential computer software. Except as specifically indicated otherwise, a valid license from Micro Focus is required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. Copyright Notice © 2002 - 2017 Micro Focus or one of its affiliates. Trademark Notices MICRO FOCUS and the Micro Focus logo, among others, are trademarks or registered trademarks of Micro Focus (IP) Limited or its subsidiaries in the United Kingdom, United States and other countries. All other marks are the property of their respective owners. Adobe™ is a trademark of Adobe Systems Incorporated. Microsoft® and Windows® are U.S. registered trademarks of Microsoft Corporation. UNIX® is a registered trademark of The Open Group. Documentation Updates To check for recent updates or to verify that you are using the most recent edition of a document, go to: https://softwaresupport.softwaregrp.com. This site requires that you register for a Software Passport and to sign in. To register for a Software Passport ID, click Register for Software Passport on the Micro Focus Support website at https://softwaresupport.softwaregrp.com. You will also receive updated or new editions if you subscribe to the appropriate product support service. Contact your Micro Focus sales representative for details. Support Visit the Micro Focus Support site at: https://softwaresupport.softwaregrp.com. This website provides contact information and details about the products, services, and support that Micro Focus offers. Micro Focus online support provides customer self-solve capabilities. It provides a fast and efficient way to access interactive technical support tools needed to manage your business. As a valued support customer, you can benefit by using the support website to: l Search for knowledge documents of interest l Submit and track support cases and enhancement requests l Download software patches l Manage support contracts l Look up Micro Focus support contacts l Review information about available services l Enter into discussions with other software customers l Research and register for software training Most of the support areas require that you register as a Software Passport user and to sign in. Many also require a support contract. To register for a Software Passport ID, click Register for Software Passport on the Micro Focus Support website at https://softwaresupport.softwaregrp.com. To find more information about access levels, go to: https://softwaresupport.softwaregrp.com/web/softwaresupport/access-levels. Integration Catalog accesses the Micro Focus Integration Catalog website. This site enables you to explore Micro Focus Product Solutions to meet your business needs, includes a full list of Integrations between Micro Focus Products, as well as a listing of ITIL Processes. The URL for this website is https://softwaresupport.softwaregrp.com/km/KM01702731. Universal CMDB (10.33) Page 2 of 343 Inventory Tools User Guide Contents Introduction to Inventory Tools 8 Analysis Workbench Overview 11 System Requirements 12 Starting Analysis Workbench 12 Analysis Workbench Quick Config Dialog Box 12 Starting the Analysis Workbench Quick Config Dialog Box 12 Preset Analysis Modes 13 Executive Summary from Enriched Scan Files 13 Summary Reports 14 Application Teaching 15 Detailed Analysis 16 Exiting 18 The Analysis Workbench User Interface 18 Shortcut Menus 18 Locating Specific Entries in a Window 22 Overview of the Columns in an Information Window 24 Saving and Loading the Workspace Layout 25 To save or load a workspace layout: 25 Main Menu Bar 26 Opening a Menu 26 The Menu Items 27 Toolbars 31 Status Bar 35 Information Windows 35 Adding a New Window 36 Resizing the Windows 36 The Window Title Bar 36 Moving Within the Windows 37 Customizing Window Layouts 37 Customizing the Font and Color 38 Changing the Font Name and Size for All Entries Displayed in the Workspace 38 Changing the Style Settings for Specific Types of Entries 38 Universal CMDB (10.33) Page 3 of 343 Inventory Tools User Guide Customizing Columns 38 Detail Window 40 Displaying the Details Window 40 Detail Window Customization 41 State Images 43 Saving a State Image 44 Loading a State Image 44 Overview of Command Line Parameters 45 Viewing Logs 47 Shortcut Keys 47 Setting Load Preferences 48 Filtering Levels 49 Configuring Load Filter Settings 51 Recognition Overview 52 Backward Compatibility 53 A Summary of the Process 53 Configuring Analysis Asset Fields 54 Selecting the Files to be Displayed 60 Selecting the Application View 62 Configuring File Version Settings 62 Information Collected by Version Data 63 Configuring Memory Settings 63 Loading Data from Scan Files 64 Selecting Multiple Files 70 Selecting Scan Files for Specific Computers (Complex Queries) 72 The Query Grid 75 The Shortcut Menu 76 The Query Grid Buttons 76 Viewing Data 80 Viewing Charts and Statistics 94 Tagging 102 Tagging Data in the Information Windows 103 Methods for Applying Tags 104 Filtering 106 Tagging and Filtering Examples 108 Common Tasks using Filtering and Tagging 110 Universal CMDB (10.33) Page 4 of 343 Inventory Tools User Guide Machine Queries 115 Teaching an Unidentified Application 116 Using the SAI Editor Overview 121 Using SAI Teaching Mode 121 Teaching Applications to the User SAI 124 License Relations and Application Suites 125 Recognition Objectives 127 Define and Review Objectives 130 Using Objectives to Improve Recognition - The SAI Teaching Wizard 138 Exporting Inventory Data 142 Exporting Stored File Data 149 Exporting Relational Data 153 Analysis Workbench Scripting 156 Analysis Workbench Script Contents 158 Variables and Commands 161 Commands for Calling Other Processes 162 Commands for Loading Data into Analysis Workbench 163 Commands for Unloading Data from the Analysis Workbench 164 Commands for Setting the Load Options 165 Commands for Running Tag Queries 166 Commands for Tagging 167 Commands for Exporting Data from Analysis Workbench 169 Commands for Script Debugging 169 Commands for Script Logging 170 Miscellaneous Commands 171 Sample Script 172 Viewing Software Utilization Data in Analysis Workbench 175 SAI Editor Overview 177 SAI Editor User Interface 177 The Operating Systems Tab 185 The Application Types Tab 187 The Files Tab 189 The All Contents Tab 191 The Language Tab 206 The License Relations Tab 207 Universal CMDB (10.33) Page 5 of 343 Inventory Tools User Guide Setting Properties for the SAI Editor 209 License Relationships 212 The Package Rules Tab 218 The Version Data Rules Tab 219 Searching for Items in the SAI 221 Exporting the Contents of a User SAI to XML Format 223 Examples of XML Export 224 Importing Data 225 The MSI Importer Workspace 235 An Example of Teaching an MSI Based Installer to the User SAI 243 The MSI Scanner Command Line Utility 252 Application Teaching Overview 254 Caveats When Creating and Modifying User SAI Files 254 Teaching Using Scan Files (Windows) 255 Teaching Using Scan Files (UNIX) 270 Using Rules to Teach Applications 283 Overview 283 How to Use Rules to Teach Applications 285 Supported Package Types 286 Rule-Based Application Teaching 287 Version Data Based Recognition Rules 288 Example of a Recognition Rule Using Version Data 290 Example of a Recognition Rule Using Installed Package Information 295 Viewing Your New Rule 298 Rules Section in the XML Import 299 Teaching Using Files 300 How to Teach Using File Based Information 300 Viewer Overview 302 Starting Viewer 302 Exiting Viewer 302 Viewer User Interface 303 Configuring Recognition Setting 307 Configuring Asset Field Settings 313 Extract Field Types 315 Loading Data from a Scan File 321 Universal CMDB (10.33) Page 6 of 343 Inventory Tools User Guide Viewing Summary Data 322 Viewing Hardware and Configuration Data 323 Viewing Directories and Files Data 326 Viewing Stored Files Data 329 Viewing Software Application Data 331 Viewing Software Utilization Data 335 Comparing Scans 337 Send documentation feedback 343 Universal CMDB (10.33) Page 7 of 343 Inventory Tools User Guide Introduction to Inventory Tools Universal Discovery offers standalone tools to help you analyze your scan data: l Analysis Workbench l Viewer l SAI Editor Analysis Workbench Analysis Workbench is one of the key components in the inventory