 |
|
|
System Administration | testemail(1m) |
| testemail - Test the event-reporting
features, which include event message logging and email notification
of events. |
SYNOPSIS
| testemail -c event_class_list -d domain_ID [-i resource_indictment_list] |
|
testemail(1M) enables you to generate test events and verify that they are logged in the SMS platform message log file and reported by email to designated recipients. This command also enables you to verify any changes made to the email control file (event_email.cf), which identifies the recipients of the event email.
You specify the test events to be generated, the domain affected by the events, and optionally a list of components that are associated (indicted) with each event listed.
|
|
The following options are supported:
- -c event_class_list
- A list of one or more fault event classes to be generated and reported by the test email, for example: fault.test.email
Use a comma to separate each event class listed. The valid fault classes are described in the file /etc/opt/SUNWSMS/SMS/config/SF15000.dict .
- -d domain_id
- Specifies the one-character ID of the domain affected by the specified event classes. Valid domain_ids are A-R and must be specified as upper-case characters.
- -h
- Help. Displays usage descriptions. Note Use alone. Any option specified in addition to -h is ignored.
- -i indictment_
resource_list
- A list of one or more components that map to each event class specified. Use a comma to separate each component in the list. The components listed correspond to each fault event specified. However, for test purposes the components specified do not actually have to be faulty.
Valid component values are:
-
board (a system_board, io_board, expander_board, or centerplane_support_board)
-
system_board/port
-
io_board/port
-
system_board/port/physical bank/dimm
-
system_board/port/physical bank/dimm/logical_dimm
-
system_board/port/ecache
-
io_board/port/iobus
-
centerplane
-
centerplane support
-
bus (address bus, data bus, or response bus)
-
expander_board/cdcdimm0
-
expander_board/bus
-
system_controller
-
system_controller_peripheral
-
fan _tray
-
power_supply
-
- where
-
system_board
-
SB(0...17) for Sun Fire 15K systems
SB(0...8) for Sun Fire 12K systems
-
io_board
-
IO(0...17) for Sun Fire 15K systems
IO(0...8) for Sun Fire 12K systems
-
expander_board
-
EX(0...17) for Sun Fire 15K systems
EX(0...8) for Sun Fire 12K systems
-
port or processors for system_boards
-
P(0...3)
-
-
-
physical bank
-
B(0|1)
-
dimm
-
D(0...3)
-
logical dimm
-
L(0|1)
-
-
-
io_bus
-
I(0|1)
-
ecache
-
E(0|1)
-
centerplane
-
CP(0|1)
-
centerplane support
-
CS(0|1)
-
bus
-
ABUS|DBUS|RBUS(0|1)
-
system_controller
-
SC(0|1)
-
system_controller_peripheral
-
SCPER(0|1)
-
fan tray
-
FT(0...7)
-
power supply
-
PS(0...5)
|
|
Test Results
|
The results of the email test includes the following:
- Event messages in the platform messages log that reflect the test fault with event code, with a text string that indicates the test should be ignored
- Email that notifies designated recipients of the events generated
|
Group Privileges Required
|
You must have platform administrator or platform service privileges to run this command.
Refer to Chapter 2, "SMS Security Options and Administrative Privileges" in the System Management Services (SMS) 1.4 Administrator Guide for more information.
|
|
| Example 1. Generating Test Fault Events for Expander and I/O Boards
|
|
sc0:sms-user:> testemail -c fault.board.ex.l1l2, fault.board.io.l1l2 -dD -i EX7,IO8
|
|
|
|
The following exit values are returned:
-
0
- Successful completion.
- >0
- An error occurred.
|
|
The following files are used by this command:
-
/etc/opt/SUNWSMS/SMS/config/event_email.cf
- Controls email notifications
|
|
See attributes(5) for descriptions of the following attributes:
Attribute Types | Attribute Values |
Availability | SUNWSMSop |
|
SMS 1.4 | Go To Top | Last Changed 19 September 2003 |
Company Info
|
Contact
|
Copyright 2003 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, CA 95054 USA. All rights reserved.
|