Administer > Administer the NNM iSPI Performance for QA > Manage QA Probes > Running iRA Commands > Updating QA Probes

Updating QA Probes

Run this command to modify an existing QA probe on the iRA.

Syntax

  • Windows: ira updateProbe -ownerName <Owner of the Probe> -testName <Name of the QA probe>[Optional Parameter to Update]
  • Linux: ./ira updateProbe -ownerName <Owner of the Probe> -testName <Name of the QA probe>[Optional Parameter to Update]

Make sure that you specify at least one optional parameter.

Parameters

ClosedICMP

Mandatory Parameters

  • -on <--ownerName>: The owner of the QA probe.

  • -tn <--testName>: Specify the name of the QA probe.

Optional Parameters

  • -dc <--description>: Specify the description of the QA probe. Specify any detail in this parameter that you may need to identify the QA probe later.

  • -ds <--dataSize>: Specify the size of the data packets that the QA probe sends or receives.

  • -fr <--frequency>: Specify the frequency of the QA probe. The value indicates the number of seconds after which the QA probe repeats the test. You can specify a value between 1-604800.

  • -pc <--probeCount>: Specify the number of probes designed for the test scenario. Specify a value between 1 and 15.
  • -sa <--sourceAddr>: Specify the source IP address for which the QA probe is configured.

  • -st <--sourceAddrType>: Specify the type of the source IP address configured for the QA probe. Specify one of the following values:

    • IPv4
    • DNS

    You can configure this parameter for all probe types. iRA uses this parameter for ICMP, TCP, UDP, DNS, DHCP, HTTP, and HTTPS probe types.

    • -ta <--targetAddr>: Specify the destination IP address for which the QA probe is configured.

  • -to <--timeOut>: The number of milliseconds after which the QA probe drops the connection between the source IP address and the destination IP address. You can specify a value between 1 and 60 for this parameter.

    • -tt <--targetAddrType>: Specify the type of the destination IP address configured for the QA probe.

    Specify any of the following values:

    • IPv4
    • DNS
ClosedTCP

Mandatory Parameters

  • -on <--ownerName>: The owner of the QA probe.

  • -tn <--testName>: Specify the name of the QA probe.

Optional Parameters

  • -dc <--description>: Specify the description of the QA probe. Specify any detail in this parameter that you may need to identify the QA probe later.

  • -fr <--frequency>: Specify the frequency of the QA probe. The value indicates the number of seconds after which the QA probe repeats the test. You can specify a value between 1-604800.

  • -pc <--probeCount>: Specify the number of probes designed for the test scenario. Specify a value between 1 and 15.
  • -sa <--sourceAddr>: Specify the source IP address for which the QA probe is configured.

  • -sp <--sourcePort>: Specify the port number for the QA probe's source node.

  • -st <--sourceAddrType>: Specify the type of the source IP address configured for the QA probe. Specify one of the following values:

    • IPv4
    • DNS

    You can configure this parameter for all probe types. iRA uses this parameter for ICMP, TCP, UDP, DNS, DHCP, HTTP, and HTTPS probe types.

  • -ta <--targetAddr>: Specify the destination IP address for which the QA probe is configured.

  • -to <--timeOut>: The number of milliseconds after which the QA probe drops the connection between the source IP address and the destination IP address. You can specify a value between 1 and 60 for this parameter.

  • -tp <--targetPort>: Specify the target port number for the node on which the QA probe runs.

  • -tt <--targetAddrType>: Specify the type of the destination IP address configured for the QA probe.

    Specify any of the following values:

    • IPv4
    • DNS
ClosedUDP

Mandatory Parameters

  • -on <--ownerName>: The owner of the QA probe.

  • -tn <--testName>: Specify the name of the QA probe.

Optional Parameters

  • -ta <--targetAddr>: Specify the destination IP address for which the QA probe is configured.

  • -tn <--testName>: Specify the name of the QA probe.

  • -tp <--targetPort>: Specify the target port number for the node on which the QA probe runs.

  • -tt <--targetAddrType>: Specify the type of the destination IP address configured for the QA probe.

    Specify any of the following values:

    • IPv4
    • DNS

  • -dc <--description>: Specify the description of the QA probe. Specify any detail in this parameter that you may need to identify the QA probe later.

  • -fr <--frequency>: Specify the frequency of the QA probe. The value indicates the number of seconds after which the QA probe repeats the test. You can specify a value between 1-604800.

  • -np <--numPackets>: Specify the number of packets to be transmitted

  • -ds <--dataSize>: Specify the size of the data packets that the QA probe sends or receives.

  • -pi <--interPktInterval>: Specify the time interval between the two consecutive transmitted packets.

  • -pc <--probeCount>: Specify the number of probes designed for the test scenario. Specify a value between 1 and 15.
  • -sa <--sourceAddr>: Specify the source IP address for which the QA probe is configured.

  • -sp <--sourcePort>: Specify the port number for the QA probe's source node.

  • -st <--sourceAddrType>: Specify the type of the source IP address configured for the QA probe. Specify one of the following values:

    • IPv4
    • DNS

    You can configure this parameter for all probe types. iRA uses this parameter for ICMP, TCP, UDP, DNS, DHCP, HTTP, and HTTPS probe types.

  • -to <--timeOut>: The number of milliseconds after which the QA probe drops the connection between the source IP address and the destination IP address. You can specify a value between 1 and 60 for this parameter.

