Skip Navigation Links
Exit Print View
| Oracle Solaris Cluster Reference Manual Oracle Solaris Cluster 4.1

Search Scope:

- This Document
- Entire Library

### sceventmib

- manage Oracle Solaris 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 - Oracle Solaris Cluster software includes an object-oriented command set. Although Oracle Solaris Cluster software still supports the original command set, Oracle Solaris 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 Oracle Solaris 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 Oracle Solaris 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 an Oracle Solaris OS user.

`-e`

  Enables the Oracle Solaris 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 Oracle Solaris 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 | `ha-cluster/system/core`
Interface Stability | Evolving

## Files

`/usr/cluster/lib/mib/sun-cluster-event-mib.mib`

  Oracle Solaris Cluster SNMP Event MIB definition file

## See Also

`Intro`(1CL), `clsnmphost`(1CL), `clsnmpmib`(1CL), `clsnmpuser`(1CL), `attributes`(5)

Oracle Solaris Cluster System Administration Guide

Copyright © 2000, 2012, Oracle and/or its affiliates. All rights reserved. Legal Notices |