cadmin#
管理员命令#
cadmin - AIP 管理cbls和cbexe的工具
概要#
cadmin 子命令
cadmin [-h | -V]
子命令列表#
说明#
警告
此命令仅供 AIP 管理员在$CB_ENVDIR/cb.yaml 文件发生更改时使用。
cadmin 是一个执行特权命令的工具，用于控制 AIP 集群中的 CBLS 和 CBEXE 操作。
如果没有为 cadmin 提供子命令，cadmin 会提示从标准输入中输入子命令。
对于可以指定多个主机名或主机组的子命令，请勿将多个主机名括在引号中。
选项#
- subcommand
执行指定的子命令。请参阅“用法”部分。
- -h
将命令用法打印到标准错误输出并退出。
- -V
打印 AIP 发行版本并退出。
用法#
- ckconfig[-v]
检查 AIP 配置文件。
- -v
显示有关配置文件检查的详细信息。
- reconfig[-f] [-v]
在集群中的所有主机上重新启动 CBLS。您应该在更改配置文件后使用 reconfig 命令。在重新启动集群中的所有 CBLS 之前，会检查配置文件。如果配置文件不正确，则不会启动重新配置。
- -f
禁用用户交互，并在未发现致命错误的情况下强制在集群中的所有主机上重新启动 CBLS。此选项在批处理模式下非常有用。
- -v
显示有关配置文件检查的详细信息。
- lsstartup[-f] [host_name… |all]
如果未指定参数，则在本地主机上启动 CBLS。
在指定主机或集群中所有主机上启动 CBLS（如果仅提供 all 参数）。系统将要求您确认。
该子命令只能由root运行，启动远程主机的cbls需要使用ssh。
- -f
禁用交互，启动 CBLS 时不要求您确认。
- lsshutdown[-f] [host_name… | all]
如果未提供任何参数，则关闭本地主机上的 CBLS。
在指定主机或集群中所有主机上关闭 CBLS（如果指定了 all 参数）。系统将要求您确认。
关闭CBLS是向CBLS发送关闭请求，由CBLS自己退出，所以只需AIP管理员权限运行命令。
- -f
禁用交互，关闭 CBLS 时不要求您确认。
- lsrestart [-v] [-f] [host_name… | all]
如果未提供任何参数，则在本地主机上重新启动 CBLS。
如果指定了 all，则在指定主机或集群中的所有主机上重新启动 CBLS。系统将要求您确认。
重启CBLS是向CBLS发送重启请求，由CBLS自己退出后重新启动，所以只需AIP管理员权限运行命令。
- -v
显示有关配置文件检查的详细信息。
- -f
禁用用户交互，并在未发现致命错误的情况下强制 CBLS 重新启动。 此选项在批处理模式下很有用。 lsrestart -f all 与 reconfig -f 相同。
- lslock [-l time_seconds]
如果未指定时间，则锁定本地主机上的 CBLS，直到明确解锁。 主机锁定后，CBLS 的负载状态将变为 lockU。AIP 不会向锁定的主机发送任何作业。
- -ltime_seconds
主机锁定指定的时间（以秒为单位）。如果计算机正在运行需要所有可用 CPU 时间和/或内存的独占作业，则此功能非常有用。
- lsunlock
解锁本地主机上的 CBLS。
- exestartup[-f][host_name … | all]
如果未指定参数，则在本地主机上启动 CBEXE。
在指定主机或所有主机上启动 CBEXE 如果指定了 all ，则在集群中执行。系统将要求您确认。
该子命令只能由root运行，启动远程主机的cbexe需要使用ssh。
- -f
禁用交互，并且在启动 CBEXE 时不要求确认。
- exeshutdown [-f] [host_name… | all]
如果未指定参数，则关闭本地主机上的 CBEXE。
关闭指定主机上的 CBEXE，如果指定了 all ，则关闭集群中所有主机上的 CBEXE。 系统将要求您确认。
如果 CBEXE 正在运行，它将一直运行，直到所有远程任务都退出。
关闭CBEXE是向CBEXE发送关闭请求，由CBEXE自己退出，所以只需AIP管理员权限运行命令。
- -f
禁用交互，并且在关闭 CBEXE 时不要求确认。
- exerestart[-f] [host_name… | all]
如果未指定参数，则在本地主机上重新启动 CBEXE。
如果指定了 all，则在指定主机或集群中的所有主机上重新启动 CBEXE。系统将要求您确认。
如果 CBEXE 正在运行，它将一直运行，直到所有远程任务退出。在等待远程任务退出期间， 将重新启动另一个 CBEXE 来处理新的查询。
重启CBEXE是向CBEXE发送重启请求，由CBEXE自己退出后重新启动，所以只需AIP管理员权限运行命令。
- -f
禁用交互，并且在重新启动 CBEXE 时不要求确认。
- exelogon [host_name… | all] [-c cpu_time]
如果未指定参数，则记录 CBEXE 在本地主机上执行的所有任务。
记录集群中指定主机或所有主机（如果指定 all）上 CBEXE 执行的任务。
CBEXE 会将任务的资源使用情况信息写入日志文件 cb.tacct.*host_name*。 日志文件的位置为/opt/skyformai/log。或者 CBEXE 无法访问该目录， 则日志文件将创建在 /tmp 中。
- -c cpu_time
仅记录 CPU 使用率超过指定数量的任务。CPU 时间由 cpu_time 指定，以毫秒为单位。
- exelogoff [host_name… |all]
如果未指定参数，则关闭本地主机上的 CBEXE 任务日志记录。
关闭集群中指定主机或所有主机（如果指定了 all）的 CBEXE 任务日志记录。
- lsdebug [-c “class_name…“] [-l debug_level] [-f logfile_name] [-o] [”host_name…“]
设置 CBLS 的消息日志级别，以便在日志文件中包含更多信息。您必须是 root 权限或 AIP 管理员才能使用此命令。
如果该命令未使用任何选项，则使用以下默认值：
class_name = 0（不记录其他类别）
debug_level = 0（参数 CB_LOG_MASK 中的 LOG_DEBUG 级别）
logfile_name = 当前 AIP 系统日志文件，位于 CB_LOGDIR 指定的目录中，格式为：daemon_name.host_name.log。
host_name= 本地主机（提交命令的主机）
- -c “class_name…“
指定要记录调试消息的软件类别。如果指定了类别列表，则必须将它们括在引号中并用空格分隔。
可能的类：
LC_AUTH - 记录身份验证消息
LC_CHKPNT - 记录检查点消息
LC_COMM - 记录通信消息
LC_EXEC - 记录作业执行的重要步骤
LC_FILE - 记录文件传输消息
LC_HANG - 标记程序可能挂起的位置
LC_SIGNAL - 记录与信号相关的消息
LC_TRACE - 记录重要的程序执行步骤
LC_RPC - 记录 XDR 传输的所有内容
默认值：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（LOG_DEBUG 级别）
- -f logfile_name
指定要记录调试消息的文件名。可以指定带或不带完整路径的文件名。
如果指定了不带路径的文件名，则文件将保存在 /opt/skyformai/log目录中。
将创建的文件名将采用以下格式：logfile_name.daemon_name.host_name.log
如果/opt/skyformai/log路径无效，则日志文件将在/tmp 目录中创建。
默认值：当前 AIP 系统日志文件，位于 CB_LOGDIR 指定的目录中，格式为 daemon_name.host_name.log。
- -o
关闭临时调试设置并将其重置为守护进程的启动状态。 消息日志级别将重置为 CB_LOG_MASK 的值， 类别将重置为 CB_DEBUG_RES 和 CB_DEBUG_LIM 的值。
日志文件将重置为默认日志文件。
- “主机名…“
在指定的一个或多个主机上设置调试设置。
默认值：本地主机（提交命令的主机）
- exedebug [-c “class_name“] [-l debug_level] [-f logfile_name] [-o] [”host_name…“]
设置 CBEXE 的消息日志级别，以便在日志文件中包含其他信息。您必须是 AIP 管理员才能使用此命令，而不是 root 用户。
有关选项的说明，请参阅 lsdebug 的说明。
- lstime [-l timing_level] [-f logfile_name] [-o] [”host_name …“]
设置 CBLS 的计时级别，以便在日志文件中包含额外的计时信息。您必须是 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
指定要记录计时消息的文件名。可以指定带或不带完整路径的文件名。
如果指定了不带路径的文件名，则文件将保存在 /opt/skyformai/log目录中。
将要创建的文件名将采用以下格式：logfile_name.daemon_name.host_name.log
如果指定的路径无效，则日志文件将在/tmp 目录中创建。
备注
计时和调试消息都记录在同一个文件中。
默认值：当前 AIP 系统日志文件位于 /opt/skyformai/log目录中， 格式为 daemon_name.host_name.log。
- -o
关闭临时计时设置并将其重置为守护进程的起始状态。 计时级别将重置为相应守护进程的参数值（CB_TIME_LIM、CB_TIME_RES）。
日志文件将重置为默认日志文件。
- “host_name …“
设置指定主机或主机的计时级别。
默认值：本地主机（提交命令的主机）
- exetime [-l timing_level] [-f logfile_name] [-o] [”host_name …“]
设置 CBEXE 的计时级别，以便在日志文件中包含额外的计时信息。您必须是 AIP 管理员才能使用此命令， 而不是 root 用户。
有关选项的说明，请参阅 lstime 的说明。
- help [subcommand…] | ? [subcommand…]
显示指定命令的语法和功能。这些命令必须明确地提供给 cadmin。
在命令提示符下，您可以使用 help 或 ?。
- quit
退出 cadmin 会话。