Node - Help

For General Help, contact:  HelpSU
Help for this subject Other Help Topics:  Main Help Page
Summary

Node Types

Fields
  Node
  Interface
  IPC
  Record   information

Special Node Configurations

Summary

The Node record type is the most common record accessed by LNAs. Node records include essential information about networked devices like name and hardware address. This is also where LNAs assign IP addresses.

Node Types

There are five (5) Node types: Regular, Template, IPC, Router and Advanced. Most LNAs will only need access to the Regular and Template Node types. A Node can be more than one type.

Regular - This is the most common type of Node. Regular Nodes are used for most computers, printers and networking equipment. Regular Nodes have one DNS name assigned.

Template - This Node type does not have an IP address but an address space instead. It was designed for the LNA who administers multiple networks or buildings and does not want to waste IP addresses. All NetDb users with Node record access can also create Nodes of type Template.

IPC (Internet Connectivity Provider) - This Node type reserves a range of addresses to be handed out and is typically used for terminal servers. IPCs are used in a special way for Stanford DSL connections: the IP address of the IPC is the DSL router address while the client's IP addresses are listed as IPC addresses. Most LNAs do not have access to this Node type.

Router - This Node type has the same fields as a Regular Node. However, router Node types have separate access restrictions. Usually, only staff who maintain routers , on campus or in the Medical Center, have access to router records.

Advanced - This new Node type allows multiple DNS names, DNS names for interfaces and DNS names for IP addresses. This would be useful for a computer with multiple network adapters that hosts multiple websites. Also, alias and MXes are associated with a particular name. Generally, access is given to Advanced Node types on special request.

When doing a reverse DNS lookup, names are returned in the following order, if they exist:

  1. IP address name
  2. Interface name
  3. Node name

For example:

Node Name: Big One
Interface 1's Name: Card1
IP address 171.64.60.10   Name: www.stanford.edu
Interface 2's Name: Card2
IP address 171.64.60.11  Name: www.stanford.org

If a reverse DNS lookup is sent for 171.64.60.10, the name returned will be www.stanford.edu.

Changing Node Type

To change the Node type, simply click on the buttons at the top of the Create Node or Modify Node page. The checkmark on the button means that Node type is selected. A Node can be an Advanced IPC Router. But Template Nodes cannot also be Advanced, IPC or Router types.

Verify Button

Due to the nature of web pages, IP addresses cannot be confirme as soon as they are entered. The "Verify " button tells NetDB to check for the following:

  • If Node name is already assigned, give an error
  • If alias name is already assigned, give an error
  • If the MX name is not a valid DNS name, give an error
  • Reserve the Node and alias names so others cannot use them
  • If IP addresses already assigned, give an error
  • Reserve IP addresses so others cannot use them
Verification is also done when a Node record is saved.

Fields

Required fields are marked with a red asterisk on the Create Node or Modify Node pages.

Node Section

DNS records are specified in the name section. Below is the list of how NetDB terms map to the equivalent DNS record.

NetDB term DNS record type
Node Name A (authoritative name)
Alias CNAME (canonical name)
Mail Alias MX

These three (3) fields must obey the following Internet naming standards:

  • Only numbers, letters and hyphens allowed
  • No leading or trailing hyphens allowed
  • At least one letter must used
  • Fully qualified name (including Domain name) cannot exceed 255 characters

For Node name, alias and mail alias, if no Domain name is specified, your default Domain (set in User Profile) is used. For most Users, the default Domain is stanford.edu.

Note that there are two special domains- .sunet and .NoDomain. Names in the .sunet domain are only resolved for Stanford hosts. This is useful for hosts on private address spaces (not reachable from the Internet). Names in the .NoDomain domain are never resolved by DNS servers. They are typically used as placeholders.

Name - Name is simply the name of the Node. An Advanced Node can have multiple names. If no Domain name is specified, your default Domain (set in User Profile) is used. For most Users, the default Domain is stanford.edu

