Skip to main content

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.

FunctionWhat it doesCommandTarget (see paths in Command targets)
Display syslog configurationDisplays 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 levelSet 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 1Enables 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 2Enables 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 - setSets 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 - setSets 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 - setSets 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 - setSets 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 messageGenerates 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 formatSet 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]>