Proposal for GBT Host Names

The Stakeholders

As new machines are introduced into the system, we should be mindful that these will be used by Operations, Software Development, Electronics and supported by Computing. Therefore we should choose names meaningful to all. Consensus should be reached prior to placing a machine in service.

Proposal Guidelines

The RFC included below expands upon the summary given here, so I would encourage all to read that section. First I will list the rules of what not to do:

  • Don't overload other terms already in common use. (e.g. a machine named "scanner")
  • Don't use long names or odd spellings (e.g. chek)
  • Don't use antagonistic or otherwise embarrassing names
  • Don't use names which differ only by a numeric postfix (e.g server1, server2) A possible exception is in the case of a cluster of machines.

A list of Do's:
  • Do get input from all stakeholders prior to deployment of a system.
  • Do consider the possibilty of the hostname as an exported filesystem name. Computer division conventions are that (with few exceptions) exported filesystems are named after the hosting computer (e.g landru exports /home/landru etc.)
  • Do consider the possibility that a host may change it's primary function over time. Manager processes will be moved around for load balencing purposes. What may be a clear name at the onset may turn into a very misleading name months from now.
  • Do keep a 'database' (read wiki page) which documents the computers function and location. This is much easier than renaming the computer each time their function changes. Whatever the hostname is, and no matter how clear it is, it still needs to be documented on the operations computer wiki page.
  • For names which users must remember, issue CNAME aliases. (e.g we have a CNAME alias for ssh.gb.nrao.edu, because remote users need to know where to login [using ssh].)

Aliases

For some time now the computer division has created aliases for some machines which provide a basic function to visiting observers. For example, a visitor might want to configure their laptop to use an email proxy or http proxy, and are able to enter 'smtp.gb.nrao.edu' (SMTP is the name of outgoing email service). This is fine because it is a name a user must remember or enter on their machine. A machine can have a number of 'aliases', but only one primary name. (For example both sntp.gb.nrao.edu and proxy.gb.nrao.edu resolve to 192.33.116.9, but 192.33.116.9 always resolves to io.gb.nrao.edu.)

I think aliases are great for machines like "smtp" where the user really doesn't care, and really only knows that they are getting a service. I think they are less appropriate (not appropriate) for gbt control computers, which are largely (not not exclusively) the subject of the immediate discussion. RMP

Note the the primary name does not describe its function.

Proposed Names

Below is a list of proposed names. A minimum number of host names are changed.

Current Name Action Proposed New Name NotesSorted descending Comments
vortex Leave as is   [1]  
gbtdcr Leave as is   [1],[2]  
vortex replacement Name as cyclone   'cyclone' is like a vortex ...(jjb)
wind Leave as is      
fire Leave as is      
dcr replacement (dozer) Name as      

# Notes:
1 Due to be replaced
2 Single function computer.

In line with the "use a theme name" suggestion below, can we agree a theme? We have two possibilities already in use - scientists and "elements". I think either would work if we were careful to choose names which were easy to spell, easy to pronounce, and had absolutely no possibility of being miscontrued. i.e. we could go with darwin, newton but not bohr or descartes, maybe ocean, mountain but not rain or snow! (RMP)

Proposed 'Themes'

Theme Why Examples For Against
Planets Astronomy related sol, earth, mars...   Some already in use onsite.
Stars Astronomy related     Some already in use on site.
Scientists Science related     I recommend against use of names, due to inconsistent spellings (jjb)
Astro units Astronomy related parsec, kelvin    
Tools Computers are tools hammer, anvil, nail, forge...    
Phonetics   alpha, bravo, charlie, delta...    
Others?        

Also see: http://seriss.com/people/erco/unixtools/hostnames.html

Naming Guideline References

An excellent reference on hostname conventions is RFC 1178, included below. The original copy is available at http://rfc.sunsite.dk/rfc/rfc1178.html
Network Working Group D. Libes Request for Comments: 1178 Integrated Systems Group/NIST FYI: 5 August 1990

