适用于 Linux 的 zac (1)

Name

zac - Linux 受管设备上安装并运行的 Micro Focus ZENworks 代理的命令行管理界面。

语法

zac command options

说明

zac 实用程序可以在 ZENworks 受管设备上执行命令行管理功能,包括安装和去除软件分发包、应用策略以及注册和取消注册设备。

使用指南

这一部分包含有关一般命令格式和约定的指南。

大多数命令都有全称和简称两种形式。

  • 全称:add-reg-key
  • 简称:ark

当两种形式都可用时,命令将如下所示:

add-reg-key (ark) 选项

使用命令时,只需输入全称或简称:

zac add-reg-key 选项

zac ark 选项

如果选项中包含空格,请使用引号将其括住:

zac ark "选项 1"

强制自变量和可选自变量

括在圆括号 ( ) 中的自变量为强制自变量,括在方括号 [ ] 中的自变量为可选自变量。

省略号 (...)

省略号表示命令允许最后一个自变量类型有多个项。必须根据命令以空格或逗号分隔各自变量。例如:

zac <命令> [选项] (服务器) (分发包) [...]

省略号表示 <命令> 可以接受多个分发包。在命令级帮助中,为明确起见,会以 [(分发包) (分发包) ... (分发包)] 的形式提供多项自变量帮助。

帮助命令

/? 或 --help

显示系统帮助。

COMMAND /?

显示指定命令的说明。

/g 或 --group

显示指定组的命令。

鉴定从属服务器命令

authentication server reconfigure (asr) [-t all|config|casa] [-u username] [-p password]

重新配置启用的鉴定从属设备。

示例:

从服务器提取配置文件:

zac asr -t config

重新配置 CASA 签名证书:

zac asr -t casa

重新配置整个从属设备:

zac asr -t all -u Administrator -p 口令

如果必须提供用户名和口令,但在命令行中未提供,您将会收到提示。

import-authentication-cert(isc)[-pk <private-key.der>] [-c <signed-server-certificate.der>] [-ca <signing-authority-public-certificate.der>] [-ks <keystore.jks>] [-ksp <keystore-pass-phrase>] [-a <signed-cert-alias>] [-ks <signed-cert-passphrase>] [-u username] [-p password] [-rc]

使用外部签名证书配置鉴定从属设备。

  • rc:确认重新配置鉴定从属服务器,如此管理员就不会收到重新配置的提示。

每个从属设备都必须有自己单独的服务器证书和私用密钥。有关生成外部证书的详细信息,请参见《ZENworks 服务器安装》。

分发包命令

bundle-install (bin) [选项] [分发包名称 | GUID | 模式]

根据与指定正则表达式或字符串或分发包 GUID 匹配的显示名称安装指定的分发包。使用 bundle-list 命令获取可用分发包及其显示名称的列表。

支持的正则表达式如下:

Regular Expression

功能

^abc

匹配以“abc”开头的字符串。

[abc]

匹配包含“a”、“b”或“c”的字符串。

a*c

匹配“c”前面有零个或多个“a”的字符串:“ac”、“aac”、“aaac”、“c”。

接受下列选项:

  • -N、--dryrun:测试并显示请求的操作,但并不实际执行这些操作。您只能对分发包版本执行一次试运行。此选项只适用于分发包的“安装 RPM”操作。

一个根据分发包名称安装分发包的示例:

zac bin bundle1

bundle-launch (bln) [分发包显示名称] [-noSelfHeal]

起动指定的分发包。起动操作集中的操作会执行。

如果尝试起动未安装的分发包,则会先安装分发包然后再起动。

使用 bundle-list 命令获取可用分发包及其显示名称的列表。

一个根据显示名称起动分发包的示例:

zac bln bundle1

以下是根据显示名称起动分发包,并在起动操作失败的情况下关闭自我修复功能(该功能默认处于打开状态)的示例:

zac bln bundle1 -noSelfHeal

bundle-list (bl) [选项]

显示指派给设备和登录用户的分发包列表。

此命令的输出会分几列显示,提供指派给受管设备或可供其使用的每个分发包的细节。“显示名称”、“版本”和“分发包类型”列分别显示分发包的显示名称、分发包或沙箱(如果分发包为沙箱版本)的版本号和分发包类型。“状态”列显示以下状态:

  • 可用:如果分发包已安装,则显示此状态。
  • 未安装:如果特定的分发包版本未安装,则显示此状态。
  • 已下载:如果内容已下载,但安装操作集中的操作尚未执行,则显示此状态。

此命令接受以下选项:

  • -a、--all:列出已过滤和未过滤的分发包。已过滤的分发包为链接分发包。默认情况下会显示未过滤的分发包。
  • -g、--show-guid:显示分发包 GUID。

一个列出所有分发包的示例:

zac bl -a

bundle-lock-add (bla) [选项] [分发包名称] […]

锁定与指定正则表达式或字符串匹配的指定分发包,阻止将其升级或去除。

支持的正则表达式如下:

Regular Expression

功能

^abc

匹配以“abc”开头的字符串。

[abc]

匹配包含“a”、“b”或“c”的字符串。

a*c

匹配“c”前面有零个或多个“a”的字符串:“ac”、“aac”、“aaac”、“c”。

接受下列选项:

  • -li、--lock-install:锁定分发包,阻止安装锁定中指定的分发包。

