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

java.util.SortedSet<java.lang.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 asterik (*) opens access to all managers.

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

setAllowedManager

void setAllowedManager(java.util.Collection<java.lang.String> values)
                       throws IllegalPropertyValueException
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 asterik (*) opens access to all managers.

Parameters:
values - The values of the "allowed-manager" property.
Throws:
IllegalPropertyValueException - If one or more of the new values are invalid.

getAllowedUser

java.util.SortedSet<java.lang.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 asterik (*) opens access to all users.

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

setAllowedUser

void setAllowedUser(java.util.Collection<java.lang.String> values)
                    throws IllegalPropertyValueException
Sets the "allowed-user" property.

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

Parameters:
values - The values of the "allowed-user" property.
Throws:
IllegalPropertyValueException - If one or more of the new values are invalid.

getCommunity

java.lang.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(java.lang.String value)
                  throws IllegalPropertyValueException
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:
IllegalPropertyValueException - If the new value is invalid.

getJavaClass

java.lang.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(java.lang.String value)
                  throws IllegalPropertyValueException
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:
IllegalPropertyValueException - If the new value is invalid.

getListenPort

java.lang.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 IllegalPropertyValueException
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:
IllegalPropertyValueException - If the new value is invalid.

getOpendmkJarfile

java.lang.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(java.lang.String value)
                       throws IllegalPropertyValueException
Sets the "opendmk-jarfile" property.

Indicates the OpenDMK runtime jar file location

Parameters:
value - The value of the "opendmk-jarfile" property.
Throws:
IllegalPropertyValueException - 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(java.lang.Boolean value)
                        throws IllegalPropertyValueException
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:
IllegalPropertyValueException - If the new value is invalid.

getSecurityAgentFile

java.lang.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(java.lang.String value)
                          throws IllegalPropertyValueException
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:
IllegalPropertyValueException - 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 id required for SNMP V3 security configuration.

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

setSecurityLevel

void setSecurityLevel(SNMPConnectionHandlerCfgDefn.SecurityLevel value)
                      throws IllegalPropertyValueException
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 id required for SNMP V3 security configuration.

Parameters:
value - The value of the "security-level" property.
Throws:
IllegalPropertyValueException - If the new value is invalid.

getTrapPort

java.lang.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 IllegalPropertyValueException
Sets the "trap-port" property.

Specifies the port to use to send SNMP Traps.

Parameters:
value - The value of the "trap-port" property.
Throws:
IllegalPropertyValueException - If the new value is invalid.

getTrapsCommunity

java.lang.String getTrapsCommunity()
Gets the "traps-community" property.

Specifies the community string that must be include 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(java.lang.String value)
                       throws IllegalPropertyValueException
Sets the "traps-community" property.

Specifies the community string that must be include 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:
IllegalPropertyValueException - If the new value is invalid.

getTrapsDestination

java.util.SortedSet<java.lang.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(java.util.Collection<java.lang.String> values)
                         throws IllegalPropertyValueException
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:
IllegalPropertyValueException - If one or more of the new values are invalid.