http://www.bea.com/ns/weblogic/920/domain
element community-prefix

Model

<community-prefix>annonymous type derived from string</community-prefix>

Disallowed substitutions (block)

none (extensions, restrictions and substitutions are allowed)

Substitution group exclusion (final)

none (extensions and restrictions are allowed)

Usage

Documentation

The password (community name) that you want this SNMP agent to use to secure SNMPv1 or v2 communication with SNMP managers. Requires you to enable community based access for this agent.

SNMPv3 does not use community names. Instead, it encrypts user names and passwords in its PDUs.

When you use SNMPv1 or v2, there are two community names that are needed when the WebLogic SNMP agent and SNMP managers interact:

• The name that you specify in this community prefix. All SNMP managers must send this name when connecting to this SNMP agent.

• The community name that the SNMP manager defines. The SNMP agent must send this name when connecting to the manager. (You supply this community name when you configure a trap destination.)

In addition to using the community prefix as a password, an SNMP agent on an Administration Server uses the prefix to qualify requests from SNMP managers. Because the Administration Server can access data for all WebLogic Server instances in a domain, a request that specifies only an attribute name is potentially ambiguous. For example, the attribute serverUptime exists for each WebLogic Server instance in a domain. To clarify requests that you send to SNMP agents on Administration Servers, use the community prefix as follows:

• To request the value of an attribute on a specific Managed Server, when you send a request from an SNMP manager, append the name of the server instance to the community prefix: community_prefix@server_name .

• To request the value of an attribute for all server instances in a domain, send a community name with the following form: community_prefix

To secure access to the values of the WebLogic attributes when using the SNMPv1 or v2 protocols, it is recommended that you set community prefix to a value other than public.

You cannot specify a null (empty) value for the community prefix. If you delete the prefix value, WebLogic Server resets the value to public. If you do not want this agent to receive SNMPv1 or v2 requests, instead of trying to set the community prefix to a null value, disable community based access. With community based access disabled, WebLogic Server ignores the community prefix value.

Privileges: Read/Write

Default Value: public

Secure value: not public

MBean Attribute: SNMPAgentMBean.CommunityPrefix

Fundamental Facets

equality, non-numeric, unbounded, unordered, countable infinite value space

Length Facets

length ≥ 1

White Space Processing

preserve