C H A P T E R 8

Managing System Alerts

Topics
Description | Links
--- | ---
Review the prerequisites | Before You Begin
Manage alert rule configurations | Create or Edit Alert Rules Disable an Alert Rule
Generate test alerts to confirm alert configuration is working | Generate Test Alerts
Send a test email alert before saving an alert rule | Send Test Email Alert to a Specific Destination
Review the CLI commands you need to use when managing alert rule configurations | CLI Commands for Managing Alert Rule Configurations
Notify recipient of system alerts using email | Enable SMTP Client
Download SNMP MIBs directly from ILOM | Download SNMP MIBs

Related Topics
For ILOM | Chapter or Section | Guide
--- | --- | ---
Concepts | System Monitoring and Alert Management | Oracle Integrated Lights Out Manager (ILOM) 3.0 Concepts Guide (820-6410)
Web interface | Managing System Alerts | Oracle Integrated Lights Out Manager (ILOM) 3.0 Web Interface Procedures Guide (820-6411)
IPMI and SNMP hosts | Inventory and Component Management | Oracle Integrated Lights Out Manager (ILOM) 3.0 Management Protocols Reference Guide (820-6413)
The ILOM 3.0 Documentation Collection is available at: `http://docs.sun.com/app/docs/prod/int.lights.mgr30#hic`.

##

Managing Alert Rule Configurations

Topics
Description | Links | Platform Feature Support
--- | --- | ---
Review the prerequisites | Before You Begin | x86 system server SP SPARC system server SP CMM
Configure alert configurations | Create or Edit Alert Rules Disable an Alert Rule
Generate test alerts to confirm alert configuration is working | Generate Test Alerts
Send a test email alert to a specific destination before saving the alert rule | Send Test Email Alert to a Specific Destination
Notify recipient of system alerts via email | Enable SMTP Client

### Before You Begin

- If you are defining an Email Notification alert, the outgoing email server that will be used to send the email notification must be configured in ILOM. If an outgoing email server is not configured, ILOM will not be able to successfully generate Email Notification alerts.

- If you are defining an SNMP Trap alert with the version set to SNMP v3, the SNMP user name must be defined in ILOM as an SNMP user. If the user is not defined in ILOM as an SNMP user, the receiver of the SNMP alert will be unable to decode the SNMP alert message.

- Review the CLI commands for managing alert rule configurations. See CLI Commands for Managing Alert Rule Configurations.

- To manage alert rule configurations, you need the Admin (`a`) role enabled.

- To send a test email alert, you need the Read Only (`o`) role enabled and you must be using ILOM 3.0.4 or a later version of ILOM.

### Create or Edit Alert Rules

Follow these steps to configure an alert rule:

1. Establish a local serial console connection or SSH connection to the server SP or CMM.

2. Type one of the following command paths to set the working directory:

- For a rackmounted server:`cd /SP/alertmgmt`

- For a blade server module: `cd /SP/alertmgmt`

- For a chassis CMM: `cd /CMM/alertmgmt`

3. Type the `show` command to view properties associated with an alert rule.

For example, to view the properties associated with the first alert rule, you would type one of the following:

- For a rackmounted server: `show /SP/alertmgmt/rules/1`

- For a blade sever module: `show /CH/BL` n`/SP/alertmgmt/rules/1`

- For a chassis CMM: `show /CMM/alertmgmt/CMM/rules/1`

4. Type the `set` command to assign values to properties associated with an alert rule.

For example, to set IPMI PET as the alert type for rule 1, you would type the following command path:

    ->set /SP/alertmgmt/rules/1 type=ipmipet

Note - To enable an alert rule configuration, you must specify a value for the alert type, alert level, and alert destination. If you are defining an SNMP alert type, you can optionally define a value for authenticating the receipt of SNMP Trap alerts.

### Disable an Alert Rule

Follow these steps to disable an alert rule:

1. Establish a local serial console connection or SSH connection to the server SP or CMM.

2. Type one of the following command paths to set the working directory:

- For a rackmounted server SP, type:`cd /SP/alertngnt/rules/`n

- For a blade server SP, type: `cd /CH/BL` n`/SP/alertmgmt/rules/`n

- For a chassis CMM, type: `cd /CMM/alertmgmt/CMM/rules/`n

Where n equals a specific alert rule number, which can be 1 to 15.

[BLn refers to the server module (blade) slot number.]

3. To disable the alert rule, type the following command:

    ->set level=disable

### Generate Test Alerts

Follow these steps to generate test alerts:

1. Establish a local serial console connection or SSH connection to the server SP or CMM.

2. Type one of the following command paths to set the working directory:

- For a rackmounted server SP, type:`cd /SP/alertmgmt/rules`

- For a blade server SP, type:`cd /CH/BL` n`/SP/alertmgmt/rules`

- For a chassis CMM, type:`cd /CMM/alertmgmt/CMM/rules`

3. Type the following command to generate a test alert for each enabled alert rule configuration:

    ->set testalert=true

### Send Test Email Alert to a Specific Destination

Follow these steps to send a test email alert:

1. Establish a local serial console connection or SSH connection to the server SP or CMM.