Choosing a Name for Your Computer

Status of this Memo:

This FYI RFC is a republication of a Communications of the ACM article on guidelines on what to do and what not to do when naming your computer [1]. This memo provides information for the Internet community. It does not specify any standard.

Distribution of this memo is unlimited.

Abstract

In order to easily distinguish between multiple computers, we give them names. Experience has taught us that it is as easy to choose bad names as it is to choose good ones. This essay presents guidelines for deciding what makes a name good or bad.

Keywords
domain name system, naming conventions, computer administration, computer network management

Introduction

As soon as you deal with more than one computer, you need to distinguish between them. For example, to tell your system administrator that your computer is busted, you might say, "Hey Ken. Goon is down!"

Computers also have to be able to distinguish between themselves. Thus, when sending mail to a colleague at another computer, you might use the command "mail libes@goon".

In both cases, "goon" refers to a particular computer. How the name is actually dereferenced by a human or computer need not concern us here. This essay is only concerned with choosing a "good" name. (It is assumed that the reader has a basic understanding of the domain name system as described by [2].)

By picking a "good" name for your computer, you can avoid a number of problems that people stumble over again and again.

Here are some guidelines on what NOT to do:

Don't overload other terms already in common use.

Using a word that has strong semantic implications in the current context will cause confusion. This is especially true in conversation where punctuation is not obvious and grammar is often incorrect.

For example, a distributed database had been built on top of several computers. Each one had a different name. One machine was named "up", as it was the only one that accepted updates. Conversations would sound like this: "Is up down?" and "Boot the machine up." followed by "Which machine?"

While it didn't take long to catch on and get used to this zaniness, it was annoying when occasionally your mind would stumble, and you would have to stop and think about each word in a sentence. It is as if, all of a sudden, English has become a foreign language.

Don't choose a name after a project unique to that machine.

A manufacturing project had named a machine "shop" since it was going to be used to control a number of machines on a shop floor. A while later, a new machine was acquired to help with some of the processing. Needless to say, it couldn't be called "shop" as well. Indeed, both machines ended up performing more specific tasks, allowing more precision in naming. A year later, five new machines were installed and the original one was moved to an unrelated project. It is simply impossible to choose generic names that remain appropriate for very long.

Of course, they could have called the second one "shop2" and so on. But then one is really only distinguishing machines by their number. You might as well just call them "1", "2", and "3". The only time this kind of naming scheme is appropriate is when you have a lot of machines and there are no reasons for any human to distinguish between them. For example, a master computer might be controlling an array of one hundred computers. In this case, it makes sense to refer to them with the array indices.

While computers aren't quite analogous to people, their names are. _Nobody expects to learn much about a person by their name_. Just because a person is named "Don" doesn't mean he is the ruler of the world (despite what the "Choosing a Name for your Baby" books say). In reality, names are just arbitrary tags. You cannot tell what a person does for a living, what their hobbies are, and so on.

Don't use your own name.

Even if a computer is sitting on your desktop, it is a mistake to name it after yourself. This is another case of overloading, in which statements become ambiguous. Does "give the disk drive to don" refer to a person or computer?

Even using your initials (or some other moniker) is unsatisfactory. What happens if I get a different machine after a year? Someone else gets stuck with "don" and I end up living with "jim". The machines can be renamed, but that is excess work and besides, a program that used a special peripheral or database on "don" would start failing when it wasn't found on the "new don".

It is especially tempting to name your first computer after yourself, but think about it. Do you name any of your other possessions after yourself? No. Your dog has its own name, as do your children. If you are one of those who feel so inclined to name your car and other objects, you certainly don't reuse your own name. Otherwise you would have a great deal of trouble distinguishing between them in speech.

For the same reason, it follows that naming your computer the same thing as your car or another possession is a mistake.

