適用於 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

顯示系統的說明。

指令 /?

顯示指定指令的描述。

/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 管理員 -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 指令將獲得可用資源集的清單及其顯示名稱。

支援的規則運算式包括以下幾種:

一般運算式

功能

^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) [選項] [套裝軟體名稱] […]

鎖定符合指定規則運算式或字串的指定套裝軟體,防止它們升級或遭移除。

支援的規則運算式包括以下幾種:

一般運算式

功能

^abc

找出以「abc」開頭的字串。

[abc]

找出包含「a」、「b」或「c」的字串。

a*c

找出「c」前面有零或多個「a」的字串,例如「ac」、「aac」、「aaac」、「c」。

適用的選項包括:

  • -li、--lock-install:鎖定套裝軟體,防止安裝鎖定中指定的套裝軟體。

附註:套裝軟體鎖定僅適用於安裝動作集。

  • -t、--type:指定要鎖定的套裝軟體類型。可用類型包括 linux 和 patch。如果未指定類型,則會選取套裝軟體類型。
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

搜尋符合指定 規則運算式或字串的套裝軟體。

支援的規則運算式包括以下幾種:

一般運算式

功能

a+bc

找出「bc」前面有一或多個「a」的字串。

例如,會找到「abc」或「aabc」前面有一或多個「a」的字串。

[a-z]\*

找出空字串以及名稱只含字母字元的字串。

例如,會找到空字串 "",或名稱為 acb 與 xyz 等只含字母字元的字串。

a*bc

比對「bc」前面有零或多個「a」的項目。

例如,會找到「abc」、「aabc」、「aaabc」或「bc」前面有零或多個「a」的字串。

此指令的輸出類似於 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 格式或 base64 編碼,並由 ----BEGIN CERTIFICATE---- 和 ----END CERTIFICATE-- 進行分隔。

範例:

若要列出每個已知 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]

喚醒:喚醒執行收集的模組 (庫存、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) <內容路徑> [<記錄的路徑>]

輸入內容路徑指定的目錄下缺少的內容,並記錄到 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

庫存指令

(inv) inventory [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 指定的是所有權限。預設會為 root 使用者指定 SuperUser 權限,該權限無法修改。

範例:

如果要允許 ZENworks 權限儲存庫中的本地使用者檢視、安裝及解除安裝套裝軟體與規則,可以執行以下指令,將 ViewInstall 權限指定給這些使用者:

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

顯示符合指定模式之指定套件的套件資訊。

支援的規則運算式包括以下幾種:

一般運算式

功能

^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 <規則運算式模式> [<規則運算式模式>]:安裝所有與指定的規則運算式相符的套件。

支援的規則運算式包括以下幾種:

一般運算式

功能

^abc

找出以「abc」開頭的字串。

[abc]

找出包含「a」、「b」或「c」的字串。

a*c

找出「c」前面有零或多個「a」的字串,例如「ac」、「aac」、「aaac」、「c」。

此外,該指令還會列出成功完成安裝所需的相依套件.

list-updates (lu) [選項] [套裝軟體名稱|服務名稱] […]

顯示指定套裝軟體和服務中的可用更新。您可以指定顯示一或多個套裝軟體或服務的更新。如果未指定套裝軟體或服務,該指令會顯示所有可用的更新。

適用的選項包括:

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

新增套件鎖定規則。此指令會鎖定與指定的規則運算式或字串相符的指定套件,防止其升級或遭移除。套件名稱可以個別指定,也可使用萬用字元模式甚至版本號碼關係指定。版本號碼應包含在單引號或雙引號內。

關係運算子

功能

=

僅鎖定特定的套件版本。

<

鎖定低於指定版本的所有套件版本,不包括該指定版本。

>

鎖定高於指定版本的所有套件版本,不包括該指定版本。

<=

鎖定低於指定版本的所有套件版本,包括該指定版本。

>=

鎖定高於指定版本的所有套件版本,包括該指定版本。

若要安裝特定版本的套件,此指令會先檢查該套件版本是否已鎖定,只有在未鎖定時才會安裝該套件版本。例如,假設套件「X 1.7」之後的所有版本都已透過 zac la 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 <規則運算式模式> [<規則運算式模式>]:移除所有與指定的規則運算式相符的套件。

支援的規則運算式包括以下幾種:

一般運算式

功能

^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。不過,您可以使用 reregister 指令為裝置指定與更換硬碟前相同的 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 Service。

PXE 申請: 影像伺服器自最近一次啟動後,接收到的所有種類之影像申請的數目。包括失敗的申請、拒絕的申請或已轉介給其他影像伺服器的申請。這些申請的相關資訊,如來源、類型、日期/時間與結果等,會一一記錄在影像伺服器上。

已傳遞的影像: 影像伺服器自最近一次啟動後,傳遞至影像用戶端之影像的數目。只包括從此影像伺服器擷取的影像。

已接收的影像: 影像伺服器自最近一次啟動後,所接收並儲存的新影像數目。包括透過用戶端轉介接收的影像。

範例:

zac iss status

狀態指令

agent-properties (agp)

提供 ZENworks Agent 的相關資訊。下列欄位提供 ZENworks Agent 的相關資訊:

裝置位址。 裝置的 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