1Smokeping_probes_OpenSSHJunOSPing(3)SmokePinSgmokeping_probes_OpenSSHJunOSPing(3)
2
3
4

NAME

6       Smokeping::probes::OpenSSHJunOSPing - Juniper SSH JunOS Probe for
7       SmokePing
8

SYNOPSIS

10        *** Probes ***
11
12        +OpenSSHJunOSPing
13
14        forks = 5
15        offset = 50%
16        packetsize = 100
17        step = 300
18        timeout = 15
19        tos =
20
21        # The following variables can be overridden in each target section
22        junospass = password # mandatory
23        junosuser = user # mandatory
24        pings = 5
25        psource = 192.168.2.129
26        source = 192.168.2.1 # mandatory
27
28        # [...]
29
30        *** Targets ***
31
32        probe = OpenSSHJunOSPing # if this should be the default probe
33
34        # [...]
35
36        + mytarget
37        # probe = OpenSSHJunOSPing # if the default probe is something else
38        host = my.host
39        junospass = password # mandatory
40        junosuser = user # mandatory
41        pings = 5
42        psource = 192.168.2.129
43        source = 192.168.2.1 # mandatory
44

DESCRIPTION

46       Connect to Juniper JunOS via OpenSSH to run ping commands.  This probe
47       uses the "extended ping" of the Juniper JunOS.  You have the option to
48       specify which interface the ping is sourced from as well.
49

VARIABLES

51       Supported probe-specific variables:
52
53       forks
54           Run this many concurrent processes at maximum
55
56           Example value: 5
57
58           Default value: 5
59
60       offset
61           If you run many probes concurrently you may want to prevent them
62           from hitting your network all at the same time. Using the probe-
63           specific offset parameter you can change the point in time when
64           each probe will be run. Offset is specified in % of total interval,
65           or alternatively as 'random', and the offset from the 'General'
66           section is used if nothing is specified here. Note that this does
67           NOT influence the rrds itself, it is just a matter of when data
68           acqusition is initiated.  (This variable is only applicable if the
69           variable 'concurrentprobes' is set in the 'General' section.)
70
71           Example value: 50%
72
73       packetsize
74           The (optional) packetsize option lets you configure the packetsize
75           for the pings sent.
76
77           Default value: 100
78
79       step
80           Duration of the base interval that this probe should use, if
81           different from the one specified in the 'Database' section. Note
82           that the step in the RRD files is fixed when they are originally
83           generated, and if you change the step parameter afterwards, you'll
84           have to delete the old RRD files or somehow convert them. (This
85           variable is only applicable if the variable 'concurrentprobes' is
86           set in the 'General' section.)
87
88           Example value: 300
89
90       timeout
91           How long a single 'ping' takes at maximum
92
93           Example value: 15
94
95           Default value: 5
96
97       tos The (optional) type of service for the pings sent.
98
99       Supported target-specific variables:
100
101       junospass
102           The junospass option allows you to specify the password for the
103           username specified with the option junosuser.
104
105           Example value: password
106
107           This setting is mandatory.
108
109       junosuser
110           The junosuser option allows you to specify a username that has ping
111           capability on the JunOS Device.
112
113           Example value: user
114
115           This setting is mandatory.
116
117       pings
118           How many pings should be sent to each target, if different from the
119           global value specified in the Database section. Note that the
120           number of pings in the RRD files is fixed when they are originally
121           generated, and if you change this parameter afterwards, you'll have
122           to delete the old RRD files or somehow convert them.
123
124           Example value: 5
125
126       psource
127           The (optional) psource option specifies an alternate IP address or
128           Interface from which you wish to source your pings from.  Routers
129           can have many many IP addresses, and interfaces.  When you ping
130           from a router you have the ability to choose which interface and/or
131           which IP address the ping is sourced from.  Specifying an
132           IP/interface does not necessarily specify the interface from which
133           the ping will leave, but will specify which address the packet(s)
134           appear to come from.  If this option is left out the JunOS Device
135           will source the packet automatically based on routing and/or
136           metrics.  If this doesn't make sense to you then just leave it out.
137
138           Example value: 192.168.2.129
139
140       source
141           The source option specifies the JunOS device that is going to run
142           the ping commands.  This address will be used for the ssh
143           connection.
144
145           Example value: 192.168.2.1
146
147           This setting is mandatory.
148

AUTHORS

150       Tobias Oetiker <tobi@oetiker.ch>
151
152       based on Smokeping::probes::TelnetJunOSPing by S H A N
153       <shanali@yahoo.com>.
154

NOTES

156   JunOS configuration
157       The JunOS device should have a username/password configured, as well as
158       the ability to connect to the VTY(s).
159
160       Make sure to connect to the remote host once from the commmand line as
161       the user who is running smokeping. On the first connect ssh will ask to
162       add the new host to its known_hosts file. This will not happen
163       automatically so the script will fail to login until the ssh key of
164       your juniper box is in the known_hosts file.
165
166       Some JunOS devices have a maximum of 5 VTYs available, so be careful
167       not to hit a limit with the 'forks' variable.
168
169   Requirements
170       This module requires the  Net::OpenSSH and IO::Pty.
171
172
173
1742.7.3                             2021-03-1S1mokeping_probes_OpenSSHJunOSPing(3)
Impressum