Alias - Alias is the alias for the Node and is equivalent to CNAME record in DNS.

MX - MX or Mail Alias allows email to be redirected. If "box1" is entered as a mail alias for Node "box2", that means that mail sent to anyone@box1 will actually be redirected to box2. A name can only be added as an MX if the node corresponding to that name is in the same group as the user. For instance, if a user tries to enter node2 as an MX for node1 (i.e., node1 will receive mail for node2), the user must have group rights to node2.

For example, suppose Node A has a mail alias B. When SMTP (simple mail transport protocol) server C is asked to send mail to somebody@B.stanford.edu. Server C will ask the Stanford DNS servers for the MX for B.stanford.edu. The DNS servers will return the IP address for A.stanford.edu. Server C then will send the mail to A.stanford.edu. In another example, if server C is asked to send mail to somebody@A.stanford.edu, server C will query the DNS servers for the MX for A.stanford.edu. In this case, there is no MX record for A.stanford.edu. Then server C will query the DNS servers for an A record for A.stanford.edu. The DNS servers will return the IP address for A.stanford.edu.

Below is the record for A.stanford.edu:
Name a.stanford.edu  
Receive Mail For  b.stanford.edu   Pref:10

Node Type - Select the desired Node types by clicking on the buttons. Selected Node types will have checkmarks on the button. The page will also be refreshed to add the fields associated with additional Node types. Note that a template Node cannot be combined with other Node types.

Department - department the computer belongs to. Select the desired department from list. To add a new department or to change the list of departments, submit a ticket to HelpSU .

Location - the building where the computer is located. Select the desired location from the list. To add a new building or to change the list of buildings, submit a ticket to HelpSU .

Room - the room where the computer is located

Make and Model - the type of computer it is. Select the Make and Model from the lists. To add a new model, click on the New button. To add a new Make, submit a ticket to HelpSU .

Operating System - Select an operating system from the dropdown list. If the computer has multiple operating systems, click on Add Another. To create a new operating system, click on New.

Administrators - Administrators are individual people or Admin Teams that are responsible for a computer.

List individuals by using their full names or their SUNet IDs. You can click on Verify to have NetDB check and resolve the names before you try to save the record. If you choose to verify, entries will be checked against the online Stanford directory; if they are not found in the directory or if a name matches multiple people in the directory, an error will occur. If an exact match is found, the person will be returned with a checked box. If multiple matches are found, a list of people and associated departments will be returned unchecked. Check to select the right administrator. The verification process is thus especially useful if you use SUNet IDs since it will show you information about the people connected to the SUNet IDs so you'll know if you entered the right SUNet IDs. Note that the directory lookup looks for matches on SUNet IDs, last name and email address. Note that verification is also done when the Node record is saved.

Admin Teams are a set of people who are responsible for the computer. For example, the Computer Resource Center (CRC) may contract with a department to support their computers. Instead of listing all the people in CRC as administrators, it's simpler to list the CRC Admin Team as an administrator. Admin Teams are generally named in all capital letters and must be followed by a semicolon when entered as a node administrator (e.g., "CRC;").

If the administrator is not associated with Stanford and does not have a SUNet ID, list Admin Team "OUTSIDE;" as the administrator and add contact information in the Comment field.

Users - This optional field lists the user of this computer. List individuals by using their full name or their SUNet IDs. You can click on Verify to have NetDB check and resolve the names before you try to save the record. If you choose to verify, entries will be checked against the online Stanford directory; if they are not found in the directory or if a name matches multiple people in the directory, an error will occur. If an exact match is found, the person will be returned with a checked box. If multiple matches are found, a list of people and associated departments will be returned unchecked. Check to select the right administrator. The verification process is thus especially useful if you use SUNet IDs since it will show you information about the people connected to the SUNet IDs so you'll know if you entered the right SUNet IDs. Note that the directory lookup looks for matches on SUNet IDs, last name and email address. Note that verification is also done when the Node record is saved.

