background image

 

EDM01-33v1 DAG_7.5G4_Card_User_Guide 

©2008 Endace Technology Ltd.  Confidential - Version 1 - November 2008 

33 

Capturing data at high speed 

As the DAG 7.5G4 card captures packets from the network link, it writes a record for each 

packet into a large buffer in the host computer’s main memory. 
To avoid packet loss, the user application reading the record, such as 

dagsnap

, must be able to 

read records out of the buffer as fast or faster than they arrive. If not the buffer will 

eventually fill and packet records will be lost. 
If the user process is writing records to hard disk, it may be necessary to use a faster disk or 

disk array. If records are being processed in real-time, a faster host CPU may be required. 
In Linux and Free BSD, when the computer buffer fills, the following message displays on 

the computer screen: 

kernel: dagN: pbm safety net reached 0xNNNNNNNN 

The same message is also printed to log 

/var/log/messages

 file. In addition, when the 

computer buffer fills the “Data Capture” LED on the card will flash or flicker, or may go OFF 

completely. 

 

In Windows no screen message displays to indicate when the buffer is full. Please contact 

Endace Customer Support at 

[email protected]

Detecting Packet Losses 

 for further information on detecting 

buffer overflow and packet loss in Windows.  

 

Once the buffer fills, any new packets arriving will be discarded by the DAG 7.5G4 card until 

some data is read out of the buffer to create free space. 
You can detect any such losses by observing the Loss Counter 

(lctr

 field) of the Extensible 

Record Format (ERF).  See 

Data Formats

53

 (page  ) later in this User Guide for more 

information on the Endace ERF record format. 

 

Increasing Buffer Size 

You can increase the size of the host computer buffer to enable it to cope with bursts of high 

traffic load on the network link. 
For information on increasing the buffer size, see 

buffer_size

22

 (page  ). 

 

Содержание DAG 5.2X

Страница 1: ...DAG 7 5G4 Card User Guide EDM01 33...

Страница 2: ...Disclaimer Whilst every effort has been made to ensure accuracy neither Endace Technology Limited nor any employee of the company shall be liable on any ground whatsoever to any party in respect of de...

Страница 3: ...jumper settings 11 Boot LEDs 11 Pluggable Optical Transceivers 12 Overview 12 Optical modules 12 Power Input 13 Splitter Losses 13 Pluggable Copper Transceivers 13 Configuring the DAG card 15 Introduc...

Страница 4: ...twork Time Protocol 42 Timestamps 43 Example 43 Dagclock 44 Dagclock Statistics reset 45 Dagclock output explained 46 Card with Reference 48 Overview 48 Pulse Signal from External Source 48 Connecting...

Страница 5: ...G 7 5G4 card provides independent four port Ethernet network monitoring at Gigabit speeds and supports header only or variable length capture It is capable of transmitting and receiving on each channe...

Страница 6: ...erver User Guide EDM11 01 ERF types PN01 13 DAG Card Quick Start Guide This User Guide and the EDM04 01 DAG Software Installation Guide are also available in PDF format on the installation CD shipped...

Страница 7: ...te for IP packets from 48 to 9600 bytes Conditioned clock with PPS input and local synchronization capability PCIe x4 Gen 1 0a 8 Gigabits per second Raw Actual performance of PCIe will depend on the m...

Страница 8: ...CK provides high resolution per packet timestamps which can be accurately synchronized Note For further information on the DUCK and time synchronization see Synchronizing Clock Time 41 page later in t...

Страница 9: ...sted below to apply to your network please contact your Network Administrator for further information Supported Line Types The line characteristics supported by the DAG 7 5G4 card are described below...

Страница 10: ...the filter and load balancing outputs It also receives the physical port the packet arrived on and calculates a classification also known as color for the packet Colorizer and Drop Block The color is...

Страница 11: ...Release TERF TR TERF The Timed Release TERF TR TERF module is a option that enables you to transmit an ERF stream while reproducing the timestamps of the packets within that stream It is able to trans...

Страница 12: ......

Страница 13: ...d to partially or completely fail 1 Turn power to the computer OFF 2 Remove the PCIe bus slot screw and cover 3 Using an approved ESD protection device attach the end with the strap to your wrist and...

Страница 14: ...nsists of an optical fiber or copper transmitter and receiver Note The DAG 7 5G4 supports both optical and copper transceivers The DAG 7 5G4G4 has an 8 pin RJ45 socket located below the optical port c...

Страница 15: ...e 2 3 or jumper not fitted Normal operation of the DAG card FF jumper settings Jumper set between Definition 1 2 Loads the factory image into the FPGA at power on 2 3 or jumper not fitted Loads the us...

