Xena Networks Valkyrie系列L2-3脚本编程指南

需积分: 12 89 浏览量更新于2024-07-16 收藏 1024KB PDF 举报

"信雅纳网络（Xena Networks）Valkyrie系列L23-Scripting-Documentation.pdf是该公司的编程手册，主要涵盖了Valkyrie系列在第二层和第三层网络测试产品的脚本API使用。这份文档适用于100M到400GE的测试接口，详细介绍了如何进行端口线速流量生成、抓包和分析，以及AN/LT功能和TSN时间敏感网络测试功能的启用流程。" 这篇文档详细阐述了信雅纳网络（Xena Networks）的脚本API，旨在为使用Xena Bay和Xena Compact的第二层到第三层测试产品提供一种替代Xena Manager的交互方式。通过命令行界面（CLI），用户可以对测试设备进行操作，并将它们集成到更广泛的自动化环境中。 1. **介绍**：这部分首先对脚本API进行了概述，解释了脚本化是如何工作的，以及如何连接到测试机箱。它还提到了与Xena Manager的关系，命令语法，状态消息，默认值和通配符的使用，以及特殊的脚本命令。 2. **样本脚本会话**：这部分展示了如何进行实际的脚本会话，并提供了输出示例，帮助用户理解如何操作和解析返回的结果。 3. **详细脚本参数**：这部分深入讲解了机箱脚本参数，包括识别参数，如机箱名称、评论、密码、型号、序列号、版本信息和机箱能力等。这些参数对于配置和控制测试环境至关重要。例如，`C_NAME`用于设置机箱的名称，`C_PASSWORD`用于认证，而`C_CAPABILITIES`则提供关于机箱功能的信息。`C_ALLPORTCAPS?`是一个查询命令，用于获取所有端口的能力。 4. **端口线速流量生成**：此功能允许用户模拟真实的网络流量，测试网络设备在满负荷下的性能和稳定性。用户可以设置特定速率和协议的流量，以评估被测设备的处理能力。 5. **抓包和分析**：这涉及到捕获网络中的数据包以便进行分析，帮助定位潜在问题或优化网络性能。用户可以利用脚本API来设定抓包规则，收集数据并进行深入的网络流量分析。 6. **AN/LT功能**：可能是指高级网络（Advanced Networking）和负载测试（Load Testing）功能，允许用户进行复杂网络行为的模拟和大规模负载的生成，以测试网络设备在高压情况下的表现。 7. **TSN时间敏感网络测试**：TSN（Time-Sensitive Networking）是针对工业自动化、音频视频流和其他需要严格时间同步的应用的网络技术。这部分内容会指导用户如何启用和测试TSN特性，确保网络能够满足低延迟、高可靠性的需求。这份文档为开发者和网络工程师提供了全面的工具，帮助他们通过编程的方式自动化测试过程，提升效率，并确保网络设备在各种场景下的性能。

At a more fundamental level, the Manager supports the notion of a testbed containing multiple chassis.

This is not applicable through scripting, since each scripting session runs through its own connection to a

single chassis, and indeed the chassis are not aware of each other. Any cross-chassis control must be

handled at the scripting client environment; in particular cross-chassis statistics such as packet loss.

In contrast, the scripting environment provides wild-carding across modules and ports, which is not

available through the Manager.

Command Syntax

The scripting language contains similar syntax for setting and getting values of individual parameters of the

chassis resources. Some parameters, like inter-frame gap, support both set and get; others, like physical

port type, support only get; and a few, like injecting errors, support only set.

You change the value of a settable parameter using:

module/port



parameter



[index



,…] value



value



…

Here, module



and port



are the numeric indices for a particular port (for chassis-level parameters neither of

these are present, and for module-level parameters only module



is present); parameter



is one of the names

specified later in this document in the reference sections; index



is a possible sub-index of the parameter,

for instance identifying a stream; and each value



specifies a value appropriate for the particular parameter.

All indices start at zero.

Values are specified using one of the following formats:

● Integer (I): decimal integer, in the 32-bit range, e.g.: 1234567.

● Long (L): decimal integer, in the 64-bit range, e.g.: 123456789123.

● Byte (B): decimal integer, in the 8-bit range, e.g.: 123.

● Hex (H): two hexadecimal digits prefixed by 0x, e.g.: 0xF7.

● String (S): printable 7-bit ASCII characters enclosed in ”, e.g.: ”A string”. Characters with values

outside the 32-126 range and the ” character itself are specified by their decimal value, outside the

quotation marks and separated by commas, e.g.: ”A line”,13,10,”and the next line”.

● Owner (O): a short string used to identify an owner, used for reservation.

● Address (A): a dot-separated IP address, e.g.: 192.168.1.200.

