chsyslogserver

Edit online

The chsyslogserver command modifies a Syslog server.

Syslog servers for each HMC can be created separately. For the parameter -hmc, the default value all specifies the primary HMC on a single HMC system, and specifies both the primary and secondary HMCs on a dual HMC system. If any of HMCs fails, an error is returned and rollback is done on both HMCs.

Note: The chsyslogserver command cannot be run from the Embedded DS CLI window.
Read syntax diagramSkip visual syntax diagram chsyslogserver  -hmc 1 2 all -addr IP_address -serverport port -type audit message event all -cacert  CA_CERT -hmccert  HMC_CERT -hmckey  HMC_KEY  -state active inactive   server_name |  -

Parameters

-hmc 1 | 2 | all
(Optional) The HMC on which you want to modify the server.
  • -hmc 1 specifies the primary HMC
  • -hmc 2 specifies the secondary HMC.
  • The default value all specifies the primary HMC on a single HMC system, and specifies both the primary and secondary HMCs on a dual HMC system.
-addr IP_address
(Optional) The TCP/IP address for the Syslog server.
-serverport port
(Optional) The communications port of the Syslog server. If you do not specify this parameter, the port of the Syslog server is not changed.
-type audit| message | event | all
(Optional) An array of one or more types of logs to be forwarded to the Syslog server. You can specify one or more types of logs, which are separated by commas.
audit
Specifies that audit log information is forwarded to the Syslog server.
message
Specifies that system messages are forwarded to the Syslog server.
event
Specifies that system event information is forwarded to the Syslog server.
all
Specifies that all types of logs (audit, message, and event) are forwarded to the Syslog server. The default value is all.
-cacert CA_CERT
(Optional) The location for CA certificates. This option is only valid when the protocol is TLS.
-hmccert HMC_CERT
(Optional) The location for HMC certificates. This option is only valid when the protocol is Transport Layer Security (TLS).
-hmckey HMC_KEY
(Optional) The location for HMC private keys. This option is only valid when the protocol is TLS.
-state active|inactive
(Optional) Whether the current server is active or not.
server_name | -
(Required) The Syslog server. Alternatively, the command accepts input from stdin when the dash (-) is specified.

Example: Modifing a Syslog server

chsyslogserver -state active syslog_1
Output 
Syslog server syslog_1 successfully modified.