This feature describes the implementation of an Automated License Diagnostic Utility
within Aspen HYSYS to address and resolve the "License Checkout Failed" error. Feature: License Health Monitor & Auto-Repair
The "License Checkout Failed" error typically occurs due to communication gaps between the client machine and the AspenTech License Server, or services like the Sentinel LDK License Manager SLM (Software License Manager) not running. Core Functionalities One-Click Diagnostic Service
: A standalone or integrated tool that checks the status of essential licensing services (e.g., Sentinel LDK License Manager
). If a service is found to be stopped, the utility provides a "Start/Restart Service" button to restore connectivity. SLM Configuration Validator : Automatically verifies that the SLM Configuration Wizard
is pointing to the correct server address or localhost. It should highlight mismatched version numbers or expired trial tokens. Port Connectivity Ping
: Tests communication over default licensing ports (such as TCP/IP ports used by FlexNet or SLM) to identify if a firewall is blocking the checkout request. License Reservation Alert
: If the failure is due to all seats being occupied or reserved for specific user groups (Error -101/147), the tool will display the current user list and estimated "check-in" times to improve transparency. User Experience (UX) Direct Troubleshooting
: Instead of a generic "Failed" popup, the error message includes a "Run Diagnostics" Visual Status Indicators : A dashboard showing: Service Status : Green (Running) / Red (Stopped). Server Reachability : Successful ping to the license server. License Availability : Number of seats currently free in the pool. Technical Requirements Permissions Aspen Hysys License Checkout Failed
: The utility must request administrative rights to restart Windows Services ( services.msc Compatibility
: Supports both standalone and network (floating) license configurations. user guide for this diagnostic utility? Fixing common licensing errors - Ansys Optics
The "Aspen HYSYS License Checkout Failed" error typically occurs when the software cannot communicate with the AspenONE SLM (Software License Manager) to verify authorization. Common Causes
Server Connectivity: The computer cannot reach the license server due to network issues, incorrect IP/hostname settings, or being disconnected from a required VPN/campus network.
Service Failures: The Sentinel RMS License Manager or Aspen SLM service is not running on the host or server machine.
Token Exhaustion: A "token leak" in some versions (e.g., v14.5 or v15.0) can cause tokens to remain checked out even after the application closes, eventually exhausting the pool.
Environment Configuration: The LSFORCEHOST or LSHOST environment variables may be missing or pointing to the wrong machine.
Version Mismatch: The license file may be outdated and not support the newer version of HYSYS being launched. Troubleshooting Steps Verify Server Configuration Open the AspenONE SLM License Manager from the Start menu. This feature describes the implementation of an Automated
Click Configure and ensure the correct server name or IP address is listed.
If the local machine is the server, ensure it is listed as localhost or by its specific computer name. Restart Licensing Services Open Windows Services (services.msc). Locate Sentinel RMS License Manager and Aspen SLM Service. Right-click and select Restart. Set Environment Variables
If the system cannot retrieve servers, manually add an environment variable. Go to System Properties > Advanced > Environment Variables.
Under System Variables, create a new variable named LSHOST and set its value to your license server's hostname. Address Token Leaks
For users on affected versions (v14.5+), an IIS reset may be required to flush the Process Data REST cache and release stuck tokens. Check Network Access
Ensure you are connected to your organization’s VPN if working remotely, as most institutional licenses require a direct network handshake.
Check that firewall ports (typically TCP 5093 for Sentinel RMS) are open.
Title: Technical Analysis and Resolution Strategies for "Aspen HYSYS License Checkout Failed" Errors lmgrd.exe aspen.exe (vendor daemon) SLMAdmin.exe
Abstract Aspen HYSYS is a critical process simulation tool used in chemical engineering for process design, optimization, and safety analysis. A common disruption to workflow efficiency is the "License Checkout Failed" error. This paper provides a technical analysis of the FLEXnet/FlexNet licensing architecture employed by AspenTech, categorizes the root causes of license checkout failures, and outlines a systematic troubleshooting methodology for system administrators and end-users.
lmgrd.exe and aspen.exe.On the client machine, verify basic connectivity:
ping <license_server_name>telnet <license_server_ip> <port_number>
Even if the server port is open, the client’s outbound rules might block the dynamic port range (1024–65535). Create an explicit Allow rule for:
lmgrd.exeaspen.exe (vendor daemon)SLMAdmin.exeWhat you see: “User 'jsmith' is not included in the license file.”
Cause: The license server has an INCLUDE list (security). You aren't on it.
Fix: Your IT admin must edit the license file:
INCLUDE HYSYS_Process USER jsmith
Then reread the license file using lmreread.