Creating a MAC address file

A MAC address file lets you specify lists of MAC addresses and properties associated with them for bulk provisioning and configuration.

When you import a MAC address file, you select the provisioning method for the devices in that file. You must create separate MAC address files for each provisioning method.

A MAC address file is a text file that contains:

  • One header line, in comma-separated format, identifying the properties that you are including in the file. The properties must be defined as device properties.
  • Data lines, in comma-separated format, one line for each device that you are importing. The values must appear in the same order as the property names in the header line.

Notes

  • Before you list a property name in the import file, the property must already exist as a Device property.
  • Alphabetic characters in MAC addresses must be in upper case.

The properties in the following table are predefined. If you want the import process to configure other properties, you must first define the properties. For example, you can enter computer names into the MAC address file and let the import process assign the names to your devices, but you must first create the property for computer name and add it to the appropriate system package. For information, see Assigning-configuration-values-during-device-import and Creating-a-local-property-in-the-system-package.

The following table describes the predefined device properties for each type of provisioning method.

Provisioning Method

Required Properties

Additional Notes

PXE

MAC, ARCHITECTURE

Architecture must be one of the following:

  • x86
  • x64
  • Blank is valid; the import process sets the architecture to match the selected boot image.

JumpStart

MAC, ARCHITECTURE

Architecture must be one of the following:

  • sun4u
  • sun4v
  • i86pc

Ignite

MAC, ARCHITECTURE

Architecture must be one of the following:

  • Itanium
  • PA_RISC

NIM

MAC

Additional predefined but optional properties are:

  • CABLE_TYPE
  • PLATFORM
  • NETBOOT_KERNEL
  • NET_SETTINGS

Examples

The following examples show only the required properties for each provisioning type.

  • NIM MAC address file
    MAC
    00-2B-CD-1B-E0-44
    00-22-B3-B1-1E-E3
    00-02-C3-B2-00-C3
  • PXE MAC address file
    MAC,ARCHITECTURE
    00-0B-CD-1B-E0-44,x86
    00-C0-9F-4B-9E-1B,x64
  • JumpStart MAC address file
    MAC,ARCHITECTURE
    00-3C-CD-2E-E0-36,sun4u
    00-4D-6F-9C-3E-4B,sun4v
  • Ignite MAC address file
    MAC,ARCHITECTURE
    00-0C-4B-D4-CD-3A,Itanium
    00-C0-1B-D5-8B-33,PA-RISC

The following examples show how to include an optional COMPUTER_NAME property in a MAC address file.

Note

COMPUTER_NAME is not a preconfigured device class property. The following examples assume that COMPUTER_NAME was previously configured as a device property and added to the NIM and PXE system packages. For information, see Assigning-configuration-values-during-device-import and Creating-a-local-property-in-the-system-package. (Note that COMPUTER_NAME values must not contain spaces.)

  • NIM MAC address file with optional property values
    MAC,COMPUTER_NAME
    00-2B-CD-1B-E0-44,"Sales1"
    00-22-B3-B1-1E-E3,"Sales2"
    00-02-C3-B2-00-C3,"Sales3"
  • PXE MAC address file with optional property values
    MAC,ARCHITECTURE,COMPUTER_NAME
    00-0B-CD-1B-E0-44,x86,"SalesA"
    00-C0-9F-4B-9E-1B,x64,"SalesB"

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*