sceventmib(1M)

NAME | Synopsis | Description | Options | Examples | Exit Status | Attributes | Files | See Also

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 information 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 independently 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 properties, such as the version of SNMP trap notifications or the host name for an IP address to which to send trap notifications. The Sun Cluster 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.

• The first example specifies the host by its host name, sc-host.

  # sceventmib -a -h sc-host -c public

• 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 specified, 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  Last Revised 9 Aug 2006

NAME | Synopsis | Description | Options | Examples | Exit Status | Attributes | Files | See Also