注:分发包锁定仅适用于安装操作集。

  • -t、--type:指定要锁定的分发包类型。可用的类型包括 Linux 和增补程序。如果未指定类型,则会选择任何分发包类型。
bundle-lock-list (bll)

列出分发包锁定。分发包锁定按 ID 号排序。

示例:

zac bll

bundle-lock-remove (blr) [选项] [分发包索引] […]

去除按号码指定的分发包锁定。您可以使用 bundle-lock-list (bll) 命令查找每个锁定的号码。

接受下列选项:

  • -n:根据名称去除指定的分发包锁定。请确保名称不包含任何模式。
  • --remove-all:去除所有分发包锁定。

一个去除分发包锁定 abc 的示例:

zac blr -n abc

一个去除所有分发包锁定的示例:

zac blr --remove-all

bundle-refresh (br) [分发包显示名称 | GUID]

刷新与指定分发包有关的信息。

示例:

zac br bundle1

bundle-search (bse) [选项] pattern

搜索与指定的 正则表达式或字符串匹配的分发包。

支持的正则表达式如下:

Regular Expression

功能

a+bc

匹配“bc”前面有一个或多个“a”的项目。

例如,“abc”或“aabc”。

[a-z]\*

匹配空字符串,以及名称只包含字母字符的字符串。

例如,匹配空字符串 "" 或者 acb、xyz 这样名称仅包含字母字符的字符串。

a*bc

匹配“bc”前面有零个或多个“a”的条目。

例如,“abc”、“aabc”、“aaabc”或“bc”。

此命令的输出与 zac bl 命令的输出相似。

接受下列选项:

  • -i、--installed-only:仅搜索已安装分发包列表。
bundle-uninstall (bu) [分发包显示名称 | GUID]

卸装指定的分发包。卸装分发包时会执行支持“撤消”操作的操作。分发包卸装完成后,分发包状态会显示为“未安装”。

使用 bundle-list 命令获取已安装的分发包及其显示名称的列表。

示例:

zac bu bundle1

bundle-verify (bv) [分发包显示名称]

重新安装分发包并执行校验操作集,确保文件均未被去除或损坏。使用 bundle-list 命令获取已安装的分发包及其显示名称的列表。

示例:

zac bv bundle1

证书命令

cert-info (ci) [ca 证书文件路径] [-u <用户名> -p <口令>]

列出每个已知 ZENworks 服务器的公共密钥证书信息,或将可信根证书添加到设备的可信存储区。文件可以是 ASN.1 DER 格式或以 ----BEGIN CERTIFICATE---- 和 ----END CERTIFICATE-- 为界限的 base-64 编码格式。

示例:

列出每个已知 ZENworks 服务器的证书:

zac ci

将可信根证书添加到设备的可信存储区:

zac ci c:\certs\mytrustcacert.der -u myuser -p mypassword

zac certificate-verify / cv

校验复制到重建储存库的服务器证书和密钥文件是否有效,并将结果更新到服务器。

集合聚集命令

collection-clients (crc)

显示已将文件上载到此集合的设备。

示例:

zac crc

collection-point (cp)

显示收集角色的状态和配置。

示例:

collection-point [wake]

wake:唤醒执行收集的模块(库存、MD 状态、讯息发送器)

collection-queued (crq)

显示已收集但尚未聚集的文件。

示例:

zac crq

collection-state (crs)

显示从属收集角色的当前状态。

示例:

zac crs

collection-upload-orphans (cuo)

查找“从属”设备上的孤立文件并将它们聚集到父收集服务器,或者如果这些文件已聚集则将它们删除。

此命令会在 /var/opt/microfocus/zenworks/work/collection 下的文件夹(collectionStatsDB 文件夹除外)中建立文件列表,然后尝试在收集统计信息数据库中查找每个条目的原始上载信息。

如果数据库中存在某个文件的条目并表明该文件尚未聚集,则会聚集该文件。如果条目表明该文件已聚集,则会在“从属”设备上将其删除。如果数据库中没有文件的条目,则会聚集该文件。此命令还会列出未上载或删除的所有文件。

运行此命令之前,应先运行 zac crw 命令将所有待处理文件发送给父服务器。

示例:

zac cuo

collection-wake (crw)

将收集到的文件发送到父服务器。

示例:

zac crw

内容分发命令

cdp-checksum (cchk) [-l:<日志路径>]

通过对每个文件计算校验和来验证从属设备的内容。

可选日志文件详细记录了校验和比较的结果。

示例:

zac cchk -l:"/var/opt/novell/zenworks/logs/cchk.log"

cdp-verify-content (cvc) [-c] [-l:<日志路径>]

将此 CDP 上的内容 ID 及其同步状态列表与主服务器认为它应该具有的状态进行比较。

可以使用以下选项:

  • c:计算本地内容的校验和。

示例:

zac cvc -l:"/var/opt/novell/zenworks/logs/cvc.log"

cdp-import-content (cic) <内容路径> [<日志路径>]

从 content-path 指定的目录导入缺少的内容,并记录到 log-path 指定的文件。

示例:

zac cic /usr/content_Dir /var/opt/novell/zenworks/logs/cic.log

distribution-info (cdi) [选项]

