Fortinet black logo

Handbook

Debug

Debug

When requesting support from FortiCare, it can be useful to attach one of the debug files described below to the TAC ticket:

  • For configuration issues, please attach the customer archive file.

  • For bug and operational issues, the entire debug archive (containing the customer archive file) may be necessary. Please note the debug archive may be large, exceeding 1GB.

Creating a system debug file

The Save Debug File feature creates two archives of various configuration files, logs and other details used to help in diagnosing any issues that may arise. The archive files are saved on the appliance/VM (maximum of 3 sets of 2 files, with newest files possibly prompting a warning before overwriting the oldest) and can be downloaded to the logged-in admin PC or uploaded to an FTP server (no security credentials).

The "system_customer_debug_file" and "system_full_debug_file" contain:

Archive File

Contents

CUSTOMER

CUSTOMER folder with:

  • System configuration

  • CSV format list of the last 100,000 Attack event logs

  • MySQL format list of the last 25,000 Event logs

  • CSV format list of all Protection Subnets

  • CSV format list of all Service Protection Profile (SPP) Thresholds

  • CSV format list of all SPPs with all associated, assigned Profiles and Service Ports

DEBUG
  • CUSTOMER folder with the same files as above

  • DEBUG folder with 10 subfolders containing various files of debug information for use by Fortinet developers only.

To create a system debug file:
  1. Go to System > Debug.
  2. Click Save Debug File.
    The save debug will run, which may take several seconds. The GUI will indicate when the new files are ready.
  3. Download the desired file via GUI or upload it to an FTP server.
    If uploading to FTP, a dialog will display. Enter the following FTP parameters:
    SettingsGuidelines

    Name

    system_debug_file_<date>_<time>.zip

    Running Status

    Running status indicates the final download status.

    Running — The system is still collecting and compressing the debug file to generate a download file.

    Ready — The file is ready to download via the GUI/upload to FTP.

    Upload Status

    The upload FTP status.

    Running — The File is uploading. Error messages will appear in the Upload Status column.

    Ready — The Upload is completed.

Debug

When requesting support from FortiCare, it can be useful to attach one of the debug files described below to the TAC ticket:

  • For configuration issues, please attach the customer archive file.

  • For bug and operational issues, the entire debug archive (containing the customer archive file) may be necessary. Please note the debug archive may be large, exceeding 1GB.

Creating a system debug file

The Save Debug File feature creates two archives of various configuration files, logs and other details used to help in diagnosing any issues that may arise. The archive files are saved on the appliance/VM (maximum of 3 sets of 2 files, with newest files possibly prompting a warning before overwriting the oldest) and can be downloaded to the logged-in admin PC or uploaded to an FTP server (no security credentials).

The "system_customer_debug_file" and "system_full_debug_file" contain:

Archive File

Contents

CUSTOMER

CUSTOMER folder with:

  • System configuration

  • CSV format list of the last 100,000 Attack event logs

  • MySQL format list of the last 25,000 Event logs

  • CSV format list of all Protection Subnets

  • CSV format list of all Service Protection Profile (SPP) Thresholds

  • CSV format list of all SPPs with all associated, assigned Profiles and Service Ports

DEBUG
  • CUSTOMER folder with the same files as above

  • DEBUG folder with 10 subfolders containing various files of debug information for use by Fortinet developers only.

To create a system debug file:
  1. Go to System > Debug.
  2. Click Save Debug File.
    The save debug will run, which may take several seconds. The GUI will indicate when the new files are ready.
  3. Download the desired file via GUI or upload it to an FTP server.
    If uploading to FTP, a dialog will display. Enter the following FTP parameters:
    SettingsGuidelines

    Name

    system_debug_file_<date>_<time>.zip

    Running Status

    Running status indicates the final download status.

    Running — The system is still collecting and compressing the debug file to generate a download file.

    Ready — The file is ready to download via the GUI/upload to FTP.

    Upload Status

    The upload FTP status.

    Running — The File is uploading. Error messages will appear in the Upload Status column.

    Ready — The Upload is completed.