Probe Manager

Add Probes

Perform the following steps to add a new probe. The Import CSV button enables you to import multiple probes from a .csv file. See the Import CSV section below.

1. Click Add Probe to display the Add Probe pop-up.

2. On the pop-up in the Name field, enter the probe name. This must be unique for the device you select.

3. In the Description field, enter the probe description for user information only.

4. Click the IP SLA Type drop-down and select an IP SLA type. The type you select determines the configuration steps. IP SLA types that are not applicable for the device you select appear in light text and you cannot select those types.

   • If you select DHCP, perform the following configuration steps.

     1. Select one of the following options.

        • Select Specify Target By Name to select the name of the target device from a drop-down list in the next step.

        • Select Specify Target By IP Address to enter the IP address of the target device in a text field in the next step.

     2. In the Target field, either click the drop-down and select the target device by name or enter the target device IP address in the text field (dependent on the selection you make in the previous step).

     3. In the Frequency field, enter the number of seconds for how often the router should perform the test. This must be greater than 0 and should be slightly less than the poll frequency of the device.

     4. In the Circuit ID field, enter the Cisco Circuiter ID on its CLI. This is a hexadecimal value.

     5. In the Remote ID field, enter the remote ID. This is a hexadecimal value.

     6. In the Subnet Mask field, enter the Cisco extension to DHCP Option 82 that allows the specification of a subnet. This is a hexadecimal value.

     7. Click the Source IP drop-down and select the IP address of the source device.

   • If you select DLSw or Echo, perform the following configuration steps.

     1. Select one of the following options.

        • Select Specify Target By Name to select the name of the target device from a drop-down list in the next step.

        • Select Specify Target By IP Address to enter the IP address of the target device in a text field in the next step.

     2. In the Target field, either click the drop-down and select the target device by name or enter the target device IP address in the text field (dependent on the selection you make in the previous step).

     3. In the Frequency field, enter the number of seconds for how often the router should perform the test. This must be greater than 0 and should be slightly less than the poll frequency of the device.

     4. (Echo only) In the ToS field, enter the type of service (ToS) byte number in the IP header of an IP SLAs operation (number between 0 and 255).

     5. (Echo only) Click the Source IP drop-down and select the IP address of the source device.

   • If you select DNS, perform the following configuration steps.

     1. In the Domain field, enter the complete valid URL of the DNS domain.

     2. In the Nameserver field, enter the IP address of the name server.

     3. In the Frequency field, enter the number of seconds for how often the router should perform the test. This must be greater than 0 and should be slightly less than the poll frequency of the device.

     4. Click the Source IP drop-down and select the IP address of the source device.

   • If you select Ethernet Jitter or Ethernet Ping, perform the following configuration steps.

     1. In the MPID field, enter the destination Maintenance Point Identifier to test.

     2. In the Domain Name field, enter the domain in which the destination maintenance point lies.

     3. In the Target VLAN field, enter identifier of the VLAN in which the destination maintenance point lies.

     4. In the Target EVC field, enter the Ethernet Virtual Connection in which the maintenance point lies.

     5. In the Frequency field, enter the number of seconds for how often the router should perform the test. This must be greater than 0 and should be slightly less than the poll frequency of the device.

     6. (Ethernet Jitter only) In the Packet # field, enter the number of packets to send.

     7. (Ethernet Jitter only) In the Interval field, enter the number of milliseconds to be the interval between packets.

     8. In the CoS field, enter the Ethernet Class of Service.

   • If you select FTP, perform the following configuration steps.

     1. In the URL field, enter the complete, valid URL of the file to fetch. This must include the ftp:// part and if a user name and password are required, use the following format; username:password@webaddress.

        Example: ftp://jerry:password@www.test.com/membersarea

     2. In the Frequency field, enter the number of seconds for how often the router should perform the test. This must be greater than 0 and should be slightly less than the poll frequency of the device.

     3. In the ToS field, enter the type of service (ToS) for the FTP packets that are sent (number between 0 and 255).

     4. Select a Mode option: either Active or Passive.

        Passive mode is required if the firewall is enabled on your appliance.

     5. Click the Source IP drop-down and select the IP address from which to issue the request. If a router has multiple interfaces and some interfaces do not have access to the FTP server, you must select the IP address of the interface that is to issue the request. If you leave this blank the router attempts to choose the best/closest interface which may not be the interface you want.

   • If you select HTTP, perform the following configuration steps.

     1. In the URL field, enter the complete, valid URL of the HTTP server.

     2. In the Nameserver field, enter the IP address of the name server.

     3. In the Frequency field, enter the number of seconds for how often the router should perform the test. This must be greater than 0 and should be slightly less than the poll frequency of the device.

     4. In the ToS field, enter the type of service (ToS) byte number in the IP header of an IP SLA operation (number between 0 and 255).

     5. Click the Operation drop-down and select an operation.

     6. Click the HTTP Version drop-down and select the HTTP version.

     7. In the Proxy field, enter the IP address of the proxy.

     8. Select the Cache check box to cache the IP SLA.

     9. Click the Source IP drop-down and select the IP address of the source device.

   • If you select ICMP Jitter, perform the following configuration steps.

     1. Select one of the following options.

        • Select Specify Target By Name to select the name of the target device from a drop-down list in the next step.

        • Select Specify Target Device By IP Address to enter the IP address of the target device in a text field in the next step.

     2. In the Target field, either click the drop-down and select the target device by name or enter the target device IP address in the text field (dependent on the selection you make in the previous step).

     3. In the Frequency field, enter the number of seconds for how often the router should perform the test. This must be greater than 0 and should be slightly less than the poll frequency of the device.

     4. In the ToS field, enter the type of service (ToS) byte number in the IP header of an IP SLAs operation (number between 0 and 255).

     5. In the Packet # field, enter the number of packets to send.

     6. In the Interval field, enter the number of milliseconds to be the interval between packets.

     7. Click the Source IP drop-down and select the IP address of the source device.

   • If you select RTP, perform the following configuration steps.

     1. Select one of the following options.

        • Select Specify Target By Name to select the name of the target device from a drop-down list in the next step.

        • Select Specify Target By IP to enter the IP address of the target device in a text field in the next step.

     2. In the Target field, either click the drop-down and select the target device by name or enter the target device IP address in the text field (dependent on the selection you make in the previous step).

     3. Click the Codec drop-down and select the codec to use for the Mean Opinion Score (MOS), and the Impairment/calculated planning impairment factor (ICPIF) score.

     4. In the Source Voice Port field, enter the voice port name, such as 0/1/1. This is not a TCP/UDP port number.

     5. In the ICPIF Factor field, enter the calculated planning impairment factor number that determines the type of access and how the service is to be used. (0=Conventional Wire Line, 5=Mobility Within Building, 10=Mobility Within Geographic Area, 20=Access to Hard-to Reach Location).

     6. In the Frequency field, enter the number of seconds for how often the router should perform the test. This must be greater than 0 and should be slightly less than the poll frequency of the device.

     7. In the Duration field, enter the IP SLA duration.

     8. Click the Source IP drop-down and select the IP address of the source device.

   • If you select TCP Connect or UDP Echo, perform the following configuration steps.

     1. Select one of the following options.

        • Select Specify Target By Name to select the name of the target device from a drop-down list in the next step.

        • Select Specify Target By IP Address to enter the IP address of the target device in a text field in the next step.

     2. In the Target field, either click the drop-down and select the target device by name or enter the target device IP address in the text field (dependent on the selection you make in the previous step).

     3. In the Target Port field, enter the port number on which to connect (number between 0 and 65535).

     4. In the Frequency field, enter the number of seconds for how often the router should perform the test. This must be greater than 0 and should be slightly less than the poll frequency of the device.

     5. In the ToS field, enter the type of service (ToS) byte number in the IP header of an IP SLAs operation (number between 0 and 255).

     6. Click the Source IP drop-down and select the IP address of the source device.

   • If you select UDP Jitter, perform the following configuration steps.

     1. Select one of the following options.

        • Select Specify Target By Name to select the name of the target device from a drop-down list in the next step.

        • Select Specify Target By IP Address to enter the IP address of the target device in a text field in the next step.

     2. In the Target field, either click the drop-down and select the target device by name or enter the target device IP address in the text field (dependent on the selection you make in the previous step).

     3. In the Target Port field, enter the port number on which to connect (number between 0 and 65535).

     4. Click the Codec drop-down and select the codec to use for the Mean Opinion Score (MOS) and the Impairment/calculated planning impairment factor (ICPIF) score.

     5. In the Frequency field, enter the number of seconds for how often the router should perform the test. This must be greater than 0 and should be slightly less than the poll frequency of the device.

     6. In the ToS field, enter the type of service (ToS) byte number in the IP header of an IP SLAs operation (number between 0 and 255).

     7. In the Packet # field, enter the number of packets to send.

     8. In the Interval field, enter the number of milliseconds to be the interval between packets.

     9. Click the Precision drop-down and select the precision that is dependent on the compliance revision (Revision 9 or after) of the sender and target IP SLA, you may be able to poll in microseconds.

     10. Click the Source IP drop-down and select the IP address of the source device.

   • If you select Video, perform the following configuration steps.

     1. Select one of the following options.

        • Select Specify Target By Name to select the name of the target device from a drop-down list in the next step.

        • Select Specify Target By IP Address to enter the IP address of the target device in a text field in the next step.

     2. In the Target field, either click the drop-down and select the target device by name or enter the target device IP address in the text field (dependent on the selection you make in the previous step).

     3. In the Target Port field, enter the port number on which to connect (number between 0 and 65535).

     4. In the Source field, enter the IP address of the source device.

     5. In the Source Port field, enter the port number of the source device.

     6. Click the Video Traffic Profile drop-down.

        • Select IPTV to indicate the profile is for Internet Protocol television (IPTV) which is a system through which television services are delivered using the Internet Protocol Suite over a packet-switched network such as the Internet, instead of being delivered through traditional terrestrial, satellite signal, and cable television formats.

        • Select IPVSC to indicate the profile is for an IP surveillance camera.

        • Select TELEPRESENCE to indicate the profile is for the set of technologies which enable a person to feel as if they were present, or to give the appearance of being present, via telerobotics, at a place other than their true location.

     7. In the Frequency field, enter the number of seconds for how often the router should perform the test. This must be greater than 0 and should be slightly less than the poll frequency of the device.

     8. In the Duration field, enter the IP SLA duration.

     9. In the ToS field, enter the type of service (ToS) byte number in the IP header of an IP SLAs operation (number between 0 and 255).

   • If you select VoIP, perform the following configuration steps.

     1. Click the Detect Point drop-down and select the detect point.

     2. In the Called Number field, enter the telephone number called.

     3. In the Frequency field, enter the number of seconds for how often the router should perform the test. This must be greater than 0 and should be slightly less than the poll frequency of the device.

     4. In the ToS field, enter the type of service (ToS) byte number in the IP header of an IP SLAs operation (number between 0 and 255).

     5. In the Source IP field, enter the IP address of the source device.

