1common Dell
1common Dell
LIMITED AND RESTRICTED RIGHTS NOTICE: If data or software is delivered pursuant a General
Services Administration “GSA” contract, use, reproduction, or disclosure is subject to restrictions set
forth in Contract No. GS-35F-05925.
Incorrect Certificate Password .............................. 14 Script example to get device parameters values.... 22
English-US
Verification process
Launch ldvu.exe by double clicking the file.
The “Start” window will be opened.
End User License Agreement (EULA), Open Source Licenses (OSL) and Privacy Statement
information are available via the corresponding links.
If there are no changes (i.e. all the device parameters have the same values as they had
at the end of the manufacturing process) then the application will show the
corresponding message with the list of parameters.
If there is at least one change (i.e. at least one device parameter value is different from
the original value which was recorded at the end of the manufacturing process) then the
application will show the corresponding message and will highlight all the detected
changes. The list of detected changes will be at the top of the table, and then there will
be the list with all parameters with highlighted changes. It is possible to copy the original
or changed value to the clipboard by right-clicking on the desired option.
Note. PCR[4] values are excluded from the comparison result. You will see PCR[4]
values as information in the parameters list.
Figure 2.3-5. “Original Data” column example when there are several versions of original values
You can export the comparison results to an XML file. Click “Export to File” button and select
the destination folder in the opened modal window. Confirm the action.
Note. XML file is described here: XML file with comparison results.
You shall select “Do Not Sign” option if there is no need to sign the exported XML file.
You shall select “Sign The File” option and proceed to the steps below, if the exported
XML file needs to be signed.
If you select “Sign The File”, then “Open file” modal window will be opened where you
shall select a certificate file.
When the certificate is selected then the “Password” modal window will be opened
where you shall provide the password for the certificate.
Note. LDVU will use the certificate and password only once during the signing
process and will not store them anywhere.
When you launch the LDVU application in CMD mode, then LDVU application will scan the
parameters of the device, then request from LTSC server the parameters values which were
recorded at the end of the manufacturing process. After that LDVU will compare the parameters
values and will create an XML file with the comparison results. LDVU application will save the
file in the folder which is specified in “output” parameter during the launch of the application.
Verification process
Open Command Line window.
Navigate to the folder with the ldvu.exe application or provide the full path to the folder with the
application.
Launch ldvu.exe.
or
start /wait ldvu.exe --output="Result"
If the application is launched via a .bat file, then the following commands can be
included into the file. In this case LDVU will also return the relevant exit code:
@echo off
start /wait Ldvu.exe --output=.\
echo %errorlevel%
Note. You can change the path of the “output” parameter to save the XML file in
a different folder. In the example above it has “.\” value then the XML file will be
saved in the same folder where the ldvu.exe file is located. You can also enter an
absolute path. If the specified folder does not exist, it will be created.
where
keyfile is path to the certificate, passphrase is certificate password.
Examples:
In the command line you can use this command:
start /wait ldvu.exe --output=" C:\Users " --
keyfile="foldername\file.pfx" --passphrase="Pa$$Phr_ze"
If the application is launched via a .bat file, then the following commands can be
included into the file. In this case LDVU will also return the relevant exit code:
start /wait ldvu.exe --output=".\" --
keyfile="foldername\file.pfx" --passphrase="Pa$$Phr_ze"
echo %errorlevel%
Wait for the verification to complete. It will take less than 1 minute.
If the ldvu.exe is launched with echo %errorlevel% command, then it will return the
relevant exit code – either an exit code for an error (see Troubleshooting) or result of
comparison:
o Exit Code: 0 – no changes detected. It means that all the scanned device
parameters have matching values with the device parameters stored on LTSC
server.
o Exit Code: 10 – changes detected. It means that at least one scanned device
parameter is different from the device parameters stored on LTSC server.
The comparison results will be saved as an XML file in the folder which was defined during
launching of LDVU.
Note. XML file is described here: XML file with comparison results.
2.5 Troubleshooting
Invalid Certificate
Exit code: 122
Provided certificate is not a .pfx file or it has incorrect structure.
You shall select a valid .pfx file.
Unsupported Algorithm
Exit code: 124
No Data on Server
Exit code: 150
This message is shown when there is no information about the device on LTSC server. Possible
reasons:
1. The device had been manufactured before the LTSC solution release.
In this case it is recommended to check the manufacturing data of the device so that it’s
later than LTSC release mentioned here https://tsc.lenovo.com .
2. The device was purchased without LTSC solution services.
If LTSC services were requested for the device in purchase order, then it is
recommended to contact Lenovo Sales Representative or Lenovo Enterprise Client
Management (https://forums.lenovo.com/t5/Enterprise-Client-Management/bd-
p/sa01_eg).
3. LTSC services are not applicable to the device, because it is not an AMD-based Lenovo
ThinkPad or ThinkStation. No further actions required.
Connection errors
This is a group of errors which can happen when there are some issues with connection.
Possible reasons:
1. No Internet Connection - Exit code: 130 - There is no connection to the Internet.
You shall check the connection and retry the verification process.
2. No Connection to Server - Exit code: 131 - There is no connection to the LTSC
server.
You can try again later or contact Lenovo Enterprise Client Management
(https://forums.lenovo.com/t5/Enterprise-Client-Management/bd-p/sa01_eg).
Incorrect Response
Exit code: 151
The error may happen if a response from LTSC server contains invalid signature or incorrect file
structure.
You can retry the verification process or contact Lenovo Enterprise Client Management
(https://forums.lenovo.com/t5/Enterprise-Client-Management/bd-p/sa01_eg).
Unavailable Folder
Exit code: 161
The error can happen when the output folder does not allow to save the file.
You shall check if the folder allows saving files or select another folder, and then retry the export
process.
Signing Issue
Exit code: 162
LDVU application cannot sign the generated XML file due to any reason.
You can retry the signing process or contact Lenovo Enterprise Client Management
(https://forums.lenovo.com/t5/Enterprise-Client-Management/bd-p/sa01_eg).
If there is no data about the device on LTSC server, then both endpoints will return a
relevant message.
The endpoint accepts a SHA256 hash computed from the Machine Type Model Number
(MTMN), Serial Number (SN), and Public key of the Trusted Platform Module (TPM)
Endorsement Certificate of the Lenovo device.
Detailed description and code examples are available in GET /machine-data section on the
official LTSC page: https://tsc.lenovo.com
Element Description
ComparisonResult Shows the result after comparing scanned and server values.
Possible values:
1. No Changes Detected - if there are no changes and all the
scanned values are matching server values.
2. Changes Detected - if there is at least one mismatching
value.
ScanPerformed The date and time (in UTC), when the LDVU scanned the device
parameters.
LocalMachineData Contains the scanned parameters of the device.
SmBios Contains information about key BIOS parameters.
Bios BIOS build information.
Version BIOS version.
ReleaseDate Timestamp for the BIOS version.
System System information.
Manufacturer System manufacturer name - i.e. manufacturer of the device.
SerialNumber Serial number of the system unit (aka chassis).
Uuid Universally unique identifier tied to the motherboard.
Baseboard Baseboard information.
Manufacturer Motherboard manufacturer name.
SerialNumber Motherboard serial number.
Processor Processor information.
Note. There can be multiple processors.
Version Description of the processor.
SerialNumber Serial number of the processor.
Memory Memory information.
Note. There can be multiple memory devices.
DeviceType Type of the memory device.
Manufacturer Memory device manufacturer name.
SerialNumber Serial number of the memory device.
Battery Battery information.
Note. There can be multiple batteries.
Manufacturer Battery manufacturer name.
You can use the scripts examples by saving their code in separate .sh files. The scripts are
meant to be used on 64-bit Linux (checked on Ubuntu 20.04) to get Device_ID_Hash and
parameters values on your Lenovo ThinkPad or ThinkStation.
rm public.der
rm public.pem
rm publicASN.txt
echo $hash
declare -i counter=1
while [ -n "$memType" ]; do
type="${memType##*:}"
memType="${memType%T*}"
echo Memory device type $counter : $type
man="${memMan##*:}"
memMan="${memMan%M*}"
echo Memory Manufacturer $counter : $man
sn="${memSn##*:}"
memSn="${memSn%S*}"
echo Memory Serial Number $counter : $sn
counter=$counter+1
done
tempcountry="${issue##*C =}"
tempcountry="${tempcountry%,*}"
country="${tempcountry%,*}"
echo Country: $country
temporg="${issue##*O = }"
organization="${temporg%,*}"
echo Organization Name: $organization
openssl x509 -in public.der -inform der --noout -pubkey -out public.pem
head -n -1 public.pem > temp.pem
mv temp.pem public.pem
tail -n +2 public.pem > temp.pem
mv temp.pem public.pem
openssl asn1parse -in public.pem -out publicASN.txt -inform PEM -strparse 24
-dump -noout
public=$(cat publicASN.txt| hexdump -v -e '/1 "%02x"')
echo Public Key: $public
rm public.der
rm public.pem
rm publicASN.txt
echo DISK
Element Description
BIOS Static header.
BIOS version BIOS version.
BIOS release date Timestamp for the BIOS version.
System Manufacturer System manufacturer name - i.e. manufacturer of the device.
System serial number Serial number of the system unit (aka chassis).
System UUID Universally unique identifier tied to the motherboard.
MB Manufacturer Motherboard manufacturer name.
MB Serial Number Motherboard serial number.
Processor Version Description of the processor.
Processor Serial Number Serial number of the processor.
Memory Device Type Type of the memory device.
Memory Manufacturer Memory device manufacturer name.
Memory Serial Number Serial number of the memory device.
Battery Manufacturer Battery manufacturer name.
Battery SBDS Serial Number Serial number of the battery.
Battery Device Name Name of the battery device.
TPM Static header.
Country Usually TMP returns country code, not the full name.
Organization Organization name.
Serial Number TPM serial number.
Public Key Public Key value.
PCR N List of PCRs (Platform Configuration Register), where ‘N’ is the
PCR number.
DISK Static header.
Drive Model Name product Drive model name.
LENOVO PROVIDES THIS PUBLICATION “AS IS” WITHOUT WARRANTY OF ANY KIND,
EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A
PARTICULAR PURPOSE. Some jurisdictions do not allow disclaimer of express or implied
warranties in certain transactions, therefore, this statement may not apply to you.
This information could include technical inaccuracies or typographical errors. Changes are
periodically made to the information herein; these changes will be incorporated in new editions
of the publication. Lenovo may make improvements and/or changes in the product(s) and/or the
program(s) described in this publication at any time without notice.
The products described in this document are not intended for use in implantation or other life
support applications where malfunction may result in injury or death to persons. The information
contained in this document does not affect or change Lenovo product specifications or
warranties. Nothing in this document shall operate as an express or implied license or indemnity
under the intellectual property rights of Lenovo or third parties. All information contained in this
document was obtained in specific environments and is presented as an illustration. The result
obtained in other operating environments may vary.
Lenovo may use or distribute any of the information you supply in any way it believes
appropriate without incurring any obligation to you.
Any references in this publication to non-Lenovo Web sites are provided for convenience only
and do not in any manner serve as an endorsement of those Web sites. The materials at those
Web sites are not part of the materials for this Lenovo product, and use of those Web sites is at
your own risk Any performance data contained herein was determined in a controlled
environment. Therefore, the result in other operating environments may vary significantly. Some
Trademarks
The following terms are trademarks of Lenovo in the United States, other countries, or both:
Lenovo
ThinkPad
ThinkCentre
ThinkStation
ThinkVantage
Intel is a trademark or registered trademark of Intel Corporation or its subsidiaries in the United
States and other countries.
Microsoft, Active Directory, Internet Explorer, and Windows are trademarks of the Microsoft
group of companies.
Other company, product, or service names may be trademarks or service marks of others