Страница 16: ...ular SFP module that is fitted to the DAG 4 5Z2 4 5Z8 card Optics modules are supplied in either Single or Multi mode See the following table for details Optical power is measured in dBm This is decib...

Страница 17: ...ither marked on their packaging or described in their accompanying documentation General guidelines are A 50 50 splitter will have an insertion loss of between 3 dB and 4 dB on each output 90 10 split...

Страница 18: ......

Страница 19: ...guring the DAG card Before configuring the FPGA you should ensure that dagmem has been run and memory allocated to each installed DAG card dagload has been run so that all DAG drivers have been instal...

Страница 20: ...iginally shipped from the factory By default the DAG 7 5G4 card boots user image 1 unless the Force factory jumper is fitted For more details on the Force factory jumper see Boot jumper settings 11 pa...

Страница 21: ...e computer and in the DAG card Newer versions are automatically loaded onto the DAG card and programmed into the FPGA See Endace recommends you use the dagrom r command when loading images from the co...

Страница 22: ...SWID key with the one supplied l hold bus Hold PBI bus from XScale DAG 3 7T only m swid key key Hexadecimal key for writing the Software ID aka SWID o swid rom read Read SWID from ROM p program curren...

Страница 23: ...0 19 01 active user 2 user 3 Card Serial 3006575 Preparing the DAG card for use Before configuring the DAG 7 5G4 card you must run the following dagconfig command to set the default parameters in the...

Страница 24: ...ou should run the dagconfig tool without arguments to display the current card configuration and verify the firmware has been loaded correctly To display the default configuration for the first card u...

Страница 25: ...packets to be all generated as multiples of 8 bytes 64 bit aligned align64 before being received by the host Not a configurable option auto_neg noauto_neg Note From DAG software 3 1 0 onwards nic non...

Страница 26: ...lt drop nodrop Determines if the DAG card s memory holes are de coupled In drop mode the memory holes are de coupled If the data rate on one memory hole slows the data rate on any other memory holes i...

Страница 27: ...ayed as a ratio as shown below mem X Y where X is the memory allocated in MB to the rx stream Y is the memory allocated in MB to the tx stream If there are multiple rx or tx streams memory can be allo...

Страница 28: ...t framers set auto mode Example dagconfig d0 reset rx and tx Streams Indicates the number of rx and tx streams are available on the DAG card Not configurable Stream information relates to the setting...

Страница 29: ...e Therefore a slen of 48 will produce a 64 byte capture record made up of 48 bytes plus the number of bytes in the ERF header steer The algorithm to use to steer the incoming packet Option Description...

Страница 30: ...in this mode the timing for each port is independent This is shown in the following example where Packet A and Packet B are transmitted at the same time even though their timestamps are one second ap...

Страница 31: ...he slen value will be captured at its actual size therefore producing a shorter record which saves bandwidth and storage space Example The example below shows a configuration for variable length full...

Страница 32: ...e in conjunction with the porta or portb options to get individual only multi port cards h help Displays the MAN pages The information displayed is dynamically based on the DAG card and does not work...

Страница 33: ...is present on the link 0 indicates the condition is not present on the link Ethernet Port pll_lock lock los reset_done link lof A 1 1 0 0 1 0 B 1 1 0 0 1 0 C 1 1 0 0 1 0 D 1 1 0 0 1 0 A definition of...

Страница 34: ...8 Universal counters The counters contain details of the number of frames and any errors The counters are latch and clear so values indicate the amount of data since the last time the counters were re...

Страница 35: ...which can then be viewed using dagbits or converted to other formats using dagconvert When capturing high speed data Endace recommends you use dagsnap see Capturing data at high speed 33 page For furt...

Страница 36: ...iting data to disk in chunks This option may not be available on all operating systems m NUM Write at most NUM megabytes of data per call to the DAG API default is 4 MiB o FILE fname FILE Write the ca...

Страница 37: ...net reached 0xNNNNNNNN The same message is also printed to log var log messages file In addition when the computer buffer fills the Data Capture LED on the card will flash or flicker or may go OFF com...

Страница 38: ...CRCs PoS and Ethernet a Set legacy format to ATM this is the default b Treat ERF timestamps as big endian c Print real time progress reports as dagbits captures traffic This is a useful indicator tha...

Страница 39: ...ly makes sense when capturing packets from a DAG card i e when used in conjunction with the d flag t NUM Terminate dagbits if any ERF record type does not match NUM U NUM Process at most NUM records i...

Страница 40: ...cap o outfile pcap To convert a file from ERF format to pcap format dagconvert T erf pcap i infile erf o outfile pcap To convert a file from pcap format to ERF format ensuring the ERF records are 64 b...

