App-Netsync
view release on metacpan or search on metacpan
I<Note: All communication with network nodes is done using SNMP.>
B<Overview>
In a typical run, execution begins by parsing a configuration file (-c).
Next, Netsync searches for active network devices at each node.
Nodes may be specified by filename, DNS (-D), or the keyboard (STDIN).
Furthermore, nodes may be required to match a hostname pattern (-m).
Gathered information may be used to identify each device in a database.
A database may be specified using Database (-d) or DB in the configuration file.
Identified devices may then be updated (-u) with interface-specific information.
See F<doc/algorithm.svg> for corresponding visual guidance
(F</usr/share/netsync/algorithm.svg> after installation).
=head2 0 Installation
$ cpan App::Netsync
or
lib/App/Netsync.pm view on Meta::CPAN
if ($config{'Verbose'}) {
say interface_string ($interface).' failed';
say ((' 'x$config{'Indent'}).$error);
}
}
}
}
}
# Show the user how many nodes have been updated if necessary.
unless ($config{'Quiet'}) {
print $successful_update_count if $config{'Verbose'};
print ' successful';
print ' ('.$failed_update_count.' failed)' if $failed_update_count > 0;
print "\n";
}
}
=head1 AUTHOR
share/mib/CISCO-IETF-IP-MIB.my view on Meta::CPAN
DESCRIPTION
"The media-dependent `physical' address."
::= { cInetNetToMediaEntry 3 }
cInetNetToMediaLastUpdated OBJECT-TYPE
SYNTAX TimeStamp
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The value of sysUpTime at the time this entry was last
updated. If this entry was updated prior to the last re-
initialization of the local network management subsystem,
then this object contains a zero value."
::= { cInetNetToMediaEntry 4 }
cInetNetToMediaType OBJECT-TYPE
SYNTAX INTEGER {
other(1), -- none of the following
invalid(2), -- an invalidated mapping
dynamic(3),
static(4),
share/mib/CISCO-STACK-MIB.my view on Meta::CPAN
DESCRIPTION "To add a new entry to the mdgGatewayTable, set
this object to primary(2) or other(3) for an IP
address which is not already in the table. The
primary entry will be used first, if it is
reachable. Otherwise, one of the other entries
will be used. Setting one entry to primary(2)
causes any previous primary entry to change to
other(3). To remove an entry from the table, set
this object to invalid(1). Changing an existing
entry from primary(2) to other(3) is not allowed.
If the value of this object is updated, the
corresponding entry of the ipRouteTable (mibII)
will be updated and vice versa."
::= { mdgGatewayEntry 2 }
-- the RADIUS group
-- Implementation of the RADIUS group is optional, but within the group
-- all the elements are current. If the RADIUS feature is implemented,
-- the entire group should be implemented.
share/mib/CISCO-VTP-MIB.my view on Meta::CPAN
DESCRIPTION
"The current Configuration Revision Number as known by
the local device for this management domain when
managementDomainVersionInUse is version1(1) or
version2(2).
If managementDomainVersionInUse is version3(4), this
object has the same value with vtpDatabaseRevisionNumber
of VLAN database type.
This value is updated (if necessary) whenever a VTP
advertisement is received or generated. When in the
'no management-domain' state, this value is 0."
::= { managementDomainEntry 4 }
managementDomainLastUpdater OBJECT-TYPE
SYNTAX IpAddress
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The IP-address (or one of them) of the VTP Server which
last updated the Configuration Revision Number, as indicated
in the most recently received VTP advertisement for this
management domain, when managementDomainVersionInUse is
version1(1) or version2(2).
If managementDomainVersionInUse is version3(4), this object
has the value of 0.0.0.0.
Before an advertisement has been received, this value is
0.0.0.0."
::= { managementDomainEntry 5 }
share/mib/CISCO-VTP-MIB.my view on Meta::CPAN
unknown database type."
::= { vtpDatabaseEntry 3 }
vtpDatabaseRevNumber OBJECT-TYPE
SYNTAX Gauge32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The current configuration revision number as known by the
local device for this VTP 3 database type in the management
domain. This value is updated (if necessary) whenever a
VTP advertisement for the database type is received
or generated. When the database type is unknown to the
local device or no VTP advertisement for the database
type is received or generated, its value is 0."
::= { vtpDatabaseEntry 4 }
vtpDatabasePrimaryServer OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-only
STATUS current
share/mib/FDDI-SMT73-MIB.txt view on Meta::CPAN
::= { fddimibMACCountersEntry 4 }
fddimibMACRingOpCts OBJECT-TYPE
SYNTAX Counter
ACCESS read-only
STATUS mandatory
DESCRIPTION
"The count of the number of times the ring has
entered the 'Ring_Operational' state from the
'Ring Not Operational' state. This count is
updated when a SM_MA_STATUS.Indication of a change
in the Ring_Operational status occurs (refer to
ANSI 6.1.4). Because of implementation
considerations, this count may be less than the
actual RingOp_Ct. It is not a requirement that
this count be exact."
REFERENCE
"ANSI { fddiMAC 86 }"
::= { fddimibMACCountersEntry 5 }
fddimibMACNotCopiedRatio OBJECT-TYPE
share/mib/FOUNDRY-SN-AGENT-MIB.mib view on Meta::CPAN
::= { snAgentRedunGbl 2 }
snAgentRedunBkupCopyBootCode OBJECT-TYPE
SYNTAX INTEGER { disabled(0), enabled(1) }
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"If enabled(1), the backup management module copies the boot code
from the active management module to its boot code flash storage
after power up, and whenever the active management module's boot
code is updated. The backup management module does not copy if
both boot codes were identical."
DEFVAL { disabled }
::= { snAgentRedunGbl 3 }
snAgentEnableMgmtModRedunStateChangeTrap OBJECT-TYPE
SYNTAX INTEGER { disabled(0), enabled(1) }
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"Indicates whether the SNMP agent process is permitted to
share/mib/IF-MIB.txt view on Meta::CPAN
" Keith McCloghrie
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
US
408-526-5260
kzm@cisco.com"
DESCRIPTION
"The MIB module to describe generic objects for network
interface sub-layers. This MIB is an updated version of
MIB-II's ifTable, and incorporates the extensions defined in
RFC 1229."
REVISION "200006140000Z"
DESCRIPTION
"Clarifications agreed upon by the Interfaces MIB WG, and
published as RFC 2863."
REVISION "199602282155Z"
DESCRIPTION
"Revisions made by the Interfaces MIB WG, and published in
share/mib/OSPF-MIB.txt view on Meta::CPAN
in RFC 4750 for more information.
Copyright (C) The IETF Trust (2006).
This version of this MIB module is part of
RFC 4750; see the RFC itself for full legal
notices."
REVISION "200611100000Z" -- November 10, 2006 09:00:00 EST
DESCRIPTION
"Updated for latest changes to OSPF Version 2:
- updated the General Group with the new
ospfRFC1583Compatibility, ospfReferenceBandwidth
and ospfDiscontinuityTime objects
- added graceful-restart-related objects
- added stub-router-related objects
- updated the Area Table with NSSA-related objects
- added ospfAreaAggregateExtRouteTag object
- added Opaque LSA-related objects
- updates to the Compliances and Security sections
- added area LSA counter table
- added section describing translation of notification
parameters between SNMP versions
- added ospfComplianceObsolete to contain obsolete
object groups
- deprecated ospfExtLsdbTable
See Appendix B of RFC 4750 for more details.
share/mib/PerfHist-TC-MIB.txt view on Meta::CPAN
"This MIB Module provides Textual Conventions
to be used by systems supporting 15 minute
based performance history counts.
Copyright (C) The Internet Society (2003).
This version of this MIB module is part of
RFC 3593; see the RFC itself for full
legal notices."
REVISION "200308130000Z"
DESCRIPTION
"Contact information and references updated.
No technical changes have been applied.
Published as RFC 3593."
REVISION "199811071100Z"
DESCRIPTION
"The RFC 2493 version of this MIB module."
::= { mib-2 58 }
-- The Textual Conventions defined below are organized
-- alphabetically
share/mib/Q-BRIDGE-MIB.txt view on Meta::CPAN
SYNTAX PortList
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The set of ports for which a frame with a specific
unicast address will be flooded in the event that it
has not been learned. It also specifies the set of
ports on which a specific unicast address may be dynamically
learned. The dot1qTpFdbTable will have an equivalent
entry with a dot1qTpFdbPort value of '0' until this
address has been learned, at which point it will be updated
with the port the address has been seen on. This only
applies to ports that are members of the VLAN, defined
by dot1qVlanCurrentEgressPorts. The default value of
this object is a string of ones of appropriate length.
The value of this object MUST be retained across
reinitializations of the management system."
REFERENCE
"IEEE 802.1Q/D11 Table 8-5, ISO/IEC 15802-3 Table 7-5"
::= { dot1qStaticUnicastEntry 3 }
share/mib/RMON2-MIB.txt view on Meta::CPAN
nlMatrixDSSourceAddress
nlMatrixDSDestAddress
nlMatrixTopNSourceAddress
nlMatrixTopNDestAddress
alHostEntry
alMatrixSDEntry
alMatrixDSEntry
alMatrixTopNSourceAddress
alMatrixTopNDestAddress
Finally, the TimeFilter TC has been updated to encourage agent
implementations that allow a MIB walk to behave well even when
performed by an application that is not aware of the special
TimeFilter semantics."
REVISION "200207080000Z" -- 08 July, 2002
DESCRIPTION
"Added new enumerations to support the High-Capacity RMON
MIB as defined in RFC 3273. Also fixed some typos and
added clarifications."
share/mib/RMON2-MIB.txt view on Meta::CPAN
returning basic conceptual entries (e.g., 'fooColumn.N.I') if
any column within the basic conceptual entry has changed since
sysUpTime 'N'. If not, the basic conceptual entry will
be ignored for the particular retrieval operation.
When sysUpTime is equal to zero, this table shall be empty.
One conceptual entry exists for each past value of sysUpTime,
except that the whole table is purged should sysUpTime wrap.
As an entry in a time-filtered table is updated (i.e., one of
the columns in the basic conceptual table is changed), new
conceptual entries are also created in the time-filtered version
(which still shares the now updated object values with all other
instances). The number of unique time-filtered instances that
are created is determined by the value of sysUpTime at which the
basic entry was last updated. One unique instance will exist
for each value of sysUpTime at the last update time for the row.
However, a new TimeFilter index instance is created for each new
sysUpTime value. The TimeFilter index values not associated
with entry updates are called duplicate time-filtered instances.
After some deployment experience, it has been determined that
a time-filtered table is more efficient if the agent
stops a MIB walk operation by skipping over rows with a
TimeFilter index value higher than the value in the received
GetNext/GetBulk request. That is, instead of incrementing a
share/mib/RMON2-MIB.txt view on Meta::CPAN
}
Note that entries exist in the time-filtered conceptual table
only if they actually exist in the underlying (basic) table.
For this example, the fooTable will have three underlying
basic entries (fooIndex == 1, 2, and 3), with the following
activity (for sysUpTime equal 0 to 9):
- fooEntry.N.1 is created at time '0' and most recently
updated at time '6' to the value '5'.
- fooEntry.N.2 is created at time '0' and most recently
updated at time '8' to the value '9'.
- fooEntry.N.3 is created at time '3', updated at time '5'
to the value '17', and deleted at time '7'.
The following tables show the values that would be returned for
MIB walk operations with various TimeFilter values, done at
different times. An application issues a retrieval request at
time 'T', with a TimeFilter value, 'N' (typically set to a lower
value, such as the value of sysUpTime at the last polling cycle).
The following values would be returned in a MIB walk of
fooCounts.N if T equals '0' and N equals '0':
share/mib/RMON2-MIB.txt view on Meta::CPAN
::= { protocolDistControlEntry 6 }
-- per interface protocol distribution statistics table
protocolDistStatsTable OBJECT-TYPE
SYNTAX SEQUENCE OF ProtocolDistStatsEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry is made in this table for every protocol in the
protocolDirTable that has been seen in at least one packet.
Counters are updated in this table for every protocol type
that is encountered when parsing a packet, but no counters are
updated for packets with MAC-layer errors.
Note that if a protocolDirEntry is deleted, all associated
entries in this table are removed."
::= { protocolDist 2 }
protocolDistStatsEntry OBJECT-TYPE
SYNTAX ProtocolDistStatsEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
share/mib/RMON2-MIB.txt view on Meta::CPAN
addressMapLastChange OBJECT-TYPE
SYNTAX TimeStamp
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The value of sysUpTime at the time this entry was last
created or the values of the physical address changed.
This can be used to help detect duplicate address problems, in
which case this object will be updated frequently."
::= { addressMapEntry 5 }
--
-- Network Layer Host Group
--
-- Counts the amount of traffic sent from and to each network address
-- discovered by the probe.
-- Note that while the hlHostControlTable also has objects that
-- control an optional alHostTable, implementation of the alHostTable is
-- not required to fully implement this group.
share/mib/TOKEN-RING-RMON-MIB.txt view on Meta::CPAN
ringStationConfigControlUpdateStats OBJECT-TYPE
SYNTAX INTEGER {
stable(1),
updating(2)
}
ACCESS read-write
STATUS mandatory
DESCRIPTION
"Setting this object to `updating(2)' causes the
configuration information associate with this
entry to be updated. The agent will set this
object to `stable(1)' after processing the
request."
::= { ringStationConfigControlEntry 4 }
-- The ringStationConfig Table
--
-- Entries exist in this table after an active
-- configuration query has completed successfully for
-- a station. This query is initiated by the associated
-- ringStationConfigControlUpdateStats variable.
share/mib/TOKEN-RING-RMON-MIB.txt view on Meta::CPAN
DESCRIPTION
"The physical address of this station."
::= { ringStationConfigEntry 2 }
ringStationConfigUpdateTime OBJECT-TYPE
SYNTAX TimeTicks
ACCESS read-only
STATUS mandatory
DESCRIPTION
"The value of sysUpTime at the time this
configuration information was last updated
(completely)."
::= { ringStationConfigEntry 3 }
ringStationConfigLocation OBJECT-TYPE
SYNTAX OCTET STRING (SIZE(4))
ACCESS read-only
STATUS mandatory
DESCRIPTION
"The assigned physical location of this station."
::= { ringStationConfigEntry 4 }
share/mib/lldp.mib view on Meta::CPAN
Periodically, NMS should poll the object
lldpStatsRemTablesLastChangeTime to find out if anything
has changed since the last poll. if something has
changed, NMS will poll the objects listed in step 1 to
figure out what kind of changes occurred in the tables.
if value of lldpStatsRemTablesInserts has changed,
then NMS will walk all tables by employing TimeFilter
with the last-polled time value. This request will
return new objects or objects whose values are updated
since the last poll.
if value of lldpStatsRemTablesAgeouts has changed,
then NMS will walk the lldpStatsRxPortAgeoutsTotal and
compare the new values with previously recorded ones.
For ports whose lldpStatsRxPortAgeoutsTotal value is
greater than the recorded value, NMS will have to
retrieve objects associated with those ports from
table(s) without employing a TimeFilter (which is
performed by specifying 0 for the TimeFilter.)
( run in 0.757 second using v1.01-cache-2.11-cpan-05444aca049 )