2. Type one of the following command paths to set the working directory:

- For a rackmounted server SP, type:`cd /SP/alertmgmt/rules`

- For a blade server SP, type:`cd /CH/BL` n`/SP/alertmgmt/rules`

- For a chassis CMM, type:`cd /CMM/alertmgmt/CMM/rules`

3. Type the following command to send a test email alert for each alert rule configuration:

    ->set testrule=true

##

CLI Commands for Managing Alert Rule Configurations

The following table describes the CLI commands that you will need to use to manage alert rule configurations using the ILOM CLI.

TABLE 8-1 CLI Commands for Managing Alert Rule Configurations
CLI Command | Description
--- | ---
`show` | The `show` command enables you to display any level of the alert management command tree by specifying either the full or relative path. Examples: To display an alert rule along with its properties using a full path, you would type the following at the command prompt:
    -> show /SP/alertmgmt/rules/1
`/SP/alertmgmt/rules/1` `Properties:` `community_or_username = public` `destination = 129.148.185.52` `level = minor` `snmp_version = 1` `type = snmptrap` `Commands:` `cd` `set` `show`
| To display a single property using the full path, you would type the following at the command prompt:
      -> show /SP/alertmgmt/rules/1 type
    /SP/alertmgmt/rules/1
    Properties:
            type = snmptrap
       Commands:
            set
            show
| To specify a relative path if the current tree location is `/SP/alertmgmt/rules`, you would type the following at the command prompt:
      -> show 1/
      /SP/alertmgmt/rules/1
        Targets:
        Properties:
            community_or_username = public
            destination = 129.148.185.52
            level = minor
            snmp_version = 1
            type = snmptrap
        Commands:
            cd
            set
            show
`cd` | The `cd` command enables you to set the working directory. To set alert management as a working directory on a server SP, you would type the following command at the command prompt:
      -> cd /SP/alertmgmt
`set` | The `set` command enables you to set values to properties from any place in the tree. You can specify either a full or relative path for the property depending on the location of the tree. For example: For full paths, you would type the following at the command prompt:
    -> set /SP/alertmgmt/rules/1 type=ipmipet
For relative path (tree location is `/SP/alertmgmt`), you would type the following command path at the command prompt:
    -> set rules/1 type=ipmipet
For relative path (tree location is `/SP/alertmgmt/rules/1`), you would type the following command path at the command prompt:
    -> set type=ipmipet

##

Configuring SMTP Client for Email Notification Alerts

Topics
Description | Links | Platform Feature Support
--- | --- | ---
Notify recipient of system alerts using email | Enable SMTP Client | x86 system server SP SPARC system server SP CMM

### Before You Begin

- To enable SMTP Clients, you need the Admin (`a`) role enabled.

- To generate configured Email Notification alerts, you must enable the ILOM client to act as an SMTP client to send the email alert messages.

- Prior to enabling the ILOM client as an SMTP client, determine the IP address and port number of the outgoing SMTP email server that will process the email notification.

### Enable SMTP Client

Follow these steps to enable the SMTP client:

1. Establish a local serial console connection or SSH connection to the server SP or CMM.

2. Type one of the following command paths to set the working directory:

- For a rackmounted server SP, type:`cd /SP/clients/smtp`

- For a blade server SP, type:`cd /CH/BL` n`/SP/clients/smtp`

- For a chassis CMM, type:`cd /CMM/clients/smtp`

3. Type the `show` command to display the SMTP properties.

For example, accessing the SMTP properties for the first time on an SP would appear as follows:

    -> show
    /SP/clients/smtp
    Targets
      Properties
      address = 0. 0. 0. 0
      port = 25
      state = enabled
    Commands:
      cd
      set
      show

4. Use the `set` command to specify an IP address for the SMTP client or to change the port or state property value.

For example:

    ->set address=222.333.44.5

5. Press Enter for the change to take effect.

For example, if you typed `set address=222.333.44.5` the following result would appear:

`Set ‘address=222.333.44.5’`

##

Downloading SNMP MIBs Directly From ILOM

Topics
Description | Links | Platform Feature Support
--- | --- | ---
Download SNMP MIBs directly from ILOM | Download SNMP MIBs | x86 system server SP SPARC system server SP CMM

### Before You Begin

- The Reset and Host Control (`r`) role is required to download SNMP MIBs from ILOM.

- You must be using ILOM 3.0.4 or a later version of ILOM.

### Download SNMP MIBs

Follow these steps to download SNMP MIBs:

1. Log in to the ILOM SP CLI or the CMM CLI.

2. Use the `show` command to display the SNMP MIBs.

For example:

    -> show /SP/services/snmp/mibs

     /SP/services/snmp/mibs
        Targets:

        Properties:
            dump_uri = (Cannot show property)

        Commands:
            cd
            dump
            set
            show

3. To download the files, type either of the following commands:

-> `dump -destination` URI `/SP/services/snmp/mibs`

or

->`set /SP/services/snmp/mibs dump_uri=`URI

Where URI specifies the target to which the files are downloaded.

A zip file containing the MIBs are transferred to the destination server.

Copyright © 2010, Oracle and/or its affiliates. All rights reserved.