跳到主要内容

License查询

概述​

fsched支持实时查询集群license使用状态和用户license分配情况。

注意
  • 大量并发查询可能影响系统性能，由于用户license分配每30秒更新一次，定期查询建议间隔不少于30秒
  • list-user-lic-allocs 在用户数和license类型较多时内存消耗较大，无过滤条件的查询在大规模集群中可能消耗大量内存。请确保fsched服务器有足够内存，建议预留至少2倍内存用于大规模查询操作。根据集群规模的内存消耗参考：
    • 1,000 用户 × 300 license = 300,000 条记录 → 约121MB内存（建议预留242MB）
    • 1,000 用户 × 500 license = 500,000 条记录 → 约167MB内存（建议预留334MB）
    • 1,000 用户 × 1,000 license = 1,000,000 条记录 → 约335MB内存（建议预留670MB）
    • 2,000 用户 × 1,000 license = 2,000,000 条记录 → 约669MB内存（建议预留1.3GB）
提示
  • 所有查询命令都支持通过 --help 参数查看详细的使用说明
  • license名称在fsched中统一转换为小写处理
  • 查询结果基于实时job数据和SLURM原生API，确保数据准确性
  • 相同license类型的不同server数据会自动合计显示

用户License分配查询​

功能说明​

list-user-lic-allocs 命令用于查询用户license分配汇总，显示每个用户运行中job的license请求情况。该功能基于实时job数据计算，反映当前集群内用户的license使用分布。

核心特性：

  • 实时计算：基于当前运行中的job数据
  • 自动合计：相同license类型的不同server使用量会自动合计
  • 活跃过滤：只显示license_count > 0的记录
  • 跨server聚合：免去客户端数据合并处理

查询所有用户license分配​

查询当前集群所有用户的license分配情况：

./stateclient list-user-lic-allocs

输出示例：

Sending requests to server localhost:20051
User License Allocations (4):
========================================
User: alice
  License: matlab
  Count: 8
----------------------------------------
User: alice
  License: ansys
  Count: 3
----------------------------------------
User: bob
  License: matlab
  Count: 2
----------------------------------------
User: charlie
  License: nastran
  Count: 5
----------------------------------------

参数说明：

  • --user: 过滤特定用户名
  • --license: 过滤特定license类型名称

集群License汇总查询​

功能说明​

list-cluster-lic-summaries 命令用于查询集群license资源汇总统计，显示每种license类型在集群维度的分配概况。该功能基于SLURM的 fsched_list_licenses API，提供权威的license统计数据。

核心特性：

  • 权威数据：基于SLURM原生API获取
  • 自动合计：相同license类型的不同server统计数据自动合计
  • 全局视图：提供集群内外license使用的完整视图
  • 资源监控：支持license配额和实际使用情况监控

查询所有license汇总​

查询当前集群所有license类型的汇总统计：

./stateclient list-cluster-lic-summaries

输出示例：

Sending requests to server localhost:20051
Cluster License Summaries (3):
========================================
License: matlab
  Used: 125
  Allowed: 180
  Total Consumed: 770
----------------------------------------
License: ansys
  Used: 30
  Allowed: 50
  Total Consumed: 45
----------------------------------------
License: nastran
  Used: 15
  Allowed: 100
  Total Consumed: 85
----------------------------------------

参数说明：

  • --license: 过滤特定license类型名称

字段含义说明​

Used (当前集群使用量)：

  • 当前集群内已分配给运行中job的license数量
  • 反映集群内实际的license占用情况

Allowed (集群配额)：

  • 分配给当前集群的license总配额
  • 集群内job最多可以使用的license上限

Total Consumed (全局消耗量)：

  • 包括当前集群和集群外的所有实际license消耗
  • 反映license server的实际使用情况