ClosedUDPEcho

Mandatory Parameters

  • -on <--ownerName>: The owner of the QA probe.

  • -tn <--testName>: Specify the name of the QA probe.

Optional Parameters

  • -ta <--targetAddr>: Specify the destination IP address for which the QA probe is configured.

  • -tn <--testName>: Specify the name of the QA probe.

  • -tp <--targetPort>: Specify the target port number for the node on which the QA probe runs.

  • -tt <--targetAddrType>: Specify the type of the destination IP address configured for the QA probe.

    Specify any of the following values:

    • IPv4
    • DNS

  • -dc <--description>: Specify the description of the QA probe. Specify any detail in this parameter that you may need to identify the QA probe later.

  • -fr <--frequency>: Specify the frequency of the QA probe. The value indicates the number of seconds after which the QA probe repeats the test. You can specify a value between 1-604800.

  • -np <--numPackets>: Specify the number of packets to be transmitted

  • -ds <--dataSize>: Specify the size of the data packets that the QA probe sends or receives.

  • -pi <--interPktInterval>: Specify the time interval between the two consecutive transmitted packets.

  • -pc <--probeCount>: Specify the number of probes designed for the test scenario. Specify a value between 1 and 15.
  • -sa <--sourceAddr>: Specify the source IP address for which the QA probe is configured.

  • -sp <--sourcePort>: Specify the port number for the QA probe's source node.

  • -st <--sourceAddrType>: Specify the type of the source IP address configured for the QA probe. Specify one of the following values:

    • IPv4
    • DNS

    You can configure this parameter for all probe types. iRA uses this parameter for ICMP, TCP, UDP, DNS, DHCP, HTTP, and HTTPS probe types.

  • -to <--timeOut>: The number of milliseconds after which the QA probe drops the connection between the source IP address and the destination IP address. You can specify a value between 1 and 60 for this parameter.

ClosedDNS

Mandatory Parameters

  • -on <--ownerName>: The owner of the QA probe.

  • -tn <--testName>: Specify the name of the QA probe.

Optional Parameters

  • -dc <--description>: Specify the description of the QA probe. Specify any detail in this parameter that you may need to identify the QA probe later.

  • -fr <--frequency>: Specify the frequency of the QA probe. The value indicates the number of seconds after which the QA probe repeats the test. You can specify a value between 1-604800.

  • -rn <--resolveHostName>: Specify the host name that the QA probe needs to resolve to an IP address. The host name resolution must complete before the source host sends the initial IP packet.

  • -sa <--sourceAddr>: Specify the source IP address for which the QA probe is configured.

  • -sp <--sourcePort>: Specify the port number for the QA probe's source node.

  • -st <--sourceAddrType>: Specify the type of the source IP address configured for the QA probe. Specify one of the following values:

    • IPv4
    • DNS

    You can configure this parameter for all probe types. iRA uses this parameter for ICMP, TCP, UDP, DNS, DHCP, HTTP, and HTTPS probe types.

  • -ta <--targetAddr>: Specify the destination IP address for which the QA probe is configured.

  • -to <--timeOut>: The number of milliseconds after which the QA probe drops the connection between the source IP address and the destination IP address. You can specify a value between 1 and 60 for this parameter.

  • -tp <--targetPort>: Specify the target port number for the node on which the QA probe runs.

  • -tt <--targetAddrType>: Specify the type of the destination IP address configured for the QA probe.

    Specify any of the following values:

    • IPv4
    • DNS
ClosedHTTP

Mandatory Parameters

  • -on <--ownerName>: The owner of the QA probe.

  • -tn <--testName>: Specify the name of the QA probe.

