Infrastructure naming conventions

From Wikitech
Jump to navigation Jump to search

This page documents the naming conventions of servers, routers, data center sites, and other infrastructure relevant to Wikimedia Foundation clusters.

Our servers currently fall in broadly two categories:

Name re-use

We never re-use names of past servers for new servers. For example, after db1001 is decommissioned, no other server will be named db1001.

The notable exception is networking gear, which are deterministically specified by rack. For example the access switch in Eqiad rack A8 is named asw-a8-eqiad. If it is replaced, the new switch will take the same name.

All previous servers are kept (even if decommissioned) in Racktables. Please check there for existing server names before deciding on a name for any new servers. (Note: Racktables is restricted by login.)

Server clusters

Clusters are named as vendor initials (at time of lease signing) followed by the IATA code for a nearby major airport.

For example: our Dallas site is named codfw. The vendor is CyrusOne, and DFW being the large nearby airport. (Technically, Love Field airport is closer but less well-known.)

Cluster Vendor Airport Code
codfw CyrusOne DFW
eqdfw Equinix DFW
eqiad Equinix IAD
eqord Equinix ORD
eqsin Equinix SIN
esams EvoSwitch AMS
knams Kennisnet AMS
ulsfo United Layer SFO


Naming for network equipment is based on role and location.

This also applies to: power distribution units, serial console servers, and other networking infrastructure.

Name prefix 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
psw dedicated peering switch psw1-eqiad
scs serial console server scs-a8-eqiad
fasw Fundraising access switch fasw-c-codfw

OpenStack deployments

[Datacenter Site][numeric identifier](optional dev suffix to indicate non-external non-customer facing deployments) - [r (if region)][letter for AZ]

  • Current Eqiad/Codfw deployments will not fully meet these standards until rebuilt: [eqiad0 (deployment), eqiad (region), nova (AZ)]
Deployment Region Availability Zone
eqiad0 eqiad0-r eqiad0-rb
eqiad1 eqiad1-r eqiad1-rb
codfw0dev codfw0dev-r codfw0dev-rb
codfw1dev codfw1dev-r codfw1dev-rb


  • Arrays must use the Storage array device role in Netbox.
  • 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 bast4001
eqsin 5000-5999 dns5001

When adding a new datacenter, make sure to update operations/puppet.git's /typos file which checks hostnames.

