svcadm

- 处理服务实例

用法概要

/usr/sbin/svcadm [-v] enable [-rst] {FMRI | pattern}...

/usr/sbin/svcadm [-v] disable [-st] {FMRI | pattern}...

/usr/sbin/svcadm [-v] restart {FMRI | pattern}...

/usr/sbin/svcadm [-v] refresh {FMRI | pattern}...

/usr/sbin/svcadm [-v] clear {FMRI | pattern}...

/usr/sbin/svcadm [-v] mark [-It] instance_state 
     {FMRI | pattern}...

/usr/sbin/svcadm [-v] milestone [-d] milestone_FMRI 

描述

svcadm 发出针对在服务管理工具中执行的服务的操作请求（请参见 smf(5)）。针对某个服务的操作是由分配给它的服务重启程序代理执行的。缺省的服务重启程序为 svc.startd（请参见 svc.startd(1M)）。

选项

所支持的选项如下：

-v

将操作详细地输出到标准输出。

子命令

常用操作

下面列出了在对服务实例的典型管理中使用的子命令。

对于接受一个或多个操作数的子命令，如果操作数指定了一个服务（而不是一个服务实例）且该服务仅有一个实例，则 svcadm 对该实例执行操作。如果某个缩写的 FMRI（故障管理资源标识符）或模式与多个服务相匹配，则显示一条警告消息并忽略该操作数。请参见 smf(5)。

如果服务具有多个实例，svcadm 将返回非零退出状态。

enable [-rst] {FMRI | pattern}. . .

启用由操作数指定的服务实例。对于每个服务实例，所分配的重启程序会尝试使其进入 online（联机）状态。此操作需要相应的权限来修改服务实例的 "general"（通用）属性组（请参见 smf_security(5)）。

如果指定了 -r 选项，svcadm 将启用每个服务实例并递归启用其依赖项。

如果指定了 -s 选项，svcadm 将启用每个服务实例，然后等待每个服务实例进入 online（联机）或 degraded（降级）状态。如果 svcadm 确定服务不能在不经管理员干预的情况下达到这些状态，它会提早返回。

如果指定了 -t 选项，svcadm 会临时启用每个服务实例。临时启用仅会持续到重新引导之前。此操作需要相应的权限来修改服务实例的 "restarter_actions" 属性组（请参见 smf_security(5)）。缺省情况下，enable 在重新引导后仍然有效。

disable [-st] {FMRI | pattern}. . .

禁用由操作数指定的服务实例。对于每个服务实例，所分配的重启程序会尝试使其进入 disabled（禁用）状态。此操作需要相应的权限来修改服务实例的 "general"（通用）属性组（请参见 smf_security(5)）。

如果指定了 -s 选项，svcadm 将禁用每个服务实例，然后等待每个服务实例进入 disabled（禁用）状态。如果 svcadm 确定服务不能在不经管理员干预的情况下达到此状态，它会提早返回。

如果指定了 -t 选项，svcadm 会临时禁用每个服务实例。临时禁用仅会持续到重新引导之前。此操作需要相应的权限来修改服务实例的 "restarter_actions" 属性组（请参见 smf_security(5)）。缺省情况下，disable 在重新引导后仍然有效。

restart {FMRI | pattern}. . .

请求重新启动由操作数指定的服务实例。此操作需要相应的权限来修改服务实例的 "restarter_actions" 属性组（请参见 smf_security(5)）。大多数重启程序将重新启动服务操作实施为一个完整的服务 "stop"（停止）操作，后跟一个 "start"（启动）操作。

此子命令只能重新启动处于 online（联机）或 degraded（降级）状态的服务，因为这些状态是在 smf(5) 中定义的。

refresh {FMRI | pattern}. . .

针对操作数指定的每个服务实例，请求所分配的重启程序使用来自当前配置的值更新该服务的运行配置快照。其中某些值是立即生效的（例如，依赖项更改）。其他值在服务下次 restart（重新启动）之前不会生效。有关更多信息，请参见重启程序和服务文档。

如果服务是由 svc.startd(1M) 管理的，将调用 refresh 方法（如果存在）来请求服务重新读取其自己的配置。对于其他重启程序，请参见重启程序文档。

此操作需要相应的权限来修改服务实例的 "restarter_actions" 属性组（请参见 smf_security(5)）。

clear {FMRI | pattern}. . .

针对操作数指定的每个服务实例，如果它处于 maintenance（维护）状态，则向所分配的重启程序发出服务已修复的信号。如果实例处于 degraded（降级）状态，则请求所分配的重启程序将该服务更改为 online（联机）状态。此操作需要相应的权限来修改服务实例的 "restarter_actions" 属性组（请参见 smf_security(5)）。

例外操作

下列子命令用于服务开发与临时管理处理。

mark [-It] instance_state {FMRI | pattern}. . .

如果 instance_state 为 "maintenance"（维护），则针对操作数指定的每个服务，svcadm 请求所分配的重启程序将该服务置于 maintenance（维护）状态。有关为每个重启程序采取的操作的详细描述，请参见svc.startd(1M) 和 inetd(1M)。