Some parameters allow a variable number of values of a particular type (I*, B*, H*), and these are simply

written with spaces in between. For hex values (H*), multiple bytes can be specified using a single0x prefix,

e.g.: 0xF700ABCD2233.

Finally, certain parameters are actually integers, but use coded names for special numeric values to

enhance readability, e.g.: (0=OFF,1=ON).

You query the current value of a gettable parameter using a very similar syntax:

module/port



parameter



[index



,…] ?

The chassis responds with a line using identical syntax to the change-command, containing the current

values. These responses can therefore be ‘replayed’ back to the chassis to re-establish the value from a

previous query. This is actually the core of the load/save mechanism of the Xena Manager, as you can see

by using an ordinary text editor to inspect the local files produced by save. You can also change the content

if you want to; it is not interpreted by the Xena Manager.

Note that some queries, like P_INFO ? and P_CONFIG ?, are special in that they do not refer to one

particular parameter, but rather to a collection of parameters. The response is multiple lines containing the

current value of each of these parameters.

Status Messages

The set/change commands themselves simply produce a reply from the chassis of:

<OK>

In case something is unacceptable to the chassis, it may return one of the following status messages:

<NOTLOGGEDON> You have not issued a C_LOGON providing the chassis password.

<NOTRESERVED> You have not issued a x_RESERVATION for the resource you want to change.

<NOTWRITABLE> The parameter is read-only.

<NOTREADABLE> The parameter is write-only.

<NOTVALID> The operation is not valid in the current chassis state, e.g. because traffic is on.

<BADMODULE> The module index value is out of bounds.

<BADPORT> The port index value is out of bounds.

<BADINDEX> A parameter sub-index value is wrong.

<BADSIZE> The size of a data value is not appropriate.

<BADVALUE> A value is not appropriate.

<FAILED> An operation failed to produce a result.

In case of a plain syntax error, misspelled parameter, or an inappropriate use of module/port/indices, the

chassis will return a line pointing out the column where the error was detected, e.g.:

● HELP ?. This command gives you an overview of the built-in help function, useful when using the

scripting environment interactively, as from the Xena Scripting Client.

● HELP ”parameter



”. Gives you a brief overview of the required indices and values for the specified

parameter. You are allowed to specify only a prefix of the parameter name, which will then give

you the overview for each matching parameter, e.g.: HELP ”P_” for all port-level parameters. The

summary of the required values uses the abbreviations for the various types introduced in the

command syntax above, e.g.:B(0=OFF,1=ON) which means a single byte value where the two

relevant values can be specified using coded names.

Sample Script Session

Below is an example of using the scripting commands to define and execute a simple test. A file containing

these commands can simply be uploaded to a chassis using the XenaScripting Client.

; This is an example of using the Xena scripting language to set-up and

; execute a simple test case.

;

; This file is simply sent to TCP/IP port 22611 on a Xena chassis,

; and while it is executing on the chassis it sends lines of text

; back on the same TCP/IP connection.

;

; Much of what you see in response from the chassis is an "<OK>" for

; each new parameter value that you have sent. There will also be a

; blank line in response to each comment you send to the chassis. More

; importantly, of course, you will see the values of the parameters and

; statistics that you explicitly query for.

;

; The chassis has a basic "WAIT" command to allow simple server-side

; waiting. For more advanced scripting logic, you should use a client-

; side scripting environment like Tcl/Perl/Python/Basic/C to send commands

; to the chassis, and retrieve and parse the responses.

;

; The example works on a single port configured in TX-to-RX loop mode

; so that everything sent is also received on the same port.

; First we authenticate the connection to the chassis and provide a user

; name for reservation:

C_LOGON "xena"

C_OWNER "example"

剩余158页未读，继续阅读

TeledyneLeCroyXena

粉丝: 358
资源: 35

Xena Networks Valkyrie系列L2-3脚本编程指南

信雅纳网络测试仪厂商（Xena Networks）-车载以太网流量测试解决方案-Vantage use case - Automotive.pptx

IXIA公司的anue使用手册 anue网络损伤仪介绍及运用

信雅纳TSN-Automotive-IIoT网络性能测试仪简介.pdf

信雅纳网络产品手册-以太网测试解决参考.pdf

信雅纳网络-汽车以太网性能测试板卡，产品规格书-Odin-1G-3S-6P-T1.pdf

Chimera-Presentation_Xena-Networks.pdf

Odin-10G-5S-6P-TSN.pdf

PyPI 官网下载 | python-xena-0.2.16.tar.gz

PyPI 官网下载 | python-xena-0.2.15.tar.gz

Chimera-Quick-Start-Guide-cn.pdf

最新资源