Installation¶

Download¶

Click here for all iLauncher downloads

Click here for Windows Upgrade Help

IMPORTANT: After September 05, 2022 the default and dart plugin channels will only be compatible with version 3.2.0 and later

v3.12.1¶

Fixes issue where the CHANNEL_ROOT cache for a given channel may not exist
All subscribed channels will now attempt to update on iLauncher start

v3.12.0¶

Fixes server error for certain reconnect scenarios
Fixes local user and hostname detection when running within Analytics Gateway
Fixes warning for path property in plugin definition files (now allows null values)
Improves pkinit/kinit error detection for “Resource temporarily unavailable…”
Improves job’s page debug mode to also hide warnings but not hide stop plugin messages
Removes Centennial’s SmartQ feature file which was causing a SmartQ results anomaly
Adds new system Carpenter at ERDC

v3.11.0¶

Fixes issue in HPC Launcher where authentication error would show even when user has a valid SSO token
Fixes issue where whitespace around a channel’s path (not spaces in path) would cause Add Custom Channel to fail
Improves Kerberos authentication error messages to be more easily understood by users
Adds “Debug mode” checkbox to job page to reduce system error notifications to users. Many of these errors can be noise and not indicate a successful or failed application and/or job launch process.
Removes decommissioned systems Onyx and Pearl
Removes Jean’s integration modal
Removes deprecated PostMessage passing that was created for the Portal’s AppManager

v3.10.1¶

Fixes issue when queue_stats.csv could fail to download causing iLauncher to crash
Adds retry for job logging to ignore ssl only if first request failed

v3.10.0¶

Fixes issue introduced in v3.9.0 where a new user would get a FileNotFound error when running iLauncher for the first time
Fixes issue where the job’s cache file, missing certain keys, could cause iLauncher to not start
Fixes issue where navigating to another page while a modal was open would cause all of iLauncher to be “greyed” out
Fixes issue where a Mac CI build could result in a false positive success (internal)
Adds support for a static custom_systems.json file (initially inteded for use by HPC Access Point)
Adds several improvements to the startup process
- automatic checks for authentication (does not require triggers by UI)
- automatic checks for system status (if kerberos authentication)
- automatic checks for channel updates (if kerberos authentication)
- does not force the queue stats file to be downloaded (only downloads if file is over an hour old)
Improves HPCMP CAC auth on Windows by automatically adding PCSDLL to Window’s registry
Improves error messages on kerberos authentication
Removes deprecated Post Message support for partial job forms
Removes the toast to tell users about applications now being launched via a toast message

v3.9.0¶

Fixes issue parsing and interpreting Reef’s show_storage output
Fixes issue where “Add Channel” errors could take up the entire screen
Fixes issue where an existing iLauncher folder on a Windows user’s Desktop would cause iLauncher to fail
- Now using C:\Users\<username>\Desktop\iLauncherUtils for necessary iLauncher components
Fixes a race condition on Linux that would cause “Open Terminal” to compute node to sometimes fail
Fixes issue where deleting a login node job would cause a server error
Changes “Job Delete” behavior to only remove the job from UI if the job was successfully deleted on remote system
Changes the application “Action” icons within Job’s Table to a dropdown menu
Improves CAC authentication experience for new and/or unfamiliar users
- Adds instructions within Kerberos modal on how to get a ticket
- Updates CAC Instructions modal with the user’s path to libcackey.dll so they can easily copy/paste this path
Adds $CHANNEL_ROOT support for plugins
- A plugin’s command, stop, parameter values, and launch script can now use the $CHANNEL_ROOT environment variable
- Backwards compatibility should exist for plugins that do not use $CHANNEL_ROOT
Adds plugins per channel view within the Plugins tab on the Settings page
Adds kereros authentication on server start to avoid refreshing UI every time the Flask server is restarted (developers only)

v3.8.0¶

Fixes issue where some non-http apps (Neo4J database) would trigger a failed alert when the SSH tunnel was established to the remote service as expected
Fixes issue where plugin images would display in a “side-by-side” format
Adds Navy system Nautilus

v3.7.2¶

Fixes performance issue when loading large log files within the Job Viewer page
Fixes show_storage command for the AG’s whitelisted SSH commands
Fixes issue where EventSource subscriptions (SSEs) would be disconnected by browser
Fixes issue with false positive success message on add custom channel
Adds terminal links for LocalCloud system for HPCLauncher (AG’s iLauncher)
Adds an “Export Logs” feature within the Log Viewer page
Adds warning alert for plugins that failed to load when adding, subscribing, or updating plugin channels
Internal: Moves plugin schema out of iLauncher repo