Optional Parameters

  • -cd <--contentDownload>: Specify whether to download the content of the destination web page

  • -dc <--description>: Specify the description of the QA probe. Specify any detail in this parameter that you may need to identify the QA probe later.

  • -fr <--frequency>: Specify the frequency of the QA probe. The value indicates the number of seconds after which the QA probe repeats the test. You can specify a value between 1-604800.

  • -pc <--probeCount>: Specify the number of probes designed for the test scenario. Specify a value between 1 and 15.

  • -sa <--sourceAddr>: Specify the source IP address for which the QA probe is configured.

  • -st <--sourceAddrType>: Specify the type of the source IP address configured for the QA probe. Specify one of the following values:

    • IPv4
    • DNS

    You can configure this parameter for all probe types. iRA uses this parameter for ICMP, TCP, UDP, DNS, DHCP, HTTP, and HTTPS probe types.

  • -ta <--targetAddr>: Specify the destination IP address for which the QA probe is configured.

  • -fe <--failOnCtlErr>: Specify if the QA probe fails for incorrect Certificate Trust List (CTL)

    Set the value to TRUE or FALSE.

    If this value is set to TRUE, specify the following parameter:

    • -pu <--proxyUsed>: Specify whether the QA probe uses an HTTP proxy server. Set the value to TRUE or FALSE.

      If you set this value to TRUE, specify the following parameters:

    • -pa <--proxyAddr>: Specify the HTTP proxy server address.
    • -pn <--proxyUsername>: Specify the HTTP proxy user name for the QA probe owner.
    • -pp <--proxyPort>: Specify the HTTP proxy port number on which the QA probe would run.
    • -pt <--proxyAddrType>: Specify any of the following the HTTP proxy address type:
      • IPv4
      • DNS
    • -pw <--proxyPassword>: Specify the HTTP proxy password for the QA probe owner.

  • -to <--timeOut>: The number of milliseconds after which the QA probe drops the connection between the source IP address and the destination IP address. You can specify a value between 1 and 60 for this parameter.

  • -tp <--targetPort>: Specify the target port number for the node on which the QA probe runs.

  • -tt <--targetAddrType>: Specify the type of the destination IP address configured for the QA probe.

    Specify any of the following values:

    • IPv4
    • DNS
  • -ui <--uri>: Specify the Uniform Resource Locator specified for the QA probe
  • -un <--username>: Specify the user name of the target HTTP web page
  • -ps <--password>: Specify the password of the target HTTP web page
ClosedHTTPS

Mandatory Parameters

  • -on <--ownerName>: The owner of the QA probe.

  • -tn <--testName>: Specify the name of the QA probe.

Optional Parameters

  • -cd <--contentDownload>: Specify whether to download the content of the destination web page

  • -dc <--description>: Specify the description of the QA probe. Specify any detail in this parameter that you may need to identify the QA probe later.

  • -fr <--frequency>: Specify the frequency of the QA probe. The value indicates the number of seconds after which the QA probe repeats the test. You can specify a value between 1-604800.

  • -pc <--probeCount>: Specify the number of probes designed for the test scenario. Specify a value between 1 and 15.

  • -sa <--sourceAddr>: Specify the source IP address for which the QA probe is configured.

  • -st <--sourceAddrType>: Specify the type of the source IP address configured for the QA probe. Specify one of the following values:

    • IPv4
    • DNS

    You can configure this parameter for all probe types. iRA uses this parameter for ICMP, TCP, UDP, DNS, DHCP, HTTP, and HTTPS probe types.

  • -ta <--targetAddr>: Specify the destination IP address for which the QA probe is configured.

  • -et <--ensureTrusted>: Specify whether or not to validate the certificate of the host (configured in the target address) against the iRA trust store.

    If the value is set to TRUE, the certificate of the host is validated against the list in the iRA Truststore.

    If the value is set to FALSE, the validation of the certificate of the host is ignored.

  • -ca <--trustCAImplicit>: Specify whether the certificate of the host configured in the target address is trusted implicitly. Set the value to TRUE or FALSE.

    If the value is set to TRUE, the certificate of the target host is downloaded to the iRA Truststore and validated.

    If the value is set to FALSE, the certificate of the host is validated against the list in the iRA Truststore. If the certificate is not listed in the iRA Truststore, the certificate validation fails which results in the probe failure.

    Note If a target host does not have a valid trusted certificate and you want to successfully complete the certificate validation, you can perform one of the following:

    • Set the value of the parameter to TRUE. This automatically downloads the certificate of the host to the iRA Truststore ($IRA_HOME/ira/conf/jssecacerts)
    • Use $IRA_HOME/lib/nonOV/jre/bin/keytool import option to manually import the certificate of the host to the iRA Truststore.

  • -to <--timeOut>: The number of milliseconds after which the QA probe drops the connection between the source IP address and the destination IP address. You can specify a value between 1 and 60 for this parameter.

  • -tp <--targetPort>: Specify the target port number for the node on which the QA probe runs.

  • -tt <--targetAddrType>: Specify the type of the destination IP address configured for the QA probe.

    Specify any of the following values:

    • IPv4
    • DNS

  • -fe <--failOnCtlErr>: Specify if the QA probe fails for incorrect Certificate Trust List (CTL)

    Set the value to TRUE or FALSE.

    If this value is set to TRUE, specify the following parameter:

    • -pu <--proxyUsed>: Specify whether the QA probe uses an HTTP proxy server. Set the value to TRUE or FALSE.

      If you set this value to TRUE, specify the following parameters:

    • -pa <--proxyAddr>: Specify the HTTP proxy server address.
    • -pn <--proxyUsername>: Specify the HTTP proxy user name for the QA probe owner.
    • -pp <--proxyPort>: Specify the HTTP proxy port number on which the QA probe would run.
    • -pt <--proxyAddrType>: Specify any of the following the HTTP proxy address type:
      • IPv4
      • DNS
    • -pw <--proxyPassword>: Specify the HTTP proxy password for the QA probe owner.
  • -ui <--uri>: Specify the Uniform Resource Locator specified for the QA probe
  • -un <--username>: Specify the user name of the target HTTPS web page
  • -ps <--password>: Specify the password of the target HTTPS web page
