Skip to main content

Updating the Universal Unique Identifier (UUID)

The Universal Unique Identifier (UUID) must be updated when the system board is replaced. Use the Lenovo ToolsCenter Suite CLI (OneCLI) to update the UUID in the UEFI-based server.

OneCLI is an online tool that supports several operating systems. Make sure that you download the version for your operating system. You can download OneCLI from the Lenovo Web site. To download OneCLI and update the UUID, do the following:
Note
Changes are made periodically to the Lenovo Web site. The actual procedure might vary slightly from what is described in this document.
  1. Download OneCLI:
    1. Go to the Lenovo Support Portal.
    2. Click the Downloads tab at the top of the panel.
    3. Under ToolsCenter, select View ToolsCenter downloads.
    4. Select Lenovo ToolsCenter Suite CLI.
    5. Scroll down, click the link, and download the OneCLI version for your operating system.
  2. OneCLI sets the UUID in the IMM2. Select one of the following methods to access the IMM2 to set the UUID:
    • Online from the target system, such as LAN or keyboard console style (KCS) access
    • Remote access to the target system (LAN based)
    • Bootable medium containing OneCLI (LAN or KCS, depending upon the bootable media)
  3. 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.
  4. After you install OneCLI, use the following command syntax to set the UUID:

    onecli config set SYSTEM_PROD_DATA.SysInfoUUID <uuid_value> [access_method]

    Where:
    <uuid_value>
    Up to 16-byte hexadecimal value assigned by you.
    [access_method]
    The access method that you selected to use from the following methods:

    • Online authenticated LAN access, type the command:

      [−−imm imm_user_id:imm_password@imm_internal_ip]

      Where:
      imm_internal_ip
      The IMM2 internal LAN/USB IP address. The default value is 169.254.95.118.
      imm_user_id
      The IMM2 account (1 of 12 accounts). The default value is USERID.
      imm_password
      The IMM2 account password (1 of 12 accounts). The default value is PASSW0RD (with a zero 0 not an O).
      Note
      If you do not specify any of these parameters, OneCLI will use the default values. When the default values are used and OneCLI is unable to access the IMM2 using the online authenticated LAN access method, OneCLI will automatically use the unauthenticated KCS access method.
      Example that does not use the user ID and password default values:
      onecli config set SYSTEM_PROD_DATA.SYsInfoUUID <uuid_value> --user <user_id> 
      --password <password>
      Example that uses the user ID and password default values:
      onecli config set SYSTEM_PROD_DATA.SysInfoUUID <uuid_value>

    • 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:
      onecli config set SYSTEM_PROD_DATA.SysInfoUUID <uuid_value>

      The KCS access method uses the IPMI/KCS interface. This method requires that the IPMI driver be installed. Some operating systems have the IPMI driver installed by default. OneCLI provides the corresponding mapping layer. For more details, see the Lenovo ToolsCenter Suite CLI Users Guide. To access this guide, do the following:

      1. Go to the Lenovo Support Portal.
      2. Click the Downloads tab at the top of the panel.
      3. Under ToolsCenter, select View ToolsCenter downloads.
      4. Select Lenovo ToolsCenter Suite CLI.
      5. Scroll down and click the link and download the OneCLI version for your operating system. Scroll down and look under Online Help to download the Lenovo ToolsCenter Suite CLI Users Guide.

    • Remote LAN access, type the command:

      Note
      When using the remote LAN access method to access IMM2 using the LAN from a client, the host and the imm_external_ip address are required parameters.
      [−−imm imm_user_id:imm_password@imm_externaln _ip]
      Where:
      imm_external_ip
      The external IMM2 LAN IP address. There is no default value. This parameter is required.
      imm_user_id
      The IMM2 account (1 of 12 accounts). The default value is USERID.
      imm_password
      The IMM2 account password (1 of 12 accounts). The default value is PASSW0RD (with a zero 0 not an O).
      Example that does not use the user ID and password default values:
      onecli config set SYSTEM_PROD_DATA.SYsInfoUUID <uuid_value> [−−imm imm_user_id:imm_password@imm_internal_ip]
      Example that does use the user ID and password default values:
      onecli config set SYSTEM_PROD_DATA.SysInfoUUID <uuid_value>

    • Bootable media:

      You can also build a bootable medium using the applications available through the ToolsCenter Web site at the Lenovo ToolsCenter website. From the ToolsCenter page, scroll down for the available tools.

  5. Restart the server.