Custom Fields - These four (4) custom fields allow NetDB Users to create their own fields for searching and reporting. Some examples: Asset Tag #, Lab Name, or Department Division. Each field has a label and a value; for example "Label: Lab Name" and "Value: Smithfield Lab" would make one custom field.

 

Interface Section

In NetDB (version 4), the association between IP addresses, hardware addresses, DHCP/Bootp and Roaming DHCP is rather flexible. Each interface can have the following:

  • Zero or one hardware addresses
  • Zero or many IP addresses
  • DHCP on or off
  • Roaming DHCP on or off

Add Another Interface

Interfaces roughly correspond to network cards. If a Node has multiple network cards (for example, docking station at office, PCMCIA card at home), assigning multiple interfaces allows the Node to get different IP addresses based on what hardware address is seen. To add another interface, click on the "Add Another Interface" button in the Interface Information bar (about halfway down the Create Node or Modify Node page).

Hardware address - This 12-character hexadecimal number can be entered in the common hardware address formats below but will always be shown in the dotted format (1234.5678.9abc). Hardware addresses must be unique throughout NetDB. Hardware addresses are also required in order to enable DHCP/BootP and Roamng DHCP.

No punctuation 123456789abc
Dotted 1234.5678.9abc
Dashed 12-34-56-78-9a-bc
Colon 123456:789abc
Colons 12:34:56:78:9a:bc