v3.7.1¶

Fixes issue where slurm jobs would not be deleted

v3.7.0¶

Fixes issue where certain plugins would not show in dropdown for an Analytics Gateway
Fixes issue where certain systems (WSU’s Fusion) could not update plugin channels
Fixes issue where a channel would fail to update or be added because the channel’s “mirror” property was null
Fixes issue where a plugin’s “path” value would not be added to the proxied URL by AG (HPCLauncher only)
Fixes issue where refreshing Show Storage and SmartQ pages would cause server heartbeat to timeout
Fixes issue with SSH key authentication to certain systems
Adds new ARL system Jean
Adds “show_storage” checks for Analytics Gateway systems
Adds a “Load Form” functionality to the “Add Plugin” feature
Adds DSRC “center” attribute to systems (for Nexus project)
Improves login node job cleanup
Removes decommissioned system Centennial

v3.6.1 (stable)¶

Fixes issue where “infinite” walltime from show_queues would cause Hours dropdown to be empty
Fixes issue where AnalyticsGateway jobs would not show in jobs table
Updates AnalyticsGateway systems metadata with “hub-to-ag” change

v3.6.0¶

Fixes issue where Windows plink.exe and ssh.exe processes would linger after a job was successfully deleted
- iLauncher should now always clean up local child procs when properly shutdown
Fixes issue where restarting iLauncher could incorrectly show an application’s tunnel and server as ‘Up’
- Since iLauncher should now kill all local tunnels when shutdown, if a user has any jobs running then their applications will reflect as ‘Tunnel: Down’ and ‘Server: ?’ after an iLauncher restart
Fixes issue where Windows could not reconnect to compute node applications
Fixes issue where applications could not reconnect if the remote socket was created by a gocat prcoess
Fixes issue where applications running on Reef would not have tunnel messages
Fixes issue where applications in a multi-app-plugin may not have an open notification because one of the application’s had failed
Fixes issue where checking remote socket “in-use” would always be a false negative
Fixes issue where user would get permission denied when writing to a local key file
Fixes issue where deleting a job could fail to kill the remote application
Fixes issue where deleting a job would show a warning that the scheduler suddenly dropped the job
Fixes issue where parsing Reef’s show_queues would fail on the string ‘infinite’
The remote environment check errors should be suppressed. They will show in logs but not in UI
Jobs should now run on Reef’s pecoc nodes just like any other node on Reef
Adds log rotation on a fixed size rather than clearing logs on every iLauncher start
Adds round-robin behavior to any system with less than 3 login nodes
- Failed ssh/scp calls should now retry just like systems with multiple login nodes

v3.5.0¶

Fixes issue where stopping a plugin would not always remove the plugin from the UI
Fixes issue where the Plugin Editors toolbar would hide the Services dropdown menu
Adds System Editor feature
- Users can now add custom system via a UI rather than manually updating the systems.json file
- Systems added through this feature should persist after iLauncher upgrades
Adds open terminal to AnalyticsGateway (AG) systems
- Instead of launching a local terminal like HPCMP systems this will simply open a web page to the authenticated users terminal in AG
Adds several improvements to File Manager service
- Feature to change ownership and permissions after file is uploaded to remote system
- Adds save form feature
- Adds redo feature
- Adds open terminal button to remote systems
Adds filters to Log Viewer service
- Filter by severity
- Invert timestamp column
Adds support for message of the day banners
Removes the iLauncher 3.0 modal
Removes most plugin icons from the iLauncher build. Plugin and application icons should now be packaged with their corresponding plugin definition file as base64
Removes port 2020 for AFRL systems compatibility with latest SSO configuration
When selecting a job, by clicking on the associated row in job table, the first application’s tunnel output should automatically be selected

v3.4.1¶

Fixes browser caching issue where users would not always get the updated Java Script when opening a new version iLauncher
- Users may still need to hard refresh their browser tab when opening this version for the fix to take effect
Improves login node job cleanup
- Adds 24 hour timer for all login node jobs where both the job and its applications will be automatically purged after timer expires
Adds support for Onyx’s SSO on port 22

v3.4.0¶

