Return to dssp-002.ms CVS log

Up to [Coherent Logic Development] / dssp

Annotation of dssp/dssp-002.ms, revision 1.1.1.1

1.1       snw         1: .TL
                      2: DSSP-002: Naming Conventions and Labeling
                      3: .br
                      4: \fIRevision 1.6 (05/09/19)\fP
                      5: .AU
                      6: Serena Willis
                      7: .AI
                      8: Datashed Proprietor
                      9: .AB
                     10: This document details standards for equipment naming and labeling, to
                     11: be followed in new system or network deployments
                     12: .AE
                     13: .NH
                     14: Naming Conventions
                     15: .NH 2
                     16: Network Equipment
                     17: .LP
                     18: Network equipment \fBMUST\fP be named according to the following
                     19: convention:
                     20: .CD
                     21: \fIaa\fP-\fIbbbb\fP-\fInn
                     22: .DE
                     23: .LP
                     24: \fIaa\fP represents one of the following equipment classes:
                     25: .IP *
                     26: \fBsw\fP - switch
                     27: .IP *
                     28: \fBrt\fP - router
                     29: .IP *
                     30: \fBap\fP - access point
                     31: .IP *
                     32: \fBfw\fP - firewall
                     33: .LP
                     34: \fIbbbb\fP represents one of the following roles:
                     35: .IP *
                     36: \fBcore\fP - core
                     37: .IP *
                     38: \fBtor\fP - top-of-rack
                     39: .IP *
                     40: \fBedge\fP - network edge
                     41: .IP *
                     42: \fBacc\fP - access
                     43: .IP *
                     44: \fBagg\fP - aggregation
                     45: .IP *
                     46: \fBvirt\fP - virtual
                     47: .LP
                     48: Finally, \fInn\fP represents a sequential number from 00-99. Numbers 
                     49: less than 10 \fBMUST\fP be padded with a leading zero.
                     50: .NH 3
                     51: Naming Exceptions
                     52: .LP
                     53: Nonconforming names \fBMUST\fP be allowed in the following circumstances:
                     54: .IP *
                     55: Where the nonconforming name has exceptional personal or historical meaning
                     56: .IP *
                     57: Where the device being attached cannot, for technical, legal, or contractual
                     58: reasons, be assigned a conforming name
                     59: .IP *
                     60: Where networks connected pursuant to DSSP-008 have a differing set of
                     61: naming conventions
                     62: .FS
                     63: Names that violate DSSP-012 \fBSHALL NOT\fP be allowed on the network,
                     64: without regard to the usual naming exceptions in DSSP-002.
                     65: .FE
                     66: .NH 2
                     67: Network Hosts
                     68: .LP
                     69: Network hosts \fBMUST\fP be named after Greek mythological figures.
                     70:  
                     71: It is acceptable to provide an alias, e.g. mail, web, nsXX, via local
                     72: name resolution mechanisms (DNS, WINS, NIS/NIS+, LDAP, etc.) as-needed,
                     73: as long as the primary hostname follows this standard.
                     74: .NH 3
                     75: Naming Exceptions
                     76: .LP
                     77: Nonconforming names may be allowed in the following circumstances:
                     78: .IP *
                     79: Where the nonconforming name has exceptional personal or historical meaning
                     80: .IP *
                     81: Where the host being attached cannot, for technical, legal, or contractual
                     82: reasons, be assigned a conforming name
                     83: .IP *
                     84: Where networks connected pursuant to DSSP-008 have a differing set of
                     85: naming conventions
                     86: 
                     87: .NH 
                     88: Physical Requirements
                     89: .NH 2
                     90: Labeling
                     91: .LP
                     92: Labeling of cables \fBMUST\fP follow ANSI/TIA-606-B labeling standards. 
                     93: 
                     94: The following facilities exist:
                     95: .IP *
                     96: \fI1DCA\fP is the datashed itself (1st floor, Data Center A)
                     97: .IP *
                     98: \fI1HTR\fP is the IDF in the house (1st floor, Home, Telecom Room)
                     99: .LP
                    100: The following special considerations are to be followed for 1DCA:
                    101: 
                    102: .IP *
                    103: Rack numbering begins at C01 (Cabinet 01), the left primary networking rack,
                    104: and proceeds counter-clockwise around the building.
                    105: 
                    106: .NH 3
                    107: Remote End Representation
                    108: .LP
                    109: The label on the near terminus of a given cable \fBMUST\fP denote the location
                    110: of the far terminus and vice-versa.
                    111: .NH 3
                    112: Example Label
                    113: .LP
                    114: A label with designation \fI1DCA.C02-36:1\fP would be read as follows:
                    115: 
                    116: .IP *
                    117: \fI1DCA\fP represents the floor and building; in this case, "1st floor, data 
                    118: center A"
                    119: .IP *
                    120: C02 represents the location within 1DCA (C02 for Cabinet 2). 
                    121: 
                    122: TIA-606-B suggests using grid coordinates denoted by raised floor tiles for 
                    123: this portion of the label, but allows for custom nomenclature in data centers 
                    124: where grid coordinates are not feasible: 1DCA has only five racks, numbered 
                    125: \fIC01\fP through \fIC05\fP, and no raised floors.
                    126: .IP *
                    127: \fI36\fP represents the location at which the equipment is installed within
                    128: the rack or enclosure, as numbers of rack units from the floor (i.e., the
                    129: lowest position in the rack is \fI01\fP, and the number increases as you
                    130: move towards the ceiling). 
                    131: 
                    132: Note that in cases where a piece of equipment occupies more than a single
                    133: rack unit, the number is the uppermost rack position occupied by the 
                    134: equipment in question.
                    135: .IP *
                    136: \fI1\fP represents a 1-based port number on the equipment.
                    137: .LP
                    138: Thus, \fI1DCA.C02-36:1\fP represents the first port in the top-of-rack
                    139: switch in cabinet 2 in the first floor of data center A.
                    140: 
                    141: .LP
                    142: @(#)dssp-002.ms        1.6
                    143: 
                    144: 
                    145: 
                    146: 
                    147: 
                    148: 
                    149: 
                    150: 
                    151: 
                    152: 
                    153: 
                    154: 
                    155: