Skip to content

HTC Exercise 1.1: Log In and Look Around

The goal of this first exercise is simply to log in to the local submit server and look around a little bit, which will take only a few minutes.

If you have trouble getting SSH access to the submit server, ask the instructors right away! Gaining access is critical for all remaining exercises.

Logging In

Today, you will use CHTC's local HTC Pool via an access point named learn.chtc.wisc.edu using the UW NetID account you set up. (This account is separate from the account you set up for the OSG Connect service, which you'll use starting tomorrow to run on OSG's Open Science Pool.)

To log in, use a Secure Shell (SSH) client.

  • From a Mac or Linux computer, start the Terminal app and run the below ssh command, replacing <USERNAME> with your NetID username:
$ ssh <USERNAME>@learn.chtc.wisc.edu
  • On Windows, we recommend a free client called PuTTY, but any SSH client should be fine.

If you need help finding or using an SSH client, ask the instructors for help right away!

Running Commands

In the exercises, we will show commands that you are supposed to type or copy into the command line, like this:

username@learn $ hostname
learn.chtc.wisc.edu

Note

In the first line of the example above, the username@learn $ part is meant to show the Linux command-line prompt. You do not type this part! Further, your actual prompt probably is a bit different, and that is expected. So in the example above, the command that you type at your own prompt is just the eight characters hostname. The second line of the example, without the prompt, shows the output of the command; you do not type this part, either.

Here are a few other commands that you can try (the examples below do not show the output from each command):

username@learn $ whoami
username@learn $ date
username@learn $ uname -a

A suggestion for the day: try typing into the command line as many of the commands as you can. Copy-and-paste is fine, of course, but you WILL learn more if you take the time to type each command yourself.

Organizing Your Workspace

You will be doing many different exercises over the next few days, many of them on this submit server. Each exercise may use many files, once finished. To avoid confusion, it may be useful to create a separate directory for each exercise.

For instance, for the rest of this exercise, you may wish to create and use a directory named intro-1.1-login, or something like that.

username@learn $ mkdir intro-1.1-login
username@learn $ cd intro-1.1-login

Showing the Version of HTCondor

HTCondor is installed on this server. But what version? You can ask HTCondor itself:

username@learn $ condor_version
$CondorVersion: 9.11.0 2022-07-19 BuildID: 597572 PackageID: 9.11.0-0.597572 RC $
$CondorPlatform: x86_64_CentOS7 $

As you can see from the output, we are using HTCondor 9.11.0.

FYI: Background information about HTCondor version numbers

HTCondor always has two types of releases at one time: long-term-support (LTS) releases and feature releases. HTCondor 9.0.x is considered an LTS release, indicated by a 0 in the second digit. Within one LTS series, all versions have the same features (for example 9.0.5 and 9.0.10 have the same set of features) and differ only in bug and security fixes.

HTCondor 9.11.0 is the latest feature release series of HTCondor. You know that this is a feature release because the second digit (i.e. 11) is greater than 0. CHTC is usually running the latest feature release as the local CHTC Pool is somewhat of a final testing ground for new features. Other HTCondor pools and submit servers that you use outside of CHTC (including the OSG submit server you'll use later) may run different versions. In general, the user-facing HTCondor features in 9.0 forward are mostly the same, but you may see some differences in the format of output from condor_ commands or in more advanced or non-user features.

Reference Materials

Here are a few links to reference materials that might be interesting after the school (or perhaps during).

  • HTCondor home page
  • HTCondor manuals; it is probably best to read the manual corresponding to the version of HTCondor that you use. That link points to the latest version of the manual, but you can switch versions using the toggle in the lower left corner of that page.
  • Center for High Throughput Computing, our campus research computing center, and home to HTCondor and other development of distributed computing tools.