5. Click Save.

6. Click to delete a probe. This icon does not appear for probes that SevOne NMS discovers because you cannot delete those probes. When you delete a probe, the probe is removed from SevOne NMS and removed from the router. The change takes effect the next time the device is discovered. Until then, the probe displays To Be Deleted.

Import CSV

The Probe CSV Importer enables you to import probes into SevOne NMS. Use any application to create a comma delimited file. The .csv file(s) must be encoded in UTF-8. Complete all required fields. The IP SLA type entry determines what fields are required. Leave the fields that relate to other IP SLA types blank and delimited by the applicable number of commas.

File format for the required fields:

Probe Type, Device Name, IP SLA Type, Name, Description, Frequency, Target, Target Port, ToS, Packet #, Packet Interval, Codec Type, Probe Precision, HTTP Version, URL, Nameserver, Proxy, Cache, Detect Point, Called Number

Conditionally required fields for specific probe types:

MPID, Domain Name, Target VLAN, CoS, Target EVC, Video Traffic Profile, Source Voice Port, ICPIF Factor, Duration, Source IP, Source Port, Mode, Circuit ID, Remote ID, Subnet Mask

The .csv file must contain the following fields:

• Probe Type – (Required) Enter IP SLA

• Device Name - (Required) Enter the name of a device that SevOne NMS discovers, including domain name and extension.

