Toolserver:Logging in

There are three servers which are accessible to users: willow, wolfsbane and nightshade. wolfsbane is the web server; unless you need to view the HTTP logs or debug a CGI problem, you wouldn't normally log in here. The two login servers, which you will want to be using most of the time, are willow and nightshade. These are identical, except that nightshade runs Linux, while willow runs Solaris. Which you use is up to you, but since willow</tt> is newer, it tends to be less loaded.

In the past, we provided a DNS alias login.toolserver.org</tt> that pointed to the current login server (e.g. nightshade</tt>). However, now that we have two login servers, it's not clear what login</tt> should do, so we recommend not using it. (However, the alias will still be provided for backwards compatibility.)

Authentication is done via SSH public keys. There is no need (and no possibility) to use a password to log in; your client will present the private part of your SSH key, and the server will grant you access. You should treat your SSH private key like a password; if it's compromised, you need to change it immediately. Your public key is not secret, and you can use the same public key on many systems.

(You might be asked to enter a passphrase when authenticating; this is not your Toolserver password, it's only used to encrypt your private key on your own computer, in case someone steals it. This passphrase is never sent to the Toolserver, and you can change it at any time.)

Using SSH on Windows
There are several SSH clients for Windows. The most popular is PuTTY, which is free and provides a GUI interface; other options include the Cygwin OpenSSH client (free, command-line), and SecureCRT (commercial, GUI).

Creating an SSH key
Your SSH client should provide a way to generate an SSH key. If it asks you what format to store the public key in, choose OpenSSH. If that's not an option, use IETF SECSH.

If your SSH client doesn't provide a way to generate a key, you can use puttygen</tt>, the PuTTY key generation utility:


 * Go to http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html
 * Download puttygen.exe</tt>
 * Open it and follow the instructions

Logging in with PuTTY
If you are using PuTTY, you need to fill in the "host name" with either willow.toolserver.org</tt> or nightshade.toolserver.org</tt>, then locate your SSH key (under Connection->SSH->Auth). Don't change any of the other settings, and click "open". Verify the fingerprint against http://fingerprints.toolserver.org. Then log in with your user name and the passphrase for your private key.

Most SSH clients provide a way to save session settings, so you don't have to enter the details every time.

Using SSH on Unix or Linux
Most modern Unix systems include the OpenSSH client. To generate a key, run:

$ ssh-keygen -t rsa

This will store your private key in $HOME/.ssh/id_rsa</tt>, and your public key in $HOME/.ssh/id_rsa.pub</tt>. You can use different filenames, but these are the default filenames, so it's easiest to not change them.

To log in to the server, run:

$ ssh @ .toolserver.org

If your Toolserver username is the same as your local username, you can just use

$ ssh .toolserver.org

If you would rather use a GUI client, a version of PuTTY (above) is also available for Unix.

Getting in
When you log in, you might be asked to confirm the toolserver's key fingerprint. They are available at https://fingerprints.toolserver.org.

After logging in, you will be presented with:
 * The current message-of-the-day
 * Whether you have new local mail
 * The date, time and location of your last login
 * Whether you are already logged in, and where from
 * Whether you have any detached screen</tt> sessions
 * The date your account will expire
 * Whether you have exceeded your disk quota
 * Any new system news

Occasionally, you might have a reason to log into wolfsbane</tt>, e.g. to examine the web server logs. Because home directories are shared between both systems, you can use the same SSH key to log in; follow the same procedure as above.