Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation
Guide That Contains This Content
[+] Expand All
[-] Collapse All

    Configuring Exception Handling Traceoptions

    Datapath tracing operations record detailed messages about the operation of exception-handling services such as packet reassembly or IPv6 router advertisements on the MobileNext Broadband Gateway. You can trace various types of exception operations such as configuration events, memory usage, the age of a packet flow, configuration information, and other information. You can specify which trace operations are logged by including specific tracing flags and levels.

    Table 1 describes the flags relating to the exceptions that you can include at the [edit unified-edge gateways ggsn-pgw gateway-name software-datapath traceoptions flag] hierarchy level.

    Table 1: Trace Flags

    FlagDescription

    ager

    Trace flow ager.

    all

    Trace everything.

    commands

    Trace operational commands.

    configuration

    Trace configuration events.

    flow

    Trace flow.

    init

    Trace events related to data path daemon initialization.

    ipv6-router-advertisement

    Trace IPv6 router advertisement.

    memory

    Trace memory.

    reassembly

    Trace reassembly.

    redundancy

    Trace redundancy.

    Table 2 describes the levels you can include.

    Table 2: Trace Levels

    LevelDescription

    all

    Match all levels.

    error

    Match error conditions.

    info

    Match informational messages.

    notice

    Match conditions that should be specially handled.

    verbose

    Match verbose messages.

    warning

    Match warning messages.

    To configure tracing options for exception operations:

    1. Specify that you want to configure tracing options for exception operations.
      [edit unified-edge gateways ggsn-pgw MBG1 software-datapath]user@host# edit traceoptions
    2. Configure the filename for the trace file.
      [edit unified-edge mobile gateways ggsn-pgw MBG1 software-datapath traceoptions]user@host# set file datapath-log
    3. (Optional) Configure the maximum size of each trace file.
      [edit unified-edge mobile gateways ggsn-pgw MBG1 software-datapath traceoptions]user@host# set file size 100m

      Note: When a trace file (for example, exception-log) reaches its maximum size, it is renamed exception-log.0, then exception-log.1, and so on, until the maximum number of trace files is reached. The oldest archived file is then overwritten.

    4. Configure the tracing flag.
      [edit unified-edge mobile gateways ggsn-pgw MBG1 software-datapath traceoptions]user@host# set flag all

      Note: You should use care when tracing all operations on a gateway. This can have a performance impact.

    5. Configure the tracing level.
      [edit unified-edge mobile gateways ggsn-pgw MBG1 software-datapath traceoptions]user@host# set level error
    6. View the trace file.
      user@host# file show /var/log/exception-log

    Published: 2011-11-16