Fixes bug where setting the custom home path via ILAUNCHER_HOME environment variable could cause failures during setup process
Fixes bug where loading a saved form would fail when a plugin’s application and/or parameter names had been changed since the form was saved
Fixes bug where reconnect would fail because of variable referenced before assignment error
Fixes issue where kerberos authentication window could fail to pull to foreground (Windows only)
Fixes issue where ordering of dictionary matters for a partial form submission (Portal’s App Manager only)
Major updates requiring user interaction to open an application
- iLauncher will no longer auto-open a browser tab when an application is ready
- User will recieve an “App Ready” toast in the UI requiring the user to click an “Open” button
- When applicable, user will recieve an “App Failed” toast in UI with links to the Log Viewer page and a link to submit a help desk ticket to iLauncher support
- The iLauncher browser tab will now reflect the number of notifications available for user awareness
Adds checks for disk quota limits per system
- Runs show_storage command on target system and provides output via new tab “Show Storage” under Services dropdown in navigation bar
- Users should now recieve a warning when selecting a system in which show_storage reflects their disk quota has been exceeded
Adds marginal improvements for the length of time taken to launch jobs. Improvements are best seen with login node jobs.
Adds support for external iLauncher service request form
- Users can now submit issues or feature requests via an HTML form rather than writing an email directly
- Users can respond to tickets via email just as before
Removes Vulcanite from available systems

v3.3.1¶

Fixes issue where a shared user would cause SmartQ results to fail
Adds HYCOM channel to packged plugin channels
Adds scheduler email support for PBS, LSF, and Slurm
Adds support for Portal’s App Manager to show job submissions with a postmessage
Adds ssh option “-J” to support jump hosts
Adds system Topsy, a stand-alone Reef node for persistent services
Upgrade to Bootstrap 5

v3.3.0¶

Fixes issue where Onyx internal SSH IP had changed
Fixes issue where an ended job on Scout would not clean up properly
Fixes issue where an application’s Tunnel Status and Remote Server Status would not properly reflect the actual state
Fixes issue where channel update would fail to remove deprecated plugins allowing users to select plugin that would not work
Adds parameter validation feature
- User can add a valid regex via the Plugin Editor and both the UI and server code will validate the user’s input against the provided regex
Adds feature for HPC access via shared accounts
Adds feature for Portal to submit partial forms to UI
Adds new route ‘/jobs’ for Portal
Adds link via plugin cards to Plugin Editor so the selected plugin will auto-load
Adds text box for custom Queue input along with the original dropdown of pre-defined queues
- The test box will auto complete with the known queues for each system
- This should allow submission to ARS queues
- The Time dropdown will now allow the max time for each available queue
Adds multi-select param type support
Removes Blackbird and Hokulea from available systems

v3.2.0¶

Fixes issue where file transfers would fail when both source and destination were remote systems and one of those systems was an Analytics Gateway instance
Fixes issue where additional properties in plugin definition files would cause the plugin to not load
Fixes issue where a channel would fail to update
Fixes issue where stderr would show in UI when command had a 0 return status (mostly affects Windows)
Improves channel actions (subscribe, unsubscribe, and update) so that errors are more informative
Adds plugin and application documentation support for channels
- See these examples on how to access documentation within iLauncher
- This feature will break backwards compatibility once the channels are updated on remote systems and has been addressed
Adds a node monitoring viewer plugin to default plugin channel
- Basic stats such as cpu usage, mem usage, load average, hostname, and account number are tracked on a per job basis
- Currently only supports single node jobs
- Users can “Opt Out” via Settings page (“Opt In” by default)
Adds confirmation modal when deleting a job

v3.1.1¶

Fixes issue where SmartQ results failed to show
Fixes issue where too many ssh keys on user’s local system would cause ssh tunnel to compute node to fail

v3.1.0¶

Tunnel messages can be viewed on a per application basis versus a plugin level view
- Adds icon in jobs table for each application’s tunnel output
- Updates Job Info tab in Job’s table with a dropdown menu for each running application
Drastically improves application launch process for multi-app plugins
- A single application’s failure(s) should not cause other applications to also fail
- Time to launch all applications is greatly improved by launching all applications back-to-back rather than waiting for previous application to launch successfully
- Adds support for a “depends_on” key/value pair for each application when application dependencies are necessary
Improves plugin updates per channel to use the plugin hash (md5sum) and not the version
Adds improvements to Plugin Editor’s save image aspect ratio
Adds conditions to exit early when certain conditions are met with a dialogue box explaining the issue and recommending a solution
- Windows permissions on certain folders and files
- Existence of certain files in Windows that will cause iLauncher to fail
Adds improvements for job launch menu when side-bar is expanded
Adds Add Plugin feature back to Gateway systems
Adds Blackbird and Warhawk to SmartQ results
Adds Edit/Save feature to Setting Page, Systems Tab to avoid issue where user fails to click Confirm
Fixes issue where Add Channel icon looked like a check box but was not (changed to different icon)
Fixes issue where Gateway systems Node Types would be empty
Fixes issue where Gateway channel update would fail
Fixes issue where Plugin selection could have many duplicate plugins
Fixes issue in SmartQ where Path Requirement check would give a false negative result
Fixes issue where acknowledging a Remote System Environment Check alert would cause a server error
Fixes issue where unloading a job submission form would not reset form options
Fixes issue where the System’s modal for Gateway systems would show incorrect Node Types
Fixes issue where no application parameters would show during Job Submission
Fixes issue where gateway job would fail to show in UI

