Award Winning Solutions
Xena has won multiple global awards for price/performance and technical innovation. Learn more.
Copyright 2009-2021 Xena Networks.
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
FormatVersion
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.
CommonConfig
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:
|
| 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:
|
| 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:
|
| MacLearningRetries | Number | Specifies the number of MAC learning retries. |
Payload
| Name | Type | Explanation |
|---|---|---|
| PayloadType | Enum | The payload generation policy:
|
| 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. |