qconf
介绍
qconf 是用于查询 Sun Grid Engine (SGE) 配置信息的工具，本实现为 FSCHED 环境提供了兼容性接口。该命令允许用户查看队列、并行环境和其他系统配置参数。
参数说明
支持参数列表
队列管理
| 选项 | 是否需要值 | 取值范围 | 用途 | 主要差异 |
|---|---|---|---|---|
-sql | 否 | 无 | 列出所有队列名称 | |
-sq | 是 | 队列名称 | 显示指定队列的详细配置 | 部分字段为dummy值 |
主机管理
| 选项 | 是否需要值 | 取值范围 | 用途 | 主要差异 |
|---|---|---|---|---|
-sel | 否 | 无 | 列出所有执行主机 | |
-se | 是 | 主机名 | 显示指定主机的详细配置 | 部分字段为dummy值 |
-sh | 否 | 无 | 列出所有管理主机 | 返回控制节点 |
-ss | 否 | 无 | 列出所有提交主机 | 返回控制节点 |
主机组管理
| 选项 | 是否需要值 | 取值范围 | 用途 | 主要差异 |
|---|---|---|---|---|
-shgrpl | 否 | 无 | 列出所有主机组 | 从配置文件读取，未配置时返回 @allhosts |
-shgrp | 是 | 主机组名 | 显示主机组详细信息 | 从配置文件读取 |
-shgrp_tree | 是 | 主机组名 | 以树状结构显示主机组 | 显示主机组层级结构 |
-shgrp_resolved | 是 | 主机组名 | 显示解析后的主机列表 | 展开所有主机名 |
并行环境
| 选项 | 是否需要值 | 取值范围 | 用途 | 主要差异 |
|---|---|---|---|---|
-spl | 否 | 无 | 列出所有并行环境 | 默认返回 smp, mpi |
-sp | 是 | 并行环境名 | 显示并行环境详细配置 | 从配置文件读取 |
用户和项目
| 选项 | 是否需要值 | 取值范围 | 用途 | 主要差异 |
|---|---|---|---|---|
-suserl | 否 | 无 | 列出所有用户 | 从配置文件或数据库获取 |
-suser | 是 | 用户名 | 显示用户详细信息 | 从配置文件或数据库获取，部分字段为dummy值 |
-sprjl | 否 | 无 | 列出所有项目 | 从配置文件或数据库获取 |
-sprj | 是 | 项目名 | 显示项目详细信息 | 从配置文件或数据库获取 |
访问控制
| 选项 | 是否需要值 | 取值范围 | 用途 | 主要差异 |
|---|---|---|---|---|
-sul | 否 | 无 | 列出所有用户集/ACL | 从配置文件读取 |
-su | 是 | ACL名称 | 显示用户集详细信息 | 从配置文件读取 |
-sm | 否 | 无 | 列出所有管理员 | 当前固定返回 root |
-so | 否 | 无 | 列出所有操作员 | 固定返回 NONE |
配置管理
| 选项 | 是否需要值 | 取值范围 | 用途 | 主要差异 |
|---|---|---|---|---|
-sconf | 可选 | global 或主机名 | 显示全局或主机配置 | 从系统配置获取 |
-ssconf | 否 | 无 | 显示调度器配置 | 从系统配置获取 |
-sconfl | 否 | 无 | 列出所有配置主机 | 返回控制节点 |
复杂资源
| 选项 | 是否需要值 | 取值范围 | 用途 | 主要差异 |
|---|---|---|---|---|
-sc | 否 | 无 | 显示所有复杂资源属性定义 | 返回预定义的资源属性列表 |
资源配额
| 选项 | 是否需要值 | 取值范围 | 用途 | 主要差异 |
|---|---|---|---|---|
-srqsl | 否 | 无 | 列出所有资源配额集 | 从数据库获取 |
-srqs | 否 | 配额集名称（可选） | 显示资源配额集详细信息，不指定名称则显示全部 | 仅支持显示名称、描述、启用状态及作业数/运行时/CPU限制，不支持复杂的筛选规则 |
调度器状态
| 选项 | 是否需要值 | 取值范围 | 用途 | 主要差异 |
|---|---|---|---|---|
-sss | 否 | 无 | 显示调度器状态 | 返回控制节点信息 |
其他选项
| 选项 | 是否需要值 | 取值范围 | 用途 | 主要差异 |
|---|---|---|---|---|
-help | 否 | 无 | 显示帮助信息 | 显示所有支持的选项 |
-version | 否 | 无 | 显示版本信息 | 显示 wrapper 版本和构建信息 |
高级查询
| 选项 | 是否需要值 | 取值范围 | 用途 | 主要差异 |
|---|---|---|---|---|
-sobjl | 是 | 对象类型 属性 值 | 列出匹配条件的对象 | 部分支持 |
队列配置输出项 (-sq)
| 输出项 | 功能描述 | 主要差异 |
|---|---|---|
qname | 队列名称 | 从队列配置获取 |
hostlist | 主机列表 | 从队列配置获取 |
seq_no | 序列号 | dummy值 0 |
load_thresholds | 负载阈值 | 固定值 "np_load_avg=1.75" |
suspend_thresholds | 挂起阈值 | dummy值 "NONE" |
nsuspend | 挂起槽位数 | dummy值 1 |
suspend_interval | 挂起间隔 | dummy值 "00:05:00" |
priority | 优先级 | 从队列配置获取 |
min_cpu_interval | 最小CPU间隔 | dummy值 "00:05:00" |
processors | 处理器限制 | dummy值 "UNDEFINED" |
qtype | 队列类型 | dummy值 "BATCH INTERACTIVE" |
ckpt_list | 检查点接口列表 | dummy值 "NONE" |
pe_list | 并行环境列表 | 固定值 "make smp mpi" |
rerun | 重运行标志 | dummy值 "FALSE" |
slots | 总槽位数 | 从队列配置获取 |
tmpdir | 临时目录 | 固定值 "/tmp" |
shell | Shell路径 | 固定值 "/bin/sh" |
prolog | Prolog脚本 | 从系统配置获取或 "NONE" |
epilog | Epilog脚本 | 从系统配置获取或 "NONE" |
shell_start_mode | Shell启动模式 | 固定值 "posix_compliant" |
starter_method | 启动方法 | dummy值 "NONE" |
suspend_method | 挂起方法 | dummy值 "NONE" |
resume_method | 恢复方法 | dummy值 "NONE" |
terminate_method | 终止方法 | dummy值 "NONE" |
initial_state | 初始状态 | 从队列配置获取 |
s_rt | 软实时限制 | 从队列配置获取或 "INFINITY" |
h_rt | 硬实时限制 | 从队列配置获取或 "INFINITY" |
s_cpu | 软CPU限制 | dummy值 "INFINITY" |
h_cpu | 硬CPU限制 | dummy值 "INFINITY" |
s_fsize | 软文件大小限制 | dummy值 "INFINITY" |
h_fsize | 硬文件大小限制 | dummy值 "INFINITY" |
s_data | 软数据限制 | dummy值 "INFINITY" |
h_data | 硬数据限制 | dummy值 "INFINITY" |
s_stack | 软栈限制 | dummy值 "INFINITY" |
h_stack | 硬栈限制 | dummy值 "INFINITY" |
s_core | 软核心文件限制 | dummy值 "INFINITY" |
h_core | 硬核心文件限制 | dummy值 "INFINITY" |
s_rss | 软RSS限制 | dummy值 "INFINITY" |
h_rss | 硬RSS限制 | dummy值 "INFINITY" |
s_vmem | 软虚拟内 存限制 | dummy值 "INFINITY" |
h_vmem | 硬虚拟内存限制 | dummy值 "INFINITY" |
主机配置输出项 (-se)
| 输出项 | 功能描述 | 主要差异 |
|---|---|---|
hostname | 主机名 | 从主机配置获取 |
load_scaling | 负载缩放 | dummy值 "NONE" |
complex_values | 复杂资源值 | dummy值 "NONE" (负载信息在 load_values 字段中) |
load_values | 负载值 | 从系统信息获取实时负载 |
processors | 处理器数量 | 从主机配置获取 |
user_lists | 用户列表 | dummy值 "NONE" |
xuser_lists | 排除用户列表 | dummy值 "NONE" |
projects | 项目列表 | dummy值 "NONE" |
xprojects | 排除项目列表 | dummy值 "NONE" |
usage_scaling | 使用率缩放 | dummy值 "NONE" |
report_variables | 报告变量 | dummy值 "NONE" |
并行环境配置输出项 (-sp)
| 输出项 | 功能描述 | 主要差异 |
|---|---|---|
pe_name | 并行环境名称 | 固定值 smp 或 mpi |
slots | 槽位数 | smp=999, mpi=99999 |
allocation_rule | 分配规则 | smp="$pe_slots", mpi="$fill_up" |
accounting_summary | 会计汇总 | smp=TRUE, mpi=FALSE |
control_slaves | 控制从节点 | 固定值 TRUE |
job_is_first_task | 作业是首个任务 | 固定值 TRUE |
用户信息输出项 (-suser)
| 输出项 | 功能描述 | 主要差异 |
|---|---|---|
name | 用户名 | 从配置文件或数据库获取 |
oticket | Override tickets | dummy值 0 |
fshare | Functional shares | dummy值 0 |
delete_time | 删除时间 | dummy值 |
default_project | 默认项目 | 从配置文件或数据库获取 |
使用示例
示例1：列出所有队列
qconf -sql
输出示例：
compute
test
示例2：查看队列详细配置
qconf -sq compute
输出示例：
qname compute
hostlist compute[1-11]
seq_no 0
...
示例3：列出所有执行主机
qconf -sel
输出示例：
compute1
compute2
test1
示例4：查看主机详细配置
qconf -se compute1
输出示例：
hostname compute1
load_scaling NONE
complex_values NONE
...
示例5：查看全局配置
qconf -sconf global
输出示例：
#global:
execd_spool_dir /opt/fastone/wrappers/sge/spool
mailer /bin/mail
...
示例6：列出所有主机组
qconf -shgrpl
输出示例：
@allhosts
示例7：列出所有并行环境
qconf -spl
输出示例：
smp
mpi
示例8：列出所有用户
qconf -suserl
输出示例：
root
示例9：查看项目详细信 息
qconf -sprj project_a
输出示例：
name project_a
oticket 0
fshare 0
acl NONE
xacl NONE
示例10：列出资源配额集
qconf -srqsl
输出示例：
normal
high
medium
low
注意事项
不支持的功能
- 所有修改类参数 (
-a*,-m*等): 不支持任何配置修改操作 - 管理类参数 (
-k*,-clearusage等): 不支持管理操作
参数限制
-sp仅支持预定义的并行环境 (smp,mpi)-sconf仅支持global配置