Debug/Syslog for IPv6

The Debug/System logging (Syslog) for IPv6 feature provides logging functions similar to those of the IPv4 version, allowing you to record IPv4 and IPv6 Event Log and debug messages on a remote device to troubleshoot switch or network operation. For example, you can send messages about routing mis-configurations and other network protocol details to an external device, and later use them to debug network-level problems.


	NOTE: This section describes the commands for Debug/Syslog configuration in an IPv6 environment. For information on using the Debug/Syslog feature in an IPv4 environment, see “Debug/Syslog Operation” in the Troubleshooting appendix in the current Management and Configuration Guide for your switch.

Configuring debug and event log messaging

To specify the types of debug and Event Log messages that you want to send to an external device:

Use the debug ipv6... command to send messaging reports for the following types of switch events:
- DHCPv6 client
- DHCPv6 relay
- forwarding
- neighbor discovery
- OSPFv3
- packets
Use the logging [ severity severity-level | system-module system-module ] command to select a subset of Event Log messages to send to an external device for debugging purposes according to:
- Severity level
- System module

Debug command

Syntax

[no] debug ipv6 [debug-type ]

Configures the types of IPv6 messages that are sent to Syslog servers or other configured debug destinations, where debug-type is any of the following event types:

(none)

all IPv6 events

dhcpv6-client [ events | packets ]

one of the following IPv6 client debug message types

events

DHCPv6 client events

packets

DHCPv6 client packets

dhcpv6-relay [ events | packets ]

one of the following IPv6 relay debug message types

events

DHCPv6 relay events

packets

DHCPv6 relay packets

forwarding

IPv6 forwarding events

nd

IPv6 neighbor discovery events

ospf3

one of the following OSPFv3 message types:

(none)

all OSPFv3 debug events

adj

adjacency changes

event

events

flood

flooding

lsa-generation

link state advertisement generation

packet

one of the following OSPFv3 packet types:

(none)

all OSPFv3 packets sent or received

DD

DD packets sent or received

Hello

Hello packets sent or received

LSA

LSA packets sent or received

LSR

LSR packets sent or received

LSU

LSU packets sent or received

retransmission

retransmissions

spf

SPF computations

packet

all IPv6 packet messages

The no debug ipv6... form of the command stops the sending of debug messages of the specified type.

Configuring debug destinations

An IPv6-based debug/syslog destination device can be a Syslog server (up to six maximum) and/or a console session:

Use the debug destination [ logging | session | buffer ] command to enable (and disable) Syslog messaging on a Syslog server or to a CLI session for the debug message types configured with the debug and logging commands (see Configuring debug and event log messaging).

`debug destination logging`	enables the configured debug message types to be sent to Syslog servers configured with the `logging [ syslog-ipv4addr \| syslog-ipv6-addr ]` command.
`debug destination session`	enables the configured debug message types to be sent to the CLI session that executed this command. The session can be on any one terminal emulation device with serial, Telnet, or SSH access to the CLI at the Manager level prompt.
`debug destination buffer`	enables the configured debug message types to be sent to a buffer in switch memory.

Use the logging [ syslog-ipv6-addr ] command to configure the Syslog server at the specified IPv6 destination address.

Configuring an IPv6 syslog server

Syslog for IPv6 is a client-server logging tool that allows a client switch to send event notification messages to n IPv6 networked device operating with Syslog server software. Messages sent to a Syslog server can be stored to a file for later debugging analysis.

To use the Syslog for IPv6 feature, you must install and configure a Syslog server application on an IPv6 networked host accessible to the switch. See the documentation for the Syslog server application for instructions.

To configure an IPv6 Syslog server, use the logging [ syslog-ipv6-addr ] command as described below.

When you configure a Syslog server, Event Log messages are automatically enabled to be sent to the server. To reconfigure this setting, use the following commands:

Use the debug command to specify additional debug message types.
Use the logging command to configure the system module or severity level used to filter the Event Log messages sent to configured Syslog servers. For more information, see Configuring debug and event log messaging.

Logging command

Syntax

[no] logging syslog-ipv4-address

Enables or disables Syslog messaging to the specified IPv4 address. You can configure up to six addresses. If you configure an address when none are already configured, this command enables destination logging (Syslog) and the Event debug type. Therefore, at a minimum, the switch begins sending Event Log messages to configured Syslog servers. If other debug message types are configured, they are also sent to the Syslog server.

no logging

Removes all currently configured Syslog logging destinations from the running configuration.

no loggingsyslog-ipv4-address

Removes only the specified Syslog logging destination from the running configuration.

NOTE: The no logging command does not delete the Syslog server addresses stored in the startup configuration. To delete Syslog addresses in the startup configuration, you must enter the no logging command followed by the write memory command. To verify the deletion of a Syslog server address, display the startup configuration by entering the show config command.

To block the messages sent to configured Syslog servers from the currently configured debug message type, enter the no debug [ debug-type ] command.

To disable Syslog logging on the switch without deleting configured server addresses, enter the no debug destination logging command.

For complete information on how to configure a Syslog server and Debug/ Syslog message reports, see the “Troubleshooting” appendix in the Management and Configuration Guide.

Viewing the configuration of debug/syslog

Use the show debug command to display the currently configured settings for:

Debug message types and Event Log message filters (severity level and system module) sent to debug destinations
IPv4/IPv6 debug destinations (Syslog servers or CLI session) and Syslog server facility to be used

Syslog Configuration to Receive Event Log Messages at Specified System Module and Severity Levels on an IPv6 Syslog Server

Examples of show debug command output that displays a configured IPv6 Syslog server.

HP Switch(config)# show debug

Debug Logging
 Destination: None
 Enabled debug types:
 None are enabled
Displays the default debug configuration when no Syslog server IP addresses or debug types are configured.
HP Switch(config)# logging fe80:215:60ff:fe7a:adc0
HP Switch(config)# write memory
HP Switch(config)# show debug

Debug Logging
 Destination:
  Logging --
   fe80:215:60ff:fe7a:adc0
   Facility=user
   Severity=debug
   System module=all-pass
  Enabled debug types:
   event
When you configure a Syslog IPv6 address with the logging command, by default, the switch enables debug messaging to the Syslog address and the user facility on the Syslog server, and sends Event Log messages of all severity levels from all system modules.

prev	up	next
DNS resolver for IPv6	home	IPv6 network defense ND snooping and detection

`no logging`	Removes all currently configured Syslog logging destinations from the running configuration.
`no loggingsyslog-ipv4-address`	Removes only the specified Syslog logging destination from the running configuration.