chsyslogserver

Use the chsyslogserver command to modify the parameters of an existing syslog server.

Syntax

chsyslogserver [ -nameserver_name ] [ -ipip_address ] [ -facilityfacility ] [ -error { on | off } ] [ -warning { on | off } ] [ -info { on | off } ] [ -cadf { on | off } ] { syslog_server_name | syslog_server_id }

Parameters

-nameserver_name
(Optional) Specifies a name to assign to the syslog server. The name must be unique. When specifying a server name, syslog is a reserved word.
-ipip_address
(Optional) Specifies an IP address to assign to the syslog server. This must be a valid IPv4 or IPv6 address.
-facilityfacility
(Optional) Specifies a facility number to identify the origin of the message to the receiving server. Servers configured with facility values of 0 - 3 receive syslog messages in concise format. Servers configured with facility values of 4 - 7 receive syslog messages in fully-expanded format. This parameter is mutually-exclusive with -cadf.
-erroron|off
(Optional) Specifies whether the server receives error notifications. Set to on, error notifications are sent to the syslog server. Set to off, error notifications are not sent to the syslog server.
-warningon|off
(Optional) Specifies whether the server receives warning notifications. Set to on, warning notifications are sent to the syslog server. Set to off, warning notifications are not sent to the syslog server.
-infoon|off
(Optional) Specifies whether the server receives information notifications. Set to on, information notifications are sent to the syslog server. Set to off, information notifications are not sent to the syslog server.
-cadfon|off
(Optional) Specifies that Cloud Auditing Data Federation (CADF) data reporting be turned on or off. Any syslog notifications sent to the server are formatted to the CADF standard. This parameter is mutually-exclusive with -facility.
syslog_server_name | syslog_server_id
(Required) Specifies the name or ID of the server to be modified.

Description

Use this command to change the settings of an existing syslog server. You must specify either the current name of the server or the ID returned at creation time. Use the lssyslogserver command to obtain this ID.

For syslog servers, SNMP servers, and email users with type set to local, the valid combinations of notification types are:
  • -error, -warning, and -info
  • -error and -warning

If you disable CADF notifications for a syslog server that has CADF notification enabled, the facility value must be set to 0.

An invocation example

chsyslogserver -facility 5 2

The resulting output:

No feedback

An invocation example

chsyslogserver -cadf on 0

The resulting output:

No feedback