• IP SLA Type - (Required) Enter one of the following: dhcp, dlsw, dns, echo, ethernetJitter, ethernetPing, FTP, http, icmpjitter, RTP, tcpConnect, udpEcho, udpJitter, video, voip

• Name - (Required) Enter the name for the probe.

• Description - (Required) Enter the description for the probe.

• Frequency - (Required) Enter is how frequently the router should perform the test, a number greater than 0.

• Target - (Required for DHCP, DLSw, Echo, ICMP Jitter, RTP, TCP Connect, UDP Echo, UDP Jitter, Video) - Enter either the valid name of a device in SevOne NMS or a valid IPv4 address.

• Target Port - (Required for TCP Connect, UDP Echo, UDP Jitter, Video) Enter a number between 0 and 65535.

• ToS - (Required for DLSw, Echo, FTP, HTTP, ICMP Jitter, TCP Connect, UDP Echo, UDP Jitter, Video, VoIP) Enter a number between 0 and 255. This stands for Type of Service.

• Packet # - (Required for Ethernet Jitter, ICMP Jitter, UDP Jitter) Enter a number.

• Interval - (Required for Ethernet Jitter, ICMP Jitter, UDP Jitter) Enter a number.

• Codec Type - (Required for RTP, UDP Jitter) Enter one of the following: notApplicable, g711ulaw, g711alaw, g729a