Don't use long names.

This is hard to quantify, but experience has shown that names longer than eight characters simply annoy people.

Most systems will allow prespecified abbreviations, but why not choose a name that you don't have to abbreviate to begin with? This removes any chance of confusion.

Avoid alternate spellings.

Once we called a machine "czek". In discussion, people continually thought we were talking about a machine called "check". Indeed, "czek" isn't even a word (although "Czech" is).

Purposely incorrect (but cute) spellings also tend to annoy a large subset of people. Also, people who have learned English as a second language often question their own knowledge upon seeing a word that they know but spelled differently. ("I guess I've always been spelling "funxion" incorrectly. How embarrassing!")

By now you may be saying to yourself, "This is all very silly...people who have to know how to spell a name will learn it and that's that." While it is true that some people will learn the spelling, it will eventually cause problems somewhere.

For example, one day a machine named "pythagoris" (sic) went awry and began sending a tremendous number of messages to the site administrator's computer. The administrator, who wasn't a very good speller to begin with, had never seen this machine before (someone else had set it up and named it), but he had to deal with it since it was clogging up the network as well as bogging down his own machine which was logging all the errors. Needless to say, he had to look it up every time he needed to spell "pythagoris". (He suspected there was an abbreviation, but he would have had to log into yet another computer (the local nameserver) to find out and the network was too jammed to waste time doing that.)

Avoid domain names.

For technical reasons, domain names should be avoided. In particular, name resolution of non-absolute hostnames is problematic. Resolvers will check names against domains before checking them against hostnames. But we have seen instances of mailers that refuse to treat single token names as domains. For example, assume that you mail to "libes@rutgers" from yale.edu. Depending upon the implementation, the mail may go to rutgers.edu or rutgers.yale.edu (assuming both exist).

Avoid domain-like names.

Domain names are either organizational (e.g., cia.gov) or geographical (e.g., dallas.tx.us). Using anything like these tends to imply some connection. For example, the name "tahiti" sounds like it means you are located there. This is confusing if it is really somewhere else (e.g., "tahiti.cia.gov is located in Langley, Virginia? I thought it was the CIA's Tahiti office!"). If it really is located there, the name implies that it is the only computer there. If this isn't wrong now, it inevitably will be.

There are some organizational and geographical names that work fine. These are exactly the ones that do not function well as domain names. For example, amorphous names such as rivers, mythological places and other impossibilities are very suitable. ("earth" is not yet a domain name.)

Don't use antagonistic or otherwise embarrassing names.

Words like "moron" or "twit" are good names if no one else is going to see them. But if you ever give someone a demo on your machine, you may find that they are distracted by seeing a nasty word on your screen. (Maybe their spouse called them that this morning.) Why bother taking the chance that they will be turned off by something completely irrelevant to your demo.

Don't use digits at the beginning of the name.

Many programs accept a numerical internet address as well as a name. Unfortunately, some programs do not correctly distinguish between the two and may be fooled, for example, by a string beginning with a decimal digit.

Names consisting entirely of hexadecimal digits, such as "beef", are also problematic, since they can be interpreted entirely as hexadecimal numbers as well as alphabetic strings.

Don't use non-alphanumeric characters in a name.

Your own computer may handle punctuation or control characters in a name, but most others do not. If you ever expect to connect your computer to a heterogeneous network, you can count on a variety of interpretations of non-alphanumeric characters in names. Network conventions on this are surprisingly nonstandard.

Don't expect case to be preserved.

Upper and lowercase characters look the same to a great deal of internet software, often under the assumption that it is doing you a favor. It may seem appropriate to capitalize a name the same way you might do it in English, but convention dictates that computer names appear all lowercase. (And it saves holding down the shift key.)

Now that we've heard what not to do, here are some suggestions on names that work well.

Use words/names that are rarely used.

