---
title: "Netprobe Command-line Options"
description: ""
url: "https://docs.itrsgroup.com/docs/geneos/current/collection/netprobe/configuration/netprobe-command-line-options/index.html"
---
## Overview

Command-line options can either be passed to the Netprobe installer on Windows, or directly to the Netprobe binary.

## Installer command-line options

The installer command line options are available only to Windows platforms.

<div class="table-container">
    <table class="legacy-table" >
                    <col class="TableStyle-ref_2_col_table-Column-Column1"/>
                    <col class="TableStyle-ref_2_col_table-Column-Column1"/>
                    <thead>
                        <tr class="TableStyle-ref_2_col_table-Head-Header1">
                            <th class="TableStyle-ref_2_col_table-HeadE-Column1-Header1">Option</th>
                            <th class="TableStyle-ref_2_col_table-HeadD-Column1-Header1">Use</th>
                        </tr>
                    </thead>
                    <tbody>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>/netport</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Sets the Netprobe listening port.	Default: <code>7036</code></td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>/servicename=&lt;servicename&gt;</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Sets the Netprobe service name. Default: <code>NetprobeNT</code></td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>/nopassword</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Allows commands to run on the Netprobe without any prompting for a password. For more information, see  <a href="https://docs.itrsgroup.com/docs/geneos/current/security/access-controls/set-passwords-on-netprobe-commands/index.html">Set passwords on Netprobe commands</a>.</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>/pass=&lt;password&gt;</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Sets a Netprobe password.</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>/listenip	</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Sets a specific IP address where the Netprobe will listen to incoming connections.This argument can be used to force Self-Announcing Netprobe not to listen for incoming connections. For more information, see  <a href="https://docs.itrsgroup.com/docs/geneos/current/collection/netprobe/configuration/manage-self-announcing-netprobes/index.html#disable-listening">Disable listening in Manage Self-Announcing Netprobes</a>.</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>/listenoverride</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Used in conjunction with <code>/listenip</code>, overrides the previous value of <code>/listenip</code> if it exists.</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>/discovery=&lt;full path to file&gt;</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                                <p>Used in conjunction with <code>/setup</code>. If <code>/setup</code> is not defined, then this option is ignored.</p>
                                <p>If invoked, the Netprobe runs a discovery executable on the machine it is running on. This  executable extracts JSON metadata from its environment, and updates the Netprobe setup file with the metadata through the use of macros.</p>
                                If you specify a setup URL with the `?` character, then the Netprobe appends the JSON metadata as query parameters and pulls the setup file from the URL specified.
                                <p>When present, the discovery executable runs at Netprobe startup, before the Netprobe reads any setup file, and before it connects to any Gateway.</p>
                                <p>For more information, see  <a href="https://docs.itrsgroup.com/docs/geneos/current/collection/netprobe/introduction/netprobe-overview/index.html#auto-discovery">Auto-discovery in Netprobe Overview</a>.</p>
                                <p>Mandatory: No</p>
                            </td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>/setup=&lt;full path</code><code> or URL</code><code> to file&gt;</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                                <p>Sets the setup file for a self-announcing or floating Netprobe. By default, the full path is <code>&lt;directory of installer&gt;\\setup.netprobe.xml</code>. </p>
                                <p>If you use the default setup file, then this will be copied into the installation directory (for example, <code>C:\\Program Files (x86)\\NetprobeNT</code>). This new path then becomes the value of the <code>-setup</code> argument of the Netprobe imagePath registry.</p>
                                <p>If you specify your own setup file, the file will be used in its respective directory. It will not be copied into the installation directory.</p>
                                <p>If you specify a remote file (<code>&lt;url&gt;</code>           ), the Netprobe saves a copy of this in the installation directory as <code>netprobe.setup.xml</code>. This overwrites the existing <code>netprobe.setup.xml</code> file in the installation directory. In this case, any local changes to the <code>netprobe.setup.xml</code> configuration are ignored as the Netprobe retrieves the configuration from the remote file every <code>/setup-interval=&lt;minutes&gt;</code>.</p>
                                <p>If you specify an invalid file  from the <code>&lt;url&gt;</code>, or the  <code>&lt;url&gt;</code> becomes inaccessible, then the Netprobe uses the existing <code>netprobe.setup.xml</code> file.</p>
                                <div>
                                    <p><strong>Auto-discovery</strong>
                                    </p>
                                    <p>When used with <code>/discovery</code>, the Netprobe setup file generates its contents from JSON metadata pulled from its environment by the discovery script.</p>
                                    If you specify a setup URL with the `?` character, then the Netprobe appends the JSON metadata as query parameters and pulls the setup file from the URL specified.
                                    <p>For more information, see  <a href="https://docs.itrsgroup.com/docs/geneos/current/collection/netprobe/introduction/netprobe-overview/index.html#auto-discovery">Auto-discovery in Netprobe Overview</a>.</p>
                                </div>
                                <p class="note"><code>/setup=&lt;url&gt;</code> only supports HTTP links by default. If you need to set up an HTTPS connection, see the <code>/setup-server-verify</code> option.When using <code>/setup=&lt;url&gt;</code> with multiple instances of the Netprobe, check that you install each probe in its own directory. Otherwise, the setup for each probe may interfere with one another.>Do not use proxy servers for <code>/setup=&lt;url&gt;</code>. Proxy servers are not supported.</p>
                            </td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>/setup-interval=&lt;minutes&gt;</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                                <p>Used in conjunction with <code>/setup</code>.</p>
                                <p>Defines the time interval before the floating or Self-Announcing Netprobe requests another configuration file and restarts the announcement process. If no new or valid file is discovered, then the Netprobe neither reloads the configuration file nor restarts the configuration process.</p>
                                <p>If no <code>-setup-interval</code> is defined, the Netprobe makes the request every 360 minutes (or 6 hours), by default.</p>
                                <div>
                                    <p><strong>Feature behaviour</strong>
                                    </p>
                                    <p>By default, this option only works for remote configurations defined through <code>/setup=&lt;url&gt;</code>. However, if used in conjunction with <code>/discovery</code>, then this option works for both <code>/setup=&lt;filename&gt;</code> and <code>&lt;url&gt;</code>.</p>
                                    <p><strong>Auto-discovery</strong>
                                    </p>
                                    <p>When used with <code>/discovery</code>, then this option defines the time interval before the Netprobe reruns the discovery executable to update the JSON metadata. If no updates are discovered from the extracted JSON metadata, then the Netprobe does not reload the Netprobe setup file.</p>
                                    <p>For more information, see  <a href="https://docs.itrsgroup.com/docs/geneos/current/collection/netprobe/introduction/netprobe-overview/index.html#auto-discovery">Auto-discovery in Netprobe Overview</a>.</p>
                                </div>
                            </td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>/setup-server-verify &lt;file&gt;</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                                <p>Used in conjunction with <code>/setup=&lt;url&gt;</code>. This option only takes effect when an HTTPS <code>&lt;url&gt;</code> is specified. Otherwise, this option is ignored.</p>
                                <p>When this option is invoked, the Netprobe verifies the remote server against the specified Certificate Authority (CA) bundle.</p>
                            </td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>/ssl-certificate=&lt;full path to file&gt;</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                                <p>Sets the SSL certificate file which is used to allow the probe to run in secure mode (when accepting incoming connections) Default: <code>&lt;directory of installer&gt;\\cert.netprobe.pem</code></p>
                                <p>If the default SSL certificate file is not used, then the file specified will be used in situ. It will not be copied into the installation destination.</p>
                                <p>If the default SSL certificate file is used then it will be copied to the installation destination (for example, <code>C:\\Program Files (x86)\\NetprobeNT</code>) and this new path will be set as the value of <code>-ssl-certificate</code> argument of Netprobe's imagePath in registry.</p>
                            </td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>/ssl-certificate-chain=&lt;filename&gt;</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Sets the SSL certificate chain file used by the Netprobe to check the certificate of the Gateway when a connection is made.Default: <code>*&lt;directory of installer&gt;\\cert-chain.netprobe.pem*</code> If the default SSL certificate chain file is not used, then the file specified will be used in situ. It will not be copied into the installation destination. If the default SSL certificate chain file is used then it will be copied to the installation destination (for example, <code>C:\\Program Files (x86)\\NetprobeNT</code>) and this new path will be set as the value of<code> *-ssl-certificate-chain*</code> argument of Netprobe's imagePath in registry.</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>/dir=&lt;install\_dir&gt;</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Sets the Netprobe installation path.</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>/log=&lt;filename&gt;</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Sets the Netprobe log filename.</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>/silent</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Runs the install with no user interaction, but you can see the installation progress.</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>/verysilent</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Does the same as <code>/silent</code> but it does not show the installer files being extracted.</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>/require-ssl-certificate-for</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">This forces the Netprobe to require certain components connecting to the Netprobe port to provide a valid SSL certificate. If no certificate is provided or the certificate cannot be vaildated using the certificate authority provided by the <code>-ssl-certificate-chain</code> option, the connection will be rejected. Currently, this does not require any additional parameter as only the connection type EMF2 is supported.</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>/minTLSversion=&lt;version&gt;</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                                <p>Specifies the minimum TLS version. The accepted values are the following: </p>
                                <ul>
                                    <li>
                                        <p><code>1</code>
                                        </p>
                                    </li>
                                    <li>
                                        <p><code>1.0</code>
                                        </p>
                                    </li>
                                    <li>
                                        <p><code>1.1</code>
                                        </p>
                                    </li>
                                    <li>
                                        <p><code>1.2</code>
                                        </p>
                                    </li>
                                    <li>
                                        <p><code>1.3</code>
                                        </p>
                                    </li>
                                </ul>
                            </td>
                        </tr>
                    </tbody>
    </table>              