显示有关内容角色的统计信息。可以使用以下选项:

  • all:执行所有带有“*”的选项。
  • ss:显示同步状态*。
  • rs:获取内容储存库大小*。
  • da:列出已从此设备检索数据的设备*。
  • ne:获取内容分发错误数*。
  • ds:获取由此设备处理的数据大小 *。
  • fs:获取已处理的文件数*。
  • ah [n]:显示访问历史中的 n (默认全部)个项。
  • ch:清除历史。
  • eh <文件>:将访问历史导出到 <文件>,其中包含路径,但文件本身不能存在。

示例:

zac cdi

zac cdi rs

distribution-state (cds)

显示从属内容角色的状态。显示角色是否已启用/已禁用、状态(正在启动、活动、正在停止、已停止)、父 URL 及复制日程安排。

示例:

zac cds

distribution-wake (cdp) [cleanup | replicate [ 内容类型]]

唤醒“内容分发点”工作线程。可以使用下列其中一个选项:

  • cleanup:去除所有不应继续储存在内容分发点上的内容。
  • replicate:从内容分发点的父 ZENworks 服务器上下载所有新内容或更改的内容。可以指定一个或多个内容类型。如果未指定内容类型,将会复制所有类型。

示例:

zac cdp

zac cdp replicate

zac cdp linux-bundle

此命令仅适用于将代理提升为从属服务器的情况。

内容类型包括:

  • Default

  • linux-bundle

  • Policy

  • Macintosh-Bundle

  • Patch-Informational-Bundles

  • zscm-policy

  • subscription-default

  • Patch-Critical-Bundles

  • Patch-System-Bundles

  • subscription-optional

  • Patch-Recommended-Bundles

  • subscription-recommended

  • Imaging

  • SystemUpdate-Agent

  • Patch-Software-Bundles

  • subscription-security

  • Windows-Bundle

    注:内容类型区分大小写。

内核命令

get-settings (gs) <密钥>

每次刷新时,设置模块都会将设置下载到本地超速缓存。这会返回与给定密钥关联的有效设置。

示例:

zac gs key1

列出远程管理设置的示例:

zac gs RemoteManagement

所有有效的 ZENworks 设置密钥都储存在 /var/opt/microfocus/zenworks/zmd/cache/settings/ 目录中。

get-pref (get) <首选项名称>

显示当前设置的首选项。

显示可设置的所有自选设置示例:

zac get-pref

显示名称以 abc 开头的所有首选项示例:

zac get-pref abc

set-pref (set) <首选项名称> <首选项值>

设置首选项的值。

将首选项值 abc 设置为 123 的示例:

zac set-pref abc 123

注:如果要为受管设备配置代理服务器,请确保受管设备配置了 proxy-hostproxy-port 自选设置。如果代理服务器需要鉴定,则受管设备还必须配置 proxy-usernameproxy-password 自选设置。

set-proxy (sp) [选项] <IP 地址/主机名:端口>

指定要连接的代理,而不是直接连接“ZENworks 服务器”。

选项为:

  • --default:设置代理,管理区域中的代理设置可覆盖该值。
  • --clear - 清除当前代理,但会使用管理区域中的代理设置。
  • --ipv6:设置 IPv6 代理。

示例:

IPv4:

zac sp 123.456.78.90:2349 administrator novell

zac sp /default 123.456.78.90:2349

zac sp /clear

IPv6:

zac sp /ipv6 [2001:db8:0:1:1:1:1:1]:2349 administrator novell

zac sp /default /ipv6 [2001:db8:0:1:1:1:1:1]:2349

zac sp /clear /ipv6

如果未指定用户名和口令,则系统会提示您输入。

系统更新命令

zac zeus-refresh / zeus-ref

如果系统更新指派给设备,将检索系统更新。

zac system-update-report-status / surs

可让管理员将系统更新状态立即重发送到服务器。

外部服务命令

这些命令用于管理外部服务。

external-service-add (esa) --type (类型) (URL) (服务名称) [属性]

添加 YUM、ZYPP 等外部包储存库或包含 RPM 的本地目录。类型特定的所有属性都应以 -D 开头。

可以使用 zac est 命令列出可添加的服务类型。

支持的类型如下:

  • YUM:添加 YUM 类型的储存库。接受以下属性:

    • -Dusername=值 -Dpassword=值:此为可选属性,在添加鉴定的 YUM 储存库时使用。
    • -DsyncExternal=true:此为可选属性,用于与本地包管理工具同步。

    例如,运行以下命令可添加 YUM 服务类型:

    zac esa --type YUM -Dusername=用户名 -Dpassword=口令 https://nu.novell.com/sles11 sles11-yum-repo

  • ZYPP:添加 ZYPP 类型的储存库。接受以下属性:

    • -DsyncExternal=true:此为可选属性,用于与本地包管理工具同步。

    例如,运行以下命令可添加 ZYPP 服务类型:

    zac esa --type ZYPP http://zypp.source.com/sles11/x86_64 sles11-zypp-repo

  • MOUNT:添加 MOUNT 类型的储存库。使用 MOUNT 类型可从包含 RPM 的本地目录添加服务。接受以下属性:

    • -Drecursive=(值):此为可选属性。有效值为 true 或 false。如果为 true,则会从指定绝对路径下的所有目录以递归方式添加 RPM。
    • -DsyncExternal=true:此为可选属性,用于与本地包管理工具同步。

    例如,使用 MOUNT 服务类型运行以下命令会从所有目录以递归方式添加包:

    zac esa --type mount -Drecursive=true file:///mnt/sles11-cd/i586 sles11-rpms

