HPC Client

HPC Client Setup & Connection Guide

Prerequisites

  • An active NETL email address to access the NETL ServiceNow platform, communicate with the support team, and receive account credentials.
  • An active HPC LAN Account
  • A provisioned HPC YubiKey inserted into your local machine
  • Network connectivity (on-site NETL network, NETL VPN, or public internet access)

Step 1: Download Required Files

To access Joule, you must download two files:

  1. HPC Access Client (software package)
  2. Network Configuration File (HPCEEClient.cfg) specific to your current network location

Download the Client Software

Download Your Location-Specific Configuration File

  • Locate the configuration file list on the right side of this page and select the file matching your physical site and network connection:
    • Internal Networks: Admin LAN, Foreign National (FN) LAN, Research LAN, or SciLAN (available for all three NETL sites: PGH, MGN, ALB)
    • VPN Access: VPN East or VPN West
    • Off-Site Access: Off-Site / Public Internet

Browser & Download Troubleshooting

  • Recommended Browsers: Microsoft Edge or Google Chrome.
  • File Download Not Starting? If clicking does not start a download, right-click the configuration link and select “Save link as…” (Chrome/Edge).
  • Blocked by Government Computer Security?
    • Submit an application unblock/whitelist request via ServiceNow (IT Application/Network/Security Team): IT Service Center → Admin → Application Services → Application Assistance – Employee Center, and specify: HPC Client or HPCEEClient.cfg.
    • Alternatively, request the configuration file directly via ServiceNow (HPC Support Team): IT Service Center → Research Computing → HPC-JOULE → Support for HPC-JOULE – Employee Center

Step 2: Installation & Configuration

  1. Extract the Client Package:
    Extract the downloaded zip archive onto your local system.
    (Recommended location: C:\UserDATA or your preferred folder.)
  2. Place the Configuration File:
    Move or copy the downloaded configuration file (HPCEEClient.cfg) into the extracted HPC Client directory (the same folder as hpcClient).

Step 3: Launching & Connecting

  1. Insert YubiKey: Ensure your assigned HPC YubiKey is plugged into a USB port on your local machine.
  2. Launch Client: Navigate to the HPC Client folder and run hpcClient.
  3. Authenticate:
    • Enter your HPC LAN Username and Password.
    • Troubleshooting Login Failures: If you forgot your password or your account was disabled after 60+ days of inactivity, submit a reactivation request via ServiceNow: Support for HPC-JOULE – Employee Center
    • Troubleshooting Silent Connection Failures: The client fails silently if it cannot establish network connectivity or if a VPN masks the source IP address. In that case, submit a ServiceNow ticket for individual debugging: Support for HPC-JOULE – Employee Center
  4. Accept Disclaimer: Review and accept the government system security banner/disclaimer.
  5. Start Session: Create a New GUI Session to connect to the cluster and access desktop applications (terminal emulator, file manager, web browser, etc.).

    Support & Documentation

    • User Guide: Consult the HPC Client Documentation for cluster hardware overviews, environment setup, and job submission (sbatch/Slurm) guides.
    • Technical Assistance: If you encounter connection or client issues, submit a ticket via ServiceNow: IT Service Center → Research Computing → HPC-JOULE → Support for HPC-JOULE – Employee Center