Skip to main content

Update the machine type and serial number

After the system board is replaced by trained service technicians, the machine type and serial number must be updated.

There are two methods available to update the machine type and serial number:
  • From Lenovo XClarity Provisioning Manager

    To update the machine type and serial number from Lenovo XClarity Provisioning Manager:
    1. Start the server and press the key according to the on-screen instructions to display the Lenovo XClarity Provisioning Manager interface.

    2. If the power-on Administrator password is required, enter the password.

    3. From the System Summary page, click Update VPD.

    4. Update the machine type and serial number.

  • From Lenovo XClarity Essentials OneCLI

    Lenovo XClarity Essentials OneCLI sets the machine type and serial number in the Lenovo XClarity Controller. Select one of the following methods to access the Lenovo XClarity Controller and set the machine type and serial number:
    • Operate from the target system, such as LAN or keyboard console style (KCS) access
    • Remote access to the target system (TCP/IP based)
    To update the machine type and serial number from Lenovo XClarity Essentials OneCLI:
    1. Download and install Lenovo XClarity Essentials OneCLI.

      To download Lenovo XClarity Essentials OneCLI, go to the following site:

      XClarity Essentials OneCLI website

    2. Copy and unpack the OneCLI package, which also includes other required files, to the server. Make sure that you unpack the OneCLI and the required files to the same directory.

    3. After you have Lenovo XClarity Essentials OneCLI in place, type the following commands to set the machine type and serial number:

      onecli config set SYSTEM_PROD_DATA.SysInfoProdName <m/t_model> [access_method]
      onecli config set SYSTEM_PROD_DATA.SysInfoSerialNum <s/n> [access_method]
      onecli config set SYSTEM_PROD_DATA.SysInfoProdIdentifier <system model> [access_method]
      onecli config set SYSTEM_PROD_DATA.SysInfoProdIdentifierEx <system model> --override [access_method]
      Where:
      <m/t_model>
      The server machine type and model number. Type xxxxyyy, where xxxx is the machine type and yyy is the server model number.
      <s/n>
      The serial number on the server. Type zzzzzzz, where zzzzzzz is the serial number.
      <system model>
      The system model. Type system yyyyyyyy, where yyyyyyyy is the product identifier.
      [access_method]
      The access method that you select to use from the following methods:
      • Online authenticated LAN access, type the command:

        [--bmc-username <xcc_user_id> --bmc-password <xcc_password>]
        Where:
        xcc_user_id
        The BMC/IMM/XCC account name (1 of 12 accounts). The default value is USERID.
        xcc_password
        The BMC/IMM/XCC account password (1 of 12 accounts).
        Example commands are as follows:
        onecli config set SYSTEM_PROD_DATA.SysInfoProdName <m/t_model> --bmc-username <xcc_user_id> --bmc-password <xcc_password>
        onecli config set SYSTEM_PROD_DATA.SysInfoSerialNum <s/n> --bmc-username <xcc_user_id> --bmc-password <xcc_password>
        onecli config set SYSTEM_PROD_DATA.SysInfoProdIdentifier <system model> --bmc-username xcc_user_id --bmc-password xcc_password
        onecli config set SYSTEM_PROD_DATA.SysInfoProdIdentifierEx <system model> --override --bmc-username xcc_user_id --bmc-password xcc_password
      • Online KCS access (unauthenticated and user restricted):

        You do not need to specify a value for access_method when you use this access method.

        Example commands are as follows:
        onecli config set SYSTEM_PROD_DATA.SysInfoProdName <m/t_model>
        onecli config set SYSTEM_PROD_DATA.SysInfoSerialNum <s/n>
        onecli config set SYSTEM_PROD_DATA.SysInfoProdIdentifier <system model>
        onecli config set SYSTEM_PROD_DATA.SysInfoProdIdentifierEx <system model> --override
        Note
        The KCS access method uses the IPMI/KCS interface, which requires that the IPMI driver be installed.
      • Remote LAN access, type the command:

        [−−bmc <xcc_user_id>:<xcc_password>@<xcc_external_ip>]
        Where:
        xcc_external_ip
        The BMC/IMM/XCC IP address. There is no default value. This parameter is required.
        xcc_user_id
        The BMC/IMM/XCC account (1 of 12 accounts). The default value is USERID.
        xcc_password
        The BMC/IMM/XCC account password (1 of 12 accounts).
        Note
        BMC, IMM, or XCC internal LAN/USB IP address, account name, and password are all valid for this command.
        Example commands are as follows:
        onecli config set SYSTEM_PROD_DATA.SysInfoProdName <m/t_model> −−bmc <xcc_user_id>:<xcc_password>@<xcc_external_ip>
        onecli config set SYSTEM_PROD_DATA.SysInfoSerialNum <s/n> −−bmc <xcc_user_id>:<xcc_password>@<xcc_external_ip>
        onecli config set SYSTEM_PROD_DATA.SysInfoProdIdentifier <system model> −−bmc xcc_user_id:xcc_password@xcc_external_ip
        onecli config set SYSTEM_PROD_DATA.SysInfoProdIdentifierEx <system model> --override −−bmc xcc_user_id:xcc_password@xcc_external_ip
    4. Reset the Lenovo XClarity Controller to the factory defaults. See Resetting the BMC to Factory Default section in the XCC documentation compatible with your server at Lenovo XClarity Controller portal page.