vpn debug

Background

Starting in R81.10, separate daemons handle different VPN connections.

Starting in R81.20, these are the responsibilities of the different daemons - vpnd, iked, and cccd:

Enabling and Disabling the IKE daemon "iked"

By default, the IKE daemon "iked" is enabled on the Security Gateway.

If you disable the IKE daemon "iked", then in such a legacy mode the VPN daemon "vpnd" handles all VPN connections.

Enabling and Disabling the CCC Daemon "cccd"

By default, the CCC daemon "cccd" is disabled on the Security Gateway.

In such a legacy mode, the VPN daemon vpnd handles all VPN connections.

If you enable the CCC daemon "cccd", then this dedicated daemon handles the Client Communication Channel protocol.

Description

This "vpn debug" command instructs the VPN daemon "vpnd" to write debug messages to these log files:

File Description

VPND Log File

IKED Log File for Each Instance

CCCD Log File

Main debug output file

$FWDIR/log/vpnd.elg*

$FWDIR/log/iked0.elg

$FWDIR/log/iked1.elg

... ...

$FWDIR/log/iked64.elg

$FWDIR/log/cccd.elg

IKEv1 output

$FWDIR/log/vpnd.ikev1trace

$FWDIR/log/iked0.ikev1trace

$FWDIR/log/iked1.ikev1trace

... ...

$FWDIR/log/iked64.ikev1trace

N / A

IKEv2 output

$FWDIR/log/vpnd.ikev2trace

$FWDIR/log/iked0.ikev2trace

$FWDIR/log/iked1.ikev2trace

... ...

$FWDIR/log/iked64.ikev2trace

N / A

Debugging of the VPN daemon "vpnd" is based on Debug Topics and Debug Levels:

  • A Debug Topic is a specific area, on which to perform debugging.

    For example, if the Debug Topic is LDAP, all traffic between the VPN daemon and the LDAP server is written to the log file.

    Check Point Support provides the specific Debug Topics when needed.

  • Debug Levels range from 1 (least informative) to 5 (most informative - write all debug messages).

For more information, see sk180488.

In addition, see ike debug.

Syntax

vpn debug

      on [<Debug_Topic>=<Debug_Level>]

      off

      ikeon [-s <Size_in_MB>]

      ikeoff

      trunc [<Debug_Topic>=<Debug_Level>]

      truncon [<Debug_Topic>=<Debug_Level>]

      truncoff

      timeon [<Seconds>]

      timeoff

      ikefail [-s <Size_in_MB>]

      mon

      moff

      say ["String"]

      tunnel [<Level>]

Parameters

Parameter

Description

No Parameters

Shows the built-in usage.

on

Turns on high level VPN debug.

The debug writes the information in these files:

$FWDIR/log/vpnd.elg*

Note - If you disabled the IKE daemon "iked" to work in the legacy mode, then the debug also writes the information in these files:

  • $FWDIR/log/iked<Index>.ikev1trace

  • $FWDIR/log/iked<Index>.ikev2trace

<Debug_Topic>=<Debug_Level>

Specifies the Debug Topic and the Debug Level.

Check Point Support provides these.

Best Practice - Run this command to start the VPN debug:

vpn debug trunc ALL=5

off

Turns off the VPN debug (in legacy mode, also turns off the IKE debug).

Best Practice - Run one of these commands to stop the VPN daemon debug:

vpn debug off

vpn debug truncoff

ikeon [-s <Size_in_MB>]

Note - Applies only if you disabled the IKE daemon "iked" to work in the legacy mode.

Turns on the IKE trace.

The debug writes the information in these files:

  • $FWDIR/log/iked<Index>.ikev1trace

  • $FWDIR/log/iked<Index>.ikev2trace

You can specify the size of these files, when to perform the log rotation (close the current activeClosed State of a Cluster Member that is fully operational: (1) In ClusterXL, this applies to the state of the Security Gateway component (2) In 3rd-party / OPSEC cluster, this applies to the state of the cluster State Synchronization mechanism. file, rename it, open a new active file).

ikeoff

Note - Applies only if you disabled the IKE daemon "iked" to work in the legacy mode.

Turns off the IKE trace.

Run this command to stop the IKE trace:

vpn debug ikeoff

trunc

or

truncon

This command:

  1. Rotates the $FWDIR/log/vpnd.elg file

  2. If you disabled the IKE daemon "iked" to work in the legacy mode:

    1. Truncates the $FWDIR/log/iked<Index>.ikev1trace file

    2. Truncates the $FWDIR/log/iked<Index>.ikev2trace file

  3. Starts the VPN daemon "vpnd" debug

  4. If you disabled the IKE daemon "iked" to work in the legacy mode:

    1. Starts the IKE debug

Best Practice - Run this command to start the VPN debug:

vpn debug trunc ALL=5

truncoff

Stops the VPN daemon debug.

Run one of these commands to stop the VPN debug:

vpn debug truncoff

vpn debug off

timeon [<Seconds>]

Enables the timestamp in the log files.

Prints one timestamp after the specified number of seconds.

By default, prints the timestamp every 10 seconds.

timeoff

Disables the timestamp in the log files every number of seconds.

ikefail [-s <Size_in_MB>]

Note - Applies only if you disabled the IKE daemon "iked" to work in the legacy mode.

Logs failed IKE negotiations.

You can specify the size of these files when to perform the log rotation (close the current active file, rename it, open a new active file):

  • $FWDIR/log/iked<Index>.ikev1trace

  • $FWDIR/log/iked<Index>.ikev2trace

mon

Note - Applies only if you disabled the IKE daemon "iked" to work in the legacy mode.

Enables the IKE Monitor.

Writes the IKE packets in this file:

$FWDIR/log/ikemonitor.snoop

Warning - The output file may contain user X-Auth passwords. Make sure the file is protected.

moff

Note - Applies only if you disabled the IKE daemon "iked" to work in the legacy mode.

Disables the IKE Monitor.

say "String"

Writes the specified text string in this file:

$FWDIR/log/vpnd.elg

For example, run:

vpn debug say "BEGIN TEST"

Notes:

  • Run this command after you start the VPN debug (with one of these commands: "vpn debug on", "vpn debug trunc", or "vpn debug truncon").

  • The length of the string is limited to 255 characters.

tunnel [<Debug_Level>]

This command:

  1. Rotates the $FWDIR/log/vpnd.elg file

  2. Truncates the $FWDIR/log/iked<Index>.ikev1trace file

  3. Truncates the $FWDIR/log/iked<Index>.ikev2trace file

  4. Starts the VPN daemon debug with these two Debug Topics:

    tunnel

    ikev2

    If the <Debug_Level> is 2,3,4 or 5, then also enables this Debug Topic:

    CRLCache

  5. Starts the IKE debug (if you disabled the IKE daemon "iked" to work in the legacy mode)