While a word like "typical" or "up" (see above) isn't computer jargon, it is just too likely to arise in discussion and throw off one's concentration while determining the correct referent. Instead, use words like "lurch" or "squire" which are unlikely to cause any confusion.

You might feel it is safe to use the name "jose" just because no one is named that in your group, but you will have a problem if you should happen to hire Jose. A name like "sphinx" will be less likely to conflict with new hires.

Use theme names.

Naming groups of machines in a common way is very popular, and enhances communality while displaying depth of knowledge as well as imagination. A simple example is to use colors, such as "red" and "blue". Personality can be injected by choices such as "aqua" and "crimson".

Certain sets are finite, such as the seven dwarfs. When you order your first seven computers, keep in mind that you will probably get more next year. Colors will never run out.

Some more suggestions are: mythical places (e.g., Midgard, Styx, Paradise), mythical people (e.g., Procne, Tereus, Zeus), killers (e.g., Cain, Burr, Boleyn), babies (e.g., colt, puppy, tadpole, elver), collectives (e.g., passel, plague, bevy, covey), elements (e.g., helium, argon, zinc), flowers (e.g., tulip, peony, lilac, arbutus). Get the idea?

Use real words.

Random strings are inappropriate for the same reason that they are so useful for passwords. They are hard to remember. Use real words.

Don't worry about reusing someone else's hostname.

Extremely well-known hostnames such as "sri-nic" and "uunet" should be avoided since they are understood in conversation as absolute addresses even without a domain. In all other cases, the local domain is assumed to qualify single-part hostnames. This is similar to the way phone numbers are qualified by an area code when dialed from another area.

In other words, if you have choosen a reasonable name, you do not have to worry that it has already been used in another domain. The number of hosts in a bottom-level domain is small, so it shouldn't be hard to pick a name unique only to that domain.

There is always room for an exception.

I don't think any explanation is needed here. However, let me add that if you later decide to change a name (to something sensible like you should have chosen in the first place), you are going to be amazed at the amount of pain awaiting you. No matter how easy the manuals suggest it is to change a name, you will find that lots of obscure software has rapidly accumulated which refers to that computer using that now-ugly name. It all has to be found and changed. People mailing to you from other sites have to be told. And you will have to remember that names on old backup media labels correspond to different names.

I could go on but it would be easier just to forget this guideline exists.

Conclusion

Most people don't have the opportunity to name more than one or two computers, while site administrators name large numbers of them. By choosing a name wisely, both user and administrator will have an easier time of remembering, discussing and typing the names of their computers.

I have tried to formalize useful guidelines for naming computers, along with plenty of examples to make my points obvious. Having been both a user and site administrator, many of these anecdotes come from real experiences which I have no desire to relive. Hopefully, you will avoid all of the pitfalls I have discussed by choosing your computer's name wisely.

Credits

Thanks to the following people for suggesting some of these guidelines and participating in numerous discussions on computer naming: Ed Barkmeyer, Peter Brown, Chuck Hedrick, Ken Manheimer, and Scott Paisley.

This essay first appeared in the Communications of the ACM, November, 1989, along with a Gary Larson cartoon reprinted with permission of United Press Syndicate. The text is not subject to copyright, since it is work of the National Institute of Standards and Technology. However, the author, CACM, and NIST request that this credit appear with the article whenever it is reprinted.

References

[1] Libes, D., "Choosing a Name for Your Computer", Communications of the ACM, Vol. 32, No. 11, Pg. 1289, November 1989.

[2] Mockapetris, P., "Domain Names - Concepts and Facilities", RFC 1034, USC/Information Sciences Institute, November 1987.

Security Considerations

Security issues are not discussed in this memo.

-- JoeBrandt - 26 Apr 2005

This topic: Main > TWikiUsers > JoeBrandt > MachineNamesProposal
Topic revision: 2005-06-16, JoeBrandt
This site is powered by FoswikiCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding NRAO Public Wiki? Send feedback