Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

OpenSolaris 2009.06 - man page for sceventmib (opensolaris section 1m)

sceventmib(1M)						  System Administration Commands					    sceventmib(1M)

NAME
sceventmib - manage Sun Cluster event MIB module
SYNOPSIS
sceventmib -a -c community -h host ... sceventmib -a -t auth-type -u username [-f password-file] sceventmib -d -s security-level -u username sceventmib {-e | -n} sceventmib -l protocol sceventmib -m -t auth-type -u username sceventmib -p {all | hosts | users} sceventmib -r -c community -h host... sceventmib -r -u username
DESCRIPTION
Note - Beginning with the Sun Cluster 3.2 release, Sun Cluster software includes an object-oriented command set. Although Sun Cluster software still supports the original command set, Sun Cluster procedural documentation uses only the object-oriented command set. For more infor- mation about the object-oriented command set, see the Intro(1CL) man page. The sceventmib command enables, disables, and configures the Sun Cluster event Management Information Base (MIB) module. When you issue this command on a cluster node, it affects only the configuration of the MIB module on that node. Each cluster node MIB module runs inde- pendently of others in the cluster. You can use this command to enable or disable the MIB module on a cluster node. You can also use this command to set configuration proper- ties, such as the version of SNMP trap notifications or the host name for an IP address to which to send trap notifications. The Sun Clus- ter Event MIB sends trap notifications on port 11162. The SNMP tree is viewed on port 11161. You can use this command only in the global zone.
OPTIONS
Basic Options The following options direct the basic form and function of the command: -a Adds an entry for the specified SNMP host and community or for the specified user to the node configuration file. You can use this option only in the global zone. -d Sets the default security level and user that you want used when you specify the SNMPv3 protocol. You can use this option only in the global zone. You must specify a default user when you specify SNMPv3. SNMPv3 allows you to configure more than one user for the MIB module. Only a single default user can exist at any time. The first user that you add is automatically defined as the default user, regardless of the setting of this option. In this context, a default user is not necessarily the same as a Solaris OS user. -e Enables the Sun Cluster event MIB module on the node. This setting remains in effect until you change it, even after you reboot the node. You can use this option only in the global zone. -l protocol Sets the version of the SNMP protocol to use with the MIBs. You can use this option only in the global zone. You can specify either SNMPv2 or SNMPv3 for the protocol. You cannot specify the SNMPv3 protocol unless you have first configured at least one SNMPv3 user. -m Modifies the authentication type for an SNMP user. You can use this option only in the global zone. -n Disables the Sun Cluster event MIB module on the node. This setting remains in effect until you change it, even after you reboot the node. You can use this option only in the global zone. -p {all | hosts | users} Displays one of the following types of MIB configuration information: all All MIB module configuration information hosts Only the configuration information for SNMP hosts that are configured for use with the MIB module users Only the configuration information for SNMP users who are configured to use the MIB module You can use this option only in the global zone. -r Removes the entry for the specified SNMP host and community or for the specified SNMP user from the node configuration file. You can use this option only in the global zone. Additional Options You can combine additional options with the basic options to modify the default behavior of each form of the command. Refer to the SYNOPSIS section for additional details about which of these options are legal with which forms of sceventmib. The following additional options are supported: -c community Specifies the name of the SNMP community that you want to add to or remove from the node configuration file. -f password-file Specifies the name of a password file that contains one or more SNMP user names and their corresponding passwords. Use the following syntax on every line that you include in the password-file file: user:password For example, specify the following lines for users Joseph Bloggs and Andrew Smith: jbloggs:fgrxty_0 asmith:artfli!9 -h host ... Specifies the name of an SNMP host. You can specify either an IP address or a host name for host. You can include a host in more than one community. However, if a host with the same name in the same community already exists, an error is returned. -s security-level Specifies the security level of the specified SNMPv3 user. This setting determines the degree to which the user can access the SNMP MIB module. You can assign more than one security level to a user. You specify one of the following case-sensitive settings for security-level: authNoPriv Authentication security measure is required, but privacy security measure is not required. authPriv Both authentication and privacy security measures are required. noAuthNoPriv Authentication and privacy security measures are not required. -t auth-type Specifies the authentication encryption mechanism that you want to use. You can specify either MD5 or SHA for auth-type. -u username Specifies the name of an SNMPv3 user. If you add an entry for a user and the same user name and security level already exists, the information is overwritten. If you remove a default SNMPv3 user, the command automatically selects another default user.
EXAMPLES
Example 1 Enabling the Event MIB The following command enables the event MIB. # sceventmib -e Example 2 Adding an SNMP Host to a Community The following commands add a host to SNMP community public. o The first example specifies the host by its host name, sc-host. # sceventmib -a -h sc-host -c public o The second example specifies the host by its IP address, 10.0.0.25. # sceventmib -a -h 10.0.0.25 -c public Example 3 Adding an SNMP User Without Providing a Password File The following command adds the user jbloggs and specifies the MD5 authentication encryption mechanism. Because a password file is not spec- ified, the command prompts the user to provide a password. # sceventmib -a -t MD5 -u jbloggs Enter password for user jbloggs: ******** Example 4 Adding an SNMP User and Providing a Password File The following command adds the user jbloggs and specifies the MD5 authentication encryption mechanism and the password file pfile. Because a password file is specified, the command does not prompt the user to provide a password. # cat pfile jbloggs:fgrxty_0 # sceventmib -a -f pfile -t MD5 -u jbloggs Example 5 Displaying All SNMP Configuration Information The following command displays all SNMP configuration information. # sceventmib -p all Example 6 Displaying Only Configuration Information About SNMP Hosts The following command displays only configuration information about SNMP hosts. # sceventmib -p hosts Example 7 Setting the Version of SNMP Protocol The following command sets the SNMP protocol version to SNMPv3. # sceventmib -l SNMPv3 Example 8 Setting the Default SNMP User The following command sets the default SNMP user to the user jbloggs, with authentication and privacy security measures required. # sceventmib -d -s authPriv -u jbloggs Example 9 Modifying the Authentication Type of a User The following command changes the authentication type of user jbloggs to SHA. # sceventmib -m -t SHA -u jbloggs Example 10 Removing an SNMP Host The following command removes the SNMP host with IP address 10.0.0.25 in community public. # sceventmib -r -c public -h 10.0.0.25 Example 11 Removing an SNMP User The following command removes SNMP user jbloggs. # sceventmib -r -u jbloggs
EXIT STATUS
This command returns the following exit status codes: 0 The command completed successfully. nonzero An error occurred.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWsczu | +-----------------------------+-----------------------------+ |Interface Stability |Evolving | +-----------------------------+-----------------------------+
FILES
/usr/cluster/lib/mib/sun-cluster-event-mib.mib Sun Cluster SNMP Event MIB definition file
SEE ALSO
Intro(1CL), clsnmphost(1CL), clsnmpmib(1CL), clsnmpuser(1CL), attributes(5) Sun Cluster System Administration Guide for Solaris OS Sun Cluster 3.2 9 Aug 2006 sceventmib(1M)