syslog command

This command manages how the CMM handles transmission of event log messages to networked syslog event collectors.

If command syntax is not correctly entered, or if a command fails to run, an error message is returned. See Common errors for a list of error messages that apply to all commands or syslog command errors for a list of error messages that are specific to the syslog command.

Note:
  • When using the syslog command to send CMM system event logs over a network, the data is sent unencrypted and can be read by any user that is connected to the network.
  • The messages a CMM sends to the syslog server are facility 1 user-level messages. Each message is assigned a priority that is based on the severity of the event being converted.
Table 1. syslog command.

The command table is a multi-row, four-column table where each row describes a CMM CLI command option: column one lists command function, column two provides a detailed command description, column three shows command-option syntax, and column four lists valid command targets.
Function What it does Command Target (see paths in Command targets)
Display syslog configuration Displays the syslog event log transmission configuration of the CMM. syslog
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set syslog filter level Set severity filtering levels for syslog event log transmission. syslog -sev level

where level is:

  • i selects error, warning, and informational logs
  • w selects error and warning logs
  • e selects error logs
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis account management
  • Chassis log management
  • Chassis administration
  • Chassis configuration
See Commands and user authority for additional information.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set syslog event log transmission state for collector 1 Enables or disables syslog event log transmission to collector 1. syslog -coll1 state

where state is enabled or disabled .

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis account management
  • Chassis log management
  • Chassis administration
  • Chassis configuration
See Commands and user authority for additional information.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set syslog event log transmission state for collector 2 Enables or disables syslog event log transmission to collector 2. syslog -coll2 state

where state is enabled or disabled .

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis account management
  • Chassis log management
  • Chassis administration
  • Chassis configuration
See Commands and user authority for additional information.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Syslog event log collector 1 host name or IP address - set Sets the host name or IP address for syslog event collector 1. syslog -i1 hostname/ip_address

where hostname/ip_address is the collector 1 host name or IP address.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis account management
  • Chassis log management
  • Chassis administration
  • Chassis configuration
See Commands and user authority for additional information.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Syslog event log collector 2 host name or IP address - set Sets the host name or IP address for syslog event collector 2. syslog -i2 hostname/ip_address

where hostname/ip_address is the collector 2 host name or IP address.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis account management
  • Chassis log management
  • Chassis administration
  • Chassis configuration
See Commands and user authority for additional information.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Syslog event log collector 1 port number - set Sets the port number for syslog event collector 1. syslog -p1 port

where port is the collector 1 port number from 1 to 65535, inclusive. If you enter a value outside this range, an error will be displayed.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis account management
  • Chassis log management
  • Chassis administration
  • Chassis configuration
See Commands and user authority for additional information.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Syslog event log collector 2 port number - set Sets the port number for syslog event collector 2. syslog -p2 port

where port is the collector 2 port number from 1 to 65535, inclusive. If you enter a value outside this range, an error will be displayed.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis account management
  • Chassis log management
  • Chassis administration
  • Chassis configuration
See Commands and user authority for additional information.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Generate test message Generates a test syslog message to test the configuration.
Note: The -test command options must be run exclusive of other command options.
 syslog -test
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis account management
  • Chassis log management
  • Chassis administration
  • Chassis configuration
  • Blade administration
  • Blade configuration
  • Blade remote presence
  • I/O module administration
  • I/O module configuration
See Commands and user authority for additional information.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set timestamp format Set timestamp format for syslog event log transmission. syslog -f format

where format is:

  • default

    where the timestamp format is like in this example 

    ‘Thu Mar  1 
07:42:53 2018’

  • RFC3164

    where the timestamp format is complaint with RFC 3164. Example:

    ‘Mar 1 07:42:53’
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 Primary CMM:
  • -T system:mm[x]
  • .
where x is the primary management-module bay number.
Example: To view the syslog event log transmission configuration of the primary CMM in bay 1, while this CMM is set as the persistent command environment, at the system:mm[1]> prompt, type 
syslog

The following example shows the information that is returned from this command:

system:mm[1]> syslog
-sev i
-coll1 enabled
-coll2 enabled
-i1 10.241.53.60
-i2 10.241.53.41
-p1 514
-p2 514
-f default
system:mm[1]>
Parent topic: Command reference