Infrastructure naming conventions

From Wikitech
Jump to: navigation, search
  • We have two types of naming conventions, clustered servers & miscellaneous servers.
  • We do not re-use hostnames of past servers on new servers. When db1001 is decommissioned, no other server @ eqiad will have the name db1001.
  • We do re-use networking gear names, keeping the access switch in eqiad rack A8 named asw-a8-eqiad, and if it is replaced, the new replacement takes that name.
  • Old servers are visible (even when decommissioned) in Racktables. Please check there for existing server names before naming any new servers.
  • Unfortunately, Racktables doesn't presently allow for us to have anonymous users, or variable user access levels, and is a login required system.

Datacenter sites

  • Our present standard is vendor initials (at time of lease signing) followed by the city/region's major airport.
  • Example: We call sites in Dallas, CODFW for cyrus one, and DFW being the largest/major airport nearby. (While in some cases, Love Field airport would be the closest.)
Datacenter Vendor Airport Code
codfw CyrusOne DFW
eqdfw Equinix DFW
eqiad Equinix IAD
eqord Equinix ORD
esams EvoSwitch AMS
knams Kennisnet AMS
ulsfo United Layer SFO

Networking & miscellaneous equipment

  • Naming is based off network equipment role and location.
  • Includes power distribution units, serial console servers, and other infrastruture
  • role-location
Abbreviation Network Role Example
asw access switch asw-a1-eqiad
cr core router cr1-eqiad
mr management router mr1-eqiad
msw management switch msw1-eqiad & msw-b2-eqiad
pfw payments fire wall pfw1-eqiad
ps1 / ps2 power strips/distribution units ps1-b3-eqiad
scs serial console server scs-a8-eqiad


  • Naming follows two conventions:
  • Array is attached to a single host:
  • hostname_of_host_system-arrayN
  • Example: ms2001-array1, ms2001-array2
  • all arrays get a number, even if there is only a single array.
  • Example: dataset1001-array1
  • Array is attached to multiple hosts
  • Labs uses this for labstore, each shelf connects to two different hosts. As such, the older single host naming scheme fails.
  • servicehostgroup-arrayN-site
  • Example: labstore-array1-codfw, labstore-array2-codfw


Any system that runs in a dedicated services cluster with other machines will be named after their role/service task. As a rule, we attempt to name after the service, not just the software package. Also, servers within a group are numbered based on the datacenter they are located in.

Datacenter Numeral range Example
pmtpa / sdtpa 1-999 cp7
eqiad 1000-1999 db1001
codfw 2000-2999 mw2187
esams / knams 3000-3999 cp3031
ulsfo 4000-4999 bastion4001

Hostname Description Status
amssq esams caching server Unused (deprecated)
amslvs esams LVS Unused (deprecated)
analytics analytics nodes (Hadoop, Hive, Impala, and various other things) In use
auth Authentication server in use
bast bastion host In use
conf Configuration system host (etcd, zookeeper...) In use
cp cache proxy (Varnish) In use
dataset dataset dumps storage In use
db database host In use
dbproxy database proxy In use
dbstore database backup In use
elastic elasticsearch servers In use
es external storage database In use
etcd Etcd server In use
etherpad Etherpad server In use (mistake)
eventlog Event logging host In use
fdb fundraising database In use
ganeti Ganeti Virtualization Cluster In use
graphite Graphite server In use
install Installation server In use (rare)
kafka Kafka Brokers In use
knsq knams squid Unused (deprecated)
lab labs virtual node Unused
labcontrol lab controller (depreciated name: virt1000) In use
labnodepool labs node pool server (CI) In use
labmon labs monitoring server In use
labnet labs network In use
labsdb labs database In use
labservices labs services In use
labstore labs storage In use
labvirt labs virtualization node In use
logstash elasticsearch/logstash/kibana node In use
lvs lvs load balancer In use
maps-test maps test cluster In use
mc memcache server In use
ms media storage In use (deprecated)
ms-be media storage backend In use
ms-fe media storage frontend In use
mw mediawiki node (apache application, api, jobrunners, bits app servers) In use
mx Mail relays In use
nas NAS boxes (NetApp) Unused
netmon Network Monitor (smokeping, torrus, librenms) In use
nfs NFS server Unused
ocg offline content generator (PDF) In use
pc Parser cache database In use
pdf PDF Collections Unused (deprecated)
planet Planet server In use (mistake)
pybal-test PyBal testing and development In use
rbf Redis Bloom Filter server Unused
rcs Recent changes stream In use
rdb Redis server In use
restbase RESTBase server In use
sca Service Cluster A - Includes: Mathoid, Citoid, CXServer, Graphoid, Zotero In use
scb Service Cluster B - Includes: mobileapps In use
snapshot Data dump processing node In use
sq squid server Unused (deprecated)
srv apache server Unused (deprecated)
stat statistics (analytics) host In use
storage storage host Unused (deprecated)
tmh TimedMediaHandler, MediaWiki videoscaler See T105009 and T115950.
virt labs virtualization nodes In use (deprecated)
wdqs wikidata query service In use
wtp wiki-text processor node (parsoid) In use

Miscellaneous servers

Any one-off or single service host. This includes pretty much all non-mediawiki software on the cluster that isn't load balanced across multiple machines. Or general task machines that can cluster (to an extent) but require opsen work to do so. The naming of these is based on location (since they tend to do more than one kind of thing or provide more than one particular service/site type.)

Datacenter Site Convention Example
codfw Star Names acamar
eqiad Elements carbon
esams / knams Notable Dutch vandale
ulsfo no misc hosts in ulsfo n/a
  • CODFW modern proper star names should be chosen that are a single word long and contain no odd characters (and have not yet been used).
  • CODFW Orion constellation (Alnilam, Alnitak, Bellatrix, Betelgeuse, Heka, Meissa, Mintaka, Nair Al Saif, Rigel, Saiph, Tabit, Thabit) is reserved for fundraising
  • EQIAD next atomic # assignment (incremental by atomic #): 100


See also Service IPs.

Floating IPs for services have a DNS entry for convenient use. These are named svc. For example, appservers.svc.codfw.wmnet or search.svc.eqiad.wmnet.