3.0 ZENworks 指令行公用程式疑難排解

以下幾節向您提供在使用 Micro Focus ZENworks 指令行公用程式時可能會遇到之問題的解決方案。

執行 zman db 指令時,可能會發生 Java 堆積空間錯誤

來源: ZENworks 2017 Update 2
說明: 執行 zman db 指令時,可能會發生 OutOfMemoryError:Java 堆積空間錯誤。
可能的原因: 為 zman 程序設定的 Java 堆積記憶體有限。
動作: 您可以使用新的設定動作 UpdateZManConfigPropertiesConfigureAction 來設定堆積大小。最大堆積大小預設設定為 512。

若要增加堆積大小:

在命令提示中,執行以下指令:

novell-zenworks-configure -c UpdateZManConfigPropertiesConfigureAction -Dzman.jvm.max.heapSize=<使用者輸入>

其中,<使用者輸入> 值可介於 max.heapsize 的預設值 512 與上限值 1024 之間

除 max.heapsize 以外,您還可以設定 min.heapsize、scrollsize 和 debugLevel 等其他參數。

novell-zenworks-configure -c UpdateZManConfigPropertiesConfigureAction -Dzman.jvm.max.heapSize=<使用者輸入> -Dzman.jvm.min.heapSize=<使用者輸入> -Dzman.renderer.scrollSize=<使用者輸入> -Dzman.debugLevel=<使用者輸入>

其中,min.heapsize 的 <使用者輸入> 值可介於預設值 64 與上限值 512 之間

scrollSize 接受任何整數值 (預設值為 -1)

debugLevel 接受值 1、2、3 (預設值) 和 4

附註:如果 zman-config.property 檔案已損毀或已刪除,請執行不含參數的 novell-zenworks-configure -c UpdateZManConfigPropertiesConfigureAction 指令,以取得該檔案中的預設值。

使用指令行重新導向運算子 (例如 > 或者 >>) 將指令的輸出重新導向至檔案時,zman 會當機

來源: ZENworks;zman。
可能的原因: zman 需要 ZENworks 管理員使用者名稱與密碼才能執行各種指令。若未在指令中提供身分證明,則系統會提示您輸入。但是,若將指令的輸出重新導向至檔案,系統就不會提示您輸入身分證明,因為對使用者名稱及密碼的輸入提示也會重新導向至檔案。因此,zman 會挂起,等候您輸入身分證明。
動作: 使用 -U|--User-P|--Password 選項,將身份證明指定為指令的一部分。
動作: 使用 admin-store-credential 指令儲存身份證明,然後執行該指令。
動作: 使用 -R|--Redirect 選項來將輸出重新導向至檔案,而不使用重新導向運算子 (例如 > 或者 >>)。

「階段群組名稱」選用引數沒有傳遞給 system-update-staging-group-create 指令時,會錯誤地顯示成功訊息

來源: ZENworks;zman。
說明: 若階段群組名稱選用引數沒有傳遞給 system-update-staging-group-create 指令,zman 會顯示下列錯誤的訊息:
Successfully created the object "null"
動作: 若要檢視會包含新建立之階段群組的階段群組清單,請在主控台提示符中執行 system-update-staging-group-list (susgl) 指令。

使用 zman ssaimg 指令新增至輔助裝置的影像角色不會立即套用於伺服器

來源: ZENworks;zman。
說明: 若使用 zman ssaimg 指令設定影像角色,角色會立即新增至裝置。若未立即新增角色,則只會在執行排程的下一次裝置重新整理時新增。
動作: 若要立即將角色套用至裝置,必須以下列方法之一手動重新整理裝置:
  • 出現指令提示時,執行 zman workstation-refresh|wrf 指令。若受管理裝置是伺服器,則執行 zman server-refresh|srf 指令。

  • 在受管理裝置的 ZENworks 圖示上按一下滑鼠右鍵,然後按一下「重新整理」

zman 指令不適用於 ZENworks Linux 伺服器上的非 root 使用者

來源: ZENworks;zman。
說明: 如果非使用者在 ZENworks Linux 伺服器中執行 zman 指令,則會顯示以下錯誤訊息:

您沒有足夠的權限,無法執行 zman 指令。做為 Linux 中的非 root 使用者,您須隸屬於 zmanusers 群組才能執行 zman 指令。

動作: 需要先將非 root 使用者新增至 zmanusers 群組,然後才能執行 zman 指令。
  1. root 使用者身分登入 ZENworks 伺服器。

  2. 於伺服器主控台提示符處:

    • 如果 Linux 裝置上已存在使用者,請執行以下指令:

      groupmod -A non-rootusername zmanusers

    • 如果 Linux 裝置上不存在使用者,請執行以下指令:

      useradd -G zmanusers non-rootusername

  3. 以非 root 使用者身分登入 ZENworks 伺服器。

