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；zac。
說明： 當您在 RHEL 輔助伺服器上執行 zac 指令時，該程序會無限期懸置。
可能的原因： 內容複製排程設定為較短期間。例如，5 分鐘。

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

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