No relevant resource is found in the selected language.

This site uses cookies. By continuing to browse the site you are agreeing to our use of cookies. Read our privacy policy>Search

Reminder

To have a better experience, please upgrade your IE browser.

upgrade

X6800 Server Node iBMC (Earlier Than V250) User Guide 29

This document describes the underlying management software Intelligent Baseboard Management Controller (iBMC) of the servers.
Rate and give feedback :
Huawei uses machine translation combined with human proofreading to translate this document to different languages in order to help you better understand the content of this document. Note: Even the most advanced machine translation cannot match the quality of professional translators. Huawei shall not bear any responsibility for translation accuracy and it is recommended that you refer to the English document (a link for which has been provided).
Syslog Commands

Syslog Commands

This topic describes how to use commands for querying and setting syslog parameters.

Querying and Setting Syslog (syslog -d state)

Function

The syslog -d state command is used to query and set the syslog feature for the iBMC.

Format

ipmcget -t syslog -d state [-v destination]

ipmcset -t syslog -d state -v [destination] <disabled | enabled>

Parameters

Parameter Description Value
destination Identifies the channel sending syslog messages.
  • Value range: 1 to 4

  • If this parameter is not specified, the command is used to set the syslog function.

disabled Disables syslog. -
enabled Enables syslog. -

Usage Guidelines

  • To set syslog for a specific channel, specify destination. The value range of destination is 1 to 4.

  • To enable or disable the syslog function, leave destination unspecified.

Example

# Disable syslog for channel 1.

iBMC:/->ipmcset -t syslog -d state -v 1 disabled
Set syslog dest1 disabled successfully.

# Query the syslog status of channel 1.

iBMC:/-> ipmcget -t syslog -d state -v 1
syslog dest1 state: disabled

Querying and Setting the Certificate Authentication Mode (syslog -d auth)

Function

The syslog -d auth is used to query and set the certificate authentication mode.

Format

ipmcget -t syslog -d auth

ipmcset -t syslog -d auth -v <option>

Parameters

Parameter Description Value
option Specifies the certificate authentication mode.
  • 1: one-way authentication
  • 2: mutual authentication

Usage Guidelines

  • One-way authentication: Only the syslog server certificate is authenticated.
  • Mutual authentication: Certificates of both the syslog server and the client are authenticated.

Example

# Set the certificate authentication mode to mutual authentication.

iBMC:/->ipmcset -t syslog -d auth -v 2
Set syslog auth type successfully.

# Query the current certificate authentication mode.

iBMC:/-> ipmcget -t syslog -d auth
Syslog auth type: mutual authentication

Querying and Setting the Syslog Host Identifier (syslog -d identity)

Function

The syslog -d identity command is used to query and set the host identifier used for syslog reporting.

Format

ipmcget -t syslog -d identity

ipmcset -t syslog -d identity -v <option>

Parameters

Parameter

Description

Value

option

Specifies the host identifier to be used.

  • 1: board serial number
  • 2: product asset tag
  • 3: host name

Usage Guidelines

None

Example

# Set the syslog host identifier to the host name.

iBMC:/-> ipmcset -t syslog -d identity -v 3
Set syslog identity successfully.

# Query the syslog host identifier.

iBMC:/-> ipmcget -t syslog -d identity
Syslog identity: host name

Querying and Setting the Protocol Type (syslog -d protocol)

Function

The syslog -d protocol command is used to query and set the protocol used for syslog reporting.

Format

ipmcget -t syslog -d protocol

ipmcset -t syslog -d protocol -v <option>

Parameters

Parameter Description Value
option Specifies the protocol used.
  • 1: UDP
  • 2: TCP
  • 3: TLS

Usage Guidelines

  • TLS: indicates a connection-oriented protocol that ensures confidentiality and integrity of the transmitted data.
  • TCP: indicates a connection-oriented protocol that establishes a reliable connection between the sender and the receiver before data transmission.
  • UDP: indicates a connectionless protocol that does not establish a connection between the sender and the receiver before data transmission.

Example

# Set the syslog reporting protocol to TLS.

iBMC:/-> ipmcset -t syslog -d protocol -v 3
Set syslog protocol successfully.

# Query the current syslog reporting protocol.

iBMC:/-> ipmcget -t syslog -d protocol
Syslog protocol: TLS

