Lex Allocation Management System

Lex is a system for managing your high-performance computing (HPC) resource assignments, account information, and tracking utilization.

Access

An NREL HPC account is required to access Lex. To log in to Lex, open a web browser to https://hpcprojects.nrel.gov. Log in with your NREL HPC username and password. An OTP token is not required to authenticate.

Requesting an Allocation

The system resource allocation request form is available on Lex. For further information on allocations and how to request one, please visit the Resource Allocations page.

Managing Users

The allocation PI, Project Lead, and Alternate Project Lead can use Lex to manage the allocation entitlement list.

To add and remove users, navigate to the "Manage Users" page for the allocation.

To add users, click the "Add User" button and enter the user's email. Repeat for any additional users. Click "Delete" to remove users from the allocation entitlement list. Be sure to click "Submit Changes" to apply your changes.

Users who have an existing NREL HPC account will be added to the allocation group and permissions will be granted within 24 hours. Otherwise, they will be sent an email invitation to request an account and will be listed in the "Pending Invitations" list until their account has been created. You can cancel an invitation by selecting the "Cancel" button and clicking "Submit Changes".

Tracking Allocation Usage

AU Usage Data

The sidebar on the Lex homepage shows all of the allocations that you have access to. Select a project to check the resource usage.

On the "AU Use Report" page, the "Project Use" section lists all of the systems that the project has an allocation on and corresponding AU usage. The "AUs Charged by User" section provides a breakdown of AU usage by user for the project. By default, the data displayed shows each user's total usage across all systems. To filter this to show data for a specific system, use the system button as shown below.

aus_report Command Line Utility

There is a CLI utility aus_report available on NREL HPC systems to track your AU usage. This utility uses the data from Lex to output AU usage information on a per-allocation and per-user basis. Please refer to Lex in the case of an discrepancies. Run aus_report --help for more information.

Jobs Data

To see the list of jobs run using the allocation, select the "List Jobs" tab.

To filter the job data, such as by a specific user or partition, use the search bar. Click the column headers to sort the list by that feature.

To see a summary about a job, click the job ID.

For any questions or feedback on Lex, please contact HPC-Help@nrel.gov.