注:在 Red Hat 设备上,ZYPP 或 MOUNT 服务无法与 YUM 包管理工具同步。

external-service-delete (esd) (索引 | 名称 | url | --all)

去除指定的外部服务。

--all 选项可删除所有外部服务。

external-service-list (esl)

列出所有外部服务。

“来源”列显示通过使用 zac 命令添加的 ZENworks 代理,以及通过外部服务策略添加的 ZENworks 服务器。

“状态”列显示外部服务处于活动还是非活动状态。您无法刷新显示为“非活动”状态的外部服务。

“状态”列显示外部服务处于启用还是禁用状态。

external-service-refresh (esr) (索引 | 名称 | url | --all)

刷新指定的外部服务。

--all 选项可刷新所有服务。

external-service-state (ess) (enable | disable) (索引 | 名称 | url | --all)

启用或禁用指定的外部服务。

--all 选项可更改所有服务的服务状态。

external-service-types (est)

列出可用的服务类型。

映像命令

file-system-guid (fsg)[-d] [-r]

去除并恢复文件系统中的工作站 GUID 以便取得映像。

从文件系统中去除 GUID 的示例:

zac file-system-guid -d

将 GUID 恢复到文件系统的示例:

zac file-system-guid -r

打印 GUID 值的示例:

zac fsg

库存命令

inventory (inv) [scannow | cdf]

运行库存扫描或打开集合数据表单。

运行库存扫描的示例:

zac inv scannow

打开集合数据表单的示例:

zac inv cdf

仅库存命令

这些命令仅用于仅库存 (IOA) 代理。

zac ioa cfg <服务器 IP>

将 Linux IOA 设备配置为上述服务器 IP。为确保仅将已获授权的 IOA 代理注册到区域中,您应在此命令中提供授权密钥。如果您没有授权密钥,则应在执行此命令前预先批准设备。

使用授权密钥配置仅库存代理的示例:

zac ioa cfg <IP 地址>"授权密钥"

zac ioa version

显示仅库存 (IOA) 代理的版本。

inventory (inv) [scannow]

运行库存扫描。

一个运行库存扫描的示例:

zac inv scannow

本地用户管理命令

这些命令用于管理本地用户及其特权。

user-add (ua) (用户名)

将本地用户添加到 ZENworks 特权储存库。

示例:

zac ua 用户名

user-delete (ud) (用户名)

从 ZENworks 特权储存库删除本地用户。

示例:

zac ud 用户名

user-list (ul)

列出以下内容:

  • - 添加到 ZENworks 特权储存库的本地用户的用户名和特权。
  • - 未添加到 ZENworks 特权储存库的本地用户(默认用户)的特权。默认用户以 *(星号)表示。

示例:

zac ul

user-edit (ue) (用户名) [+/-特权]

编辑本地用户特权。您可以用 +(加号)添加新特权,用 -(减号)去除现有特权。

默认情况下,新创建的本地用户拥有 View(查看)特权。未添加到 ZENworks 特权储存库中的本地用户会继承指派给以 *(星号)表示的默认用户的特权。您可以更改指派给任何本地用户的特权,并可向其指派以下特权:

特权

功能

View

查看或列出有关分发包、策略、配置等的信息。

Install

安装或卸装分发包、策略、包等。

Configure

运行配置命令。

SuperUser

执行所有 zac 命令,因为 SuperUser(超级用户)拥有所有特权。系统默认会为根用户指派 SuperUser 特权,而这一指派无法修改。

示例:

如果要允许 ZENworks 特权储存库中的本地用户查看、安装和卸装分发包和策略,可以通过运行以下命令将 View(查看)和 Install(安装)特权指派给这些用户:

zac ue 用户名 +Install

如果要允许未添加到 ZENworks 特权储存库中的本地用户查看、安装和卸装分发包和策略,可以通过运行以下命令将 ViewInstall 特权指派给 * 用户:

zac ue '*' +Install

user-privilege-export (upe) (.xml 文件名)

将本地用户及其特权的列表导出到指定的 .xml 文件,以在其他受管设备上重新使用此列表。

示例:

zac upe /tmp/privileges.xml

导出该列表后,可以通过运行 user-privilege-import (upi) 命令将其导入到其他受管设备。

user-privilege-import (upi) (.xml 文件名)

将本地用户及其特权的列表从指定的 .xml 文件导入到其他受管设备。可以通过运行 user-privilege-export (upe) 命令将此列表导出到 .xml 文件。

示例:

zac upi /tmp/privileges.xml

位置命令

config-location (cl)

显示配置位置。配置位置决定设备会连接到哪一个或哪几个 ZENworks 服务器来进行鉴定、获取配置、内容和集合。

示例:

zac config-location

zac cl

location-create (lc) (位置名称) [-d|--desc=<说明>] [网络环境名称] [...]

创建一个位置,并将网络环境指派到该位置(可选)。

(位置名称):要指派给新位置的名称。

[网络环境名称]:要指派到位置的现有网络环境的名称。您可以添加多个网络环境。可以选择在创建位置的过程中添加网络环境,也可以使用 location-nwenv-assign 命令在创建位置之后添加网络环境。

