How to maintain the Software Catalog
On this page
The software catalog holds the software products that inventory finds on your computers. The AlloyScan and Alloy Discovery synchronizations bring its entries in, and each run removes the products that nothing refers to any more. An administrator sets up the import in the Settings App or the Admin Center and chooses which software an AlloyScan job brings in. In the Web App, you then review the products, link the ones your organization manages to Tracked Software items, and release the ones you no longer want, so that a later run removes them. At the end, the catalog keeps the products that your devices report and the products you track, and each run removes the others.
Before you begin
- AlloyScan and Alloy Discovery synchronization jobs bring products into the catalog, and the Automation Server runs them on a schedule. A new database contains no AlloyScan job: there is none until an administrator creates one.
- An administrator works with AlloyScan jobs under the AlloyScan permission, in the Services Configuration Management group. It opens Services > AlloyScan in the Settings App and Services and Integrations > AlloyScan in the Admin Center (see What each administrative permission opens). An AlloyScan job also needs the AlloyScan site's URL and the Client ID and Client Secret of an AlloyScan app registration.
- The entries of the Web App's Software Asset Management group of the navigation rail need an ITAM license (see About Alloy Navigator). What your account can view and change on Tracked Software items is set by the permissions in Software Asset Management permissions.
Bring in products with an inventory import
You cannot create records in the Web App's Software Products list: it switches off New and workflow actions. The inventory imports bring products in:
- An AlloyScan run adds the manufacturers, platforms, and products it does not know to the catalog, then brings each imported computer's detected software in line with its audit: it updates changed entries, deletes entries no longer detected, and adds new ones. Hardware records get no detected software.
- An Alloy Discovery run brings its own software catalog across. It copies the manufacturers, platforms, software product groups, and categories that Alloy Navigator lacks, and adds a product whose software group in Alloy Discovery is empty or marked for synchronization, when the catalog holds no product with the same name, version, and manufacturer. This catalog step adds and updates products but deletes none.
To set up an AlloyScan job, see Create or edit a job; a new job runs every 60 minutes. For the Alloy Discovery import, see Alloy Discovery Synchronization.
Choose which software the import brings in
The AlloyScan job's Import software option decides which computers get software. To change it, in the Settings App:
- Go to Services > AlloyScan > Synchronization.
- Select the job and click Open, or double-click it. The AlloyScan dialog opens.
- Under Import software, choose For all platforms, For selected platforms only and the platforms, or Do not import software.
- Save the job.
The choices have these effects:
- For all platforms: software is imported for Windows, Linux, and macOS computers.
- For selected platforms only: software is imported for the platforms you select; the detected software of computers on the other platforms is cleared.
- Do not import software: AlloyScan is asked not to return software, and the detected software of imported computers is cleared.
AlloyScan imports software only for its Windows, Linux, and Mac computer types. The dialog notes that only software from groups marked for tracking can be imported.
The software catalog's platform for Mac computers is named macOS. On a database upgraded from an earlier version, the platform named Macintosh is renamed macOS. If that platform had been given another name in your database, it keeps that name, and the first import of Mac software adds a second platform named macOS.
In the Admin Center, the same jobs are listed under Services and Integrations > AlloyScan, on the Synchronization tab; see AlloyScan synchronization in the Admin Center.
Review the products in the Web App
In the Web App, the Software Products list of the Software Asset Management section holds the software catalog. A Software Product carries its product name, manufacturer, version, platform, suite, group, and category. Several of them come with the import:
- AlloyScan adds the manufacturers and platforms it does not know.
- Alloy Discovery copies the software product groups and categories that Alloy Navigator lacks, and updates a group's name or ignored setting, or a category's name, where it differs. Because a product is matched by its name, version, and manufacturer, a product renamed in Alloy Discovery arrives as a second product.
- When a member of a suite is found on a device, the suite's parent product is added to that device too.
In the Settings App, Software Catalog is one of the classes that have no Classification node (see Classification node and icons).
A Software Product's Discovered Installations tab lists where the product was found. The tab has an include-retired check box.
Link the products you manage to Tracked Software
A Tracked Software item is the software your organization decides to manage. It groups software products, and one item can cover several versions or editions of a product. A product that a Tracked Software item maps stays in the catalog even when no device reports it any more.
In the Web App, create the item from the New menu of the Tracked Software list in the Software Asset Management section, or from the header's New... menu. Then link the products the item covers:
- Open the Tracked Software item, and go to the Products tab inside General.
- Use the add button to link the products. You can link several products at once, from the products that are not yet linked to any Tracked Software item.
To record the licenses of the item and allocate them, see How to set up and allocate software licenses.
Release the products you no longer want
A product leaves the catalog only when no Tracked Software item maps it and no discovered installation names it. At the end of each AlloyScan or Alloy Discovery run, every such product is removed from the catalog, including a product that AlloyScan or an administrator added.
To release a product that a Tracked Software item maps, in the Web App:
- Open the Tracked Software item, and go to the Products tab inside General.
- Delete the product's row. This removes only the product's link to this item, not the product.
The next AlloyScan or Alloy Discovery run then deletes the product, when no discovered installation names it. Alloy Navigator has no command that deletes a discovered installation. Installations go away in these cases:
- An AlloyScan or Alloy Discovery load can remove a computer's installations of products that are missing from the software it loads for that computer.
- The AlloyScan job's Import software choice clears the detected software of computers whose platform it excludes (see Choose which software the import brings in).
- Deleting a computer, a hardware item, or a product removes the installations that name it.
Retiring a computer keeps its discovered installations, so their products stay in the catalog, and an import that matches a retired computer logs it and leaves it unchanged. Only installations on computers and hardware that are not retired count in compliance and usage figures. Retired means the platform status that marks a Computer or Hardware record as inactive, whatever its label; in a new database created with the Default Workflow (see Default Workflow Configuration), that status is labeled Retired.
Run the import and check the result
An enabled job runs on its schedule. To run an AlloyScan job at once, in the Settings App:
- Go to Services > AlloyScan > Synchronization.
- Select the job and click Run. Run is available only while the Settings App last read the Automation Server as running.
- When the run has finished, open Services > AlloyScan > Logs. For each run, the log shows the run date, the job name, the comments, the duration, and the numbers of created and updated computers and hardware and of errors. View Log opens the run's text.
In the Admin Center, Run on the Synchronization tab of Services and Integrations > AlloyScan queues the selected job; it needs an active Automation Server. For both applications, see Run and manage jobs and Check the results.
Then open the Software Products list in the Web App to see the catalog as the run left it.
What you have now
Your inventory import brings the software of the platforms you chose into the catalog. The products your organization manages are linked to Tracked Software items and stay in the catalog, and the products you released are removed by the first run after their last discovered installation is gone. Products installed on retired computers stay in the catalog while those computers keep their installations.
Related topics
- Software Asset Management - software products, Tracked Software, licenses, and how a product leaves the catalog.
- AlloyScan Synchronization - set up, run, and check the AlloyScan import.
- Inventory Data and Audit Conflicts - what AlloyScan and Alloy Discovery imports write, including discovered software.
- Classification - classification lists in the Admin Center and the Settings App.
- Allocate Software Licenses - link products and licenses to a Tracked Software item.
- How to set up and allocate software licenses - the next step for the products you track.