Account Services on the Web
Page Help
You may upload a file in either comma-separated values (.csv) or tab-delimited (.txt) format.Machine Registration File Format
Regardless of format, each line should contain the following fields in this order:
| Field | Example | Explanation |
|---|---|---|
| Name | any.dept.iastate.edu | The fully qualified domain name of the system. |
| MAC Address | 00:aa:00:bb:00:cc | The "Ethernet Address" of the system |
| IP Address | 0.0.0.0 | This must always be 0.0.0.0 for NetReg. |
| Owner | jqpublic | The Net-ID of the owner of the system. |
| Admins | yourlisthere | An ASW list of IT Admins for this system. |
| Department | IT SERVICES | Department owning the system.  |
| Building | Durham | The building where the system is to be located. |
| Room | 1234 | The room where the system is to be located. |
| Options | public personal |
Choose address type, ownership and data-classification. |
| Expiry | 01-Jul-2011 | A date if the system is to be automatically unregistered. |
| O/S | Windows XP | The Operating System on the system. |
| Note | Whatever... | A note for your own use. |
Defaulting
Most of the fields may be left empty and a reasonable
attempt will be made to apply a default value.
This is to make bulk adds where much of the data
is similar (like a lab) require as little data as possible.
| Field | Defaulting |
|---|---|
| Name | REQUIRED, no defaulting (.iastate.edu will be appended if omitted) |
| MAC Address | REQUIRED, no defaulting |
| IP Address | 0.0.0.0 (DHCP Assigned) |
| Owner | (YOUR Net-ID) |
| Admins | netreg (ITS NetReg Staff) |
| Department | PREVIOUS, else YOUR DEPARTMENT, else NONE |
| Building | PREVIOUS, else YOUR BUILDING, else NONE |
| Room | PREVIOUS, else YOUR ROOM, else NONE |
| Options | PREVIOUS, else NAT |
| Expiry | PREVIOUS, else NONE |
| O/S | PREVIOUS, else NONE |
| Note | PREVIOUS, else Bulk Upload, else NONE |
Notes
- PREVIOUS means from the most recent line containing a value, if any. Often this means every line after the first need contain only NAME and MAC Address.
- To actually put nothing in a field with a PREVIOUS default available, use the word NONE (where shown as a legal option).
- NONE is only valid as a Building or Department when Options is Guest.
- Typically you need not provide an admins list as the list subdomain-nr-admin has rights over all NetReg'd machines in subdomain.
- If machine Name already exists, then an interface add will be done instead of a machine registration, so just use multiple lines with the same Name for machines with multiple NICs. Note that most of these fields (Owner, Admins, Department, Building, Room, Expiry, O/S, Note) are per-machine not per-interface, so they will have no effect when adding additional interfaces.
- The Mac Address can use colons, or dashes or no separators at all.
- Valid options are optionally one of {NAT|Private|Public} and optionally Personal and/or Restricted
An example
du1234-01.its,00:11:22:33:44:55,,,,,Durham Center,1234,private/restricted,,OS X,Wired
du1234-01.its,11:22:33:44:55:66,,,,,,,,,,Wireless
du1234-02.its,22:33:44:55:66:77,,,,,,,,,,Wired
du1234-02.its,33:44:55:66:77:88,,,,,,,,,,Wireless
...
du1234-40.its,77:88:aa:bb:cc:dd,,,,,,,,,,Wired
du1234-40.its,88:99:aa:nn:cc:dd,,,,,,,,,,Wireless
Option File Format (Add or Delete)
Regardless of format, each line should contain the following fields in this order:
| Field | Example | Explanation |
|---|---|---|
| Name | any.dept.iastate.edu | The fully qualified domain name of the system. |
| Option Name | next-server | The name of the option to set (see below for list) |
| Option Value | pxe.dept.iastate.edu | The value of the option to set |
Defaulting
Most of the fields may be left empty and a reasonable
attempt will be made to apply a default value.
This is to make bulk adds where much of the data
is similar (like a lab) require as little data as possible.
| Field | Defaulting |
|---|---|
| Name | REQUIRED, no defaulting (.iastate.edu will be appended if omitted) |
| Option Name | PREVIOUS |
| Option Value | PREVIOUS |
Notes
- PREVIOUS means from the most recent line containing a value.
- The currently known Option Names are:
Option Name Opt # Value Type avaya-call-server 176 text avaya-system-parameters 242 text avaya-voice-priority-processor 151 ip-address bootfile-name 67 text cisco-tftp-server-address 150 ip-address domain-search 119 string filename 0 text hp-printer-config-file 144 text log-server 7 ip-address next-server 0 ip-or-hostname tftp-server 66 text vendor-class-identifier 60 text vendor-specific-information 43 string web-proxy-auto-discovery 252 text wyse-dev-mgr-non-secure-port-num 192 unsigned integer 16 wyse-dev-mgr-secure-port-number 190 unsigned integer 16 wyse-dev-mgr-server-address 186 ip-address wyse-mgmt-suite-ca-validation 167 string wyse-mgmt-suite-group-key 199 string wyse-mgmt-suite-mqtt-server 166 string wyse-mgmt-suite-server 165 string wyse-thin-client-ftp-server 161 text wyse-thin-client-wnos-folder 162 text
An example
du1234-01.its,next-server,pxe.its.iastate.edu
du1234-02.its,,
du1234-03.its,,
...
du1234-40.its,,
du1234-01.its,filename,pxelinux.0
du1234-02.its,,
du1234-03.its,,
...
du1234-40.its,,
