csadmin#
管理员命令#
csadmin - - AIP 调度系统cbsched、cbjm、和jservice管理工具
概要#
csadmin子命令
csadmin[-h | -V]
子命令列表#
ckconfig [-v]
reconfig [-v] [-f]
schedrestart [-v] [-f]
qopen [队列名称 … | all]
qclose [队列名称 … | all]
qact [队列名称 … | all]
qinact [队列名称 … | all]
qhist [-t time0,time1] [-f 日志文件名] [队列名…]
hopen [-C 消息] [主机名 … | 主机组 … | all]
hclose [-C 消息] [主机名 … | 主机组 … | all]
jmrestart [-f] [主机名 … | all]
jmshutdown [-f] [主机名 … | all]
jmstartup [-f] [主机名 … | all]
jsrestart
jsreconfig
hhist [-t time0,time1] [-f 日志文件名] [主机名 …]
schedhist[-t time0,time1] [-f 日志文件名]
hist [-t time0,time1] [-f 日志文件名]
help [命令 …] | ? [命令 …]
quit
jmdebug [-c 类名 …] [-l 调试级别] [-f 日志文件名] [-o] [主机名 …]
scheddebug [-c 类名 …] [-l 调试级别] [-f 日志文件名] [-o]
jmtime [-l 计时级别] [-f 日志文件名] [-o] [主机名 …]
schedtime [-l 计时级别] [-f 日志文件名] [-o]
pwup [-C 消息] [-f] 主机名 [主机名 …]
pwdown [-C 消息] [-f] 主机名 [主机名 …]
pwrestart [-C message] [-f] host_name [host_name …]
描述#
警告
此命令仅供 AIP 管理员使用。
csadmin 提供了一组用于控制和监控 AIP 的命令。如果没有为 csadmin 提供子命令，csadmin 会提示从标准输入中输入命令。
每个命令的相关信息可通过 help 命令获取。
csadmin 命令由一组特权命令和一组非特权命令组成。特权命令仅可由 root 或 AIP 管理员调用，具体定义在配置文件中（有关管理员信息，请参阅 cb.yaml(5)）。特权命令包括：
reconfig
schedrestart
qopen
qclose
qact
qinact
hopen
hclose
jmrestart
jmshutdown
jmstartup
jsrestart
pwup
pwdown
pwrestart
所有其他命令均为非特权命令，可由任何 AIP 用户调用。如果要由 AIP 管理员执行特权命令，则必须以 setuid root 身份安装 csadmin，因为它需要使用特权端口发送请求。
对于可以指定多个主机名或主机组的子命令，请勿将多个主机名或主机组括在引号中。
选项#
- 子命令
执行指定的子命令。请参阅“用法”部分。
- -h
将命令用法打印到 stderr 并退出。
- -V
将 AIP 发行版本打印到 stderr 并退出。
用法#
- ckconfig [-v]
检查 AIP 配置文件。配置文件位于 CB_ENVDIR 目录中。
默认情况下，csadmin ckconfig 仅显示配置文件检查的结果。如果发现警告错误，csadmin 会提示您显示详细信息。
- -v
详细模式。将配置文件检查的详细消息显示到 stderr。
reconfig [-v] [-f]
- schedrestart [-v] [-f]
重新配置，重启 CBSCHED。 检查配置文件中的错误，并将结果显示到 stderr。如果配置文件中未发现任何错误，则会向 CBSCHED 发送重新配置请求，并重新加载配置文件。
发出此命令后，CBSCHED 重新启动。
如果发现警告错误，csadmin 会提示您显示详细消息。如果发现致命错误，则不会执行重新启动，并且 csadmin 会退出。
- -v
详细模式。显示有关配置文件状态的详细消息。如果不使用此选项，则默认显示配置文件检查的结果。所有配置文件检查的消息 都会打印到标准错误输出 (stderr)。
- -f
如果配置文件不包含致命错误，则禁用交互并继续重新启动。
- qopen [queue_name …| all]
打开指定的队列，如果指定了保留字 all，则打开所有队列。如果未指定队列， 则默认使用系统默认队列（有关 default_queues，请参阅 cb.yaml ）。 队列只有在打开时才能接受作业。
- qclose [queue_name … | all]
关闭指定的队列，如果指定了保留字 all，则关闭所有队列。如果未指定队列， 则默认使用系统默认队列。队列关闭后将不会接受任何作业。
- qact[queue_name … | all]
激活指定队列，如果指定了保留字 all，则激活所有队列。如果未指定队列， 则默认使用系统默认队列。如果队列已激活，则队列中的作业可以被调度。 被其运行窗口停用的队列无法通过此命令重新激活（有关 run_window，请参阅 cb.yaml ）。
- qinact [queue_name … | all]
停用指定队列，如果指定了保留字 all，则停用所有队列。如果未指定队列， 则默认使用系统默认队列。如果队列已停用，则队列中的作业无法调度。
- qhist [-t time0,time1] [-f logfile_name] [queue_name …]
显示指定队列的历史事件，如果未指定队列，则显示所有队列的历史事件。队列事件包括队列打开、关闭、激活和停用。
- -t time0,time1
仅显示从 time0 到 time1 期间发生的事件。有关时间格式，请参阅 chist 。 默认显示事件日志文件中的所有队列事件（见下文）。
- -f logfile_name
指定事件日志文件的文件名。可以指定绝对路径或相对路径。默认使用 AIP 系统当前使用的事件日志文件： /opt/skyformai/word/data/cb.events。选项 -f 对于离线分析非常有用。
- hopen [-C message] [host_name… | host_group… | all]
打开服务器主机。指定任何服务器主机或主机组的名称（参见 cmgroup ）。 如果指定了保留字 all，则将打开所有服务器主机。如果未指定主机或主机组， 则假定为本地主机。如果主机处于打开状态，则会接受作业。
选项 -C 将文本作为管理员消息记录到操作历史记录中。消息字符串的最大长度为 128 个字符。
- hclose [-C message] [host_name… | host_group… | all]
关闭服务器主机。指定任何服务器主机或主机组的名称（参见 cmgroup ）。 如果指定了保留字 all，则所有服务器主机都将关闭。 如果未指定任何参数，则默认使用本地主机。关闭的主机将不会接受任何新作业， 但已调度到该主机的作业不会受到影响。注意，这与通过窗口关闭的主机不同， 在这种情况下，该主机上的所有作业都将被暂停。
选项 -C 将文本作为管理员消息记录到操作历史记录中。消息字符串的最大长度为 128 个字符。
- jmrestart [-f] [host_name… | all]
在指定主机上重新启动 CBJM，如果指定了保留字 all，则在所有服务器主机上重新启动。 如果未指定主机，则默认使用本地主机。CBJM 将从头重新执行自身。 这允许使用新的 CBJM 二进制文件。
该子命令向CBJM发送重启请求，由CBJM自身退出后重运行，只需AIP管理员权限即可。
- -f
禁用交互，重启 CBJM 时无需确认。
- jmshutdown [-f] [host_name… | all]
关闭指定主机上的 CBJM，如果指定了保留字 all，则关闭所有服务器主机上的 CBJM。 如果未指定主机，则默认使用本地主机。CBJM 将在收到请求后退出。
该子命令向CBJM发送退出请求，由CBJM自身退出，只需AIP管理员权限即可。
- -f
禁用关闭 CBJM 时无需确认。
- jmstartup [-f] [host_name… | all]
在指定主机或所有服务器主机上启动 CBJM（如果指定了保留字 all）。 只有 root 可以使用此选项，并且这些用户必须能够在所有 AIP 主机上使用 ssh。 如果未指定主机，则假定使用本地主机。
- -f
禁用交互，启动 CBJM 时无需确认。
- jsrestart
如果 JSERVICE 正在运行，则重新启动 JSERVICE。如果 JSERVICE 未运行， 则该命令失败。当在 $CB_ENVDIR/jservice.yaml 中启用 JSERVICE 时， 在主服务器上重新启动 CBJM (csadmin jmrestart) 会冷启动 JSERVICE。
- jsreconfig
让 JSERVICE 重读 jservice.yaml 和 cb.yaml 配置文件，更新参数。这个操作不改变 JSERVICE内存里的作业数据。
- hhist [-t time0,time1] [-f logfile_name] [host_name…]
显示指定主机的历史事件，如果未指定主机，则显示所有主机的历史事件。 主机事件包括主机的开启和关闭。选项 -t 和 -f 与 qhist 的选项完全相同（见上文）。
- schedhist [-t time0,time1] [-f logfile_name]
显示 CBSCHED 的历史事件。事件描述 CBSCHED 的启动和退出。选项 -t 和 -f 与 qhist 的选项完全相同（见上文）。
- hist [-t time0,time1] [-f logfile_name]
显示所有队列、主机和 CBSCHED 的历史事件。 选项 -t 和 -f 与 qhist 的选项完全相同（见上文）。
- help [command …] | ? [command …]
显示指定命令的语法和功能。
- quit
退出 csadmin 会话。
- jmdebug [-c class_name …] [-l debug_level] [-f logfile_name] [-o] [host_name …]
设置 CBJM 的消息日志级别，以便在日志文件中包含更多信息。您必须是 root 或 AIP 管理员才能使用此命令。
如果该命令未使用任何选项，则使用以下默认值：
class_name = 0（不记录其他类）
debug_level = 0（参数 CB_LOG_MASK 中的 LOG_DEBUG 级别）
logfile_name = 当前 AIP 系统日志文件，位于 CB_LOGDIR 指定的目录中，格式为 daemon_name.log.host_name
host_name = 本地主机（提交命令的主机）
-c class_name …
指定要记录调试消息的软件类。
class_name的格式是类的名称，或类名称列表，以空格分隔并用引号括起来。
可能的类别：
LC_AUTH - 记录身份验证消息
LC_CHKPNT - 记录检查点消息
LC_COMM - 记录通信消息
LC_EXEC - 记录作业执行的重要步骤
LC_FILE - 记录文件传输消息
LC_HANG - 标记程序可能挂起的位置
LC_JLIMIT - 记录作业槽位限制消息
LC_LOADINDX - 记录负载索引消息
LC_PEND - 记录与作业等待原因相关的消息
LC_PERFM - 记录性能消息
LC_PIM - 记录 CBPS 消息
LC_SIGNAL - 记录与信号相关的消息
LC_SYS - 记录系统调用消息
LC_TRACE - 记录重要的程序执行步骤
LC_RPC - 记录 XDR 传输的所有内容
LC_SS - 与高级调度相关的日志消息
LC_POWER - 与电源操作相关的日志消息
备注
类也列在 cube.h 中。
默认值：0（不记录其他类）
- -l debug_level
指定调试消息的详细级别。数字越高，记录的详细程度越高。较高级别包含所有较低级别。
可能的值：
0: LOG_DEBUG 级别。
- 1: LOG_DEBUG1 级别用于扩展日志记录。较高级别包含较低日志记录级别。
例如，LOG_DEBUG3 包含 LOG_DEBUG2、LOG_DEBUG1 和 LOG_DEBUG 级别。
2: LOG_DEBUG2 级别用于扩展日志记录。较高级别包含较低日志级别。例如，LOG_DEBUG3 包含 LOG_DEBUG2、LOG_DEBUG1 和 LOG_DEBUG 级别。
- 3: LOG_DEBUG3 级别用于扩展日志记录。较高级别包含较低日志级别。例如，LOG_DEBUG3 包含 LOG_DEBUG2、
LOG_DEBUG1 和 LOG_DEBUG 级别。
默认值：0（参数 CB_LOG_MASK 中的 LOG_DEBUG 级别）
- -f logfile_name
指定要记录调试消息的文件名。可以指定带或不带完整路径的文件名。
如果指定了不带路径的文件名，则文件将保存在/opt/skyformai/log目录中。
将要创建的文件的名称将采用以下格式：
logfile_name.daemon_name.host_name.log
如果指定的路径无效，则日志文件将在/tmp 目录中创建。
默认值：当前 AIP 系统日志文件，位于 CB_LOGDIR 指定的目录中，格式为 daemon_name.host_name.log。
- -o
关闭临时调试设置并将其重置为守护进程的启动状态。消息日志级别将重置为 CB_LOG_MASK 的值，类别将重置为 CB_DEBUG_SCHED 和 CB_DEBUG_JM 的值。
日志文件也将重置为默认日志文件。
- host_name …
可选。在指定的一个或多个主机上设置调试设置。
主机名列表必须用空格分隔并用引号括起来。
默认值：本地主机（提交命令的主机）
- scheddebug [-c class_name …] [-l debug_level] [-f logfile_name] [-o]
设置 CBSCHED 的消息日志级别，以便在日志文件中包含其他信息。您必须是 root 或 AIP 管理员才能使用此命令。
有关选项的说明，请参阅 jmdebug。
- jmtime [-l timing_level] [-f logfile_name] [-o] [host_name …]
设置 CBJM 的计时级别，以便在日志文件中包含其他计时信息。您必须是 root 或 AIP 管理员才能使用此命令。
如果命令未使用任何选项，则使用以下默认值：
timing_level = 不记录计时信息
logfile_name = 当前 AIP 系统日志文件，位于 CB_LOGDIR 指定的目录中，格式为：
daemon_name.log.host_name
host_name= 本地主机（提交命令的主机）
- -l timing_level
指定日志文件中包含的计时信息的详细信息。计时信息指示软件中函数的执行时间， 并以毫秒为单位记录。
有效值：1 | 2 | 3 | 4 | 5
数字越大，软件中计时并记录执行时间的函数越多。数字越小，包含更常用的软件函数。较高级别包含所有较低级别。
默认值：未定义（不记录计时信息）
- -f logfile_name
指定要记录计时消息的文件名。可以指定带或不带完整路径的文件名。
如果指定了不带路径的文件名，则文件将保存在 cb.conf 中 CB_LOGDIR 参数指定的目录中。
将要创建的文件名将采用以下格式：logfile_name.daemon_name.host_name.log
如果指定的路径无效，在Linux系统中，日志文件将创建在/tmp 目录中。
备注
计时消息和调试消息都记录在同一个文件中。
默认值：当前 AIP 系统日志文件，位于 CB_LOGDIR 指定的目录中， 格式为 daemon_name.host_name.log。
- -o
可选。关闭临时计时设置并将其重置为守护进程的启动状态。计时级别将重置为相应守护进程的参数值 （CB_TIME_SCHED、CB_TIME_JM）。
日志文件也将重置为默认日志文件。
- host_name…
在指定的一个或多个主机上设置计时级别。
主机列表必须用空格分隔，并用引号括起来。
默认值：本地主机（提交命令的主机）
- schedtime [-l timing_level] [-f logfile_name] [-o]
设置 CBSCHED 的计时级别，以便在日志文件中包含额外的计时信息。您必须是 root 或 AIP 管理员才能使用此命令。
有关选项的说明，请参阅 jmtime。
- pwdown [-C message] [-f] host_name [host_name … ]
使用 cb.yaml 中配置的 power_down_cmd 命令关闭主机，并在主机上发布可选消息 (-C) （chosts -l 可以显示该消息）。
选项 -f 禁用用于在每个主机上确认操作的交互模式。
- pwup [-C message] [-f] host_name [host_name … ]
使用在 cb.yaml 中配置的 power_up_cmd 命令启动主机，并在主机上发布可选消息 (-C)（chosts -l 可以显示该消息）。只有通过 csadmin 命令或电源调度策略关闭的主机才能通过此命令恢复。
选项 -f 禁用交互模式，用于在每个主机上确认操作。
- pwrestart [-C message] [-f] host_name [host_name … ]
执行 cb.yaml 中配置的 power_restart_cmd 命令，并指定要在主机上发布的可选消息 (-C)（chosts -l 可以显示该消息）。
选项 -f 禁用交互模式，用于在每个主机上确认操作。