[网络环境名称]:要指派到位置的现有网络环境的名称。您可以添加多个网络环境。可以选择在创建位置的过程中添加网络环境,也可以使用 location-nwenv-assign 命令在创建位置之后添加网络环境。

接受下列选项:

-d |--desc=说明: 指定位置的说明。

-t | -- downloadThrottle=下载节流率: 指定下载节流率。

-u | -- uploadThrottle=上载节流率 指定上载节流率。

-a | -- auditUpload=审计上载数据 指定 0 会启用审计上载数据,指定 1 则会禁用。

-e | -- 首选通讯协议 根据您的首选通讯协议指定 IPv4 或 IPv6。

如果您希望此位置的设备先尝试使用 IPv4 URL 与服务器通讯,然后再尝试使用 IPv6 URL,请指定 IPv4。

如果您希望此位置的设备先尝试使用 IPv6 URL 与服务器通讯,然后再尝试使用 IPv4 URL,请指定 IPv6。

C | -- cifsServer=CIFS 服务器: 指定允许您提供共享访问的 CIFS 服务器。

-i | --proxyAddress=IPv4 HTTP 代理地址 指定 IPv4 代理地址。

-p | --proxyPort= IPv4 HTTP 代理端口: 指定代理服务器应该侦听的端口号。

-r | --proxyCidr=IPv4 HTTP 代理 CIDR: 以 CIDR 表示法指定 IPv4 地址的范围。

-x | --ipv6ProxyAddress=IPv6 HTTP 代理地址 指定 IPv6 代理地址

-y –ipv6ProxyPort=IPv6 HTTP 代理端口: 指定代理服务器应该侦听的端口号。

-z | -- ipv6ProxyCidr=IPv6 HTTP 代理 CIDR: 以 CIDR 表示法指定 IPv6 地址的范围。

location preferred protocol communication | lppc <位置名称> [选项]

编辑现有位置。

<位置名称>:指定位置的名称。

接受下列选项:

IPv4: 如果您希望此位置的设备先尝试使用 IPv4 URL 与服务器通讯,然后再尝试使用 IPv6 URL,请指定 IPv4。

IPv6: 如果您希望此位置的设备先尝试使用 IPv6 URL 与服务器通讯,然后再尝试使用 IPv4 URL,请指定 IPv6。

日志记录命令

logger [resetlog | level [MANAGED|ERROR|WARN|INFO|DEBUG] | managedlevel]

更改记录器配置。

可以使用以下选项:

  • resetlog:重置日志。
  • level:如果不使用级别,则会显示当前受管的日志记录级别。如果在一个级别下使用,则更改日志记录级别为指定级别。
  • managedlevel:显示区域的全局日志级别。

重设置日志文件的示例:

zac logger resetlog

显示当前日志级别的示例:

zac logger level

将日志级别设置为 DEBUG 及以上的示例:

zac logger level DEBUG

包管理命令

checkpoint-add (cpa) (名称) [日期]

添加检查点。如果未指定日期,则会添加当前日期的检查点。

checkpoints-list

列出保存的检查点。

checkpoint-remove (cpr) (名称) […]

去除指定的检查点。

dist-upgrade (dup) [选项] [分发包名称|服务名称] […]

执行发行套件升级。此命令会以涉及包结构更改、包分割、模式及产品更新等的特殊解析程序算法对所有包执行更新。如果没有提供变量,则所有 ZENworks 分发包中的包和外部服务均会被视作分发升级。

接受下列选项:

  • -d、--download-only:仅下载包。
  • -N、--dry-run:测试并显示请求的操作,但并不实际执行这些操作。
  • -y、--no-confirm:不提供确认提示。

例如,您可以将发行套件从 SLES 10 SP2 升级到 SLES 10 SP3。

info (info) [选项] pattern

显示与指定模式匹配的指定包的包信息。

支持的正则表达式如下:

Regular Expression

功能

^abc

匹配以“abc”开头的字符串。

[abc]

匹配包含“a”、“b”或“c”的字符串。

a*c

匹配“c”前面有零个或多个“a”的字符串:“ac”、“aac”、“aaac”、“c”。

该命令会显示包的名称、版本、结构和说明。

接受下列选项:

  • --provides:列出与指定模式匹配的包提供的包和文件。
  • --requires:列出与指定模式匹配的包所需的包和文件。
install (in) [选项] (包名称) [ ]

安装指定的包。如果指定包的版本,则会安装该版本的包。如果指定包的名称,则会安装该包最合适的版本。

注:如果要降级某个包,请指定要将包降级为哪个版本。

接受下列选项:

  • -b、--bundle [分发包名称]:从指定分发包安装包。您也可以指定 Linux 依赖项分发包。不过,要安装 Linux 依赖项分发包,应将“发布包”设置为 True。有关发布包的详细信息,请参见“Creating Linux Dependency Bundles”(创建 Linux 依赖项分发包)。
  • -d、--download-only:将包下载到 zen 超速缓存目录。默认情况下,zen 超速缓存目录位于 /var/opt/microfocus/zenworks/zmd/cache 中。
  • -N、--dry-run:测试并显示请求的操作,但并不实际执行这些操作。
  • -y、--no-confirm:不提供确认提示。
  • -f、--freshen:只有存在旧版包时,才安装包。
  • -s、--service [服务名称]:通过指定服务安装包。
  • -p、--pattern [模式名称]:安装一个指定模式的包。但只会安装该模式的强制包部分。
  • --entire-bundle [分发包名称] […]:从指定的分发包安装所有包。您可以指定单个或多个分发包。
  • --ignore-dependency:不检查依赖项。将会跳过依赖包,只安装指定的包。
  • -r、--regex-pattern <正则表达式模式> [<正则表达式模式>]:安装所有与指定的正则表达式相匹配的包。

