Logging In
Accounts on Hyak#
To log into any Hyak cluster you need an account created. Please review our documentation around accounts and get an account before moving forward with this tutorial. Click here for account documentation.
Two Factor Authentication#
UW policy is that all services (of which Hyak is one) require 2 factor authentication (2FA) by default as a security posture. Please go to this 2FA page and ensure you have 2FA enabled and configured before proceeding with this tutorial.
important
You need 2FA to log onto any Hyak cluster.
Logging in with SSH#
Once you have your account and 2FA set up, you can use ssh to log into klone. ssh is the most common method of logging into the cluster using the command-line interface (CLI).
Mac: If you're using any Linux or Linux-like system (e.g., MacOS, BSD) you probably already have a Terminal installed by default. Locate Terminal in your Applications directory on your Mac.
Windows:
Newer versions of Windows also have a new Linux sub-system so there are also native options to bring up a local terminal. Alternatively, you can login to klone using Command Prompt or Windows Powershell. Other options include PuTTY and Git Bash - use "The Bash Shell" with Git installed on Windows from this link for a video with install instructions..
Once you have a shell open in Terminal or any of the Windows options, you can login with the following command replacing the word UWNetID with your UW Net ID. Then you will be prompted to enter your password for your UW Net ID. You'll know it worked when you see the "klone hyak" welcome message printed to your screen.
warning
Too many incorrect login attempts will result in a IP ban, which could last up to an hour.
What's a shell?#
The shell is a program where users can type commands. With the shell, it’s possible to invoke complicated programs like climate modeling software or simple commands which we will discuss in the following sections. When you use ssh to log into klone, you are using a shell called Bash (the Bourne Again SHell — so-called because it’s derived from a shell written by Stephen Bourne) to interact with klone. If you were successful logging into klone you are looking at a shell. I like to think of it as my "view" into klone. This is where you will execute commands (i.e., activate programs to perform various activities like viewing documents, listing the contents of a directory, etc.)
note
In Linux CLI, the term "directory" is used instead of "folder" to describe a location where files are stored, reflecting its roots in UNIX where "directory" is the standard term. While "folder" is commonly used in graphical interfaces like Windows File Explorer and MocOS Finder. "Directory" is more accurate in the context of command-line operations.
When the shell is first opened, you are presented with a prompt, indicating that the shell is waiting for input.
Let's breakdown the pieces of our prompt:
- You will see your UW Net ID in place of the word UWNetID above, indicating you are logged in under your username for
klone. @klone-login01or@klone-login03indicates you have logged into the login node or the "front door" of Hyak. This is where all users start. Please review our list of Acceptable Uses of the Login Node [HERE]. We will discuss how to perform all other activities on compute nodes later on in this tutorial.- The
~symbol is shorthand for your Home directory. This is your default login "location" onklone. Please review our Storage Documentation [HERE] to learn about Disk Storage in your Home directory, which is an important concept for Hyak users.
In the next section, we will discuss your "location" on the klone file system and how to navigate from directory to directory.