/etc/party.conf

Configuration file for SNMPv2 party definitions

Name:

/etc/party.conf

Description:

The party.conf is used to define the different parties you'll be using for your SNMPv2 communication.

Here's the search order that's used to find this file:

  1. /nodecfg/node_name/etc/party.conf, where node_name is the value of the CS_NODENAME configuration string (see getconf and setconf)
  2. /etc/party.conf

The file uses this format:

FriendlyName PartyID
TDomain IP-address UDP-port
authProtocol privProtocol
lifetime  maxmessagesize
clock
authPrivate authPublic-length authPublic
privPrivate privPublic-length privPublic

where:

FriendlyName
Unique alphanumeric readable name for the context.
PartyID
Unique object identifier for the context.
TDomain
Transport domain.
IP-address
Address of the host using the party.
UDP-port
Port that the host will be listening to.
authProtocol
Authentication protocol used to authenticate the other host.
privProtocol
Protocol used for packet encryption.
lifetime
Decimal value.
maxmessagesize
Number of octets for the largest supported PDU.
clock
Decimal clock offset value.
authPrivate
32 hex digits.
authPublic-length
Decimal or "Null" (if "Null," no next field).
authPublic
Hex string of 2*authPublic-length digits.
privPrivate
32 hex digits.
privPublic-length
Decimal or "Null" (if "Null", no next field).
privPublic
Hex string of 2*privPublic-length digits.

For example:

agent_party .1.3.6.1.6.3.3.1.3.10.0.0.59.5
snmpUDPDomain 10.0.0.59 161
noAuth noPriv
300 484
29F660EA
00000000000000000000000000000000 Null
00000000000000000000000000000000 Null

The agent_party using an object identifier of .1.3.6.1.6.3.3.1.3.10.0.0.59.5 on host 10.0.0.59 is listening to port 161. It's using no authentication for communication and no encryption.

If TDomain (Transport domain) doesn't list an IP address that matches the IP address of an interface on the host running snmpd, there'll be no ports listed in the snmpd output when snmpd is started.


Note: If you see the following line with no ports listed:
Opening port(s):

the IP address listed in TDomain (the agent definition entry in /etc/party.conf) doesn't match the IP address of an interface on the host. You must change the agent definition to include the IP address of the interface where you wish to listen for SNMP requests.


See also:

snmpget, snmpgetnext, snmptest, snmptrapd, snmpwalk

ISO IS 8824 (ASN.1), RFC 1065, RFC 1066, RFC 1067, RFC 1446