Interface Name (Advanced Node type only - Interface names would probably be used for computers that host multiple websites or services.

DHCP/BootP - Checking the DHCP/BootP box tells the DHCP servers to respond to DHCP requests from the associated hardware address. This flag cannot be set without a hardware address. This flag is also required to enable Roaming DHCP. For more information about DHCP, see DHCP Help.

Roaming - Checking the Roaming box enables Roaming DHCP. Roaming DHCP is usually used for laptops that move from location to location. To set Roaming, a valid hardware address and the DHCP/BootP flag are also required. For more information, see DHCP Help.

IP Address - IP addresses can be assigned in a number of ways. The address box overrides the address space dropdown list.

  • If a Node or template Node is used as a template, NetDB will attempt to assign an IP address in the same address space as the template
  • If the User has a default address space (set in User Profile), NetDB will attempt to assign an IP address from that address space
  • If the User selects an address space from the select box (shows only those address spaces that User is allowed to assign addresses from) or enter in an address space, NetDB will attempt to assign an IP address from that address space
  • If the User specifies a particular IP address, NetDB will use that address if available.

Otherwise, NetDB will look for the next available address in the address space, starting from the specified address.

Valid IP Address format is in dotted octet form: 171.64.60.10.

Valid Address space formats are shown below:

  • w.x.y.z/n - existing address space with prefix, e.g. TMPL_FRAG{'example addrspace
  • w.x.y/n - existing address space without trailing zeroes, e.g. 171.64.60/24
  • w.x.y.z - existing address space without prefix, e.g. 171.64.60.0

For more information, see Address Spaces .

Because of the nature of web pages, IP addresses cannot be confirmed as soon as they are entered. The "Verify address" button tells NetDB to see check if the addresses are already used. Note that verification is also done when the Node record is saved

IP Address Name (Advanced Node type only) - IP address names would probably be used for computers that host multiple websites or services. To check if the names are already used, click on the "Verify address & name" button.

DHCP Options - Because DHCP Options are rare in Nodes, the window is normally hidden. To add DHCP options, click on the Display options and add the desired options. If a Node has DHCP options, this window will automatically be opened. For more information about DHCP options, see DHCP Help

 

IPC Section (IPC Node type only)

IPC addresses are addresses that this Node will pass out. The easiest way to assign a block of IPC addresses is to select an address space (usually the same as the address space of the IPC) and put the number of desired addresses in the Count box. NetDB will try to find a contiguous block of IP addresses to assign. To see these addresses before saving the Node record, click on "Verify address & name" in the IPC section. Note that IPC addresses are automatically assigned names. Verification is also done when a Node record is saved.

IPC Address - List of addresses that an IPC Node will pass out.

IPC Address Name - Automatically assigned to an IPC address, this name is generated as DN<IPC address in hex>

For example, for IPC address TPML_FRAG{'dynamic addr'}, the automatic name would be "dnab400305" (hex AB = 171, hex 64 = 40, etc.) This name can be changed, but that is not generally recommended.

Count - Count is the number of requested IPC addresses. If Count is not specified, Count is assumed to be 1.

 

Record Information

Expiration Date - Expiration Date is a date string field added to facilitate dormitory administrator's periodic purging of student computer records. For example, all the Nodes in a freshman dorm may have an expiration date of 7/1/2001, just after the end of the school year. During the summer, the administrator could search on all expiration dates expiring before 8/1/2001 and delete those records since the students have moved out. NOTE: NetDB does not take any action based on the expiration date. This is purely an informational field for you.

Group - Only NetDB Users in the same Group as this record or with All Group access can modify or delete this Node. User must also have record access to Nodes and the appropriate Node types. A Node can be in multiple Groups.

Comment - This searchable field is for any additional information. Only printable characters are valid for comments. The printable character set consists of the alphabet, any numbers, all punctuation and spaces. For example, the carriage return is a non-printable character.

Created By - This field gives the full name and SUNet ID of the NetDB User who created this Node and the date it was created.

Last Modified By - This field gives the full name and SUNet ID of the NetDB User who last modified this Node and the date it was last modified.

 

Special Configurations (Wireless, Multiple Locations, Etc.)

1. Computer with multiple network cards - Create a node record with one interface per network card. Assign IP addresses and hardware addresses appropriately.

Example
Name: mylaptop.TMPL_FRAG{'localdomain'
Interface 1: (wireless card)
   Hardware address = 0000.0000.1111 DHCP ROAM
Interface 2: (office network- wired Ethernet)
   Hardware address = 0000.0000.2222 DHCP
   IP address: 171.64.60.10

2. Computer used in two on-campus locations with one network card - Assign 2 IP addresses to one interface with DHCP. DHCP will hand out IP address based on location.

Example
Name: mylaptop.stanford.edu
Interface 1:
   Hardware address = 0000.0000.1111 DHCP
   IP address: 171.64.60.10
   IP address: 171.64.20.123

3. Computer used on campus and with Stanford DSL- Assign as in #2 and submit HelpSU request to enable DHCP on DSL router.

4. Computer used in office and roaming - Assign one IP addresses to an interface with roaming DHCP. DHCP will give the fixed IP if the machine is on the office net and will give a roaming DHCP address otherwise.

Example
Name: mylaptop.stanford.edu
Interface 1:
   Hardware address = 0000.0000.1111 DHCP ROAM
   IP address: 171.64.60.10

5. Laptop only roams on campus (no fixed address) - Create a record with the hardware address, DHCP, roaming and no IP address.

Example
Name: mylaptop.stanford.edu
Interface 1:
   Hardware address = 0000.0000.1111 DHCP ROAM

6. Laptop used between dorms/Stanford West and campus - The student should register the machine in the dorms. The LNA then requests access to that record through HelpSU or Residential Computing (appropriate group access will be added to that record). The LNA assigns a campus IP address.

Example
Name: mylaptop.stanford.edu=
Groups: Residential Computing, MyDepartment
Interface 1:
   Hardware address = 0000.0000.1111 DHCP
   IP address: 171.64.60.10 (campus IP address)
   IP address: 128.12.75.2 (dorm IP address)

 
© 2000-2006 Stanford University. All Rights Reserved.
Last modified Jun 1, 2006