CTWUG Naming Convention

From CTWUG Wiki
Jump to: navigation, search

This page forms part of Node Certification

Why

Networks require standards when naming devices and resources. They make administration easier and allow for automated processing. Without standards automation is impossible, and the network will become confusing and discouraging to administrators trying to help maintain it.

This convention consists of 4 parts: Routerboard Identity, SSID, Radio Name, and Interface Name. Please take a moment to understand all 4 below.


Routerboard Identity

Format: rbNR.HS
NR: start at 1 and increase by 1 for every new routerboard
HS: replace with the high site DNS name as seen in WiND ("Nameserver prefix").

Examples:
rb1.mars
rb3.diabolix

On a Mikrotik RouterBOARD this is set, for example, with:

/system identity set name="rb1.mars"


SSID

Format: http://ctwug.za.net/HS+NR
HS: replace with the high site DNS name as seen in WiND ("Nameserver prefix")
NR: start at 1 and increase by 1 for every interface

Examples:
http://ctwug.za.net/jupiter4
http://ctwug.za.net/mars9

On a Mikrotik RouterBOARD this is set, for example, with:

/interface wireless set 0 ssid="http://ctwug.za.net/jupiter4"

This SSID format serves as an unmistakable reference to a web resource. The web resource typically redirects to a wiki page that provides detailed information on the SSID and the high site. This helps both newcomers and admins, and promotes CTWUG at the same time. It is important to realise this SSID convention applies to all wireless links - Point-to-Points included.


Radio Name

On a Mikrotik RouterBOARD this is set, for example, with:

/interface wireless set 0 radio-name="jupiter-neptune"

Please note the difference between point-to-point links and point-to-multipoint links below.

Point-to-Point Links

Format: Local HS-Remote HS
HS: the high site DNS name as seen in WiND ("Nameserver prefix")
Max length: 16 characters

Examples:
jupiter-neptune
saturn-jupiter

Point-to-Multipoint Links

Access Point Interface

Format: Area-Type-Direction
Area: Shorten to 11 characters max.
Type: s, p, g, o or y (Sector, Panel, Grid, Omni*, Yagi)
Direction: Use n,ne,e,se,s,sw,w or nw.
Note: Do not add the high site name to the radio name, as it is already present in the SSID.
Max length: 16 characters

Examples:
parow-s-nw - Sector at Mars covering Parow, pointing North West
parow-s-ne - Sector at Mars covering Parow, pointing North East
ssuburbs-s-s - Sector at Mars covering southern suburbs, pointing South
kuilsriver-s-se - Sector at Saturn covering Kuils River, pointing South East
rondebosch-s-ne - Sector at Uranus covering Rondebosch, pointing North East

Station Interfaces

Format: WiND DNS name of the node ("Nameserver prefix")
Max length: 16 characters

Examples:
tfyre
vash


Interface Name

On a Mikrotik RouterBOARD this is set, for example, with:

/interface set 0 name="link-neptune"

Please note the difference between point-to-point links and point-to-multipoint links below.

Point-to-Point Interfaces

Format: link-Remote HS
HS: the high site DNS name as seen in WiND ("Nameserver prefix")

Examples:
link-neptune
link-jupiter

Point-to-Multipoint Links

Access Point Interface

Format: Same as #Radio Name

Examples:
parow-s-nw - Sector at Mars covering Parow, pointing North West
parow-s-ne - Sector at Mars covering Parow, pointing North East
ssuburbs-s-s - Sector at Mars covering southern suburbs, pointing South
kuilsriver-s-se - Sector at Saturn covering Kuils River, pointing South East
rondebosch-s-ne - Sector at Uranus covering Rondebosch, pointing North East

Station Interfaces

Format: High Site Name

Examples:
Mars
Mercury