Migrating XClarity Administrator
XClarity Administrator is planned to be withdrawn from marketing on June 30, 2026, with support planned until June 30, 2027. Lenovo is evolving its systems management strategy by transitioning from XClarity Administrator to XClarity One, a next-generation platform designed for increasingly complex and distributed IT environments. All future innovation and roadmap investments are now dedicated to XClarity One. To ensure a smooth transition, Lenovo provides a migration tool that is part of XClarity One cloud and on-premises versions, allowing XClarity Administrator customers to move to XClarity One at their own pace.
You can migrate an existing XClarity Administrator instance (v4.3.4 or later) to Lenovo XClarity One (with hub v1.7 or later). This process transfers device management to XClarity One, associates the devices with a specific hub, and imports key artifacts (such as firmware policies, device configuration patterns, groups, service tickets, and XClarity Pro licenses) into XClarity One. Once the migration is complete, you can manage the devices through XClarity One.
Migrating artifacts to XClarity One
You can migrate an XClarity Administrator instance that manages no more than 1,000 devices.
You can migrate a specific XClarity Administrator instance multiple times, but artifacts that were migrated are not migrated again.
Ensure that the XClarity Administrator instance is at v4.3.4 or later.
Ensure that the XClarity Administrator instance has valid licenses for each managed device.
Back up the XClarity Administrator system data and settings and then save the backup to your local system (see Backing up XClarity Administrator in the XClarity Administrator online documentation).
Ensure that you are an organization owner in the organization.
Ensure that your XClarity Administrator user account has lxc-supervisor or lxc-admin privileges.
Ensure that the hub that you want to use to manage the new devices is connected to XClarity One and is in a healthy state. The hub must be Lenovo XClarity One Hub v1.7 or later.
You can migrate existing XClarity Administrator instance in any of the following ways.
When adding new devices, by clicking the Device management view, clicking Unmanaged Devices in the context menu, and then clicking the Add icon (
) above the table. When the wizard opens, select Migrate from LXCA for the device type, and then follow the steps in the wizard to complete the process.When adding a new hub, by clicking the Organizations management view, and then clicking the Add icon (
) from the Management hubs panel, and follow the steps in the wizard to complete the process. You are given the option at the end of the wizard to migrate an XClarity Administrator instance to this new XClarity One Hub.
Only supported devices and compatible artifacts are migrated. XClarity One assesses each device and artifact to determine which ones are eligible for migration. The migration assessment report includes a list of eligible and ineligible devices and artifacts and the reason why they are ineligible. You can view and download this assessment from the user interface before you start the migration process.
When the migration is complete, you can view the migration results report from the job or event that was generated by the migration process.
- Devices that have encapsulation enabled. Disable encapsulation on the devices before migrating them to XClarity One.
- Events and alerts. Consider downloading the events logs from XClarity Administrator before starting the migration to keep a historical record.
- Firmware packages and operating systems images
- Lenovo XClarity Pro licenses
Devices. Supported devices are unmanaged by XClarity Administrator and then managed by the hub. Only devices managed by XClarity One and online devices in XClarity Administrator that are supported by the hub running firmware released in January 2023 or later are eligible for migration.
AttentionXClarity One Hub does not support all devices that are supported byXClarity Administrator. For a list of supported devices, see XClarity One Hub Support for Servers webpage. Device groups. Eligible static and dynamic device groups are migrated to XClarity One.
NoteStatic groups must have at least one eligible device for migration. (This requirement does not apply to dynamic groups.)
Dynamic groups with contact or FQDN attributes are not supported in XClarity One and are not eligible for migration.
Groups with the same name and type (static or dynamic) as groups in XClarity One are eligible for migration. A new group is not created, but devices are assigned to the existing group.
Groups with the same name but different type are migrated with a new name.
Dynamic groups with the same name but different criteria are migrated with a new name.
Migrated groups might not be include to any devices if those devices could not be managed in XClarity One.
Firmware policies. Eligible firmware policies are migrated to XClarity One as firmware rules in templates (see Firmware rules and criteria). The firmware policies must be assigned and compliant on at least one eligible device and the target firmware must be released in January 2023 or later.
NoteMigrated firmware policies might not be assigned to any devices if those devices could not be managed in XClarity One.Configuration patterns. Eligible configuration patterns are migrated to XClarity One as device-settings configurations (see Device settings configurations). Configuration patterns must be applied and compliant on at least one eligible device and must include settings for BMC and UEFI versions released January 2024 or later. Only BMC and UEFI settings are included in the device-settings configurations; other settings are not migrated.
NoteYou must have compliant XClarity Pro licenses in XClarity Administrator to migrate configuration patterns.
In XClarity One, device-settings configurations are learned from an existing device. For each configuration pattern that is migrated from XClarity Administrator, XClarity One generates a device-settings configuration based on what is learned from a device of that device type. Therefore, the configurations in XClarity One might have component settings that are not included in the migrated XClarity Administrator configuration patterns.
Only one device-settings configuration is allowed per device type.
Migrated configuration patterns might not be assigned to any devices if those devices could not be managed in XClarity One.
Service tickets. Eligible service tickets are migrated to XClarity One. Only service tickets that were created by Lenovo Call Home and are related to eligible devices are migrated. ServiceNow, Cherwell, and software Call Home service tickets are not migrated.
Call Home configurations. If default Call Home settings are configured in XClarity Administrator, the Call Home configuration is migrated to XClarity One and automatically shipping replacement parts is enabled.
NoteInformation for contacts assigned to individual devices and groups is not migrated.
If Call Home is already configured in XClarity One, the XClarity Administrator configuration is not migrated.
Licenses. Your active XClarity Pro licenses are imported into XClarity One. These licenses are aggregated as XClarity One - Standard, Per Endpoint licenses in the user interface. The number of licensed devices, software support entitlement, and expiration date remain the same as the XClarity Pro licenses.
NoteEnsure that XClarity One has the same customer number as the one in XClarity Administrator to migrate the licenses.
Reverting the migration
If something went wrong during the migration and you wish to revert the XClarity Administrator instance back to the initial state, you can restore the XClarity Administrator instance using the backup archive (see Restoring XClarity Administrator in the XClarity Administrator online documentation).
After restoring XClarity Administrator, your managed devices will appear offline because they are still managed by XClarity One. You must remanage the devices in XClarity Administrator using the Force option.