File: //opt/OV/www/htdocs/ito_man/opcnetchk.1m.html
<!-- manual page source format generated by PolyglotMan v3.2, -->
<!-- available at http://polyglotman.sourceforge.net/ -->
<html>
<head>
<title>Title</title>
</head>
<body bgcolor='white'>
<a href='#toc'>Table of Contents</a><p>
<h2><a name='sect0' href='#toc0'>Name</a></h2>
<p>
opcnetchk - a test utility from the Hewlett Packard OpenView Support
Operation
<p>
<h2><a name='sect1' href='#toc1'><b>Synopsis</b></a></h2>
<p>
<b>opcnetchk</b> [-p [-m]] [-d] [-P <port>] [-T <time>] [-i <time>] [-I <num>]
[-v <variable>] [-t <single test>] <hostname>
<p>
<h2><a name='sect2' href='#toc2'><b>Description</b></a></h2>
<p>
is a tool that is designed to test basic types of communication.
<p><p>
opcnetchk is used to troubleshoot OVO communication problems.
<p><p>
Please note that opcnetchk is a strictly unsupported tool, however, HP
continues to invest in this tool and welcomes feedback on problems as
well as enhancement requests.
<p><p>
This tool is only used for reporting. It does not make any changes on
the system it checks. The report will be printed to stdout/stderr.
<p><p>
This version of opcnetchk supports the following OVO versions: OVO
5.30, 6.x, 7.x, 8.x.
<p><p>
Checks made by opcnetchk:
<p><p>
TCP connection check:
<p><p>
tries to establish a TCP connection. If the -p flag is used (DCE only),
then it will parse the OVO default configuration file and test whether
it can establish connections according to the defined port restric‐
tions.
<p><p>
ICMP ping check:
<p><p>
checks whether the specified host returns echo replies.
<p><p>
SNMP check:
<p><p>
retrieves .1.3.6.1.2.1.1.1.0 (system.sysDescr.0), if possible.
<p><p>
HTTP/HTTPS ping check:
<p><p>
uses HTTP and HTTPS protocols for a simple ping to the HTTPS communica‐
tion broker (ovbbccb) on the target host.
<p><p>
<b>Options</b><br>
<dl>
<dt><b>-p</b> </dt></dt>
<dd> parse /opt/OV/bin/OpC/install/opcinfo file, bind to all speci‐
fied ports, and connect to the default port. This is for DCE
agents only.
<p></dd>
<dt><b>-m</b> </dt></dt>
<dd> parse /opt/OV/bin/OpC/install/opcsvinfo file, bind to all speci‐
fied ports, and connect to the default port. This is only sup‐
ported for OVO servers up to version 7.x.
<p></dd>
<dt><b>-d</b> </dt></dt>
<dd> run in verbose mode.
<p></dd>
<dt><b>-P</b> <b><port></b></dt></dt>
<dd>
connect to the specified port. The default port is 23.
<p></dd>
<dt><b>-T</b> <b><time></b></dt></dt>
<dd>
set TCP connect timeout to the specified value in seconds. There
is no time limit on default.
<p></dd>
<dt><b>-i</b> <b><time></b></dt></dt>
<dd>
set ICMP wait timeout to the specified value in seconds. There
is no time limit on default. In case that ICMP timeout is set
to zero, the reply will be expected immediately. This is rarely
possible and could cause the ‘Server unreachable error’ even if
that is not the case.
<p></dd>
<dt><b>-I</b> <b><num></b></dt></dt>
<dd>
set number of sent ICMP packets. The default value is 3.
<p></dd>
<dt><b>-v</b> <b><variable></b></dt></dt>
<dd>
retrieve the <i>variable</i> via snmpget. The default is
.1.3.6.1.2.1.1.1.0 (system.sysDescr.0).
<p></dd>
<dt><b>-t</b> <b><single</b> <b>test></b></dt></dt>
<dd>
perform only one of the tests. Allowed values are <i>icmp,</i> <i>tcp,</i>
<i>snmp,</i> <i>http</i> and <i>all</i>.
<p></dd>
</dl>
<h2><a name='sect3' href='#toc3'><b>Return</b> <b>Value</b></a></h2>
<p>
returns the following value:
<p>
<dl>
<dt>0 </dt></dt>
<dd> All tests passed.
<p></dd>
<dt>1 </dt></dt>
<dd> One or more tests failed.
<p></dd>
</dl>
<h2><a name='sect4' href='#toc4'><b>Files</b></a></h2>
<p>
/opt/OV/contrib/OpC/opcnetchk<br>
The binary.
<p><p>
/opt/OV/bin/OpC/install/opcsvinfo<br>
OVO server configuration file... Port restrictions are checked
if -p and -m options are specified.
<p><p>
/opt/OV/bin/OpC/install/opcinfo<br>
OVO agent configuration file... Port restrictions are checked if
-p option is specified.
<p>
<h2><a name='sect5' href='#toc5'><b>Examples</b></a></h2>
<p>
Invoke opcnetchk and print usage:
<p><p>
<i>opcnetchk</i>
<p><p>
Check OVO environment, connect to port 21, send 3 ICMP pings, and
retrieve .1.3.6.1.2.1.1.1.0 SNMP variable:
<p><p>
<i>opcnetchk</i> <i>-P</i> <i>21</i> <i>hostname</i>
<p><p>
Check OVO environment, parse opcsvinfo file, bind to all ports defined
by port restrictions, and retrieve .1.3.6.1.2.1.1.1.0 SNMP variable:
<p><p>
<i>opcnetchk</i> <i>-p</i> <i>-m</i> <i>hostname</i>
<p>
<h2><a name='sect6' href='#toc6'><b>Warnings</b></a></h2>
<p>
When running <i>opcnetchk</i> against the local host, the <i>icmp</i> check may be
inaccurate in that it reports more lost packages than are actually
lost).
<p>
<h2><a name='sect7' href='#toc7'><b>See</b> <b>Also</b></a></h2>
<p>
<i>HP</i> <i>OpenView</i> <i>OV/Operations</i> <i>Concepts</i> <i>Guide</i>,
<i>HP</i> <i>OpenView</i> <i>OV/Operations</i> <i>Administrator’s</i> <i>Reference</i>
<p>
<h2><a name='sect8' href='#toc8'><b>Author</b></a></h2>
<p>
The utility was developed by HP and is an expert utility from the Open‐
View Support Operation.
<p>
<hr><p>
<a name='toc'><b>Table of Contents</b></a><p>
<ul>
<li><a name='toc0' href='#sect0'>Name</a></li>
<li><a name='toc1' href='#sect1'>Synopsis</a></li>
<li><a name='toc2' href='#sect2'>Description</a></li>
<li><a name='toc3' href='#sect3'>Return Value</a></li>
<li><a name='toc4' href='#sect4'>Files</a></li>
<li><a name='toc5' href='#sect5'>Examples</a></li>
<li><a name='toc6' href='#sect6'>Warnings</a></li>
<li><a name='toc7' href='#sect7'>See Also</a></li>
<li><a name='toc8' href='#sect8'>Author</a></li>
</ul>
</body>
</html>