IBM Support

QRadar: qchange_netsetup コマンドが 'Please un-assign host before running this script.' エラーで失敗します。

Troubleshooting


Problem

管理対象ホストをデプロイメントから正しく削除した後でも、qchange_netsetup コマンドが失敗し、次のエラーが出力されます。
Please un-assign host before running this script

Symptom

エラーメッセージの例:
ERROR:
----
Please un-assign host before running this script.
----
Failed. Exit code: 255. 

Cause

一部のインスタンスにおいて、管理対象ホストをデプロイメントから削除しても管理対象ホストの設定からコンソール IP が削除されないためにエラーが発生する場合があります。

Diagnosing The Problem

管理対象ホストをデプロイメントから削除するとき、通常、管理対象ホストの次のファイルから CONSOLE_PRIVATE_IP フィールドは削除されます。
/opt/qradar/conf/nva.conf
/opt/qradar/conf/nva.hostcontext.conf
フィールドが削除されず、コンソール のプライベート IP が残ったままのときにエラーが発生します。

Resolving The Problem


qchange_netsetupを実行する前に、以下のテクニカル・ノートをご覧ください。


Procedure
  1. root ユーザーとして コンソール に SSH 接続します。
  2. 管理対象ホストに SSH 接続します。
  3. ファイルを更新する前に nva.conf と nva.hostcontext.conf の構成ファイルのバックアップを作成します。
     
    cp -p /opt/qradar/conf/nva.conf /store/backup
    cp -p /opt/qradar/conf/nva.hostcontext.conf /store/backup
  4. 次のファイルの CONSOLE_PRIVATE_IP 値を空に設定します。
    /opt/qradar/conf/nva.conf
    /opt/qradar/conf/nva.hostcontext.conf
    CONSOLE_PRIVATE_IP=
    
  5. hostcontext サービスが起動することを防ぐために、hostcontext.STOP トークン・ファイルを /opt/qradar/conf/ ディレクトリーに作成します。
     
    touch /opt/qradar/conf/hostcontext.STOP
  6. hostcontext サービスを停止します。
     
    systemctl stop hostcontext
  7. サービスがアクティブではないことを確認します。
    systemctl status hostcontext
     systemctl status hostcontext
    ● hostcontext.service - hostcontext daemon
       Loaded: loaded (/usr/lib/systemd/system/hostcontext.service; enabled; vendor preset: disabled)
      Drop-In: /etc/systemd/system/hostcontext.service.d
               └─timeout.conf, ulimit.conf
       Active: failed (Result: exit-code) since Thu 2020-09-17 13:51:39 EDT; 1h 6min ago
      Process: 29247 ExecStart=/usr/bin/env ${JAVA_HOME}/bin/java $JOPTS -classpath ${CLASSPATH} -Dcom.q1labs.frameworks.jmx.port=${JMXPORT} -Xcompressedrefs $GC_OPTS $MEM_OPTS $DUMPOPTS $REMOTE_DEBUG_OPTS com.q1labs.hostcontext.HostContext start (code=exited, status=143)
      Process: 29206 ExecStartPre=/opt/qradar/systemd/bin/check_hostcontext_stop.sh (code=exited, status=0/SUCCESS)
      Process: 28944 ExecStartPre=/opt/qradar/systemd/bin/generate_environment.sh hostcontext (code=exited, status=0/SUCCESS)
     Main PID: 29247 (code=exited, status=143)
        Tasks: 0
       Memory: 1.5G
       CGroup: /system.slice/hostcontext.service
    
  8. 管理対象ホストのネットワーク設定を変更するために、qchange_netsetup コマンドを使用します。
  9. hostcontext.STOP ファイルを削除します。

    Results
    管理対象ホストのネットワーク設定を更新したら、そのホストをQRadarのデプロイメントに追加することができます。ネットワーク設定の更新に関する問題が引き続き発生する場合は、QRadar サポートにお問い合わせください。

Document Location

Worldwide

[{"Line of Business":{"code":"LOB24","label":"Security Software"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSBQAC","label":"IBM Security QRadar SIEM"},"ARM Category":[{"code":"a8m0z000000cwtNAAQ","label":"Deployment"}],"ARM Case Number":"","Platform":[{"code":"PF016","label":"Linux"}],"Version":"All Version(s)"}]

Document Information

Modified date:
07 October 2021

UID

ibm16415703