Overwrite customizations for Basic Software Asset Management migration

---
title: Overwrite customizations for Basic Software Asset Management migration
description: When migrating from the Software Asset Management plugin to the Basic Software Asset Management, further actions are required by the customer after plugin activation to ensure successful migration of customized forms and lists.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/australia/it-service-management/software-asset-management-foundation-plugin/t\_MigrateSAMCustomSAMF.html
release: australia
product: Software Asset Management Foundation plugin
classification: software-asset-management-foundation-plugin
topic_type: task
last_updated: "2026-11-06"
reading_time_minutes: 2
breadcrumb: [Basic Software Asset Management migration, Basic Software Asset Management Administration, Basic Software Asset Management, ITSM Software Asset Management, Asset Management common applications, IT Service Management]
---

# Overwrite customizations for Basic Software Asset Management migration

When migrating from the Software Asset Management plugin to the Basic Software Asset Management, further actions are required by the customer after plugin activation to ensure successful migration of customized forms and lists.

## Before you begin

Role required: admin

## About this task

If these lists and forms have been customized before the migration, they may have been skipped during plugin activation and, in that case, require further action.

-   Software Entitlements \(formerly Software Licenses\)
-   Software Allocations \(formerly Software Entitlements\)
-   Software Models
-   Discovery Models
-   Software Installations

You can review plugin activation changes in the Upgrade History module to determine what changes have automatically been skipped so you can resolve the skipped update, if needed.

Certain fields added by the migration also must be configured to take advantage of the new features offered.

## Procedure

1.  Navigate to **All** > **System Diagnostics** > **Upgrade History**.

2.  Identify the records that correspond to the upgrade history for the activation of the Basic Software Asset Management.

    The records in System Upgrades list that represent plugin activation contain the value **n/a** in the **From** field, and plugin name in the **To** field \(such as com.snc.samp, com.snc.samp.core, com.snc.sam.core, com.glide.data\_services\_canonicalization.client, com.snc.asset\_management, com.snc.model, com.snc.procurement\).

    You can determine the list of related plugins based on the time stamp of when the Software Asset Management plugin was activated by sorting on the **Upgrade started** column.

3.  Open a Basic Software Asset Management upgrade record that has changes skipped.

4.  In the **Upgrade Details** related list, open an Upgraded Details record, and then click **Resolve Conflicts** to view a side-by-side comparison of the base system file with the customized file.

5.  Click **Revert to Base System** to overwrite the skipped change if it applies to form or list customization, and note down the changes.

6.  Repeat these steps for all upgrade entries with skipped changes relating to customizations.

7.  In Basic Software Asset Management configuration, manually reconfigure your original form and list customizations.

8.  In Basic Software Asset Management configuration, set new field values \(added as part of the automatic changes performed by plugin activation\) to take advantage of the new features offered.

    1.  Navigate to **Software Asset** > **Licensing** > **Software Models**.

        -   Select the software product in the **Product** reference field.
        -   Select a discovery map, or clear the **Discovery Map** field and set the discovery conditions to find all discovery models that correspond to the software model.
    2.  Navigate to **Software Asset** > **Licensing** > **Software Entitlements** \(formerly Software Licenses\).

        -   Navigate to **Software Asset** > **Licensing** > **Software Entitlements** \(formerly Software Licenses\).
        -   Select the **License Metric** that the software license is counted against when reconciliation is run.
        -   Define the upgrade and downgrade scenarios covered by certain rights.
    3.  In the **User Allocations** and **Device Allocations** related lists \(formerly User/Device Entitlements\), verify that the number of allocated rights are not more than rights owned.

        If so, delete allocations so that the number of allocations does not exceed the number of rights owned.

9.  If you have entitlements that require management of license keys, you can create multiple license keys associated to the same entitlement, as well as allocate these license keys to a user or device.


**Parent Topic:**[Basic Software Asset Management migration](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/software-asset-management-foundation-plugin/c_SAMMigrationSAMF.md)