Name prefix Description Status Points of contact
acmechief ACME certificate manager In use
acmechief-test ACME certificate manager staging environment In use
alert Alerting host (Icinga / Alertmanager) In use
amssq esams caching server No longer used (deprecated)
amslvs esams LVS No longer used (deprecated)
analytics analytics nodes (Hadoop, Hive, Impala, and various other things) Being replaced by an-worker
analytics-master analytics master nodes Being replaced by an-master
analytics-tool virtual machines in production (Ganeti) running analytics tools/websites Being replaced by an-tool
an-coord analytics coordination node In use
an-master analytics master node In use, replacing analytics-master
an-tool analytics tools node In use
an-test-(coord/master/worker) analytics hadoop test cluster nodes In use
an-worker analytics worker node In use, replacing analyticsNNNN
an-scheduler analytics job scheduler node In use
an-airflow analytics job scheduler node dedicated to the Discovery team In use
aphlict notification server for Phabricator In use
apt Advanced Package Tool Repository (Debian APT repo) In use
aqs Analytics Query Service In use
archiva Archiva Artifact Repository In use
auth Authentication server In use
authdns Authoritative DNS (gdsnd) In use Traffic
backup Backup hosts In use
bast bastion host In use
censorship Censorship monitoring databases and scripts In use
centrallog Centralized syslog In use
certcentral Central certificates service In use
chartmuseum Helm Chart repository ChartMuseum In use ServiceOps
cloud*-dev Any cloud role + '-dev' = internal deployment (PoC, Staging, etc) In use (new)
cloudcephmon Ceph monitor and manager daemon for WMCS In use (new)
cloudcephosd Ceph object storage data nodes for WMCS In use (new)
cloudceph Converged Ceph object storage and monitor nodes for WMCS (currently only slated for testing) In use (new)
cloudcontrol OpenStack deployment controller for WMCS In use (new)
clouddb Wiki replica servers for WMCS Soon to be in use
cloudelastic Replication of ElasticSearch for WMCS In use (new)
cloudnet Network gateway for tenants of WMCS (Neutron l3) In use (new)
cloudservices Misc OpenStack components (Designate) for WMCS In use (new)
cloudvirt OpenStack Hypervisor (libvirtd + KVM) for WMCS In use (new)
cloudvirtan OpenStack Hypervisor (libvirtd + KVM) for WMCS (dedicated to Analytics) In use (new)
cloudstore Storage system for WMCS In use (new)
cloudbackup Backup storage system for WMCS In use (new)
conf Configuration system host (etcd, zookeeper...) In use
contint Continuous Integration In use
cp Cache proxy (Varnish) In use Traffic
cumin Cluster management (cumin/spicerack/debdeploy/etc...) In use Volans
dataset dataset dumps storage No longer used (deprecated)
db Database host In use
dbmonitor Database monitoring In use
dbprov Database backup generation and data provisioning In use
dbproxy Database proxy In use
dbstore Database analytics In use
debmonitor Debian packages monitoring In use Volans
deploy Deployment hosts In use
dns DNS recursors In use
doc Documentation server (CI) In use
an-druid Druid Cluster (Analytics). Due to naming legacy, druid100[1-3] are also in this cluster. In use
druid Druid Cluster (Public) In use
dumpsdata dataset generation fileset serving to snapshot hosts In use
elastic elasticsearch servers In use
es Database host for MediaWiki external storage In use
etcd Etcd server In use
etherpad Etherpad server In use (mistake)
eventlog EventLogging host In use
flowspec Network controller In use (testing) Netops
fr* Fundraising servers, e.g. frdb, frlog, frpm (puppetmaster) In use
ganeti Ganeti Virtualization Cluster In use
gerrit Gerrit code review (cobalt in eqiad is currently used) In use (deprecated)
grafana Grafana server In use
graphite Graphite server In use
icinga Icinga servers In use Volans
idp Identity provider (Apereo CAS) In use
install Installation server In use (rare)
kafka Kafka brokers In use
kafka-jumbo Large general purpose Kafka cluster In use
kafkamon Kafka monitoring (VMs) In use
knsq knams squid No longer used (deprecated)
krb Kerberos KDC/Kadmin In use Moritz/Luca/Andrew Otto
kubernetes Kubernetes cluster (k8s) In use
kubestage Kubernetes staging cluster In use
kubestagetcd Etcd cluster for the Kubernetes staging cluster In use
kubetcd Etcd cluster for the Kubernetes cluster In use
lab labs virtual node No longer used (deprecated)
labcontrol Controller node for WMCS (aka "labs") In use (deprecated)
cloudmetrics Monitoring server for WMCS In use (deprecated)
labnet Networking host for WMCS In use (deprecated)
labnodepool Dedicated WMCS host for Nodepool (CI) In use (deprecated)
labpuppetmaster Puppetmasters for WMCS In use (deprecated)
labsdb Replication of production databases for WMCS In use (deprecated)
labservices Services for WMCS In use (deprecated)
labstore Disk storage for WMCS In use (deprecated)
labtest* Test hosts for WMCS In use (deprecated)
labvirt Virtualization node for WMCS In use (deprecated)
labweb Management websites for WMCS In use (deprecated)
logstash elasticsearch/logstash/kibana node In use
lvs lvs load balancer In use Traffic
maps Maps cluster In use
maps-test maps test cluster No longer used (deprecated)
miscweb miscellaneous web server planned; to replace krypton Dzahn (mutante)
mc memcached server In use
mc-gp memcached gutter pool server In use
ms media storage No longer used (deprecated)
ms-be media storage backend In use
ms-fe media storage frontend In use
mw MediaWiki application server (MediaWiki PHP webservers, api, jobrunners, videoscalers) In use
mwdebug MediaWiki application server for debugging and deployment staging (Ganeti VMs) In use
mwlog MediaWiki logging host In use
mwmaint MediaWiki maintenance host (formerly "terbium") In use
mx Mail relays In use
nas NAS boxes (NetApp) Unused
netflow Network visibility In use Netops
netmon Network monitor (smokeping, torrus, librenms, rancid, netbox) In use Volans (Netbox only)
netbox Netbox front-end instances Proposed Volans or CRusnov
netboxdb Netbox back-end database instances Proposed Volans or CRusnov
notebook Jupyterhub experimental server In use
nfs NFS server Unused
peek Security Team workflow and project management tooling In use
ocg offline content generator (PDF) No longer used (deprecated)
ores ORES cluster In use
orespoolcounter ORES PoolCounter In use
oresrdb ORES Redis systems In use
pc Parser cache database In use
pdf PDF Collections No longer used (deprecated)
people peopleweb ( In use
parse parsoid Soon in use
phab Phabricator host (currently iridium is eqiad phab host) In use
ping Ping offload server In use Traffic/Netops
planet Planet server In use (mistake)
pki PKI Server (CFSSL) In use
poolcounter PoolCounter cluster In use
prometheus Prometheus cluster In use
proton Proton cluster In use
puppetboard PuppetDB Web UI In use Volans
puppetdb PuppetDB cluster In use Volans
puppetmaster Puppet masters In use
pybal-test PyBal testing and development In use
rbf Redis Bloom Filter server Unused
rcs Obsolete:RCStream server (recent changes stream) No longer used (deprecated)
rdb Redis server In use
registry Docker registries In use
releases Software Releases In use
relforge Discovery's Relevance Forge (see discovery/relevanceForge.git, T131184) In use
restbase RESTBase server In use
rpki RPKI#Validation In use Traffic/Netops
sca Service Cluster A - Includes various services In use
scb Service Cluster B - Includes various services. It's effectively the next generation of the sca cluster above In use
schema Event Schemas HTTP server In use Ottomata, Pchelolo
search-loader Analytics to Elastic Search model data loader In use Search team
snapshot Data dump processing node In use
sq squid server No longer used (deprecated)
srv apache server No longer used (deprecated)
stat statistics computation hosts (see Analytics/Data access) In use
storage storage host No longer used (deprecated)
testreduce parsoid visual diff testing In use
thanos-be Prometheus long term storage backend In use
thanos-fe Prometheus long term storage frontend In use
thumbor Thumbor In use
tmh MediaWiki videoscaler (TimedMediaHandler). See T105009 and T115950. No longer used (deprecated)
torrelay Tor relay No longer used (deprecated)
urldownloader url-downloader In use (added in T224551)
virt labs virtualization nodes No longer used (deprecated)
wdqs wikidata query service In use
webperf webperf metrics (performance team). See T179036. In use
wtp wiki-text processor node (parsoid) In use Will be replaced by parsoid
xhgui A graphical interface for PHP debug profiles built on MongoDB. See Performance/Runbook/XHGui service. 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). The use of those names is deprecated in favour of specialized cluster names above, when possible.

Datacenter Site Convention Example Notes
codfw Star Names acamar Only use modern proper star names that are a single word long and contain no odd characters.

Orion constellation is reserved for fundraising (Alnilam, Alnitak, Bellatrix, Betelgeuse, Heka, Meissa, Mintaka, Nair Al Saif, Rigel, Saiph, Tabit, Thabit).

eqiad Elements helium Next atomic # assignment (incremental by atomic #): 112
esams / knams Notable Dutch vandale