支持的正则表达式如下:

Regular Expression

功能

^abc

匹配以“abc”开头的字符串。

[abc]

匹配包含“a”、“b”或“c”的字符串。

a*c

匹配“c”前面有零个或多个“a”的字符串:“ac”、“aac”、“aaac”、“c”。

此外,该命令还会列出成功完成安装所需的依赖包。

list-updates (lu) [选项] [分发包名称|服务名称] […]

显示指定的分发包或服务中的可用更新。您可以指定显示更新的单个或多个分发包或服务。如果未指定分发包或服务,该命令会显示所有可用的更新。

接受下列选项:

  • -t、--type [类型]:列出指定的服务类型中的更新。
lock-add (la) (名称或模式)[版本]

添加包锁定规则。此命令可锁定与指定的正则表达式或字符串匹配的指定包,阻止将其升级或去除。可以单独指定包名称,也可以通过配符模式甚至版本号关系来指定。版本号应括在单引号或双引号内。

关系运算符

功能

=

仅锁定特定的包版本。

<

锁定早于指定版本(不包括指定版本)的所有包版本。

>

锁定晚于指定版本(不包括指定版本)的所有包版本。

<=

锁定早于指定版本(包括指定版本)的所有包版本。

>=

锁定晚于指定版本的所有包版本(包括指定版本)。

如果要安装包的特定版本,此命令会先检查包版本是否锁定,如果未锁定才会安装该版本。例如,假设使用 zac la X '>' 1.7 命令锁定了包“X 1.7”的所有较高版本。则在尝试使用 zac in X (1.9) 命令安装包“X 1.9”时,安装会失败。

lock-delete (ld) (锁定号码) […]

删除按号码指定的分发包锁定。您可以使用 lock-list (ll) 命令查找每个锁定的号码。

lock-list (ll)

列出包锁定。

packagehistory (ph) [选项] […]

列出通过 ZENworks 执行的包事务历史。此命令会显示包的名称、日期、操作、版本和修订版。

接受下列选项标志:

  • -n、--search-name [包名称]:按包名称搜索
  • -a、--search-action [操作名称]:按操作名称搜索。有效的操作名称为“无”、“安装”、“去除”和“升级”。
  • -d、--days-back [天数]:回溯的最大天数(默认值为 30)。
  • -c、--clean-history:清理包历史。
  • -o、--search-operation [操作]:根据执行的操作进行搜索。执行的操作可以是 Install(安装)、Removal(去除)或 Upgrade(升级)。
remove (rm) [选项] (包名称) […]

去除指定的包。

接受下列选项:

  • --entire-bundle [分发包名称]:从指定的分发包中去除所有包。
  • -N、--dry-run:测试并显示请求的操作,但并不实际执行这些操作。
  • -y、--no-confirm:不提供确认提示。
  • -r、--regex-pattern <正则表达式模式> [<正则表达式模式>]:去除所有与指定的正则表达式相匹配的包。

支持的正则表达式如下:

Regular Expression

功能

^abc

匹配以“abc”开头的字符串。

[abc]

匹配包含“a”、“b”或“c”的字符串。

a*c

匹配“c”前面有零个或多个“a”的字符串:“ac”、“aac”、“aaac”、“c”。

此外,此命令还会列出成功去除指定包所需的依赖包。

rollback (ro) [选项] [日期或检查点]

如果设置了回滚自选设置,会将包事务回滚至指定的日期和时间。默认情况下,回滚自选设置处于禁用状态。您可以通过运行 zac set rollback true 命令启用回滚自选设置。

如果要回滚到包的特定版本,该包版本及其依赖项应作为服务或指派分发包的一部分提供。如果该包版本或其依赖项不可用,则回滚将失败。

此外,此命令还会列出成功回滚所需的依赖包。

接受下列选项:

  • -d、--download-only:仅下载包。
  • -N、--dry-run:测试并显示请求的操作,但并不实际执行这些操作。
  • -y、--no-confirm:不提供确认提示。
  • -p、--package (包名称):需要回滚的包的名称。
search (se) [选项] [模式]

搜索与指定模式匹配的包。如果未提供自变量,将显示显示所有包。此命令会显示源名称、源类型、包名称、版本和结构。

接受下列选项:

  • -b、--bundle [分发包名称]:在指定分发包中搜索包。
  • -d、--search-in-description:搜索包说明(不搜索包名称)。
  • -i、--installed-only:仅显示已安装的包。
  • -u、--uninstalled-only:仅显示未安装的包
  • -s、--service [服务名称]:在指定服务中搜索包。
  • -t、--type [服务类型]:根据指定的服务类型搜索包。
  • -p、--pattern [模式名称]:显示可用的模式。
  • --sort-by-bundle:按分发包(而非名称)对包进行排序。默认情况下会按包名称排序。
  • --show-nevra:显示包的 NEVRA 细节。