Страница 41: ...cludes 0 dag1 and dev dag3 to refer to DAG cards and 0 2 dag1 1 and dev dag2 0 to refer to specific streams on cards f FILTERS A comma delimited list of filters to be applied to the data Supported fil...

Страница 42: ...ng dsm_loader d0 f filter_filename If you have configured DSM filtering but want to revert to normal capture mode you will need to bypass DSM filtering to the original null configuration using dsm_loa...

Страница 43: ...ace com support If packets have been captured without using the align64 option you can convert the trace files so that they can be transmitted by using In addition the length of the ERF records to be...

Страница 44: ...d for any reason To allow for this TR TERF can be optionally configured not to retransmit any packets marked with the rxerror receive error flag Usage Notes The following points should be noted when u...

Страница 45: ...etween sets of DAG cards or between DAG cards and coordinated universal time UTC You can obtain an accurate time reference by connecting an external clock to the DAG card using the time synchronizatio...

Страница 46: ...the computer clock directly In both cases the computer clock time is loaded onto the DAG clock when the DAG card is started dagload dagreset dagrom p When clock synchronization is enabled the DAG card...

Страница 47: ...that are not active being set to zero In this way the interpretation of the timestamp does not need to change when higher resolution clock hardware is available The DAG 7 5G4 implements the 27 most si...

Страница 48: ...exiting K NUM Set the synchronization timeout in seconds default is 60 seconds l NUM Set the Health threshold in nanoseconds default is 596ns v Increase output verbosity V Display version information...

Страница 49: ...at has its clock reference connected The clock statistics have been reset since the card was last synchronized Note Values will differ for each DAG card type muxin rs422 muxout none status Synchronise...

Страница 50: ...s value can be adjusted using the dagclock l option Failures This is a count of the number of times the DAG card has become Not Synchronized Resyncs This is a count of the number of times the DAG card...

Страница 51: ...ime pulses are considered Bad if they were not received 1 second approximately after the last time pulse These may be caused by noise Singles missed The number of times a single time pulse failed to b...

Страница 52: ...ernal source as follows dagclock d0 Output muxin rs422 muxout none status Synchronised Threshold 596ns Failures 0 Resyncs 0 error Freq 30ppb Phase 15ns Worst Freq 238ppb Worst Phase 326ns crystal Actu...

Страница 53: ...ieved with this method is not as accurate as using an external reference source such as GPS The DUCK clock is synchronized to a computer clock by setting input synchronization selector to overflow as...

Страница 54: ...the host and also act as a master for the second DAG card Synchronizing with Each Other Although the master DAG card s clock drifts against UTC the DAG cards will be locked together This is achieved b...

Страница 55: ...the computer clock and output a RS 422 synchronization signal to the second DAG card as follows dagclock d0 none overin overout Output muxin over muxout over status Synchronised Threshold 11921ns Fail...

Страница 56: ...AL Normally you connect the GPS input to the PPS A channel input pins 3 and 6 The DAG card can also output a synchronization pulse for use when synchronizing two DAG cards i e without a GPS input The...

Страница 57: ...ts the following ERF Types ERF Type Description 2 TYPE_ETH Ethernet Variable Length Record 16 TYPE_DSM_COLOR_ETH Ethernet Variable Length Record The ERF file contains a series of ERF records with each...

Страница 58: ...ets are snapped off at snap length and shorter packets are padded up to the snap length rlen resembles snap length Setting novarlen and slen greater than 256 bytes is wasteful of bandwidth 3 Truncated...

Страница 59: ...MC_RAW_ CHANNEL Multi channel Raw link data 9 TYPE_MC_AAL5 Multi channel AAL5 frame 10 TYPE_COLOR_HDLC_ POS HDLC format like TYPE_HDLC_POS but with the LCNTR field reassigned as COLOR 11 TYPE_COLOR_ET...

Страница 60: ..._ETH record format Field Description Offset 1 byte Number of bytes not captured from start of frame Typically used to skip link layer headers when not required in order to save bandwidth and space Not...

Страница 61: ...r1 and so on 14 hlb0 CRC calculation output bit 15 hlb1 parity calculation output bit Offset 1 byte Number of bytes not captured from the start of the frame This is typically used to skip link layer h...

Страница 62: ...ts in automatic support across ERF types Bit 7 of the ERF type field is used to indicate that Extension Header s are present If set to 1 Extension Headers are present The Extension Header type field i...

Страница 63: ...ckage in use Any compiler errors or warnings when building DAG driver or tools For Linux and FreeBSD messages generated when DAG device driver is loaded These can be collected from command dmesg or fr...

Страница 64: ......

Страница 65: ...shown below Version Date Reason 1 November 2008 First release Based on 7 5G2 Status Description Preliminary The products described in this technical document are in development and have yet to comple...

Страница 66: ......

Отзывы: