sys_id(1M)

NAME | SYNOPSIS | DESCRIPTION | SYSTEM ID | OPTIONS

NAME

sys_id- display or change system ID in SSP IDPROM

SYNOPSIS

sys_id
sys_id -d [-f filename]
sys_id -x [-f filename]
sys_id -m [yy] yymmddhhmm [-f filename]
sys_id -k key -s serial_no [-f filename]
sys_id -k key -h host_id [-f filename]

DESCRIPTION

sys_id displays or changes the host ID and Ethernet number on a Sun Enterprise 10000 SSP's IDPROM and saves the changes in the eeprom.image file.

The management and relationship of the system ID (machine serial numbers, host IDs, and Ethernet numbers) are kept in a file on the SSP as part of the IDPROM portion of the EEPROM image.

The IDPROM portion of the EEPROM image is encrypted to prevent tampering. However, you can change the encrypted ID in the eeprom.image file for system ID modifications. To do so you must first obtain a key from Sun Microsystems. The key restricts you from changing the system ID to anything other than the designated machine serial number.

To ensure uniqueness, Sun Enterprise 10000 system host ID and Ethernet numbers are derived from the FOA/serial number. The Sun Enterprise 10000 system's serial number comes from a block of numbers assigned to Sun Microsystems by SPARC International.

SYSTEM ID

The sys_id command must be executed on a SSP where the host name and the $SUNW_HOSTNAME environment variable match the ones provided to Sun (when a key is requested). The existing host ID (obtained from the IDPROM) and the -s serial_number or -h host-id must also match.

OPTIONS

When invoked with no arguments, sys_id displays the host ID as specified in the eeprom.image file (located in the default location) in decimal format.

-d

Display all IDPROM fields. The date and time of manufacture are displayed in Universal Coordinated Time, the peculiar acronym for which is UTC.

-m [yy]yymmddhhmm

Set the manufacturing date and time of the IDPROM as the specified year (the first two digits are optional), month, day, hour and minute. If the first yy is not specified and the year is specified as a two-digit number between 69 and 99, inclusive, sys_id interprets the year as 1969 through 1999. If the yy is not specified and the year is specified as a number between 00 and 68, the year is expanded to 2000 through 2068.

sys_id -m can be executed only once.

-f filename

Override the default location of the eeprom.image file and use filename as the alternate location and name. -f uses the specified location regardless of whether a read or write of the file is being performed. The default location and name of the EEPROM image is $SSPVAR/etc/platform name/$SUNW_HOSTNAME/eeprom.image

-k key

Change the system ID. Before executing sys_id with this option you must obtain from Sun the key, which restricts where and how this command can be run. The -k option is the only way to get or change IDs for extra domain hosts (multiple domains). Values between the ranges 0x80A66000 and 0x80A66DFF and 0x80A67000 and 0x80A6FFFF must be used for extra domains.

When executing sys_id with the -k option, you must also specify either -s or -h.

-s serial_no

Change the system ID. When executed with the -s option, sys_id changes the serial number portion of the host ID entry in the IDPROM to the specified serial number. You must obtain this number from Sun. You can then specify the serial number in either decimal or hex format. To specify it in hex, use a prefix of 0x or 0X. Valid serial numbers are in the ranges 0xA65000-0xA65FFF, 0xA66E00-0xA66FFF, and 0xA70000-0xA70FFF.

-h host

Change the host ID. When executed with the -h option, sys_id changes the host ID portion of the host ID entry in the IDPROM to the specified host ID number. You must obtain this number from Sun. You can then specify the host ID number in either decimal or hex format. To specify it in hex, use a prefix of 0x or 0X. Valid host ID numbers are in the range 0x80A65000-0x80A70FFF.

-x

Display the serial number in hex format.

NAME | SYNOPSIS | DESCRIPTION | SYSTEM ID | OPTIONS