update (up) [选项] [分发包名称|服务名称] […]

更新已安装的包。您可以指定要更新包的单个或多个分发包或服务的名称。如果未指定分发包或服务的名称,则会更新所有包。

如果安装的某些包的名称和结构相同,但版本不同,则只升级版本较高的包。

接受下列选项:

  • -d、--download-only:仅下载包。
  • -N、--dry-run:测试并显示请求的操作,但并不实际执行这些操作。
  • -y ---no-confirm:不提供确认提示。
  • -t、--type [服务类型]:从指定的外部服务类型更新包。
what-provides (wp) pattern

显示提供与指定模式匹配的库、程序或包的包。只支持 * 通配符模式。

显示以 a 结尾的包的示例:

zac wp *a

what-requires (wr) pattern

列出需要与指定模式匹配的库、程序或包的包。

一个显示以 a 开头的包的示例:

zac wr a*

增补程序管理命令

patch-scan (ps)

使用设备的当前增补程序签名 (DAU) 文件扫描设备中有无未应用的增补程序。之后,结果会上载到服务器。

一个运行增补程序扫描的示例:

zac ps

patch-scan --quick (ps --quick)

将上次扫描结果上载到服务器,此命令不会运行新的检测扫描。

运行快速增补程序扫描的示例:

zac ps --quick

patch-scan --complete (ps --complete)

使用更新的增补程序签名 (DAU) 文件设备中有无未应用的增补程序。然后,结果会上载到服务器。

运行完整增补程序扫描的示例:

zac ps --complete

patch-apply-policy (pap)

使用所有增补程序策略的最新版本更新设备。

运行增补程序应用策略的示例:

zac pap

patch-quarantine-release (pqr)

释放要运行该命令的设备上的所有已隔离增补程序,以允许通过增补程序策略日程安排或更新日程安排来启动一次性安装尝试。

运行增补程序隔离释放的示例:

zac pq

策略命令

policy-list (pl)

列出设备上当前实施的策略(有效策略)。要列出所有策略(有效策略和无效策略),请使用 --all 选项。

示例:

zac pl

zac pl --all

policy-refresh (pr)

应用指派给设备和用户的所有策略。

示例:

zac pr

注册命令

add-reg-key (ark) <注册密钥>

使用指定的注册密钥注册设备。使用注册密钥进行注册具有加性。如果以前曾经使用注册密钥注册过设备,当使用新注册密钥注册该设备时,该设备会接收与两个注册密钥相关联的所有组指派。

示例:

zac ark key12

register (reg) [-k <注册密钥>] [-u <用户名> -p <口令>] <ZENworks 服务器地址:端口>

在“管理区域”中注册设备。要执行此命令,您必须对尝试注册的文件夹拥有创建/删除设备权限。

示例:

zac reg -k key1 https://123.456.78.90

zac reg -k key1 https://zenserver.novell.com:8080

只有在“ZENworks 服务器”不使用标准的 HTTP 端口 (80) 的情况下才需要提供端口号。如果未提供用户名和口令,系统会显示提示要求您提供。

注:如果服务器上已存在对应的设备对象,且对该设备对象进行了调节,则无法使用 -k 选项。

reregister (rereg)[-u <用户名> -p <口令>] <新 GUID>

在当前区域注册设备,并为其指派现有设备对象的 GUID。当前关联的设备对象会被删除。要执行此命令,您必须对尝试重新注册的文件夹拥有创建/删除设备权限。

例如,如果在替换硬盘驱动器之后映像设备,设备会获得新的 GUID。但通过使用注册命令,可以在替换硬盘驱动器之前指派与之相同的 GUID。

示例:

注册并指定用户名和口令:

zac reregister -u myuser -p mypassword eaa6a76814d650439c648d597280d5d4

注册并提供用户名和口令:

zac reregister eaa6a76814d650439c648d597280d5d4

unregister (unr) [-f] [-s] [-a] [-u <用户名> -p <口令>]

从“管理区域”中去除设备的注册。要执行此命令,您必须对尝试取消注册的文件夹拥有创建/删除设备权限。

示例:

无法连接到服务器时强制设备在本地取消注册:

zac unr -f -u myuser -p mypassword

在本地取消注册且不提示输入用户名和口令:

zac unr -s

使用 -a 选项可异步取消注册。使用此选项时,服务器会异步删除设备。

-a、-f-u-p 参数为可选参数。如果不使用 -u-p 参数,系统会提示您输入用户名和口令。如果指定了 -a 选项,ZENworks 服务器会立即返回取消注册调用,但会于稍后从数据库异步删除设备对象。如果未完成设备删除就尝试再次注册设备,ZENworks 服务器会显示错误。如果数据库中含有大量与设备关联的数据,则可能需要花费较长时间才能删除设备。如果在服务器上实际删除设备的时间较长,并导致代理取消注册命令超时,请确保使用 -a 选项。

注:运行 UNR 命令可能会导致占用大量的数据库资源。发生此情况的原因可能为以下任一种:

  • 服务器上正在运行 UNR 命令。

  • 区域中包含大量受管设备。

  • 受管设备具有海量历史记录。

  • 启用了增补程序管理。

reestablish-trust (retr) [-u <用户名> -p <口令>]