ClosedORACLE

Mandatory Parameters

  • -on <--ownerName>: The owner of the QA probe.

  • -tn <--testName>: Specify the name of the QA probe.

Optional Parameters

  • -db <--databaseName>: Specify the name of the database running on the target Oracle server.
  • -dc <--description>: Specify the description of the QA probe. Specify any detail in this parameter that you may need to identify the QA probe later.
  • -fr <--frequency>: Specify the frequency of the QA probe. The value indicates the number of seconds after which the QA probe repeats the test. You can specify a value between 1-604800.
  • -pc <--probeCount>: Specify the number of probes designed for the test scenario. Specify a value between 1 and 15.
  • -pw <--password>: Specify the Oracle database password.
  • -qs <--queryStr>: Specify the SQL Query that the QA probe would run. In Linux, use the following command format while using "*" (Asterisk), in the query string: 'select "*" from <Table Name>'
  • -sa <--sourceAddr>: Specify the source IP address for which the QA probe is configured.

  • -st <--sourceAddrType>: Specify the type of the source IP address configured for the QA probe. Specify one of the following values:

    • IPv4
    • DNS

    You can configure this parameter for all probe types. iRA uses this parameter for ICMP, TCP, UDP, DNS, DHCP, HTTP, and HTTPS probe types.

  • -ta <--targetAddr>: Specify the destination IP address for which the QA probe is configured.

  • -tp <--targetPort>: Specify the target port number for the node on which the QA probe runs.

  • -to <--timeOut>: The number of milliseconds after which the QA probe drops the connection between the source IP address and the destination IP address. You can specify a value between 1 and 60 for this parameter.

  • -tt <--targetAddrType>: Specify the type of the destination IP address configured for the QA probe.

    Specify any of the following values:

    • IPv4
    • DNS
  • -un <--username>: Specify the Oracle database user name.
ClosedDHCP

Mandatory Parameters

  • -on <--ownerName>: The owner of the QA probe.

  • -tn <--testName>: Specify the name of the QA probe.

Optional Parameters

  • -op <--operation>: Specify the type of operation you want the probe to perform. DHCP probes support dhcpIpGet operation.

  • -tp <--targetPort>: Specify the target port number for the node on which the QA probe runs.

  • -ta <--targetAddr>: Specify the IP address of the destination DHCP server.

  • -tt <--targetAddrType>: Specify the type of the destination server IP address configured for the QA probe. DHCP probes support IPv4 address.

  • -op82 <--option82>: Specify the custom parameters such as Circuit ID, Remote ID.

  • -dc <--description>: Specify the description of the QA probe. Specify any detail in this parameter that you may need to identify the QA probe later.

  • -fr <--frequency>: Specify the frequency of the QA probe. The value indicates the number of seconds after which the QA probe repeats the test. You can specify a value between 1-604800.

  • -pc <--probeCount>: Specify the number of probes designed for the test scenario. Specify a value between 1 and 15.
  • -sa <--sourceAddr>: Specify the source IP address for which the QA probe is configured.

  • -sp <--sourcePort>: Specify the source port number of the node on which the QA probe runs.

  • -st <--sourceAddrType>: Specify the type of the source IP address configured for the QA probe.DHCP probes support only IPv4 address.

    You can configure this parameter for all probe types. iRA uses this parameter for ICMP, TCP, UDP, and DNS probe types.

  • -to <--timeOut>: Number of milliseconds after which the QA probe drops the connection between the source IP address and the destination server IP address. You can specify a value between 1 and 60 for this parameter.

Send Help Center feedback