Before using the Add a Product wizard, check first whether a Sassafras Product definition already exists! Use "Find Product Definitions..." from the Tasks menu. Products already discovered at your site will appear without a checkmark, others that match your search will appear with a checkmark suggesting that you might want to add them to your Products window.
If PRS has no match for the product definition that you need, then use the Add a Product Wizard to create your own. The wizard opens using New Product... from the Tasks menu or using the right-click context menu from the Products window.
The various screens in the Wizard are arranged in a logical progression to guide you through the creation of a product record with the fields of the Product Details window correctly filled in. You can click Finish at any point to exit the wizard and jump to the resulting Product Details Window, but then you won't have the benefit of its suggestions.
Double check before saving the Product Details Window. In particular, you will want to check that the Programs pane includes all of the appropriate Applications. The wizard includes a search button to help find programs (from the Programs Window) based on publisher, name, etc. It also suggests that your product should not include an entire undistinguished program family (i.e. based on the Identifier only) – typically you should distinguish among programs out to the first decimal of version information. For example, a definition for some Product might include the variant consisting of program versions like 23.x.x.x but not older versions (e.g. 22.x.x.x etc.). Or perhaps the Product must be defined with program a program variant that distinguishes more precisely, e.g. 23.7.x.x.
Variants provide a convenient way to aggregate many executable files that are essentially the same from a Product licensing point of view. In the case of a "suite product" (e.g. Microsoft Office), the product definition must include the correct variant for each application comprising the suite (e.g. Word 16.x, Excel 16.x, PowerPoint 16.x, Outlook 16.x).
But even when a simple "point product", not a "suite product", is being defined, in some cases, you must list multiple program variants – often each having a different identifier! This complication can arise if your KeyServer has ever supported computers using legacy client software (pre 7.3 KeyAccess) as well as 7.3 clients. The programs window may then have a program family identifier of 8 characters (reported by a legacy client) that is just the first 8 characters of a longer identifier reported by a 7.3 or higher client. If the variant with the longer identifier corresponds to exactly the same program files as the variant using the shorter identifier, it should be included in your program definition. Fortunately, the New Product wizard will notice this situation and point out related variants (with different identifiers) that perhaps should be included. The possibility of confusion is much less when all your computers are running KeyAccess 7.3 or better, but ultimately, it is always necessary to inspect the details of a product definition carefully.
Read this blog post:
Creating Accurate Product Definitions
for an example with a discussion of additional details.