Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Software Asset Management Foundation plugin discovery models and software installations

Software discovery models are automatically created during discovery so you can manually normalize the software installed in your environment.

Software discovery models are stored in the Software Discovery Model [cmdb_sam_sw_discovery_model] table.

There is a difference between software models and software discovery models.

  • A software model is a specific version or configuration of software that is purchased and/or available to users.
  • A software discovery model is a model created when a version of software is discovered in a network environment.

Multiple software discovery models can be associated to one software model. For example, a software model can be defined as follows:

  • Publisher = X
  • Product = Y
  • Version = Starts with 10

If there are two separate installs of this product (version 10.1 and version 10.2), two discovery models are created. One of the discovery models has the discovered version set to 10.1, and the other discovery model has the discovered version set to 10.2. The reconciliation process associates both of these discovery models to the same software model since they both meet the version criterion of Starts with 10.

Discovery Models

Software discovery models cannot be created manually. The following field combination, called the primary key, is used to match new software installations to a new or existing software discovery model.

Primary key: Publisher, Display Name, and Version

Note: When analyzing version numbers, an exact match is always searched for first, but rounds down to a major version number when an exact match is not found.

For example, if no match is found for version number 8.0.4, but version 8.0 is found, then version 8.0 is used in the Software model field.

FieldDescription
Display nameName of the discovery model as it appears in record lists. This value is generated automatically using the discovered publisher, discovered product, and discovered version.
Normalization statusStatus of the normalization process:- Manually Normalized - New
PublisherPublisher of the software.
ProductProduct name of the software.
VersionVersion of the software product.
Discovered publisherDiscovered publisher of the software.
Discovered productDiscovered name of the software.
Discovered versionDiscovered version of the software.
Additional Information
Product type- Child: A subcomponent of main software \(not licensable\). - Driver: A software product that controls a device. - Licensable: A software product that is licensable. - Not Licensable: A software product that is not licensable. - Patch: A software product designed to update, fix, or improve an existing computer program. - Unknown: Not discovered. For unknown product types, the product type can be changed to another value. When the product type is changed, the normalization status of the discovery model is updated to Manually Normalized. The reconciliation process only considers software discovery models that are licensable.
PlatformPlatforms include:- Windows - Mac - Unix
Language- Dutch - English - French - German - Italian - Spanish Additional languages are generated if discovered.
EditionEdition of the software.
Full versionFull version of the software.

Note: If a normalized discovery model has a missing version, edition, language, or platform value, those field values can be set by the user. Once a new value is set, the normalization status changes form New to Manually Normalized.

Software Installations

The Software Installations list contains the software installed in your organization and is automatically populated by discovery.

Installed software is placed in the Software Installation [cmdb_sam_sw_install] table by Discovery, and a primary key is built (using Publisher, Display Name, and Version fields).

Discovery automatically matches the discovered software installation with a new or existing software discovery model using the primary key.

FieldDescription
Display name.Name of the software installation as it appears in the record lists. Can be a combination of the discovered product name and edition.
Discovery modelSoftware discovery model that represents the installed software.
PublisherPublisher of the software.
VersionVersion of the software.
Edition OverrideOverride of the software edition setting.If the edition for the software was not discovered, you can edit this field to set the edition, if known, so reconciliation can be performed successfully. For more information, see Manually override SAM Foundation edition value.
Installation
Prod idUnique ID for the product assigned by the manufacturer. Found through discovery.
Install locationPath under which the software is installed.
Install dateDate that the software was installed.
RevisionRevision of the software.
Instance keyUnique ID for the instantiation of the software. Automatically generated when the software is installed.
Installed onHardware on which the software is installed.
Uninstall stringIdentifier used to uninstall the software.
ISO serial numberISO number of the software.
Reconciliation
EntitlementThe entitlement found to use with this installation.
Inferred suiteThe inferred suite model this installation belongs to.
Omit from suitesCheck box for not counting the software install as a component of a suite during reconciliation.

Parent Topic:Exploring Software Asset Management Foundation plugin