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:
- HPC Access Client (software package)
- 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
- Extract the Client Package:
Extract the downloaded zip archive onto your local system.
(Recommended location: C:\UserDATA or your preferred folder.) - 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
- Insert YubiKey: Ensure your assigned HPC YubiKey is plugged into a USB port on your local machine.
- Launch Client: Navigate to the HPC Client folder and run hpcClient.
- 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
- Accept Disclaimer: Review and accept the government system security banner/disclaimer.
- 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

