Overview:

Most Next Generation Sequencing (NGS) analysis is done via the command line with typed text commands rather than using Graphical User Interfaces (GUIs) that are more common in day to day computer use. Additionally, rather than analysis being confined to your personal computer/laptop it is often beneficial to access shared computer resources such as those at TACC. This is done via Secure Shell (SSH) programs. Windows10 began including an "OpenSSH Client" package first as an optional feature before enabling by default. Installation of this feature enables access to some key commands on the windows command line, or power shell application. If you are already experienced with logging into remote computers on the command line via other programs, it is recommended that you continue to us those programs, but please note support may be more limited.

Tutorial Objectives:

1. Ensure "OpenSSH Client" is activated on your computer
2. Launch powershell command line interface.
3. Use ssh command to log into lonestar5 on TACC.

Launching powershell : 

Use one of the following to launch the powershell application:

1. hit the windows key on your keyboard and type out powershell
2. On the start menu expand "Windows PowerShell"

In either case you may see 2 versions. 1 titled "Windows PowerShell" and 2 titled "Windows PowerShell (x86)". On my wife's computer, the "correct" one is the one that lacks the (x86). You may need to experiment with both by typing ssh and seeing what happens. In either case feedback to the instructor of what worked for you may help make this more straight forward for future students.

Good response showing ssh command is working and you can continue to use the ssh command to log into lonestar5:

Bad response showing you need to check the alternative program or skip down to the troubleshooting section:

Use ssh command to log into lonestar5: 

You will need 4 pieces of information to log into lonestar:

1. Your TACC userID

   1. If you do not have a TACC ID sign up for one here.

2. Hostname of the remote computer you are trying to log into

   1. For this class the hostname will be "ls5.tacc.utexas.edu" for lonestar5.

3. Your TACC password

   1. You should have chosen this when you signed up for your account. You can reset your password here if you have forgotten it.

4. 2 factor authentication code

   1. This page describes the 2 factor authentication in general terms.

   2. This page is used to set it up for your account.

   3. This will either be displayed on the TACC app if you choose to install it on your phone, or will be sent to your phone via a text message after you enter your password.

The ssh command:

The ssh command consists of 3 parts:

1. The letters 'ssh' followed by a space.
   1. This is used to tell your computer what command you are trying to run.
2. Your username followed by an @ symbol.
   1. This is used to tell the remote computer who is wanting access.
3. The hostname/address of the remote computer you are trying to access.
   1. This is often very similar to a typical website address without any preceding http:// or www
   2. Alternatively this may be a numerical IP address.

Note that username@hostname has no spaces in it.

Logging in:

ssh ded@ls5.tacc.utexas.edu

Once you hit return, you will see a prompt for entering your password.

Next you will be prompted for your TACC Token Code. This will either be the number displayed on the TACC app if you chose to install it or the number you receive via text message.

If you are successful you should see something that looks like this followed by additional information:

If you see a screen like the above, you can Return to the GVA2020 main page.

Troubleshooting ssh command:

It is strongly suggested that you verify the installation of the openssh client before checking for alternate powershell applications. If you have tried both of these troubleshooting options and are still having trouble please show up for one of the zoom help sessions or email your instructor to set up an alternate time.

Verify "OpenSSH Client" is installed:

Navigate through the following:

1. Windows settings
2. Apps
3. Optional Features

Scrolling down you should see an optional feature titled "OpenSSH Client". Note that this is different than "OpenSSH Server" which is not enabled by default and will not be needed for anything in this course.

If you do not see "OpenSSH Client" in optional features:

1. click "Add a feature" near the top. 
2. On the subsequent screen you should see OpenSSH client listed there with an option to install it once you click it.
3. Restart your computer once the installation is complete.
4. Retry launching the powershell application and retry the ssh command from above.

Check for alternate powershell.exe programs:

Navigate through the following in the windows file explorer:

1. "C" drive (or other drive containing your windows installation)
2. "Windows" folder
3. "System32" folder (note this is different than the "System" folder which may also be present)

Verify that there is a folder titled "OpenSSH". Should be if installation was successful above.

Inside of the System32 folder, enter powershell.exe in the search bar near the top right corner of the window.

If it returns a result, launch that instance of powershell and retry the ssh command from above.

Contact instructor via scheduled zoom time or email:

If both of the troubleshooting steps above failed, please show up during one of the scheduled zoom times or via email to schedule an additional time.

Windows10 OpenSSH alternatives:

As alluded to above, it is a relatively recent change by Microsoft/windows to recognize the usefulness of having an ssh client built into the operating system. As such, multiple alternatives exist for ssh clients. While the commands in this class will be centered around the powershell environment with OpenSSH enabled, in your future work you may decide to branch out into alternatives. If you are already familiar with an alternative program, you are encouraged to continue using it.

At the end of the class several alternatives will be listed here with links for your future consideration.

Return to the GVA2020 main page.