• Precision - (Required for UDP Jitter) Enter one of the following: milliseconds, microseconds

• HTTP Version - (Required for HTTP) Enter one of the following: 0.9, 1.0, 1.1

• URL - (Required for FTP, HTTP) Enter a valid URL.

• Nameserver - (Required for DNS, HTTP) Enter a valid IPv4 address.

• Proxy - (Required for HTTP) Enter a valid IPv4 address.

• Cache - (Required for HTTP) Enter either Yes for enabled or No for disabled.

• Detect Point - (Required for VoIP) Enter one of the following: voipDTAlertRinging, voipDTConnectOK

• Called Number - (Required for VoIP) Enter a valid phone number.

The .csv file may require some or all of the following fields:

• MPID - (Required for Ethernet Jitter, Ethernet Ping) Enter a number.

• Domain Name - (Required for DNS, Ethernet Jitter, Ethernet Ping) Enter a valid domain.

• Target VLAN - (Required for Ethernet Jitter, Ethernet Ping) Enter a number between 1 and 4095 (inclusive).

• CoS - (Required for Ethernet Jitter, Ethernet Ping) Enter a number between 0 and 255.

• Target EVC - (Required for Ethernet Jitter, Ethernet Ping) Enter a valid number.

• Video Traffic Profile - (Required for Video) Enter one of the following: IPTV, IPVSC, TELEPRESENCE.

• Duration - (Required for RTP, Video) Enter a number.

• Source IP - (Required for DNS, Echo, FTP, HTTP, ICMP Jitter, RTP, TCP Connect, UDP Echo, UDP Jitter, Video, VoIP, Optional for DHCP) Enter a valid IPv4 address

• Source Port - (Required for RTP, Video) Enter a number between 0 and 65535.

• Mode - (Optional for FTP) Enter Active or Passive. Defaults to Passive if left blank.

• Circuit ID - (Optional for DHCP) Enter a hex number between 000000 and ffffff.

• Remote ID - (Optional for DHCP) Enter a hex number between 000000 and ffffff.

• Subnet Mask - (Optional for DHCP) Enter a hex number between 000000 and ffffff.

Perform the following steps to import the IP SLAs.

1. Open the .csv file, copy all the contents and paste them into the text field on the Probe CSV Importer.

2. Edit the information in the text field.

3. Click Save.

4. A message appears below the text field to display the success or failure of the import. If an error occurs during the import, the message describes the error and the offending lines display. SevOne NMS imports all probes that do not have errors. Fix the errors in the import file and repeat the steps.