</div>

The `/nopassword` option will override `/pass` option but `ENCODED_PASSWORD` will still be set in the registry.

To set up a Self-Announcing or Floating Netprobe from the installer wizard, check the "Install as Self-Announcing or Floating Netprobe" checkbox from the "Configure Self-Announcing or Floating Netprobe" screen. Select a configuration file from that screen.

You can also specify the Self-Announcing or Floating Netprobe configuration file through installer command-line switch. To do this, start a new Administrator command-line window and run geneos-netprobe-<version>.windows-<platform>`.setup.exe.windows-x64.setup.exe` /setup=<setup xml filename>, where <setup xml filename> specifies the full path to the Self-Announcing or Floating Netprobe configuration file:

```
geneos-netprobe-*<version>*.windows-<platform>.setup.exeExample: geneos-netprobe-*<version>*.windows-<platform>.setup.exe.
```

To setup a secure Netprobe from the installer wizard, check the "Run probe in Secure Mode" checkbox from the "Configure Netprobe Secure Connections" screen. Select a PEM file that contains both the secure key and the secure certificate that the probe will use. This can also be done on the command line by using the /ssl-certificate flag. The flag followed by the name of the PEM file to use.

The certificate chain that is used to verify the certificates presented to the Netprobe can also be set either by using the wizard and setting the file on the "Configure Netprobe Secure Chain" page, or by using the /ssl-certificate-chain command flag. In both cases a file containing the certificates with which the presented certificates have been signed must be provided.