如果 instance_state 为 "degraded"（降级），则针对操作数指定的处于联机状态的服务，svcadm 请求分配给这些服务的重启程序将其置于 degraded（降级）状态。

如果指定了 -I 选项，该请求被标记为即时的。

-t 选项仅对维护请求有效。如果指定了此选项，该请求将被标记为临时的，它的效果仅会持续到下次重新引导之前。

milestone [-d] milestone_FMRI

如果 milestone_FMRI 为关键字 "none"，则将临时禁用除主重启程序 svc:/system/svc/restarter:default 以外的所有服务。

如果 milestone_FMRI 为关键字 "all"，则将废除对所有服务的临时启用和禁用请求。

如果 milestone_FMRI 为下列值之一：

svc:/milestone/single-user:default
svc:/milestone/multi-user:default
svc:/milestone/multi-user-server:default

则将废除对指定的服务及其依赖的（直接或间接）的所有服务的临时启用和禁用请求。将临时禁用所有其他服务。

使用 "milestone" 子命令更改系统的当前里程碑将不会更改系统的当前运行级。要更改系统的运行级，请直接调用 /usr/sbin/init。

此操作需要相应的权限来修改 svc:/system/svc/restarter:default 服务实例的 "options_ovr" 属性组（请参见 smf_security(5)）。

如上所述，-d 选项会即时将里程碑更改为所需的里程碑。此外，它将使指定的里程碑成为缺省的引导里程碑，缺省的引导里程碑在重新引导后仍然有效。缺省的里程碑是由主重启程序 svc:/system/svc/restarter:default 中的 options/milestone 属性定义的。如果此属性不存在，缺省值为 "all"。此操作需要相应的权限来修改 svc:/system/svc/restarter:default 服务实例的 "options"（选项）属性组（请参见 smf_security(5)）。

操作数

支持下列操作数：

FMRI

一个 FMRI，用于指定一个或多个实例。可以通过指定实例名称或指定服务名的后缀部分以缩写形式指定 FMRI。例如，对于以下 FMRI：

svc:/network/smtp:sendmail

下列各项都是有效的缩写：

sendmail 
:sendmail 
smtp 
smtp:sendmail 
network/smtp

而下列项则无效：

mail
network
network/smt

如果 FMRI 指定了一个服务，则命令将应用于该服务的所有实例。FMRI 的缩写形式不稳定，不应在脚本或其他永久性工具中使用。

pattern

服务实例的 FMRI 根据 fnmatch(5) 描述的 "globbing"（通配）规则与之匹配的模式。如果该模式不以 "svc:" 开头，则会在其前面加上 "svc:/"。

如果某个缩写的 FMRI 或模式与多个服务相匹配，则显示一条警告消息并忽略该操作数。

示例

示例 1 重新启动服务实例

以下命令重新启动 NFS 服务器。缺省服务实例的完整 FMRI 为：svc:/network/nfs/server:default

不过，您可以将该完整的 FMRI 缩写为以下形式：

# svcadm restart nfs/server

示例 2 禁用标准的 HTTP 服务器

以下命令禁用标准的 HTTP 服务器，其中使用了缩写的 FMRI：

$ svcadm disable http

示例 3 启用实例及其依赖的实例

以下命令启用 foo:bar 实例及其依赖的所有实例：

$ svcadm enable -r foo:bar

示例 4 以同步方式启用实例

以下命令启用 foo:bar 实例。在实例联机或 svcadm 断定该服务无法联机之前，此命令不会返回。

$ svcadm enable -s foo:bar

示例 5 限制和恢复正在运行的服务

以下命令将正在运行的服务限制到单用户模式：

# svcadm milestone milestone/single-user

以下命令恢复正在运行的服务：

# svcadm milestone all

退出状态

将返回下列退出值：

0

成功完成。

1

发生了致命错误。会在标准错误输出中显示一条或多条错误消息。

2

指定的命令行选项无效。

3

svcadm 断定由于它等待的服务实例本身存在某个问题，不经管理员干预该服务实例无法达到所需的状态。

4

svcadm 断定由于它等待的服务实例的依赖项存在某个问题，不经管理员干预该服务实例无法达到所需的状态。

属性

有关以下属性的说明，请参见 attributes(5)：

交互式输出为 Uncommitted（未确定）。调用和非交互式输出为 Committed（已确定）。

另请参见

svcprop(1)、svcs(1)、inetd(1M)、init(1M)、svccfg(1M)、svc.startd(1M)、libscf(3LIB)、contract(4)、attributes(5)、smf(5)、smf_security(5)

附注

svcadm 等待服务及其依赖项更改状态时花费的时间量由其方法超时隐式限制。例如，如果某个服务使用的缺省重启程序的 start 方法挂起，则超时时间到期后，该服务将转换为 maintenance（维护）状态。svcadm 将认为该服务在不经管理员干预的情况下无法联机。

尝试以同步方式启用依赖于（直接或间接）某个文件的服务时，如果调用者不具备搜索包含某个文件的目录所需的特权，该尝试可能会失败且退出状态指出不满足依赖项。将来的 Solaris 发行版中可能会取消这一限制。