3.0 ZENworksコマンドラインユーティリティのトラブルシューティング

ソース: ZENworks 2017 Update 2

説明: zman dbコマンドを実行するときに、OutOfMemoryError: Javaヒープスペースエラーが発生することがあります。

考えられる原因: zmanプロセスに対するJavaヒープメモリの設定が不十分です。

アクション: 新しい設定アクションUpdateZManConfigPropertiesConfigureActionを使用して、ヒープサイズを設定できます。デフォルトでは、最大ヒープサイズは512に設定されています。

ヒープサイズを増やすには、次の手順に従います。

コマンドプロンプトで、次のコマンドを実行します。

novell-zenworks-configure -c UpdateZManConfigPropertiesConfigureAction -Dzman.jvm.max.heapSize=<user-input>

<user-input>は、max.heapsize 512 (デフォルト)～ 1024 (上限)の範囲で指定できます。

max.heapsizeとは別に、min.heapSize、scrollSize、debugLevelなどの他のパラメータを設定できます。

novell-zenworks-configure -c UpdateZManConfigPropertiesConfigureAction -Dzman.jvm.max.heapSize=<user-input> -Dzman.jvm.min.heapSize=<user-input> -Dzman.renderer.scrollSize=<user-input> -Dzman.debugLevel=<user-input>

min.heapsizeの<user-input>は、64 (デフォルト)～ 512 (上限)の範囲で指定できます。

scrollSizeには任意の整数値を指定できます(デフォルトは-1)。

debugLevelには1、2、3 (デフォルト)、および4の値を指定できます。

ソース: ZENworks; zman

考えられる原因: zmanで各コマンドを実行するには、ZENworks管理者のユーザ名とパスワードが必要です。コマンドで資格情報を指定しなかった場合には、同じものを入力するように要求されます。ただし、コマンドがファイルにリダイレクトされている場合、ユーザ名とパスワードのプロンプトもファイルにリダイレクトされるため、資格情報を入力するよう要求するプロンプトがユーザに表示されません。その結果、zmanは、資格情報の入力を待ち続けて、ハングしたのと同じような状態になります。

アクション: -U|--Userおよび-P|--Passwordオプションを使用して、コマンドの一部として資格情報を指定します。

アクション: admin-store-credentialコマンドを使用して、資格情報を保存し、コマンドを実行します。

アクション: >や>>などのリダイレクション演算子の代わりに、-R|--Redirectオプションを使用して、出力をファイルにリダイレクトします。

ソース: ZENworks; zman

説明: system-update-staging-group-createコマンドにステージグループ名オプション引数を渡さなかった場合、zmanは誤ったメッセージを表示します。

Successfully created the object "null"

アクション: 新たに作成されたステージンググループを含む、ステージンググループのリストを表示するには、コンソールプロンプトでsystem-update-staging-group-list (susgl)コマンドを実行します。

ソース: ZENworks; zman

説明: zman ssaimgコマンドを使用してイメージングの役割を設定した場合、役割はデバイスにただちに追加されます。役割がただちに追加されない場合は、次回のデバイス更新スケジュールのときにのみ追加されます。

アクション: 役割をただちにデバイスに適用したい場合には、次のいずれかの方法で、手動でデバイスを更新する必要があります。

ソース: ZENworks; zman

説明: ZENworks Linuxサーバ上で非rootユーザがzmanコマンドを実行すると、次のエラーメッセージが表示されます。

zmanコマンドを実行する十分な権限がありません。Linuxの非ルートユーザである場合、zmanコマンドを実行するにはzmanusersグループに属している必要があります。

アクション: zmanコマンドを実行する前に、非rootユーザをzmanusersグループに追加します。

ソース: ZENworks; zman

説明: 非ルートユーザが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

アクション: 次の操作を実行してください:

ソース: ZENworks; zac

説明: エージェント監査ファイルがサテライトサーバにアップロードされる際、collectionStatsDBデータベース内の監査ファイルへの参照は保持されます。データベースが破損している場合、すべての参照が失われ、ファイルは孤立することになります。そのため、エージェント監査ファイルをプライマリサーバにアップロードするためにzac cuoコマンドを実行すると、エラーが発生します。

アクション: エージェント監査ファイルをプライマリサーバにアップロードするには、サテライトサーバで次の手順を実行してください。

ソース: ZENworks; zman

説明: 一部のzmanコマンドは、OutOfMemoryエラーが発生して失敗する可能性があります。

アクション: zmanの最大ヒープサイズを増やすには、次のように指定します。

ソース: ZENworks; zman

説明: zmanコマンドssdが、次のエラーにより失敗します。

An internal error occurred. Please check the zman log for more (内部エラーが発生しました。詳細については、zmanログを確認してください)

サテライトから役割を削除するためのzmanコマンドssdを使用すると、役割が削除されますが、サテライト更新クイックタスクの送信には失敗します。

考えられる原因: これはサテライト用のサテライト更新クイックタスクがすでに処理中であるか、これから処理されるためです。

アクション: なし

ソース: ZENworks、zac

説明: RHELサテライトサーバ上でzacコマンドを実行する際に、プロセスが無期限にハングします。

考えられる原因: コンテンツの複製スケジュールが短時間に設定されています。たとえば、5分です。

アクション: ZENworksコントロールセンターにログインして、ゾーンのシステム変数enable.cdp.cleanup.thread.wait.timeを追加し、値をTrueに設定します。

ソース: ZENworks

説明: 設定アクションは次の警告で完了します。

com.novell.zenworks.configure.NonFatalConfigureException: ZEN configure action container is not responding (com.novell.zenworks.configure.NonFatalConfigureException: ZEN設定アクションコンテナが応答していません)

考えられる原因: この問題は、ZENConfigureコンテナが待機時間内に初期化に失敗したため、発生しました。

アクション: /etc/opt/microfocus/zenworks/host-configure-action.propertiesディレクトリのmax-retries-for-configure-server=<再試行回数>設定プロパティを使用して、ZENConfigureコンテナの待機時間を増やします。max-retries-for-configure-serverのデフォルト値は60です。