Valkyrie Knowledge Base

Valkyrie2544 Configuration File Syntax

This page describes the syntax of the configuration files used by the Valkyrie2544 test program.

The files are saved in a JSON text format. They can in principle be edited by a normal text editor.

Main File Structure

The configuration file contains the following main parts:

Name Explanation
FormatVersion Specifies the version of the file format.
CommonConfig Common configuration options and bookkeeping for the test configuration.
ChassisList Contains a list of all the Xena chassis (testers) and ports used in the test.
TestTypeMap Contains configuration parameters for the 4 test-types supported (Throughput, Loss, Latency/Jitter and Back-to-Back).
TrafficConfig Contains the common traffic configuration parameters.
ReportConfig Contains the reporting configuration parameters.

General Configuration


This parameter is an integer value indicating the format version of the configuration file. This is intended for handling potential future non-backward compatible changes.


This section contains the following parameters:

Name Type Explanation
CreationDate String A timestamp indicating the file creation date and time.
Topology Enum Indicates the topology used by the test. Can be one of the following:

  • MESH
Direction Enum Indicates the direction of the traffic flows used by the test. Can be one of the following:


Traffic Configuration

This section provides the overall traffic configuration used by all test types.

General Traffic Options

Name Type Explanation
TrafficType Enum Specifies the traffic type used. Can be one of the following:

UseUDPChecksum Bool Specifies if a UDP checksum should be generated. Only valid if the traffic type includes UDP.

Frame Sizes

Name Type Explanation
TrafficSizeSel Enum Specifies how the packet sizes are specified. The following values are supported:

  • IEEEDefault (use the standard IEEE-defined sizes)
  • MixedSizes (use a mix specified by the Xena tester)
  • CustomSizes (specify your own size list)
  • Specified (specify using start, end and step values)
CustomTrafficSizes Number list A list of size values.Only used when TrafficSizeSel = CustomSizes.
StartSize Number The start value to use when TrafficSizeSel = Specified.
EndSize Number The end value to use when TrafficSizeSel = Specified.
StepSize Number The step value to use when TrafficSizeSel = Specified.

MAC Address and Learning

Name Type Explanation
MacBaseAddress Byte list A comma-separated list of byte value to use as the first 3 bytes on a MAC address when constructing port addresses. Only used when set to a L2 traffic type and UseNativeMacForL2 = False.
UseNativeMacForL2 Bool If set to True use the native (factory-assigned) MAC addresses for the ports, otherwise construct MAC addresses for ports.
MacLearningMode Enum Specifies the MAC learning frequency. Can be one of the following values:

  • Never (never perform MAC learning)
  • Once (perform MAC learning once for every test)
  • EveryTrial (perform MAC learning at the start of every trial)
MacLearningRetries Number Specifies the number of MAC learning retries.


Name Type Explanation
PayloadType Enum The payload generation policy:

  • Pattern (specify a pattern)
  • Incrementing (use an automatic incrementing pattern)
  • PRBS (use a PRBS pattern)
PayloadPattern Byte list A comma-separated list of byte values to use when PayloadType = Pattern.

Port Speed

Name Type Explanation
UsePhysPortSpeed Bool Specifies whether to use the full physical port speed or if a lower speed should be used.
MaxConfigPortSpeed Number Specifies the max. port speed to use when UsePhysPortSpeed = False.

Packet Fields

Name Type Explanation
EtherType1 Byte list A comma-separated list of bytes to use for the EtherType field in the base Ethernet frame.
PCP1 Number The PCP value for the first (inner) VLAN tag
VlanTag1 Number The VLAN tag value for the first (inner) VLAN tag.
EtherType2 Byte list The EtherType value for the first (inner) VLAN tag.
PCP2 Number The PCP value for the second (outer) VLAN tag
VlanTag2 Number The VLAN tag value for the second (outer) VLAN tag.
EtherType3 Byte list The EtherType value for the second (outer) VLAN tag.
DiffServCodePoint Number The IP DSCP field value.
IpIdentification Number The IP ID field value,
IpProtocolType Number The IP Protocol field value
UdpSrcPort Number The UDP Source port field value.
UdpDestPort Number The UDP Destination port field value.