If you're doing a silent mode install using either /silent or /verysilent option then the /setup= switch should be used if a the probe is to run as a Self-Announcing or Floating Netprobe. The /ssl-certificate= flag should be used if the Netprobe is to run in a secure mode and only accept secure (TLS) connections from the gateway. The /ssl-certificate-chain= switch should be used if the Netprobe is to validate the gateway certificates prior to allowing the gateway to connect to the probe. If any of the files specified do not exist then the installer will fail silently and an 'Install Failed' line will be logged in the setup log. You can specify the log file with the /log=<log file> switch in the installer.

On completion, the Netprobe will have been installed and started running as a service. The relevant registry settings will also have been set up.


**Note**

  
If the Windows Win Apps Plug-in is to be run on a Windows 2008 Server, then it is necessary to alter the properties of the service to "Allow service to interact with desktop". For more information, see [Windows Win Apps Plugin](https://docs.itrsgroup.com/docs/geneos/current/collection/windows-apps/index.html). 



## Binary command-line options

The binary command line options are applicable to all platforms, unless otherwise stated.

<div class="table-container">
<table class="legacy-table">
                    <col style="width: 50%;" class="TableStyle-ref_2_col_table-Column-Column1"/>
                    <col style="width: 50%;" class="TableStyle-ref_2_col_table-Column-Column1"/>
                    <thead>
                        <tr class="TableStyle-ref_2_col_table-Head-Header1">
                            <th class="TableStyle-ref_2_col_table-HeadE-Column1-Header1">Binary command line option</th>
                            <th class="TableStyle-ref_2_col_table-HeadD-Column1-Header1">Description</th>
                        </tr>
                    </thead>
                    <tbody>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>-help</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Displays a list of command line options and
 exits.</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">
                                <p><code>
                          -version </code>
                                </p>
                                <p><code>-ver </code>
                                </p>
                                <p><code>-v
                        </code>
                                </p>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Displays version information and exits.</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>-port</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Sets the listening port for the Gateway connection.</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>-nolog</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Ignores any setting from the  <code>LOG_FILENAME</code> variable
and logs to the terminal instead.</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>-extract &lt;key&gt; &lt;filename&gt;</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                                <p>
                                        Extracts data embedded in the
 binary, writing it to the <code>&lt;filename&gt;</code> specified.</p>
                                <p>There are two
 supported values for <code>&lt;key&gt;</code>:
                                        </p>
                                <div>
                                    <ul class="simple">
                                        <li><code>schema</code> &#8212; extracts the
 Gateway Setup File schema embedded in the
 Netprobe binary.</li>
                                        <li><code>npschema</code> &#8212; extracts the
                                Netprobe Setup
 File schema embedded in the
 Netprobe binary.
                              </li>
                                    </ul>
                                </div>
                            </td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>-noschema</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">If invoked, the Netprobe does not publish the schema to the Gateway.</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>-discovery &lt;file path&gt;</code><a name="discovery"/>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                                <p>Used in conjunction with <code>-setup</code>. If <code>-setup</code> is not defined, then this option is ignored.</p>
                                <p>If invoked, the Netprobe runs a discovery executable on the machine it is running on. This  executable extracts JSON metadata from its environment, and updates the Netprobe setup file with the metadata through the use of macros.</p>
                                If you specify a setup URL with the `?` character, then the Netprobe appends the JSON metadata as query parameters and pulls the setup file from the URL specified.
                                <p>When present, the discovery executable runs at Netprobe startup, before the Netprobe reads any setup file, and before it connects to any Gateway.</p>
                                <p>For more information, see  <a href="https://docs.itrsgroup.com/docs/geneos/current/collection/netprobe/introduction/netprobe-overview/index.html#auto-discovery">Auto-discovery in Netprobe Overview</a>.</p>
                                <p>Mandatory: No</p>
                            </td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1">
                                <p><code>-setup</code>
                                </p>
                                <p><code>-setup &lt;filename&gt;</code>
                                </p>
                                <p>
                                    <MadCap:conditionalText><code>-setup &lt;url&gt;</code>
                                    </MadCap:conditionalText>
                                </p>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                                <p>
                        Used when running the Netprobe in Floating or
 Self-Announcing mode. Specifies the Netprobe Setup File
                        to use.</p>
                                <p>
                                    <MadCap:conditionalText>The Netprobe Setup File can be specified as a local file (<code>&lt;filename&gt;</code>) or a remote file (<code>&lt;url&gt;</code>).</MadCap:conditionalText>
                                </p>
                                <p>If no <code>&lt;filename&gt;</code><MadCap:conditionalText>or <code>&lt;url&gt;</code></MadCap:conditionalText>is specified, then the Netprobe
 defaults to the <code>netprobe.setup.xml</code> file in the current
 working directory. The Netprobe Setup File
                        needs to specify the connection details of one
 or more Gateways.
</p>
                                <p>If you specify a remote file (<code>&lt;url&gt;</code>           ), the Netprobe saves a copy of this in the current working directory as <code>netprobe.setup.xml</code>. This overwrites the default Netprobe configuration. In this case, any local changes to the <code>netprobe.setup.xml</code> configuration are ignored as the Netprobe retrieves the configuration from the remote file every <code>-setup-interval &lt;minutes&gt;</code>.</p>
                                <p>If you specify an invalid file  from the <code>&lt;url&gt;</code>, or the  <code>&lt;url&gt;</code> becomes inaccessible, then the Netprobe uses the  default configuration.</p>
                                <div>
                                    <p><strong>Auto-discovery</strong>
                                    </p>
                                    <p>When used with <code>-discovery</code>, the Netprobe setup file generates its contents from JSON metadata pulled from its environment by the discovery script.</p>
                                    If you specify a setup URL with the `?` character, then the Netprobe appends the JSON metadata as query parameters and pulls the setup file from the URL specified.
                                    <p>For more information, see  <a href="https://docs.itrsgroup.com/docs/geneos/current/collection/netprobe/introduction/netprobe-overview/index.html#auto-discovery">Auto-discovery in Netprobe Overview</a>.</p>
                                </div>
                                <p class="note"><code>-setup &lt;url&gt;</code> only supports HTTP links by default. If you need to set up an HTTPS connection, see the <code>-setup-server-verify</code> option.  When using <code>-setup &lt;url&gt;</code> with multiple instances of the Netprobe, check that you run each probe in its own directory. Otherwise, the setup for each probe may interfere with one another.  Do not use proxy servers for <code>-setup &lt;url&gt;</code>. Proxy servers are not supported.  The <code> -setup &lt;url&gt;</code> option is not supported for IBM AIX platforms.</p>
                            </td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>-setup-interval &lt;minutes&gt;</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                                <p>Used in conjunction with <code>-setup</code>.</p>
                                <p>Defines the time interval before the floating or Self-Announcing Netprobe requests another configuration file and restarts the announcement process. If no new or valid file is discovered, then the Netprobe neither reloads the configuration file nor restarts the configuration process.</p>
                                <p>If no <code>-setup-interval</code> is defined, the Netprobe makes the request every 360 minutes (or 6 hours), by default.</p>
                                <div>
                                    <p><strong>Feature behaviour</strong>
                                    </p>
                                    <p>By default, this option only works for remote configurations defined through <code>-setup &lt;url&gt;</code>. However, if used in conjunction with <code>-discovery</code>, then this option works for both <code>-setup &lt;filename&gt;</code> and <code>&lt;url&gt;</code>.</p>
                                    <p><strong>Auto-discovery</strong>
                                    </p>
                                    <p>When used with <code>-discovery</code>, then this option defines the time interval before the Netprobe reruns the discovery executable to update the JSON metadata. If no updates are discovered from the extracted JSON metadata, then the Netprobe does not reload the Netprobe setup file.</p>
                                    <p>For more information, see  <a href="https://docs.itrsgroup.com/docs/geneos/current/collection/netprobe/introduction/netprobe-overview/index.html#auto-discovery">Auto-discovery in Netprobe Overview</a>.</p>
                                </div>
                                <p class="note"><MadCap:conditionalText>For IBM AIX platforms, this option works when used in conjunction with <code>-discovery</code> and <code>-setup &lt;file path&gt;</code>.</MadCap:conditionalText></p>
                            </td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>-setup-server-verify &lt;file&gt;</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                                <p>Used in conjunction with <code>-setup &lt;url&gt;</code>. This option only takes effect when an HTTPS <code>&lt;url&gt;</code> is specified. Otherwise, this option is ignored.</p>
                                <p>When this option is invoked, the Netprobe verifies the remote server on the <code>-setup &lt;url&gt;</code> against the specified Certificate Authority (CA) bundle.</p>
                                <p>You can specify a CA bundle on the <code>&lt;file&gt;</code> argument in PEM format.</p>
                                <p>If no <code>&lt;file&gt;</code> is specified, then the Netprobe verifies the remote server against the operating system's Certificate Authority (CA) bundle. In this case, the required certificates must be installed in the appropriate certificate stores.</p>
                                <p class="note">On Windows, the <code> &lt;file&gt;</code> argument is required.   On Linux, the Netprobe searches for the default <code>ca-bundle</code> file at <code>&lt;/etc/pki/tls/certs/ca-bundle.crt&gt;</code>. However, in SLES platforms, the default <code>ca-bundle</code> is not at this path. For SLES platforms, we recommended that you specify a <code>ca-bundle</code> file for this option or create a symbolic link at <code>&lt;/etc/pki/tls/certs/ca-bundle.crt&gt;</code> to the default <code>ca-bundle</code> file of SLES platform.  On IBM AIX, this option is not supported.</p>
                            </td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>-mdmtest &lt;lua_script&gt; [params]</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                                <p>
                                       Test utility for Market Data
 Monitor Lua script prior to deployment.</p>
                                <p>Example:</p>
                                <p><code>$./netprobe.linux-mdmtesttest.luaparam1param2</code>
                                </p>
                            </td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>-listenip</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1" style="padding-left: 5px;padding-right: 5px;padding-top: 5px;padding-bottom: 5px;border-left-width: 0;border-right-width: 0;border-top-width: 0;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #e5e5e5;">
                                <p>Sets a specific IP address where the Netprobe will listen to incoming connections.</p>
                                <p>
                                    <MadCap:conditionalText>This argument can be used to force Self-Announcing Netprobes not to listen for incoming connections. For more information, see  <a href="https://docs.itrsgroup.com/docs/geneos/current/collection/netprobe/configuration/manage-self-announcing-netprobes/index.html#disable-listening">Disable listening in Manage Self-Announcing Netprobes</a>.</MadCap:conditionalText>
                                </p>
                            </td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>-ssl-certificate</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">This is the file that contains the signed SSL
 server certificate in PEM format.</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>-ssl-certificate-key</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                                <p>This is the file that contains the signed
 SSL server private key in PEM format.</p>
                                <p>                                If this is option not specified, but the
 certificate is, then the Netprobe will look
 for the private key in the same file as the
 server certificate.</p>
                            </td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>-ssl-certificate-chain</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">This is the file that contains the trusted
 certificate authority.</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>-require-ssl-certificate-for</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                                <p>This forces the Netprobe to require certain
 components connecting to the Netprobe port to
 provide a valid SSL certificate.</p>
                                <p>If no
 certificate is provided, or the certificate cannot
 be vaildated using the certificate authority
 provided by the <code class="docutils literal">-ssl-certificate-chain</code> option,
 the connection will be rejected. The connection
 type of the connections to check must be
 provided.</p>
                                <p>This command line option only supports the following argument:</p>
                                <ul>
                                    <li><code class="docutils literal">emf2</code> &#8212; covers all Geneos
 components connecting using the Geneos EMF2
 protocol.</li>
                                </ul>
                            </td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>-secure</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                                <p>If this option is present, the Netprobe will listen on a secure port rather than an
 insecure port.</p>
                                <p>If <code>-secure</code> is specified, then an SSL
 server certificate and an server private key
 also need to be specified.</p>
                            </td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>-nopassword</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                        Run commands on the Netprobe's host. For more information, see
                         <a href="https://docs.itrsgroup.com/docs/geneos/current/security/access-controls/set-passwords-on-netprobe-commands/index.html">Set passwords on Netprobe commands</a>.
                      </td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>-mq QM=&lt;qm_name&gt; MQSERVER=&lt;conn_string&gt; CHANTAB=&lt;chan_table&gt; KEYREPO=&lt;ssl_keyrepo&gt; CIPHER=&lt;cipher_spec&gt;</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                                        Test MQ connection
                                        <ul class="simple"><li><code>QM </code>&#8212; queue manager, e.g. <code>qm.test</code></li><li><code>MQSERVER</code> &#8212; server connection string,
 e.g. <code>CHAN/TCP/host(port)</code></li><li><code>CHANTAB</code> &#8212; full path to the channel
 table file, e.g.
 <code>/var/mqm/AMQCLCHL.TAB</code></li><li><code>KEYREPO</code> &#8212; full path to SSL key
 repository, e.g.
 <code>/var/mqm/ssl/key(.kdb)</code></li><li><code>CIPHER</code> &#8212; SSL cipher specification,
 e.g.<code> TRIPLE_DES_SHA_US</code></li></ul><p>Example value: <code>netprobe-mqQM=qm.testMQSERVER=CHAN/TCP/host</code></p></td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>-minTLSversion &lt;version&gt;</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">Specifies the minimum TLS version. The accepted values are:<ul><li><code>1</code></li><li><code>1.0</code></li><li><code>1.1</code></li><li><code>1.2</code></li><li><code>1.3</code></li></ul> For more information, see  <a href="https://docs.itrsgroup.com/docs/geneos/current/security/secure-communications/ssl_ug/index.html">Secure Communications</a>.
						</td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>-openssl-cipher &lt;ciphers&gt;</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                                To set the available TLS ciphers use the `-openssl-cipher <ciphers>` command line option, replacing `<ciphers>` with a comma separated list of ciphers.

For more information, see  <a href="https://docs.itrsgroup.com/docs/geneos/current/security/secure-communications/ssl_ug/index.html">TLS ciphers in Secure Communications</a>.
                            </td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>-json2XML &lt;filename&gt;</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                                <p>Converts JSON document specified by <code>&lt;filename&gt;</code> to XML and displays result to the console.</p>
                                <p>Applicable to Windows platforms only.</p>
                            </td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>-jvm-libpath &lt;path&gt;</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                                <p>Specifies <code>&lt;path&gt;</code> of the JVM library to use.</p>
                                <p>If this option is invoked, the Netprobe does not attempt to locate the library in the <code>PATH</code> or <code>LD_LIBRARY_PATH</code> environment variable. In Windows, the <code>JVM_LIBPATH</code> registry key is ignored.</p>
                                <p>Example value: <code>-jvm-libpath /usr/java/jdk/jre/lib/amd64/server/libjvm.so</code></p>
                            </td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>-java-home &lt;path&gt;</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                                <p>Specifies the <code>&lt;path&gt;</code> of the JRE to use. Overrides the <code>JAVA_HOME </code>environment variable.</p>
                            </td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>-perf</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                                <p>Show available performance monitor
 counters.</p>
                                <p>Applicable to Windows platforms only.</p>
                            </td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>-cmd</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                                <p>Run in the foreground, rather than as a
 service.</p>
                                <p>Applicable to Windows platforms only.</p>
                            </td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>-install</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                                <p>Installs the probe as a service.</p>
                                <p>Applicable to Windows platforms only.</p>
                            </td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>-uninstall</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                                <p>Uninstalls the probe as a service.</p>
                                <p>Applicable to Windows platforms only.</p>
                            </td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>-showcpus</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                                <p>Shows detected CPU information for this
 machine.</p>
                                <p>Applicable to Windows platforms only.</p>
                            </td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>-disable-core-dump</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                                <p>Disables creation of core dump files.</p>
                                <p>Applicable to Windows platforms only.</p>
                            </td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>-ifconfig, -if</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                                <p>Lists down the NICs present in the Windows
 machine. This should be used in configuring
 X-plugins send / recv interfaces.</p>
                                <p>Applicable to Windows platforms only. </p>
                                <p class="note">The Npcap packet capture library needs to be installed on the host. If Npcap is not installed using WinPcap API-compatible mode, then the Npcap installation directory must be added in the <code>PATH</code> environment variable or the <code>DLL_PATH</code> registry variable.</p>
                            </td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyE-Column1-Body1"><code>-perfdebug</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyD-Column1-Body1">
                                <p>Dumps performance counter data into a file
 (i.e. <code>perfout.dat</code>).</p>
                                <p>Applicable to Windows platforms only.</p>
                            </td>
                        </tr>
                        <tr class="TableStyle-ref_2_col_table-Body-Body1">
                            <td class="TableStyle-ref_2_col_table-BodyB-Column1-Body1"><code>-json2XML &lt;filename&gt;</code>
                            </td>
                            <td class="TableStyle-ref_2_col_table-BodyA-Column1-Body1">
                                <p>Converts JSON document specified by <code>&lt;filename&gt;</code> to XML and displays result to the console.</p>
                                <p>Applicable to Windows platforms only.</p>
                            </td>
                        </tr>
                    </tbody>
                </table>
</div>