Querying and Setting the Log Levels for Reporting (syslog -d severity)

Function

The syslog -d severity command is used to query and set the levels of logs to be reported as syslog packets.

Format

ipmcget -t syslog -d severity

ipmcset -t syslog -d severity -v <level>

Parameters

Parameter

Description

Value

level

Specifies the levels of logs to be reported.

  • none: indicates that no alarms will be reported.
  • all: indicates that all alarms including fault and log alarms will be reported.
  • normal: indicates that all alarms including fault and log alarms will be reported.
  • minor: indicates that minor, major, and critical fault alarms will be reported.
  • major: indicates that major and critical fault alarms will be reported.
  • critical: indicates that critical fault alarms will be reported.

Usage Guidelines

None.

Example

# Set the log level to critical for syslog reporting.

iBMC:/->ipmcset -t syslog -d severity -v critical
Set syslog severity successfully.

# Query the log level of syslog reporting.

iBMC:/-> ipmcget -t syslog -d severity
Syslog severity:  critical

Querying and Uploading the Server Root Certificate (syslog -d rootcertificate)

Function

The syslog -d rootcertificate command is used to upload the syslog server root certificate to iBMC or query the current root certificate information.

Format

ipmcget -t syslog -d rootcertificate

ipmcset -t syslog -d rootcertificate -v <filepath>

Parameters

Parameter

Description

Value

filepath

Specifies the absolute path of the syslog server root certificate on the iBMC.

For example, /tmp/rootcertificate.cer

Usage Guidelines

Before running this command, use a file transfer tool that supports SFTP, for example WinSCP, to transfer the custom root certificate to the specified directory (for example /tmp) of the iBMC file system.

Example

# Upload the server root certificate.

iBMC:/-> ipmcset -t syslog -d rootcertificate -v /tmp/rootcertificate.cer
Set syslog root certificate successfully.

# Query the server root certificate information.

iBMC:/-> ipmcget -t syslog -d rootcertificate
Server Root Certificate:
Issued     To: CN=SERVER, OU=IT, O=HW, L=, S=GD, C=CH
Issued     By: CN=Huawei, OU=IT, O=Huawei, L=ShenZhen, S=GuangDong, C=CN
Valid    From: Mar 24 2016 GMT
Valid      To: Mar 24 2017 GMT
Serial Number: 0b

Querying and Uploading the Local Certificate (syslog -d clientcertificate)

Function

The syslog -d clientcertificate command is used to upload the syslog client (local) certificate to iBMC or query the current local certificate information.

Format

ipmcget -t syslog -d clientcertificate

ipmcset -t syslog -d clientcertificate -v <filepath> <password>

Parameters

Parameter

Description

Value

filepath

Indicates the absolute path of the root certificate on iBMC.

For example, /tmp/rootcertificate.cer
password

Indicates the password used to decrypt the local certificate.

The password is automatically generated when the certificate server is used to generate a local certificate.

Usage Guidelines

Before running this command, use a file transfer tool that supports SFTP, for example WinSCP, to transfer the local certificate to the specified directory (for example /tmp) of the iBMC file system.

Example

# Upload the local certificate.

iBMC:/-> ipmcset -t syslog -d client -v /tmp/clientcertificate.pfx syslogpw
Set syslog client certificate successfully.

# Query local certificate information.

iBMC:/-> ipmcget -t syslog -d clientcertificate
Syslog Client Certificate Information:
Issued     To: CN=Server, OU=IT, O=Huawei, L=ShenZhen, S=GuangDong, C=CN
Issued     By: CN=huangmin, OU=it3, O=huawei3, L=, S=guangdong2, C=cn
Valid    From: Feb 17 2015 GMT
Valid      To: Feb 17 2016 GMT
Serial Number: 25

Setting the Syslog Server Address (syslog -d address)

Function

The syslog -d address command is used to set the syslog server address.

Format

ipmcset -t syslog -d address -v <destN> <address>

Parameters

Parameter Description Value
destN Specifies the number of a syslog reporting channel. 1 to 4
address Specifies the syslog server address. The address can be an IPv4, IPv6, or domain address.

Usage Guidelines

None

Example

# Set the syslog server address to host for channel 1.

