MID サーバーパラメーター
パラメーターは特定の MID サーバーの動作を制御し、MID サーバープロパティよりも優先順位が低いです。
必要なパラメーター
- URL
- 関連するインスタンスへの URL を指定します。通常、この URL は https://instance.service-now.com のようになります。instance はインスタンス名に置き換えます。独自のインスタンスをホストしている場合は、組織が設定した URL を使用します。
- タイプ:文字列
- デフォルト値:なし
- mid_sys_id
- MID サーバーレコードの一意の識別子を記録します。最初に MID サーバーを設定するときは、このパラメーターを空にする必要があります。値を変更しないでください。
- タイプ:文字列
- デフォルト値:自動設定 (GUID)
- name
- このパラメーターを使用して、わかりやすい名前を指定します。このパラメーターを指定しない場合、MID サーバーはデフォルト値を使用します。一連のビジネス ルールにより、構成ファイルの名前と MID サーバーレコードの名前が同期されます。このビジネス ルールにより、ある場所で名前を変更すると、別の場所の名前も変更されます。
- タイプ:文字列
- デフォルト値:YOUR_MIDSERVER_NAME_GOES_HERE
- mid.instance.username または glide.glidesoap.username
- デフォルトと同様に ServiceNow インスタンスの認証が有効になっている場合は、このパラメーターを設定して、MID サーバーがインスタンスへのログインに使用するユーザー名を定義します。必要なテーブルとフィールドにアクセスするために、このユーザーは ServiceNow インスタンスに対する mid_server ロールを持つ必要があります。このパラメーターを使用して、特殊文字を持つユーザー名を定義することができます。
- タイプ:文字列
- デフォルト値:なし
- mid.instance.password または glide.glidesoap.password
- デフォルトと同様に ServiceNow インスタンスの認証が有効になっている場合は、このパラメーターを設定して、MID サーバーがインスタンスへのログインに使用するパスワードを定義します。このパラメーターを使用して、特殊文字を持つパスワードを定義することができます。
- タイプ:文字列
- デフォルト値:なし
CIM パラメーター
- mid.cim.batch.size
- CIM サーバーに一度に送信されるメッセージの最大数を指定します。
- タイプ:整数
- デフォルト値: 1
- mid.cim.request.interval
- 同じ共通情報モデル オブジェクト マネージャー (CIMOM) への要求の間に待機するミリ秒数を指定します。
- タイプ:整数
- デフォルト値:0
- mid.cim.host.connection.limit
- 各 CIMOM への最大同時接続数を指定します。値を 0 にすると同時接続が無効になります。
- タイプ:整数
- デフォルト値:0
接続パラメーター
- glide.mid.fast.responses
- 準備ができ次第インスタンスへのメッセージの送信を試みるよう MID サーバーに指示します。通常、MID サーバーは ServiceNow インスタンスへのメッセージを連続的に (つまり、一度に 1 つのメッセージを) 終了します。多くのプローブが並列で実行されることがあるため、複数のメッセージが同時にインスタンスに送信されることがあります。このパラメーターを true に設定すると、プローブが完了してから応答がインスタンスに到着するまでの時間が短縮される可能性があります。ただし、複数の同時メッセージはリソースを消費し、全体的なインスタンスの応答性を低下させます。また、通信に問題がある場合、通常はプローブを実行するために使用されるスレッドがメッセージを送信するために使用される可能性があるため、このパラメーターの値によって MID サーバーで渋滞が発生する可能性もあります。通常は、このパラメーターは構成から除外してください。このパラメーターを true に設定することは、非常に特殊な状況下でのみ意味があります。
- タイプ:true | false
- デフォルト値:false
- glide.mid.max.sender.queue.size
- キューを取得できる大きさに上限を設定します。この制限を超えると、MID サーバーはキューに格納されたメッセージの削除を開始します。MID サーバーが送信できるよりも早く ServiceNow インスタンスへのメッセージを生成すると、MID サーバーホストのファイル システムでメッセージが一時的にキューに格納されます。このキューは通常は非常に小さく、短時間 MID サーバーの処理が低速になるとすぐに完全に空になります。ただし、MID サーバーとインスタンスの間の通信に問題がある場合、特に MID サーバーで統合が実行されている場合は、このキューのサイズが大きくなる可能性があります。 このパラメーターの形式は {number}{multiplier} です。{number} は非整数を含む正の 10 進数で、オプションの {multiplier} は bytes、kilobytes、megabytes、gigabytes、または terabytes のスペルです (最初の文字のみがテストされ、このテストでは大文字と小文字は区別されません)。デフォルトの乗数はバイトです。空白は自由に使用できます。次の文字列はすべて有効なパラメーターを表しています:「1000000000」、「0.5m」、「5 GB」、「7.67gigas」、「145.69392 meg」、および「1.1 terra」。
- タイプ:文字列
- デフォルト値:0.5 GB
- instance.date.format
- インスタンスが日付と時刻に使用する形式を指定します。このパラメーターを設定することの主な影響は、MID サーバーが ServiceNow の MID サーバーレコードの開始時間と停止時間を正しく更新できるようになることです。この日付/時刻文字列の形式は、Java SimpleDateFormat クラスで使用されるものと同じです。
- タイプ:文字列 (日付形式)
- デフォルト値:yyyy-MM-dd HH:mm:ss
- mid.disable_amb
- 新しい ECC キュー出力メッセージの非同期メッセージバス (AMB) 通知を無効にします。詳細については、「Asynchronous Message Bus」の「非同期メッセージバス」セクションを参照してください。AMB が有効になっている場合、MID サーバーは AMB が無効になっている場合とは異なるデフォルトのポーリング間隔を使用します。詳細については、mid.poll.time パラメーターを参照してください。mid.poll.time パラメーターでポーリング間隔を設定した場合は、AMB クライアントが有効かどうかにかかわらず、MID サーバーがその値を使用します。
- タイプ:true | false
- デフォルト値:false
- mid.https.truststore.password
- 非同期メッセージバス (AMB) クライアントとの HTTPS 接続に必要な trustStore パスワードを設定します。
- タイプ:文字列
- デフォルト値:なし
- mid.https.truststore.path
- TLS トランザクション (非同期メッセージバス (AMB) クライアント) の MID サーバーによって使用される trustStore へのパス。デフォルトのパスを変更する場合にのみ、このパラメーターを追加します。
- タイプ:文字列
- デフォルト値:MID サーバーにバンドルされている JRE trustStore へのパス
- mid.instance.skip_basic_auth
ベーシック認証情報の代わりに Cookie を使用して MID サーバーがインスタンスにコネクトできるようにします。true に設定すると、最初に Cookie が使用されます。ただし、接続が失敗した場合、MID サーバーはベーシック認証情報を使用して再接続を試行します。
- タイプ:true | false
- デフォルト値:true
- mid.jmx.enabled
- MID サーバー上の JMX サーバーを有効にします。このサーバーは、JMX コンソールにいくつかの管理情報を公開します。JMX を実装するには、Java ランタイム環境の追加構成が必要です。このパラメーターを true に設定することは、Java セキュリティ アーキテクチャについての詳細な知識があり、JMX のための特定のニーズがあるユーザーにのみ推奨されます。
- タイプ:true | false
- デフォルト値:false
- mid.poll.time
デフォルトの MID サーバーのポーリング間隔 (秒単位) を設定します。このポーリング間隔は、MID サーバーがビジー状態でない場合に、MID サーバーが作業のために ECC キューをチェックするまでの待機時間です。詳細については、「」の「非同期メッセージバス」セクションを参照してください。
mid.disable.amb が false (デフォルト設定) に設定されている場合、mid.poll.time の使用方法の詳細については、「Asynchronous Message Bus」の「非同期メッセージバス」セクションを参照してください。
mid.disable.amb が true に設定されている場合、ポーリングは固定の mid.poll.time 間隔で行われますが、MID サーバーがビジー状態の場合、ポーリングは mid.poll.time.standard (デフォルトでは 5 秒) を使用するように切り替わります。
- タイプ:整数 (秒)
- デフォルト値:mid.disable.amb が false の場合は 40、 mid.disable.amb が true の場合は 5
- mid.probe.wait.resources
- リソースが利用可能になるまでプローブの実行を遅らせるかどうかを示します。MID サーバーリソース予約を有効にするために使用されます。 注:MID サーバーの再起動が必要です。
- タイプ:true | false
- デフォルト値:true
- mid.property.long_runner
- 長時間実行されているコマンドを管理するスクリプトインクルードの名前を示します。注:このプロパティは、Rome バージョンまでのみ適用されます。インスタンスのバージョンがそれより後のバージョンの場合は、システムプロパティ glide.eccprobe.longrunner.class を設定する必要があります。
- タイプ:文字列
- デフォルト値: LongRunner
- threads.interactive.max
- インタラクティブスレッドプールで同時に実行できるインタラクティブワーカースレッドの最大数を設定します。「MID サーバースレッドの使用を設定する」を参照してください。
- タイプ:整数
- デフォルト値:10
- threads.expedited.max
- 迅速化済みスレッドプールで同時に実行できる迅速化済みワーカースレッドの最大数を設定します。「MID サーバースレッドの使用を設定する」を参照してください。
- タイプ:整数
- デフォルト値:20
- threads.max
- 標準スレッドプールで同時に実行できる標準ワーカースレッドの最大数を設定します。このパラメーターは、MID サーバーをホストしているコンピューターで MID サーバーが消費する CPU リソースを直接制御します。「MID サーバースレッドの使用を設定する」を参照してください。
- タイプ:整数
- デフォルト値:25
重要:threads.max を 200 まで設定することができますが、OS によってはこの設定を変更する必要があります。たとえば、ディスカバリーを実行している Windows ベースの MID サーバーは、リソース集約的な Powershell を使用します。この場合、スレッド数がわずか 50 でホストマシンの CPU 電力を消費する可能性があります。
認証情報パラメーター
- mid.aws.instance_profile_name
- EC2 インスタンスで構成された AWS IAM ロールの名前。構成されている場合、MID サーバーは、AWS インスタンスプロファイルによってこのロールに付与された一時的な認証情報を使用してクラウドリソースを検出します。
- タイプ:文字列
- デフォルト値:なし (ユーザーは空白以外の値を入力する必要があります)
- mid.credentials.provider
- 認証情報プロバイダーの Java クラス名を指定します。
- タイプ:文字列
- デフォルト値:com.service_now.mid.creds.standard.StandardCredentialsProvider
- mid.secure_credentials.key_pairs.provider
- MID サーバーがセキュアなキーペアを生成するために使用するクラス。
- タイプ:文字列
- デフォルト値:com.service_now.mid.keypairs.provider.standard.StandardKeyPairsProvider
デバッグ パラメーター
- debug.logging
[使用廃止] MID サーバーのイベントとメッセージ (送信と受信の両方) のログを有効にするかどうかを指定します。通常、このパラメーターは開発者のみが使用しますが、問題のトラブルシューティングに役立つことがあります。このパラメーターを true に設定すると、MID サーバーで集中的なログ記録が行われ、かなりのディスク スペースが使用される可能性があることに注意してください。
- タイプ:true | false
- デフォルト値:false
このパラメーターは mid.log.level パラメーターに置き換えられました。
- debug
[使用廃止] MID サーバーでデバッグログ記録を有効にするかどうかを指定します。通常、このパラメーターは開発者のみが使用しますが、問題のトラブルシューティングに役立つことがあります。このパラメーターを true に設定すると、MID サーバーで集中的なログ記録が行われ、かなりのディスク スペースが使用される可能性があることに注意してください。
- タイプ:true | false
- デフォルト値:false
このパラメーターは mid.log.level パラメーターに置き換えられました。
- file.probe.template.debug
- ファイル プローブ テンプレートをデバッグするかどうかを指定します。
- タイプ:true | false
- デフォルト値:false
- mid.cim.debug
- CIM、WBEM、SLP、または SMI-S のデバッグ ログを有効にするかどうかを指定します。
- タイプ:true | false
- デフォルト値:false
- mid.ssh.debug
- ログ ファイル内の SSH デバッグ情報を有効にします。このパラメーターの使用方法は、ServiceNow SSH クライアントが有効かどうかによって異なります。ServiceNow SSH クライアントが有効な場合、このパラメーターは次のように機能します。
- タイプ:文字列
- デフォルト値:false
ServiceNow SSH クライアントには次の文字列値が有効です。
- true:ログ ファイル内の SSH デバッグ情報を有効にします。
- false:ログ ファイル内の SSH デバッグ情報を無効にします。
- <IP Addresses>:ログ ファイル内の SSH デバッグ情報を有効にする IP 範囲を指定します。IP アドレスは、次の形式で入力できます。
- サブネットワーク内のスラッシュとビット数で定義された IP 範囲。たとえば、文字列 10.10.10.0/24 は 24 ビットの IP アドレス 10.10.10.0 から 10.10.10.254 までをスキャンします。
- ダッシュで定義された IP 範囲。たとえば、文字列 10.10.11.0-10.10.11.165 は IP アドレス 10.10.11.0 から 10.10.11.165 までをスキャンします。
- 特定の IP アドレスをカンマで区切ったリスト。たとえば、文字列 10.10.11.200,10.10.11.235 は IP アドレス 10.10.11.200 および 10.10.11.235 をスキャンします。
- 保留:エラーまたは警告が発生しない限り、SSH デバッグ情報をメモリに記録します。エラーまたは警告が発生した場合は、プラットフォームがデバッグ情報をログファイルに公開します。これにより、ログファイルのうちエラーまたは警告に関連する部分のみが確実に記録されるようになります。エラーまたは警告が検出されなかった場合、プラットフォームはセッションの終了時にメモリから未使用のログデータを削除します。各セッションには、最大 1000 件のログメッセージが保存されます。セッションのログメッセージが 1000 件を超えた場合、保留されたログの最も古いログメッセージが破棄され、最新のログメッセージのための空きが確保されます。
ServiceNow SSH クライアントが無効になっている場合、このパラメーターはログ ファイル内の SSH デバッグ情報を有効または無効にします。- タイプ:true | false
- デフォルト値:false
注:MID サーバーパラメーター mid.ssh.debug は、SNCSSH と J2SSH にのみ影響します。Maverick クライアントのデバッグログ記録を有効にするには、MID サーバー設定パラメーター mid.log.level をdebug, com.maverick=debugに設定します。 - mid.log.level
- MID サーバーのログ レベルを指定します。可能な値:
- debug
- 情報
- 警告
- エラー
注:値の大文字と小文字は区別されません。- タイプ:文字列
- デフォルト値:info
- mid.http.idle_connection_monitor.debug
- アイドル接続監視のデバッグ ログを有効にします。
- タイプ:true | false
- デフォルト値:false
DNS パラメーター
- mid.dns_scan.regulator.interval_ms
- DNS スキャンの間隔をミリ秒単位で指定します。
- タイプ:整数
- デフォルト値:10
- mid.dns_scan.regulator.packets_per_interval
- DNS スキャンごとのレギュレーター パケット数を指定します。
- タイプ:整数
- デフォルト値: 1
- mid.dns_scan.default_name_servers
- デフォルト ネーム サーバーのホスト名または IP アドレスを指定します。
- タイプ:文字列
- デフォルト値:なし
- mid.dns_scan.default_name_servers
- デフォルト ネーム サーバーのホスト名または IP アドレスを指定します。
- タイプ:文字列
- デフォルト値:なし
- mid.dns_scan.additional_name_servers
- 追加のネーム サーバーのホスト名または IP アドレスを指定します。
- タイプ:文字列
- デフォルト値:なし
- mid.dns_scan.load_balancing_enable
- ネーム サーバーの負荷分散を有効にするかどうかを指定します。
- タイプ:true | false
- デフォルト値:false
- mid.probe.use_legacy_forward_dns
- 従来の DNSNameResolver プローブを有効にし、デフォルトの DNSNameResolver プローブを無効にします。詳細については、「Probes used by Orchestration」を参照してください。
- タイプ:true | false
- デフォルト値:false
- mid.probe.use_legacy_reverse_dns
- 従来の DNS プローブを有効にし、デフォルトの DNS プローブを無効にします。デフォルトの DNS プローブの機能で問題が発生した場合は、このパラメーターを使用してこれらの機能を無効にします。デフォルトの DNS プローブの機能には、並列で実行されるため軽量で高速な機能がありますが、従来のプローブはシリアルで実行されるため MID サーバーによって抑制されます。デフォルトのプローブは、MID サーバーホスト OS による DNS ルックアップを使用して、維持されている DNS キャッシュを利用します。従来のプローブとは異なります。そのため、Windows システムでデフォルトのプローブによる DNS ルックアップが失敗した後、OS は NETBIOS 名によるルックアップも試行します。
- タイプ:true | false
- デフォルト値:false
イベント管理パラメーター
- mid.probe.event.bulk_size
- イベント ペイロードの最大サイズを MB 単位で指定します。
- タイプ:整数
- デフォルト値: 120
- mid.probe.event.wait_time
- イベントを送信するための空のキューでの待機時間。
- タイプ:整数
- デフォルト値:1000
- mid.probe.event.send.enabled
- イベントの送信を有効または無効にします。
- タイプ:true | false
- デフォルト値:true
- mid.probe.event.queue.max_size
- 受信イベントが却下される前にイベント キューに対して許可される最大サイズを指定します。
- タイプ:整数
- デフォルト値:100,000
- mid.probe.event.max.retry_time
- MID がイベントの送信を再試行する最大秒数。
- タイプ:整数
- デフォルト:1800
- mid.probe.event.queue.use_bulk
- イベントをサーバーに単独で送信するか、バルクで送信するかを指定します。このパラメーターが true と評価された場合、イベントは一括でサーバーに送信されます。
- タイプ:true | false
- デフォルト値:true
- mid.probe.event.suppress.whitespaces
- 複数行イベントの説明フィールド内で改行を許可します。イベントコネクタインスタンスで使用する各 MID サーバーに、このパラメーターを適用します。選択肢は次のとおりです。
- すべて
- この設定では、すべての空白が削除されます。
- leave_as_is
- この設定では、すべての空白が維持されます。
- keep_newline
- この設定は改行のみを保持し、他のすべての空白を削除します。
- タイプ:文字列
- デフォルト:すべて
- mid.em.metric.metric_to_ci_map_limit
- CI マップごとに許可されるアクティブなメトリクスの最大数を指定します。
- タイプ:整数
- デフォルト値:200,000
- mid.em.metric_binding_timeout_seconds
- 未処理のイベントを再送信するまでに待機する秒数を指定します。
- タイプ:整数
- デフォルト値:300
- mid.em.metric_binding_timeout_max_seconds
- 未処理のイベントを再送信するまでに待機する最大秒数を指定します。
- タイプ:整数
- デフォルト値:10800
- mid.em.metric_max_elapsed_time_before_refresh
- メモリ内のメトリクスソース タイプのキャッシュをリフレッシュするまでの最大秒数を指定します。
- タイプ:整数
- デフォルト値: 60
- mid.em.matric_max_sql_string_length_for_types
- SQL コマンドに使用される文字列 (タイプで構成される) の最大長を指定します。
- タイプ:整数
- デフォルト値:30000
- mid.em.statistics_report_perioon_sec
- インスタンスへの統計情報レポートの間隔を秒単位で指定します。0 を使用するとレポートは無効になります。このパラメーターには再起動が必要です。
- タイプ:整数
- デフォルト値: 60
- mid.em.metric_connector_max_run_time_seconds
- 各サイクルでメトリクスを収集する最大秒数を指定します。
- タイプ:整数
- デフォルト値:300
- mid.em.metric_connector_history_min
- メトリクスを取得するために履歴に戻る時間を分単位で指定します。
- タイプ:整数
- デフォルト値:180
- mid.em.metric_event_logging
- メトリクスとイベント ロギングのレベルを指定します。選択肢は次のとおりです。
- なし
- すべて
- イベント
- メトリクス
- メトリクス:<フィルター>
- イベント:<フィルター>
- タイプ:文字列
- デフォルト値:なし
- mid.em.metric_connector_late_arrivals_delay
- メトリクスを収集するときに遅延する秒数を指定します。
- タイプ:整数
- デフォルト値:30
FTP 接続パラメーター
- mid.ftp.max_pool_size
- FTP 接続プールの最大サイズをメガバイト単位で指定します。
- タイプ:整数
- デフォルト値:25
- mid.ftp.max_per_target
- ターゲットごとの FTP 接続の最大数を指定します。
- タイプ:整数
- デフォルト値:5
- mid.ftp.max_conn_idle_time
- プール内で FTP 接続がアイドル状態になる最大時間をミリ秒単位で指定します。
- タイプ:整数
- デフォルト値: 300000
- mid.filesystem.max.ls
- filesystem list directory コマンドで返すことができるファイルの最大数を指定します。
- タイプ:整数
- デフォルト値:10000
ログ記録パラメーター
- disable_monitors
- MID サーバーがインスタンスでの監視をアクティブにチェックすることを無効にするかどうかを指定します。
- タイプ:true | false
- デフォルト値:true
- mid.show.queries
- ServiceNow インスタンスに対して行うすべてのクエリーに関する詳細を記録するかどうかを MID サーバーに指示します。通常、このパラメーターは開発者のみが使用しますが、問題のトラブルシューティングに役立つことがあります。このパラメーターを true に設定すると、MID サーバーで集中的なログ記録が行われ、かなりのディスク スペースが使用される可能性があることに注意してください。
- タイプ:true | false
- デフォルト値:false
- disable.remote.logging
- MID サーバーがインスタンス上の MID サーバーログに情報を記録しないようにします。どのような場合でも、インスタンスで記録される情報は比較的少ないですが、このパラメーターを true に設定すると、インスタンスへのすべてのログ記録が行われなくなります。
- タイプ:true | false
- デフォルト値:false
- disable.status
- MID サーバーが 10 分ごとにインスタンスにステータス レポートを送信しないようにします。
- タイプ:true | false
- デフォルト値:false
- mid.file_cleaner.disabled
次のフォルダー内のファイルや空のフォルダーは、この MID ファイルクリーナーによって削除される場合があります。最後のアクセスから 30 日以上経過しているファイルは削除されます。起動時に実行され、その後は 24 時間ごとに実行されます。MID サーバーサービスを再起動することで、ファイルクリーナーを強制的に実行できます。
クリーニングされるフォルダー/ファイル:\agent\import- \
agent\export- エクスポートセット機能で使用されます。 - \
agent\work\monitors\ECCSender\output_error- 何らかの理由で挿入できない ECC 入力ペイロードに使用されます。 - \
agent\work\monitors\ECCSender\output_oversize- mid.eccq.max_payload_size で設定された制限 (デフォルトは 200,000,000 バイト) よりも大きいためにインスタンスに送信されないペイロードのコピーを保存するために使用されます。 - \
agent\logs- 具体的には JFR ダンプ
- タイプ:true | false
- デフォルト値:false
mTLS プロトコルパラメーター
これらのパラメーターを、MID サーバーインストールディレクトリの /agent ディレクトリにある config.xml ファイルに追加します。
- mid.httpclient.protocol.myprotocol.path
-
キーストアへのパスを指定します。パスは、絶対パスまたは相対パスにすることができます。パラメーター名の myprotocol を、使用するプロトコルの名前に置き換えてください。
タイプ:文字列。
- mid.httpclient.protocol.myprotocol.port
-
プロトコルのポート番号を指定します。パラメーター名の myprotocol を、使用するプロトコルの名前に置き換えてください。
タイプ:文字列。
- mid.httpclient.protocol.myprotocol.password
-
mTLS 認証情報パスワードを指定します。パラメーター名の myprotocol を、使用するプロトコルの名前に置き換えてください。暗号化属性 secure="true" を追加し、標準の MID サーバー暗号化を使用してパスワードを暗号化します。
タイプ:文字列。
パターンパラメーター
- mid.parsing.max_field_size
パターンの実行中に一時変数として保存される文字列の最大文字数を設定します。このパラメーターの値よりも長い文字列は、値と等しくなるように切り捨てられます。長い文字列を解析するときは、パラメーターを使用して制限を増やします。
警告:SQL データベース実装の最大フィールドサイズ制限を超えると、エラーが発生します。- タイプ:整数
- デフォルト値:1024
- mid.sa.discovery.pattern_string_attributes.deduplicate
重複する文字列を排除することで、パターン実行コンテキスト属性のメモリ消費量を削減します。
- タイプ:true | false
- デフォルト:true
プロキシ サーバー パラメーター
- mid.instance.use_proxy または mid.proxy.use_proxy
- ServiceNow インスタンスにアクセスするために MID サーバーが Web プロキシを経由する必要がある場合は、このパラメーターを true に設定し、プロキシを使用するように MID サーバーに指示します。また、プロキシ サーバーのホストとポートに加えて、おそらくはユーザー名とパスワードも設定する必要があります。
- タイプ:true | false
- デフォルト値:false
- mid.proxy.host
- ServiceNow インスタンスにアクセスするために MID サーバーが Web プロキシを経由する必要がある場合は、このパラメーターを設定してプロキシのホストを定義します。
- タイプ:文字列
- デフォルト値:なし
- mid.proxy.password
- ServiceNow インスタンスにアクセスするために MID サーバーが Web プロキシを経由する必要があり、プロキシにパスワードが必要な場合は、このパラメーターを設定してパスワードを定義します。
- タイプ:文字列
- デフォルト値:なし
- mid.proxy.port
- ServiceNow インスタンスにアクセスするために MID サーバーが Web プロキシを経由する必要がある場合は、このパラメーターを設定してプロキシのポートを定義します。
- タイプ:整数 (0 ~ 65535)
- デフォルト値:80
- mid.proxy.username
- ServiceNow インスタンスにアクセスするために MID サーバーが Web プロキシを経由する必要があり、プロキシにユーザー名が必要な場合は、このパラメーターを設定してユーザー名を定義します。
- タイプ:文字列
- デフォルト値:なし
要求タイムアウトの上書きパラメーター
- mid.sa.cloud.request_timeout
- クラウド要求のタイムアウトをミリ秒単位で設定します。このパラメーターは、送信 REST トランザクションがタイムアウトするまで待機する最大ミリ秒数を指定する glide.http.timeout システムプロパティを上書きします。
- タイプ:整数
- デフォルト値:30000
- mid.http_classy.request_timeout
- HTTP 分類プローブを使用して HTTP 分類要求のタイムアウトをミリ秒単位で設定します。このパラメーターは、送信トランザクションがタイムアウトするまで待機する最大ミリ秒数を指定する glide.http.timeout システムプロパティを上書きします。
- タイプ:整数
- デフォルト値:30000
セキュリティパラメーター
- mid.windows_host.file_permissions.allow_list
- セキュリティを向上させるために、Windows ファイル権限適用の包含リストを設定します。このパラメーターは、カンマ区切りのグループ名、ユーザー名、および SID の文字列を受け取ります。グループ名とユーザー名は、SAM アカウントの命名要件に従う必要があります。ドメインアカウントは、SID を使用して指定できます。
- タイプ:文字列(カンマ区切りのグループ名とユーザー名)
- デフォルト値:なし
- mid.windows_host.file_permissions.enforce
- MID サーバーが Windows ファイル権限適用を使用してセキュリティを強化できるようにします。このパラメーターを false に設定すると、MID サーバーはファイル権限包含リストを更新できなくなりますが、ファイル権限は元に戻りません。
- タイプ:true | false
- デフォルト値:true
Shazzam パラメーター
- mid.shazzam.regulator.interval_ms
- Shazzam がパケットを開始できる間隔をミリ秒単位で設定します。このパラメーターは、mid.shazzam.regulator.packets_per_interval パラメーターと連携して、この間隔で許可されるパケット数を設定します。デフォルトでは、Shazzam は 1 ミリ秒ごとに 1 パケットを開始します。
- タイプ:整数
- デフォルト値: 1
- mid.shazzam.regulator.packets_per_interval
- 設定された時間間隔で Shazzam が開始できるパケット数を設定します。このパラメーターは、この間隔を設定する mid.shazzam.regulator.interval_ms パラメーターと連携します。デフォルトでは、Shazzam は 1 ミリ秒ごとに 1 パケットを開始します。
- タイプ:整数
- デフォルト値: 1
- mid.shazzam.chunk_size
- Shazzam が並行してスキャンする IP アドレスの最大数を指定します。このパラメーターは、主に送信ポートの消費を制御します。
- タイプ:整数
- デフォルト値: 100
- mid.shazzam.threads
- Shazzam が使用する同時スレッド数を指定します。これまたは mid.shazzam.max_scanners_per_thread パラメーターを 0 に設定すると、Shazzam マルチスレッド最適化が無効になります。
- タイプ:整数
- デフォルト値:5
- mid.shazzam.max_scanners_per_thread
- 各 Shazzam スレッドによって処理される同時スキャナーの数を指定します。これまたは mid.shazzam.threads パラメーターを 0 に設定すると、Shazzam マルチスレッド最適化が無効になります。
- タイプ:整数
- デフォルト値: 500
SNMP 設定パラメーター
- mid.snmp.enable_auto_public
- 他の SNMP 認証情報が成功しなかった場合は自動的に SNMP パブリック コミュニティ文字列を使用するかどうかを指定します。
- タイプ:true | false
- デフォルト値:true
- mid.snmp.request.timeout
- 最初の OID 要求のタイムアウト値をミリ秒単位で指定します。後続の要求 (たとえば、テーブル OID) では、mid.snmp.session.timeout configuration 設定パラメーター (下記参照) が有効になります。注:このパラメーターは、timeout SNMP プローブパラメーターで上書きできます。
- タイプ:整数
- デフォルト値:1500
- mid.snmp.session.timeout
- 後続の OID 要求のタイムアウト値をミリ秒単位で指定します。SNMP 通信はステートレスであり、通常の意味においてセッションまたは接続を持ちません。システムは、最初の OID 要求からの肯定的な応答を、後続の要求に対する迅速な応答を期待すべきサインとみなします。デフォルトでは短いですが、このパラメーター値を mid.snmp.request.timeout に使用するのと同じ値に増加すると便利です。注:このパラメーターは、establish_session_timeout SNMP プローブパラメーターで上書きできます。
- タイプ:整数
- デフォルト値: 500
- mid.snmp.use_getbulk
- 大量のデータを一括で受信するために GETBULK を使用するかどうかを指定します。これは、個別の MID サーバーを構成するために使用できます。
- タイプ:true | false
- デフォルト値:True
GETBULK は、プローブレベルまたはグローバルですべての MID サーバーに対して設定することもできます。設定は、優先度の順にリストされます。- SNMP プローブパラメーター
- MID サーバー設定パラメーター
- MID サーバープロパティ
- mid.snmp.use_snmp4j
- SNMP 通信に Snmp4j ライブラリーを使用します。これは SNMPv3 の厳密な要件です。このパラメーターは、カスタマーサービス & サポート からのアドバイスに基づいて false にのみ設定する必要があります。
- タイプ:true | false
- デフォルト値:true
- mid.snmp.use_snmp_v1_v2c
-
SNMPv1 および SNMPv2c プロトコル バージョンを使用して通信を試みます。SNMP community credentialsの構成が必要になる場合があります。このパラメーターは代替であり、 SNMPv3 の厳密な要件ではありません。
- タイプ:true | false
- デフォルト値:true
- mid.snmp.use_snmp_v3
- SNMPv3 プロトコル バージョンを使用して通信を試みます。SNMPv3 認証情報の設定が必要です。
- タイプ:true | false
- デフォルト値:true
SSH ディスカバリーパラメーター
- /usr/sbin
- /usr/bin
- /bin
- /sbin
- mid.connection_cache
- 接続をキャッシュするかどうかを指定します。接続キャッシュを無効にするには、false に設定します。このパラメーターは、SSH 接続にのみ適用されます。
- タイプ:true | false
- デフォルト値:true
- mid.ssh.disable_history
- シェルセッション履歴をターゲットホストに保存するかどうか、
および HISTFILE=/dev/nullコマンドを実行するかどうかを制御します。このプロパティを false に設定すると、ターゲット ホストに履歴が保持され、HISTFILE=/dev/nullコマンドがターゲット デバイスに送信されなくなります。- タイプ:true | false
- デフォルト値:true
- mid.ssh.set_path
- SSH コマンド用の PATH 環境変数を設定するかどうかを指定します。
- タイプ:true | false
- デフォルト値:true
- mid.ssh.local
- コンソールからではなく SSH 経由で MID サーバーホスト マシン (localhost) に対してコマンドを実行するかどうかを指定します。これにより、長時間実行されるコマンドを適切に実行することができます。このパラメーターは、レガシー SSH クライアントにのみ適用されます。
- タイプ:true | false
- デフォルト値:false
- mid.ssh_connections_per_host
- MID サーバーが特定のホストに対して実行できる同時プローブの数を制御します。同時接続数を減らすとディスカバリーが遅くなることがあります。
- タイプ:整数
- デフォルト値:
ServiceNow クライアントの場合は 7
従来の SSH クライアントの場合は 3。
- mid.ssh.sudo_preserve_environment
- SSH の環境を保持するために sudo を使用するかどうかを指定します。
- タイプ:true | false
- デフォルト値:false
- mid.ssh.terminal.width
- ターミナルで sudo -l を処理するときの 1 行あたりの最大文字数を制御します。値が小さすぎると、出力が複数の行に分割され、パーサーに影響を与える可能性があります。必要に応じて、出力を処理するのに十分なサイズに値を設定します。
- タイプ:整数
- デフォルト値:255
- mid.ssh.path_override
- コマンドを実行する前に設定されているデフォルトのパスを上書きします。コロン (:) で区切られた 1 つ以上の上書きパスを入力します。デフォルトのパスは /usr/sbin: /usr/bin: /bin: /sbin です。
- タイプ:文字列 (コロンで区切られたディレクトリのリスト)
- デフォルト値:なし
ServiceNow SSH クライアントは、path_overide 値の前に次のプリフィックスを受け入れます。- append:上書きパスをホストのパスの末尾に追加します。これはデフォルトの動作です。
- replace:ホストパスを path_overide 値に置き換えます。
- prepend:上書きパスをホストパスの先頭に追加します。
- mid.ssh.use_snc
- 個々の MID サーバー上の ServiceNow SSH クライアント (SNCSSH) を有効にする。SNCSSH は ServiceNow SSH クライアントの実装であり、MID サーバープロパティ によってデフォルトでは新しいインスタンスのすべての MID サーバーに対してアクティブです。ServiceNow SSH クライアントの有効にすると、従来の J2SSH クライアントは無効になります。重要:同じインスタンスに接続されている MID サーバーの SSH クライアント タイプを混在させることは良い方法ではありません。
- タイプ:true | false
- デフォルト値:false
- mid.ssh.max_retries
- タイムアウト後に SSH 操作を再試行する最大時間を指定します。システムは、接続試行のたびに 2 秒間スリープします。デフォルトでは、MID サーバーは一度だけ再試行します。パラメーターを 0 に設定すると再試行は無効になります。
- タイプ:整数
- デフォルト値: 1
- mid.ssh.alt_rm
- 別の SSH ファイル削除コマンドを設定します。
- タイプ:文字列
- デフォルト値:なし
- mid.ssh.initial_delay_ms
- ターゲットへの接続後に SSH プローブ コマンドをサーバーに送信するのを指定された時間 (ミリ秒単位) 遅らせます。このパラメーターは、レガシー SSH クライアントにのみ適用されます。
- タイプ:整数 (ミリ秒)
- デフォルト値:0
- mid.ssh.suppress_history
- SSH 履歴ファイルの生成を抑制します。このパラメーターは、レガシー SSH クライアントにのみ適用されます。
- タイプ:true | false
- デフォルト値:false
- mid.ssh.socket_timeout
- ソケット タイムアウトによって発生する問題を防ぐために、SSH ソケットのタイムアウト値を指定します。SSH が有効になっている UPS や PDU などの組み込みコントローラーを搭載したシステムなど一部のデバイスでは、認証要求に応答するためにより多くの時間が必要です。デフォルト値の 2 分は、そのような要求のタイムアウトが早すぎないようにします。
- タイプ:整数 (ミリ秒)
- デフォルト値:120000 (2 分)
- mid.ssh.channel_timeout
- 接続を閉じる前に、MID サーバーが SSH ソケット上のアクティビティを待機する時間を指定します。指定されたタイムアウト値の間 SSH ソケットにアクティビティがない場合、MID サーバーは接続を閉じます。SSH が有効になっている UPS や PDU などの組み込みコントローラーを搭載したシステムなど一部のデバイスでは、認証要求に応答するためにより多くの時間が必要な場合があります。
- タイプ:整数 (ミリ秒)
- デフォルト値:120000 (2 分)
- mid.ssh.session_timeout
- 前回の使用後にキャッシュされたセッションをメモリに残す時間を指定します。値が小さすぎるとパフォーマンスが低下しやすくなります。このパラメーターは、ServiceNow SSH クライアントにのみ適用されます。
- タイプ:整数 (ミリ秒)
- デフォルト値:300000 (5 分)
- mid.ssh.command_timeout_ms
- SSH コマンドの実行のタイムアウト時間 (ミリ秒単位)。
- タイプ:整数 (ミリ秒)
- デフォルト値:300000 (5 分)
- mid.ssh.use_keyboard_interactive
- 有効化された SSH デーモンでキーボード インタラクティブ認証モードを使用します。
- タイプ:true | false
- デフォルト値:false
警告:Mac OS X Sierra 以降では、[パスワード] の認証順および [キーボードインタラクティブ] モードによりディスカバリーが失敗する可能性があるという問題があります。この問題と適切な SSH 認証に必要な設定の詳細については、「KB0623600」を参照してください。 - mid.ssh.dh_group_length_min
- 「共有秘密」鍵を生成するために使用される最小グループ長をビット単位で Diffie-Hillman 鍵交換に指定します。鍵が大きければ大きいほど、SSH 接続はより安全ですが、パフォーマンスのコストは低下します。
- タイプ:整数 (ビット)
- デフォルト値:1024
- mid.ssh.dh_group_length_max
- 「共有秘密」鍵を生成するために使用される最大グループ長をビット単位で Diffie-Hillman 鍵交換に指定します。鍵が大きければ大きいほど、SSH 接続はより安全ですが、パフォーマンスのコストは低下します。
- タイプ:整数 (ビット)
- デフォルト値:8192
- mid.ssh.shells_supported
- MID サーバーでサポートされる bourne 互換シェルを定義します。この値は、サポートされるシェルのカンマ区切りのリストです。例:[ksh]、[dsh]、[bash]、[sh]。
- タイプ:文字列
- デフォルト値:ksh、bash、sh
- mid.ssh.discard_lrc_error
- レガシー動作をエミュレートして、長時間実行されるコマンドのエラー出力を破棄します。
- タイプ:文字列
- デフォルト値:j2ssh - true、sncssh - false
- mid.ssh.pool_thread_ratio
- 設定されている MID サーバースレッド数 (threads.max) に対する SSH セッション プール キャパシティの比率をパーセンテージで示します。許可されるプール キャパシティ セッションの数はこのパラメーターで設定されます。このパラメーターに設定されている値に関係なく、システムはプール キャパシティが 25 セッション未満になることを許可しません。
- タイプ:整数
- デフォルト値:150
- mid.ssh.disable_privilege_check
- ターゲットが sudo 以外の特権コマンドを使用している場合、このパラメーターには効果がありません。詳細については、「MID サーバー特権コマンド」を参照してください。
このセクションの残りの部分は、sudo を実行するターゲットにのみ適用されます。このパラメーターを true に設定すると、MID サーバーは、認証情報で設定されているユーザーに、sudo を使用して、指定されたコマンドを実行する権限があるとみなします。MID サーバーは、ターゲットユーザーがターゲットで sudo に続くコマンド文字列を実行できるとみなします。このパラメーターを false に設定すると、MID サーバーは「sudo -l」をターゲットで実行し、sudo に続くコマンドにターゲットで動作する権限があることを確認します。このパラメーターの値にかかわらず、MID サーバーは、sudo 自体をターゲットで実行できることを常に確認します。
一部のリリースでは、MID 設定パラメータープルダウンリストにこのパラメーターが表示されません。この場合は、MID プロパティに、オプションでこのパラメーターを追加できます。
- タイプ:true | false
- デフォルト値:false
アップグレード パラメーター
- mid.pinned.version
- この MID サーバーが固定されているバージョンの名前。
- タイプ:文字列
- デフォルト値:MID buildstamp 注:インスタンスの MID buildstamp を表示するには、ナビゲーションフィルターに [stats.do] と入力します。buildstamp 形式の例は、london-06-27-2018__patch3-10-24-2018_11-11-2018_0542 です。
- mid.upgrade.use_proxy
- アップグレード URL にアクセスするために MID サーバーが Web プロキシを経由する必要がある場合は、このパラメーターを true に設定し、プロキシを使用するように MID サーバーに指示します。プロキシ サーバーのホストとポートも設定する必要があります。インスタンス プロキシのユーザー名とパスワードが設定されている場合は、アップグレード プロキシにも使用されます。注:このパラメーターは、 glide.mid.autoupgrade.proxy* パラメーターで構成されたプロキシの詳細を制御するためのものではありません。
- タイプ:true | false
- デフォルト値:true
- glide.mid.autoupgrade.proxy_host または glide.glidesoap.proxy_host
- アップグレード URL にアクセスするために MID サーバーが Web プロキシを経由する必要がある場合は、ここでプロキシのホストを定義します。
- タイプ:文字列 (URL)
- デフォルト値:なし
- glide.mid.autoupgrade.proxy_port または glide.glidesoap.proxy_port
- アップグレード URL にアクセスするために MID サーバーが Web プロキシを経由する必要がある場合は、ここでプロキシのポートを定義します。
- タイプ:整数 (0 ~ 65535)
- デフォルト値:80
- glide.mid.autoupgrade.proxy_user
- アップグレード URL にアクセスするために MID サーバーが Web プロキシを経由する必要がある場合は、ここでプロキシのユーザー名を定義します。
- タイプ:文字列 (URL)
- デフォルト値:なし
- glide.mid.autoupgrade.proxy_password
- アップグレード URL にアクセスするために MID サーバーが Web プロキシを経由する必要がある場合は、ここでプロキシのパスワードを定義します。
- タイプ:文字列
- デフォルト値:なし
Windows ディスカバリーパラメーター
- mid.powershell_api.session_pool.max_size
セッションプールで許可されるセッションの最大数を指定します。
注:このパラメーターを設定または変更するには、MID サーバーを再起動する必要があります。- タイプ:整数
- デフォルト値:25
- mid.powershell_api.session_pool.target.max_size
ターゲットホストごとにプールで許可されるセッションの最大数を指定します。
注:このパラメーターを設定または変更するには、MID サーバーを再起動する必要があります。- タイプ:整数
- デフォルト値:2
- mid sa. prefer_powershell
- MID サーバーを有効にして PowerShell リモート機能を使用します。
- タイプ:true | false
- デフォルト値:false
- mid.powershell_api.winrm.use_ssl
- WinRM を使用する HTTPS 接続には SSL 証明書の使用が必要です。
- タイプ:true | false
- デフォルト値:false
- mid.powershell_api.winrm.additional_pssesion_options
- PSSession の詳細オプションを制御します。詳細な PSSession オプションの詳細については、「https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/new-pssessionoption?view=powershell-6」を参照してください。
- mid.powershell_api.winrm.remote_https_port
- HTTPS 上で PowerShell を使用する Windows サーバーに接続するためのポートを設定します。
- タイプ:整数
- デフォルト値:5986
- mid.powershell_api.winrm.remote_port
- HTTP 上で PowerShell を使用する Windows サーバーに接続するためのポートを設定します。
- タイプ:整数
- デフォルト値:5985
- mid.powershell_api.winrm.skip_ssl_cert_check
- HTTPS 接続に WinRM を使用するときは SSL 証明書の確認をスキップします。
- タイプ:true | false
- デフォルト値:false
- mid.powershell_api.winrm.skip_ssl_cert_check_options
- HTTPS 接続に WinRM を使用するときは特定の SSL 証明書の確認をスキップします。認証局 (CA) からの証明書、証明書に関連付けられたホストを識別する共通名 (CN) からの証明書、および失効した証明書の確認をスキップするよう MID サーバーを設定します。
- タイプ:文字列
- デフォルト値:-SkipCACheck -SkipCNCheck -SkipRevocationCheck
- mid.powershell.use_credentials
- PowerShell で ディスカバリー を使用するための認証情報を判断します。true に設定すると、MID サーバーはプローブを実行するために認証情報テーブルから Windows 認証情報を使用します。MID サーバーサービスでユーザーの認証情報を使用してプローブを実行するには、このパラメーターを false に設定します。
- タイプ:true | false
- デフォルト値:true
- mid.powershell.path
- 複数の PowerShell がインストールされている場合、アドミニストレーターは MID サーバー 上の特定の PowerShell をポイントできます。PowerShell 実行可能ファイルを含むフォルダー (たとえば、C:\mypowershell または C:\mypowershell\) へのパスを指定します。ServiceNow は文字列 powershell.exe をパスに自動的に追加します。32 ビットおよび 64 ビット PowerShell の両方が同じ MID サーバーでアクティブなときにこのパラメーターを設定します。そのコンテキストでは正しい PowerShell を起動することが必要になります。64 ビット Windows はファイルシステムリダイレクトを採用し、MID サーバーは 32 ビットアプリケーションとして動作します。%WinDir%\System32 にパスを指定すると、Windows は自動的に %WinDir%\SysWOW64 にリダイレクトします。リダイレクトを回避するには、パスを %WinDir%\Sysnative として指定します。たとえば、C:\WINDOWS\system32\WindowsPowerShell\v1.0\ の代わりに、C:\WINDOWS\sysnative\WindowsPowerShell\v1.0\ を指定します。 注:Windows XP の 64 ビットバージョンでは、この機能を有効にするために Microsoft ホットフィックスが必要な場合があります。
64 ビット Windows マシン上で実行するアプリケーションを検出するため、MID サーバー は 64 ビット Windows ホストマシン上で実行する必要があります。
- タイプ:文字列 (パス)
- デフォルト値:なし
- mid.powershell.enforce_utf8
- このパラメーターを有効にすると、ターゲットの Windows システム上のコマンドは UTF-8 エンコードされた出力を返します。無効にすると、ターゲット システムはデフォルトのエンコーディングを使用できます。このパラメーターは、PowerShell が有効な場合にのみ有効です。
この値を false に設定すると、プローブによって非 ASCII 文字が返された場合に CMDB の値が不正になる可能性があります。
- タイプ:true | false
- デフォルト値:true
- mid.powershell.local_mid_service_credential_fallback
- 他の認証情報がすべて失敗した場合、自動的に MID サーバー サービスの認証情報にフォール バックすることを有効にします。
- タイプ:true | false
- デフォルト値:true
- mid.powershell_api.idle_session_timeout
アイドル状態の PowerShell セッションのタイムアウト値を秒単位で指定します。
注:このパラメーターを設定または変更するには、MID サーバー を再起動する必要があります。- タイプ:整数
- デフォルト値: 60
- mid.powershell.command.parameter_passing
- このパラメーターを有効にすると、コマンドラインから PowerShell パラメーターを渡すことができます。
- タイプ:true | false
- デフォルト値:false
- mid.powershell.command.script.parameter_passing
- このパラメーターを有効にすると、コマンドラインから PowerShell スクリプトを渡すことができます。
- タイプ:true | false
- デフォルト値:true
- mid.windows.management_protocol
デバイスおよびプロセスの分類に使用される Windows 管理プロトコルをアドミニストレーターが選択できるようにします。オプションには、WMI と WinRM があります。
- タイプ:文字列
- デフォルト値:WMI
- mid.windows.probe_timeout
- 特定の MID サーバー上のすべての Windows プローブのタイムアウト間隔を設定します。この値は、wmi_timeout プローブ パラメーターを使用して個々のプローブに対して設定された値によって上書きされます。
- タイプ:整数
- デフォルト値:300
- mid.powershell.jea.append_username
- 現在のユーザーのユーザー名を JEA エンドポイントに追加するかどうかを指定します。
- タイプ:true | false
- デフォルト値:False
- mid.powershell.jea.endpoint
- MID サーバーのコネクト先のリモートサーバー上の JEA 構成名 (エンドポイント)。JEA_DISCO_BASIC に設定します。
- タイプ:文字列
- デフォルト値:""
MID サーバーのパラメーターを追加する
特定の MID サーバーの動作をコントロールするには、MID サーバーパラメーターを使用します。
始める前に
必要なロール:admin