v3.0.2¶

Fixes issue where subscribing to a channel with only one plugin could fail to download to local system
Fixes issue where unsubscribing from a custom channel would cause a KeyError
Fixes issue where UI failed to alert user when a new version of iLauncher was available for download

v3.0.1¶

Fixes issue where Windows would not automatically update user’s registry with accepted remote hosts

v3.0.0¶

Major changes to plugins
- Plugins are now provided by channels which are defined on remote systems
- Plugins provided by default and other packaged channels will be updated automatically on iLauncher start
- A new “Plugins” tab has been added to Settings page to manage channel subscriptions
Adds support for plink ssh session sharing which should help with command timeouts to remote systems (Windows only)
Fixes issue where krb5.conf would not be set properly causing kerberos authentication issues
Fixes issue where a user’s existing kerberos keystore would cause iLauncher’s authentication with kerberos to fail
Fixes issue where subproject data would take a very long time to show in UI
- The first time loading data will be slow but subsequent attempts should be nearly instant
Fixes issue where scheduler paths on remote system would be missing a backslash “/”

v2.10.0 (stable)¶

Adds Blackbird (AFRL) support
Adds initial support for forwarding credentials to HPCs when used from an IT Gateway
Adds ‘Default’ web browser option in Settings
Adds documentation for all flask endpoints (accessible via link in About page)
Improves remote environment checking
Fixes broken buy credit link for Gateway systems
Fixes bug where a long running iLauncher application would spam system status checks
Fixes bug in Plugin Editor where saving a plugin without a description would cause the plugin to not load in the editor properly
Fixes bug where kerberos authentication on a Mac would show user as authenticated, but their ticket was actually expired
Fixes bug where open terminal would fail if the remote host’s IP was changed
Fixes bug where walltime of 0.5 would error

v2.9.1¶

Fixes kerberos authentication issues on Windows due to HPCMP kerberos server upgrades
Fixes bug where job submissions to Reef would fail if greater than 23 hours
Adds new AFRL system Warhawk
Adds remote environment checks to assist in detecting misconfigured remote environments
- Results can be viewed in the Job Info tab per job
Adds default tab feature on the Home page
Minor updates correcting SCOUT’s system and scheduler information
Moves SmartQ tab from Home page to Services dropdown on navbar

v2.8.2¶

Adds support for SCOUT and LSF
- Available plugins are Jupyter and TTYD (web terminal)
Adds support for Microsoft OneDrive
Fixes bug on Windows where tunneling over previously used port was allowed
Fixes bug where the same local port could be assigned to two different applications
Fixes bug where PBS launch scripts were not being cleaned up on HPC
Fixes bug where Open Terminal feature would fail if first HPC login node was down
Show Usage and Show Queues data is now updated on an hourly bases

v2.7.0¶

Provides latest kerberos kits (Mac, Windows, and Linux) to work with KDC upgrades on Nov 1, 2021
Adds Plugin Editor feature
Fixes File Manager error when $PROJECTS_HOME was undefined
Updates node definitions in systems.json
Adds more intuitive error messages for yubikey authentication
Authentication modal will stay open with “Your password will expire …” message when appropriate
Updates to UI for more uniform page headers
Adds new plugin OpenSearch

IMPORTANT: All versions below will not work with HPCMP after November 1, 2021

v2.6.0¶

