org.opends.server.admin.std.client

Interface SNMPConnectionHandlerCfgClient

All Superinterfaces:

ConfigurationClient, ConnectionHandlerCfgClient

public interface SNMPConnectionHandlerCfgClient
extends ConnectionHandlerCfgClient

A client-side interface for reading and modifying SNMP Connection Handler settings.

The SNMP Connection Handler can be used to process SNMP requests to retrieve monitoring information described by the MIB 2605. Supported protocol are SNMP V1, V2c and V3.

Method Summary

Methods

Modifier and Type	Method and Description
ManagedObjectDefinition<? extends SNMPConnectionHandlerCfgClient,? extends SNMPConnectionHandlerCfg>	definition() Get the configuration definition associated with this SNMP Connection Handler.
SortedSet<String>	getAllowedManager() Gets the "allowed-manager" property.
SortedSet<String>	getAllowedUser() Gets the "allowed-user" property.
String	getCommunity() Gets the "community" property.
String	getJavaClass() Gets the "java-class" property.
SortedSet<InetAddress>	getListenAddress() Gets the "listen-address" property.
Integer	getListenPort() Gets the "listen-port" property.
String	getOpendmkJarfile() Gets the "opendmk-jarfile" property.
String	getSecurityAgentFile() Gets the "security-agent-file" property.
SNMPConnectionHandlerCfgDefn.SecurityLevel	getSecurityLevel() Gets the "security-level" property.
Integer	getTrapPort() Gets the "trap-port" property.
String	getTrapsCommunity() Gets the "traps-community" property.
SortedSet<String>	getTrapsDestination() Gets the "traps-destination" property.
boolean	isRegisteredMbean() Gets the "registered-mbean" property.
void	setAllowedManager(Collection<String> values) Sets the "allowed-manager" property.
void	setAllowedUser(Collection<String> values) Sets the "allowed-user" property.
void	setCommunity(String value) Sets the "community" property.
void	setJavaClass(String value) Sets the "java-class" property.
void	setListenAddress(Collection<InetAddress> values) Sets the "listen-address" property.
void	setListenPort(int value) Sets the "listen-port" property.
void	setOpendmkJarfile(String value) Sets the "opendmk-jarfile" property.
void	setRegisteredMbean(Boolean value) Sets the "registered-mbean" property.
void	setSecurityAgentFile(String value) Sets the "security-agent-file" property.
void	setSecurityLevel(SNMPConnectionHandlerCfgDefn.SecurityLevel value) Sets the "security-level" property.
void	setTrapPort(int value) Sets the "trap-port" property.
void	setTrapsCommunity(String value) Sets the "traps-community" property.
void	setTrapsDestination(Collection<String> values) Sets the "traps-destination" property.

Methods inherited from interface org.opends.server.admin.std.client.ConnectionHandlerCfgClient

getAllowedClient, getDeniedClient, isEnabled, setAllowedClient, setDeniedClient, setEnabled

Methods inherited from interface org.opends.server.admin.ConfigurationClient

commit, properties

Method Detail

definition

ManagedObjectDefinition<? extends SNMPConnectionHandlerCfgClient,? extends SNMPConnectionHandlerCfg> definition()

Get the configuration definition associated with this SNMP Connection Handler.

Specified by:

definition in interface ConfigurationClient

Specified by:

definition in interface ConnectionHandlerCfgClient

Returns:

Returns the configuration definition associated with this SNMP Connection Handler.

getAllowedManager

SortedSet<String> getAllowedManager()

Gets the "allowed-manager" property.

Specifies the hosts of the managers to be granted the access rights. This property is required for SNMP v1 and v2 security configuration. An asterisk (*) opens access to all managers.

Returns:

Returns the values of the "allowed-manager" property.

setAllowedManager

void setAllowedManager(Collection<String> values)
                       throws PropertyException

Sets the "allowed-manager" property.

Specifies the hosts of the managers to be granted the access rights. This property is required for SNMP v1 and v2 security configuration. An asterisk (*) opens access to all managers.

Parameters:

values - The values of the "allowed-manager" property.

Throws:

PropertyException - If one or more of the new values are invalid.

getAllowedUser

SortedSet<String> getAllowedUser()

Gets the "allowed-user" property.

Specifies the users to be granted the access rights. This property is required for SNMP v3 security configuration. An asterisk (*) opens access to all users.

Returns:

Returns the values of the "allowed-user" property.

setAllowedUser

void setAllowedUser(Collection<String> values)
                    throws PropertyException

Sets the "allowed-user" property.

Specifies the users to be granted the access rights. This property is required for SNMP v3 security configuration. An asterisk (*) opens access to all users.

Parameters:

values - The values of the "allowed-user" property.

Throws:

PropertyException - If one or more of the new values are invalid.

getCommunity

String getCommunity()

Gets the "community" property.

Specifies the v1,v2 community or the v3 context name allowed to access the MIB 2605 monitoring information or the USM MIB. The mapping between "community" and "context name" is set.

Returns:

Returns the value of the "community" property.

setCommunity

void setCommunity(String value)
                  throws PropertyException

Sets the "community" property.

Specifies the v1,v2 community or the v3 context name allowed to access the MIB 2605 monitoring information or the USM MIB. The mapping between "community" and "context name" is set.

Parameters:

value - The value of the "community" property.

Throws:

PropertyException - If the new value is invalid.

getJavaClass

String getJavaClass()

Gets the "java-class" property.

Specifies the fully-qualified name of the Java class that provides the SNMP Connection Handler implementation.

Specified by:

getJavaClass in interface ConnectionHandlerCfgClient

Returns:

Returns the value of the "java-class" property.

setJavaClass

void setJavaClass(String value)
                  throws PropertyException

Sets the "java-class" property.

Specifies the fully-qualified name of the Java class that provides the SNMP Connection Handler implementation.

Specified by:

setJavaClass in interface ConnectionHandlerCfgClient

Parameters:

value - The value of the "java-class" property.

Throws:

PropertyException - If the new value is invalid.

getListenAddress

SortedSet<InetAddress> getListenAddress()

Gets the "listen-address" property.

Specifies the address or set of addresses on which this SNMP Connection Handler should listen for connections from SNMP clients.

Multiple addresses may be provided as separate values for this attribute. If no values are provided, then the SNMP Connection Handler listens on all interfaces.

Returns:

Returns the values of the "listen-address" property.

setListenAddress

void setListenAddress(Collection<InetAddress> values)
                      throws PropertyException,
                             PropertyException

Sets the "listen-address" property.

Specifies the address or set of addresses on which this SNMP Connection Handler should listen for connections from SNMP clients.

Multiple addresses may be provided as separate values for this attribute. If no values are provided, then the SNMP Connection Handler listens on all interfaces.

This property is read-only and can only be modified during creation of a SNMP Connection Handler.

Parameters:

values - The values of the "listen-address" property.

Throws:

PropertyException - If one or more of the new values are invalid.

PropertyException - If this SNMP Connection Handler is not being initialized.

getListenPort

Integer getListenPort()

Gets the "listen-port" property.

Specifies the port number on which the SNMP Connection Handler will listen for connections from clients.

Only a single port number may be provided.

Returns:

Returns the value of the "listen-port" property.

setListenPort

void setListenPort(int value)
                   throws PropertyException

Sets the "listen-port" property.

Specifies the port number on which the SNMP Connection Handler will listen for connections from clients.

Only a single port number may be provided.

Parameters:

value - The value of the "listen-port" property.

Throws:

PropertyException - If the new value is invalid.

getOpendmkJarfile

String getOpendmkJarfile()

Gets the "opendmk-jarfile" property.

Indicates the OpenDMK runtime jar file location

Returns:

Returns the value of the "opendmk-jarfile" property.

setOpendmkJarfile

void setOpendmkJarfile(String value)
                       throws PropertyException

Sets the "opendmk-jarfile" property.

Indicates the OpenDMK runtime jar file location

Parameters:

value - The value of the "opendmk-jarfile" property.

Throws:

