Operating-systems repository
Lenovo XClarity One does not maintain the repository of operating systems. You need to manually download and import operating-system files that you need for your organization.
To manually import operating-system files, click Lifecycle management tab in the context menu from the Device management view, click the Operating systems tab, and then click the Add icon (
) from the Operating systems page. Follow the steps in the wizard to complete the process.
You are automatically signed out of the web interface after four hours regardless of activity. If the OS import process does not complete within that time frame, you need to sign in and start the import process again.
For XClarity One in the cloud, you must use a chromium-based browser (such as Chrome, Edge, or Opera) to import large files (such as operating-system images). Other browsers, such as Mozilla Firefox, are not supported.
When you import operating-system files, the files are available to only the organization that you are in when you import the files.
For all operating system image files, you must also provide an sha256sum or signature file or both.
For Windows Server:
You must import both the base image and the bundle that contains the boot files and drivers in to XClarity One. For Windows Server bundle files, you must provide a signature file.
You must import a boot file before you can deploy a Windows operating system. Lenovo bundles the predefined WinPE_64.wim boot file along with a set of device drivers into a single package that you can download from the Lenovo Windows drivers and WinPE Images Repository webpage.
Metadata file
You must create a metadata file (named metadata.json) that describes the operating-system files that you want to import in a single import operation.
If you import one or more operating-system files in a compressed file format, such as zip, the compressed file must include a metadata file that describes all operating-system files in that compressed file. If you import operating-system files individually, you must import the associated metadata file along with the individual operating-system files.
The metadata file is a JSON formatted file that contains an array of objects with the following attributes.
| Property | Required / Optional | Description |
|---|---|---|
| category | Required for driver files; otherwise, ignored. | Driver category Possible values: network, storage, or other |
| description | Optional | File description |
| filename | Required | Name of the operating-system file |
| os | Required for driver, bootfile and bundle files; otherwise, optional. | Operating system type Possible values: esxi, rhel, ubuntu, or win |
| osRelease | Required for driver and bootfile files; otherwise, optional. | Operating system release that supports this file |
| osVersion | Required for driver and bootfile files; otherwise, optional. | Operating system version that supports this file |
| required | Optional for driver files; otherwise, ignored. | Indicates whether this file is required for operating-system deployment Possible values: true or false (default) |
| sha256sum | Required if signature is not provided. You must provide either a sha256sum or signature or both. | SHA-256 checksum string for validating the file |
| signature | Required for Windows bundle files; otherwise, required if sha265sum is not provided. You must provide either a sha256sum or signature or both. | GPG signature file |
| signedFile | Required if a signature is provided. | Name of the file that is signed by a GPG tool |
| type | Required | File type Possible values: image, driver, bootfile, or bundle |
[{
"fileName": "en-us_windows_server_2025_x64_dvd_b7ec10f3.iso",
"sha256sum": "e9fac784ee150cb21ab906834ada77f2d8661b307960ede7b18cb64af609d293",
"type": "image"
},{
"category": "network",
"fileName": "en-us_windows_server_2025_x64_dvd_b7ec10f3.zip",
"os": "win",
"osRelease": "2025",
"osVersion": "1",
"required": true,
"sha256sum": "e9fac784ee150cb21ab906834ada77f2d8661b307960ede7b18cb64af609d293",
"signature": "en-us_windows_server_2025_x64_dvd_b7ec10f3.zip.asc",
"signedFile": "en-us_windows_server_2025_x64_dvd_b7ec10f3.zip",
"type": "driver"
},{
"fileName": "WinPE_64_win2025_20250122.zip",
"os": "win",
"osRelease": "2025",
"osVersion": "1",
"sha256sum": "e9b69df6a28410a14eaefd0e960ad90160f4381d88081b284107588e42be6c3f",
"type": "bootfile"
},{
"fileName": "bundle_win2025_20250420.zip",
"os": "win",
"signature": "bundle_win2025_20250420.zip.asc",
"signedFile": "bundle_win2025_20250420.zip",
"type": "bundle"
}]