重新建立与当前管理区域的信任关系。必须使用区域管理员的用户名和口令。

示例:

zac retr -u myuser -p mypassword

其中,-u-p 均为可选参数。如果不使用 -u-p 参数,系统会提示您输入用户名和口令。

从属角色命令

import-satellite-cert(isc)[-pk <private-key.der>] [-c <signed-server-certificate.der>] [-ca <signing-authority-public-certificate.der>] [-ks <keystore.jks>] [-ksp <keystore-pass-phrase>] [-a <signed-cert-alias>] [-ks <signed-cert-passphrase>] [-u username] [-p password] [-rc]

使用外部签名的证书配置从属设备。

  • rc:确认重新配置从属服务器,如此管理员就不会收到重新配置提示。

每个从属设备都必须有自己单独的服务器证书和私用密钥。有关生成外部证书的详细信息,请参见《ZENworks 服务器安装》。

remint-satellite-cert (rsc)

为从属服务器重建 SSL 证书并重新配置 Jetty Web 服务器。

示例:zac rsc

satellite-cachecfg (satcfg)

从超速缓存中读取从属角色。

示例:

zac satcfg

satellite-clearcache (satcc)

清除超速缓存中的从属配置信息。

示例:

zac satcc

satellite-refreshcfg (satrc)

刷新从属角色。

示例:

zac satrc

satellite-roles (satr)

报告当前从属角色及其状态。

示例:

zac satr

imgsatserver status (iss status)

显示设备的映像角色属性,包括其当前状态、PXE 服务状态、映像文件和映像统计数字。

当前状态: 显示设备当前是否配置为执行“映像”操作。当设备提升为具有映像角色的从属设备时,其当前状态为“活动”

PXE 服务状态: 显示是否对设备启用 Proxy DHCP 服务。

PXE 请求: “映像服务器”自上次启动后所接收的各种映像请求的数量。包括失败的、被拒绝的或指向其他“映像服务器”的请求。有关每个请求的信息(例如来源、类型、日期/时间以及结果)将一一记录在“映像服务器”中。

已发送的映像: “映像服务器”自上次启动后发送到映像客户机的映像数量。只包含从该“映像服务器”检索到的映像。

已接收的映像: “映像服务器”自上次启动后所接收和存储的新映像数量。包含通过客户机参照接收的映像。

示例:

zac iss status

状态命令

agent-properties (agp)

提供有关 ZENworks 代理的信息。以下字段提供了 ZENworks 代理的相关信息:

设备地址。 设备的 IP 地址。

设备名。 设备的计算机名称。

设备状态。 设备状态:受管、不受管、已淘汰或未知。仅在出现错误时,状态才会显示为“未知”。

上一次连接服务器。 ZENworks 代理上次连接 ZENworks 服务器的时间。

下一次连接服务器。 安排 ZENworks 代理连接 ZENworks 服务器的时间。

主用户。 当前登录的用户。

示例:

zac agp

zac agent-properties

cache-clear (cc)

清除设备上的 ZENworks 超速缓存。此命令会去除超速缓存数据库中的所有项并删除与这些项关联的所有超速缓存文件。

示例:

zac cc

info-collect (zeninfo) [<targetfile>]

收集 ZENworks 支持信息,包括超速缓存数据、配置数据、调试日志、产品安装信息、刷新时间、状态事件和基本系统信息。此信息会打包成 ZIP 文件,并放在您指定的位置。如果您未指定位置,将使用 ${TMPDIR}\zeninfo-${DateTime}.zip。如果受管设备出现问题,Micro Focus 支持部门可能会要求您运行此命令,并将产生的 ZIP 文件发送给 Micro Focus 以协助查错。

要在后台运行 zeninfo 进程,请运行以下命令。

zac zeninfo /tmp/zeninfo/ & echo $! > /tmp/zeninfo/zeninfo.pid

要停止 zeninfo 进程,请运行以下命令:

kill `cat /tmp/zeninfo/zacinfo.pid`

refresh (ref)[general [bypasscache] | partial [bypasscache] | bypasscache]

启动一般刷新以刷新所有注册和配置设置;或启动部分刷新以刷新所有注册和配置设置。

使用 bypasscache 可避免在刷新期间使用服务器超速缓存中的数据。此选项对于测试或查错很有用。

示例:

zac ref general bypasscache

zac ref partial bypasscache

zac ref bypasscache

zenhttp-status(zhs)

列出已注册处理程序的端口和标记。

示例:

zac zhs

zone-config (zc)

显示设备正在访问以获取配置信息的“ZENworks 服务器”(配置服务器)的相关信息,或列出配置服务器的信息。

示例:

zac zc

get-settings (gs) <密钥>

每次刷新时,设置模块都会将设置下载到本地超速缓存。这会返回与给定密钥关联的有效设置。

示例:

zac gs key1

所有有效的 ZENworks 设置密钥都储存在 /var/opt/novell/zenworks/cache/zmd/settings/ 目录中。

列出远程管理设置的示例:

zac gs RemoteManagement

statussender (sts)

此命令将状态信息汇总到主服务器。您可以汇总自上次汇总状态以来更新的信息,也可以汇总完整的状态信息。

示例:

要汇总自上次成功汇总状态以来更新的状态信息,请运行:

zac sts rollup

要汇总完整的状态信息,请运行:

zac sts rollup full