PropertyException - If the new value is invalid.

isRegisteredMbean

boolean isRegisteredMbean()

Gets the "registered-mbean" property.

Indicates whether the SNMP objects have to be registered in the directory server MBeanServer or not allowing to access SNMP Objects with RMI connector if enabled.

Returns:

Returns the value of the "registered-mbean" property.

setRegisteredMbean

void setRegisteredMbean(Boolean value)
                        throws PropertyException

Sets the "registered-mbean" property.

Indicates whether the SNMP objects have to be registered in the directory server MBeanServer or not allowing to access SNMP Objects with RMI connector if enabled.

Parameters:

value - The value of the "registered-mbean" property.

Throws:

PropertyException - If the new value is invalid.

getSecurityAgentFile

String getSecurityAgentFile()

Gets the "security-agent-file" property.

Specifies the USM security configuration to receive authenticated only SNMP requests.

Returns:

Returns the value of the "security-agent-file" property.

setSecurityAgentFile

void setSecurityAgentFile(String value)
                          throws PropertyException

Sets the "security-agent-file" property.

Specifies the USM security configuration to receive authenticated only SNMP requests.

Parameters:

value - The value of the "security-agent-file" property.

Throws:

PropertyException - If the new value is invalid.

getSecurityLevel

SNMPConnectionHandlerCfgDefn.SecurityLevel getSecurityLevel()

Gets the "security-level" property.

Specifies the type of security level : NoAuthNoPriv : No security mechanisms activated, AuthNoPriv : Authentication activated with no privacy, AuthPriv : Authentication with privacy activated. This property is required for SNMP V3 security configuration.

Returns:

Returns the value of the "security-level" property.

setSecurityLevel

void setSecurityLevel(SNMPConnectionHandlerCfgDefn.SecurityLevel value)
                      throws PropertyException

Sets the "security-level" property.

Specifies the type of security level : NoAuthNoPriv : No security mechanisms activated, AuthNoPriv : Authentication activated with no privacy, AuthPriv : Authentication with privacy activated. This property is required for SNMP V3 security configuration.

Parameters:

value - The value of the "security-level" property.

Throws:

PropertyException - If the new value is invalid.

getTrapPort

Integer getTrapPort()

Gets the "trap-port" property.

Specifies the port to use to send SNMP Traps.

Returns:

Returns the value of the "trap-port" property.

setTrapPort

void setTrapPort(int value)
                 throws PropertyException

Sets the "trap-port" property.

Specifies the port to use to send SNMP Traps.

Parameters:

value - The value of the "trap-port" property.

Throws:

PropertyException - If the new value is invalid.

getTrapsCommunity

String getTrapsCommunity()

Gets the "traps-community" property.

Specifies the community string that must be included in the traps sent to define managers (trap-destinations). This property is used in the context of SNMP v1, v2 and v3.

Returns:

Returns the value of the "traps-community" property.

setTrapsCommunity

void setTrapsCommunity(String value)
                       throws PropertyException

Sets the "traps-community" property.

Specifies the community string that must be included in the traps sent to define managers (trap-destinations). This property is used in the context of SNMP v1, v2 and v3.

Parameters:

value - The value of the "traps-community" property.

Throws:

PropertyException - If the new value is invalid.

getTrapsDestination

SortedSet<String> getTrapsDestination()

Gets the "traps-destination" property.

Specifies the hosts to which V1 traps will be sent. V1 Traps are sent to every host listed.

If this list is empty, V1 traps are sent to "localhost". Each host in the list must be identifed by its name or complete IP Addess.

Returns:

Returns the values of the "traps-destination" property.

setTrapsDestination

void setTrapsDestination(Collection<String> values)
                         throws PropertyException

Sets the "traps-destination" property.

Specifies the hosts to which V1 traps will be sent. V1 Traps are sent to every host listed.

If this list is empty, V1 traps are sent to "localhost". Each host in the list must be identifed by its name or complete IP Addess.

Parameters:

values - The values of the "traps-destination" property.

Throws:

PropertyException - If one or more of the new values are invalid.