Setting up syslog notifications using the CLI

You can set up syslog event notifications using the command-line interface (CLI).

The syslog protocol is a standard protocol for forwarding log messages from a sender to a receiver on an IP network. The IP network can be either IPv4 or IPv6. SAN Volume Controller can send syslog messages that notify personnel about an event. SAN Volume Controller can transmit syslog messages in either expanded or concise format. You can use a syslog manager to view the syslog messages that SAN Volume Controller sends. SAN Volume Controller uses the User Datagram Protocol (UDP) to transmit the syslog message. You can use the SAN Volume Controller Console or the SAN Volume Controller command-line interface to configure and modify your syslog settings.

The syslog event notification settings apply to the entire cluster. You can specify the types of events that cause the cluster to send a notification. The possible types of notifications are error, warning, or information.

To specify a syslog destination, you must provide a valid IP address.

Note: Servers that are configured with facility values of 0 - 3 receive syslog messages in concise format. Servers that are configured with facility values of 4 - 7 receive syslog messages in fully expanded format.

The SAN Volume Controller uses the notifications settings to call home if errors occur.

To configure and work with notification settings, use the following commands:

Issue the svctask mksyslogserver CLI command to specify the action that you want to take when a syslog error or event is logged to the error log. For example, you can issue the following CLI command to set up a syslog notification:
```
svctask mksyslogserver -ip 9.11.255.634  
```
where 9.11.255.634 is the IP address of the syslog server.
To modify a syslog notification, issue the svctask chsyslogserver command. For example:
```
svctask chsyslogserver -name -facility facility_number syslog_server_name_or_id
```
where facility number is a facility number to identify the origin of the message to the receiving server and syslog_server_name_or_id is the name or ID of the server to be modified.
To delete a syslog notification, issue the svctask rmsyslogserver command. For example:
```
svctask rmsyslogserver syslog_server_name_or_id
```
To display either a concise list or a detailed view of syslog servers that are configured on the cluster, issue the svcinfo lssyslogserver command. For example, to display a concise view, enter the following command:
```
svcinfo lssyslogserver -delim :
```
To display a detailed view of a syslog server, enter the following command:
```
svcinfo lssyslogserver snmp_server_name_or_id
```