iBMC:/-> ipmcset -t syslog -d address -v 1 host
Set syslog dest1 address successfully.

# Query the syslog server address.

iBMC:/-> ipmcget -t syslog -d iteminfo

Item Num        | state      | port       | dest address         | log type     
1               | disabled   | 0          | host                 | operationlogs securitylogs eventlogs
2               | disabled   | 0          |                      | operationlogs securitylogs eventlogs
3               | disabled   | 0          |                      | operationlogs securitylogs eventlogs
4               | disabled   | 0          |                      | operationlogs securitylogs eventlogs

Setting the Syslog Server Port Number (syslog -d port)

Function

The syslog -d port command is used to set the syslog server port number.

Format

ipmcset -t syslog -d port -v <destN> <number>

Parameters

Parameter Description Value
destN Specifies the number of a syslog reporting channel. 1 to 4
number Specifies the syslog server port number. 1 to 65535

Usage Guidelines

None

Example

# Set the syslog server port number to 65535 for channel 1.

iBMC:/-> ipmcset -t syslog -d port -v 1 65535
Set syslog dest1 port successfully.

# Query the syslog server port numbers.

iBMC:/-> ipmcget -t syslog -d iteminfo

Item Num        | state      | port       | dest address         | log type     
1               | disabled   | 65535      | host                 | operationlogs securitylogs eventlogs
2               | disabled   | 0          |                      | operationlogs securitylogs eventlogs
3               | disabled   | 0          |                      | operationlogs securitylogs eventlogs
4               | disabled   | 0          |                      | operationlogs securitylogs eventlogs

Setting Logs Types for Reporting (syslog -d logtype)

Function

The syslog -d logtype command is used to set the types of logs to be reported as syslog packets.

Format

ipmcset -t syslog -d logtype -v <destN> <type>

Parameters

Parameter Description Value
destN Specifies the number of a syslog reporting channel. 1 to 4
type Specifies the types of logs to be reported.
  • none: No logs will be reported.
  • all: All logs will be reported.
  • operationlogs: Operations logs will be reported.
  • securitylogs: Security logs will be reported.
  • eventlogs: Event logs will be reported.

Usage Guidelines

None

Example

# Set the log types for channel 4 to operation and event logs.

iBMC:/-> ipmcset -t syslog -d logtype -v 4 operationlogs eventlogs
Set syslog log type successfully.

# Query the types of logs reported through channel 4.

iBMC:/-> ipmcget -t syslog -d iteminfo

Item Num        | state      | port       | dest address         | log type
1               | disabled   | 65535      | host                 | operationlogs securitylogs eventlogs
2               | disabled   | 0          |                      | operationlogs securitylogs eventlogs
3               | disabled   | 0          |                      | operationlogs securitylogs eventlogs
4               | disabled   | 0          |                      | operationlogs eventlogs

Testing Reachability of the Syslog Server (syslog -d test)

Function

The syslog -d test command is used to test whether the syslog server is reachable.

Format

ipmcset -t syslog -d test -v <destN>

Parameters

Parameter Description Value
destN Specifies the number of a syslog reporting channel. 1 to 4

Usage Guidelines

None

Example

# Test whether the syslog server for channel 1 is reachable.

iBMC:/-> ipmcset -t syslog -d test -v 1
Test syslog dest1 successfully.

Querying Configuration Information of All Syslog Reporting Channels (syslog -d iteminfo)

Function

The syslog -d iteminfo command is used to query configuration information of the four syslog reporting channels.

Format

ipmcget -t syslog -d iteminfo

Parameters

None

Usage Guidelines

None

Example

# Query configuration information of iBMC syslog reporting channels.

iBMC:/-> ipmcget -t syslog -d iteminfo

Item Num        | state      | port       | dest address         | log type     
1               | disabled   | 65535      | host                 | operationlogs securitylogs eventlogs
2               | disabled   | 0          |                      | operationlogs securitylogs eventlogs
3               | disabled   | 0          |                      | operationlogs securitylogs eventlogs
4               | disabled   | 0          |                      | operationlogs eventlogs
Translation
Download
Updated: 2019-02-28

Document ID: EDOC1000066341

Views: 133333

Downloads: 1081

Average rating:
This Document Applies to these Products
Related Documents
Related Version
Share
Previous Next