Fixes bug where iLauncher could fail to launch properly
Fix lost authentication state bug for Windows
SmartQ now considers selected account when determining queue
FileManager estimates transfer time if coming from localhost
SmartQ integration with FileManager to transfer missing requirements
External log files can now be ‘uploaded’ to be viewed in the native log viewer
Fix FileManager crash when spaces are in paths
ElasticSearch available on Reef and as a shared database
Neo4j plugin available
Terminal plugin available on login nodes
Allow environment variable to disable CAC Authentication option
Fixed issue where log files were not displayed
Fixed issue where deleting a login node job could freeze the UI
Fixed issue where selecting node type after clearing HPC form would cause form to be stuck in a broken state

v2.5.0¶

Major updates to SmartQ feature
- Produces “cost” and data-driven “wait-time” estimates for iLauncher jobs optimized across all HPCMP systems and Cloud instances
- Selecting an item in the Results table will now update all fields in Cloud or HPC form except the Plugin field
Adds new UI element for show_queues data for every available system
Adds show_queues data to Home page HPC tab
- Both queues and node types info modals are now available for any selected system
Adds Code Server plugin for login nodes
Adds warning when submitting to a full HIE queue
- Utilizes show_queues data from selected system
Updates all HPCMP plugins to use singularity 3+ by default
Updates TensorFlow to versions 2.4 (gpu nodes) and 2.5 (other nodes) for Jupyter and Code Server plugins
Fixes a bug where using the “Stop Plugin” feature on Onyx would fail

v2.4.1¶

Major Windows performance improvements
- Adds plink connection sharing
- Fixes tunneling to Onyx since latest STO
- Fixes race condition that could cause tunnel to compute node to fail

v2.4.0¶

Fixes bug where Queued job could be lost / ignored by iLauncher if user restarted iLauncher while job was in Queued state
Fixes bug where delete job could cause iLauncher server to become unresponsive requireing a restart
Fixes File Manager bug where spaces in path would cause errors
Fixes Add Plugin bug where previous failed attempt would cause adding new plugin to also fail
Fixes issue where iLauncher on linux could fail to open if openblas libraries where not present on local system
Adds support for new Navy DSRC system Narwhal
Adds TensorBoard plugin for login nodes
Adds Account option for Reef
- Users accounts should now show in Account dropdown
Major updates to plugin documentation
- Adds better plugin descriptions
- Adds “hello world” examples in online documentation
Changes all anaconda modules to conda-forge modules

v2.3.0¶

Built-in File Manager: Sync files and folders between
- Local computer to/from an HPC
- Local computer to/from an Analytics Gateway Cloud instance
- HPC to/from an HPC
- HPC to/from an Analytics Gateway Cloud instance
Anytime Plugin Feature - Dynamically add or remove a plugin on a running node without queueing a new job
Adds audible job expiration warning - ensures time to save work when a node is about to expire
Fixes Onyx status availability icon; Onyx was showing down after show_usage structure changed
Fixes plugin “stop command” used by custom user plugins leveraging certain iLauncher state variables
Defaulted Talon to a “disabled” state (overridable in Settings)
Removes duplicate entries of in the Pearl MLA and Onyx job tables
Upgrades Codeserver to support a built-in browser
Establishes direct Onyx batch node terminal connections for CSH users

v2.2.1¶

Fixes bug where a user’s predefined kerberos path would cause iLauncher to crash

v2.2.0¶

Adds support for Slurm
Adds support for Reef (MHPCC)
Adds User-Defined / Constrained Smart Queueing (SmartQ) feature
Adds default queue failover when HIE queue on target system is full
Adds RShiny/Rstudio plugin
Adds feature for users to set their own icon in plugin file
Adds support for SSO keys
Improves job cleanup
Updates FileBrowser plugin to remove hidden files
Plugins for Hokulea should now accurately reflect
Fixes bug where reconnecting to a remote application would try to kill PID 0
Fixes major performance impact to web browser when using log viewer
Fixes issue where false negative job submission errors would show in UI
Fixes bug where hours field could be incorrect after loading a form

v2.1.2¶

Adds user’s accounts from HPC’s show_usage command to Account dropdown list
Adds load / save form feature for Cloud based systems
Cleans up remote system file clutter by keeping launch files under a hidden directory
Filters false negative errors from spamming UI
Updates plugin files to have specified icon paths (plugin and application specific)
Fixes bug on deleting a Cloud job could cause an ‘Unauthorized’ error
Fixes bug where credit cost calculation would not trigger
Adds hooks for iLauncher to run in the HPCMP Portal

v2.0.1¶

Bug fix to allow run for brand new Windows users.

v2.0.0¶

New Streamlined User Interface
Access to submit jobs to HPCs and the Public Hub, AWS GovCloud and Azure GovCloud all from iLauncher dashboard.