非 root 使用者無法使用 zman ssc 指令設定輔助角色

來源: ZENworks;zman。
說明: 如果非 root 使用者嘗試在 Linux 主要伺服器上使用 zman ssc 指令來設定輔助角色,則會顯示以下錯誤訊息:
The role you specified (Satellite_role_name) is not a valid satellite server role. Valid roles are:
ZoneConfig.ROLE_COLLECTION
ZoneConfig.ROLE_CONTENT
ZoneConfig.ROLE_AUTHENTICATION
動作: 請進行下列幾項操作:
  1. 確定該非 root 使用者已新增至 zmanusers 群組。

    1. root 使用者身分登入 ZENworks 伺服器。

    2. 於伺服器主控台提示符處:

      • 如果 Linux 裝置上已存在使用者,請執行以下指令:

        groupmod -A non-rootusername zmanusers

      • 如果 Linux 裝置上不存在使用者,請執行以下指令:

        useradd -G zmanusers non-rootusername

  2. 使用 usermod -A non-root_username 指令,將非 root 使用者新增至 ZENworks 使用者群組。新增之後,非 root 使用者便可設定輔助角色。

若 collectionStatsDB 資料庫損毀,zac cuo 指令不會將輔助伺服器上的代理程式稽核檔案上傳至主要伺服器。

來源: ZENworks;zac。
說明: 代理程式稽核檔案上傳至輔助伺服器後,該伺服器仍會參考 collectionStatsDB 資料庫中的稽核檔案。如果該資料庫損毀,所有參考都會丟失,檔案將變成遺留檔案。因此,在您執行 zac cuo 指令將代理程式稽核檔案上傳至主要伺服器時會收到錯誤訊息。
動作: 若要將代理程式稽核檔案上傳至主要伺服器,應在輔助伺服器上執行以下步驟:
  1. 停止代理程式服務。

  2. 刪除參考遺留稽核檔案的 /var/opt/novell/zenworks/work/collection/collectionStatsDB 資料夾。

  3. 啟動代理程式服務。

  4. 執行 zac cuo 指令。

某些 zman 指令失敗並顯示 OutOfMemoryError

來源: ZENworks;zman。
說明: 某些 zman 指令可能失敗並顯示 OutOfMemoryError。
動作: 增加 zman 的最大堆積大小:

Windows:%ZENWORKS_HOME%\conf\zman\properties\zman-config.properties 檔案中,將 JVM_STARTUP_OPTIONS 的最大堆積大小值從 128m 增加到 512m。

Linux:/opt/novell/zenworks/bin/zman 檔案中,將 MEM_OPTS 的最大堆積大小從 256m 增加到 512m。

用於移除輔助角色的 zman 指令 ssd 失敗

來源: ZENworks;zman
說明: zman 指令 ssd 失敗,並顯示以下錯誤:

發生內部錯誤。請檢查 zman 記錄以瞭解詳細資訊

當您使用 ssd (該 zman 指令用於移除輔助伺服器的角色) 時,此指令會移除角色,但無法傳送重新整理輔助伺服器快速任務。

可能的原因: 這是因為已在為輔助伺服器執行重新整理輔助伺服器快速任務,或該任務即將進行。
動作:

當內容複製排程設定為較短期間時,zac 指令會在 RHEL 輔助伺服器上懸置

來源: ZENworks;zaczac
說明: 當您在 RHEL 輔助伺服器上執行 zac 指令時,該程序會無限期懸置。
可能的原因: 內容複製排程設定為較短期間。例如,5 分鐘。

附註:建議將內容複製排程設定為 12 小時。

動作: 登入 ZENworks 控制中心,新增區域系統變數 enable.cdp.cleanup.thread.wait.time,並將其值設定為 True

設定動作失敗,並顯示 ZEN 設定動作容器未回應例外

來源: ZENworks
說明: 設定動作完成,但顯示以下警告:

com.novell.zenworks.configure.NonFatalConfigureException:ZEN 設定動作容器未回應

可能的原因: 出現此問題的原因是 ZENConfigure 容器未能在等待時間內啟始化。
動作: 使用 /etc/opt/microfocus/zenworks/host-configure-action.properties 目錄中的 max-retries-for-configure-server=<number of retries> 內容增加 ZENConfigure 容器的等待時間。max-retries-for-configure-server 的預設值為 60。

附註:如果該檔案不存在,請建立該檔案並在其中包含該項目。