Xena Knowledge Base

This page describes the ribbon menus and other application-level menus for the XenaManager application.

Ribbon Menus

The XenaManager features a modern ribbon menu similar to applications like Microsoft Word. Each of the submenu items are explained below.

Edit Menu

This menu contains the main simple editing functions. Each function is context sensitive and is only enabled when a suitable selection of resources is selected in the Available Resources treeview.

Each function is explained in another section of this manual and will not be explained further on this page.

Operations Menu

This menu contains functions that can perform more complex operations on one or more resources.

Release All My Resources

This command will release all resources (chassis, modules and ports) that has been reserved by you. You can use this to clean up your reservations if you have many chassis, modules and/or ports and do not want to traverse through the Available Resources treeview to manually release everything you may have reserved.

Reset Used Port

This command will reset all used test bed ports, reserved by you, to default.

Relinquish Chassis Resources

This command will relinquish all resources on selected chassis reserved by anyone.

Import XM-1G Testbed

Using this option you can import a legacy XenaManager testbed definition. Simply click the button and select the testbed file you have previously exported from the legacy XenaManager. A new XenaManager testbed will be created with the definitions from the legacy definition.

XenaManager is the previous software now replaced by XenaManager.

Load Test Case

Enables you to load settings from a XenaManager testcase file.

Save Test Case

Enables you to save the complete port configurations for all ports in your current testbed.

Import XI LogCfg

Import XenaIntegrator logging configuration.

DHCP Client

This command activates the DHCP client for one selected port.

Pair Streams

This operation work on two streams defined on different ports. It require that you select the two streams in the Available Resources treeview.

When invoked it will ensure that certain fields in the defined packet headers for each of the two streams point to the other stream.

• Ethernet segment: The DMAC Address field will be set to the MAC address of the peer port.
• IPv4/IPv6 segment: The Dest. IP Address field will be set to the defined IP address for the peer port.

This should ensure that when the traffic is started the traffic on a port actually reaches the other port. For IP traffic you may have to resolve the IP gateway MAC address using ARP if the two ports are located on different IP subnetworks.

Preview Port Traffic

This operation will enable you to preview the actual packets sent on a port before starting a test. The function require that you select a port stream in the Available Resources tree view.

• When invoked the operation will perform the following actions:
• Stop traffic on the port if it is currently active
• Set the port in Tx(off)-to-Rx loopback mode.
• Setup and start capture on the port itself
• Start traffic on the port
• Let the traffic run until the capture buffer runs full. The traffic will also be stopped after 10 seconds if the buffer is still not full.
• Collect the captured packets and save them to a temporary file.
• Restore the saved port and stream settings.
• If Wireshark is installed it will be launched to view the captured packets. Otherwise you will have to use the Capture panel to inspect the packets.

Preview Stream

This operation will enable you to preview the actual packets sent on a stream before starting a test. This is especially useful if you have defined one or more modifiers on the stream and wants to ensure that the result looks correct.

The function require that you select a single stream in the Available Resources treeview.

When invoked the operation will perform the following actions:

• Stop traffic on the port if it is currently active
• Disable all other streams on the port after saving their initial state
• Set the port in Tx(off)-to-Rx loopback mode.
• Setup and start capture on the port itself
• Start traffic on the port
• Let the traffic run until the capture buffer runs full. The traffic will also be stopped after 10 seconds if the buffer is still not full.
• Collect the captured packets and save them to a temporary file.
• Restore the saved port and stream settings.
• If Wireshark is installed it will be launched to view the captured packets. Otherwise you will have to use the Capture panel to inspect the packets.

View Menu

This menu contains functions that affect the visual appearance of the application.

Panel Layout

Checking the Freeze Layout checkbox disables the ability to show or hide panels and to drag panels to other docking positions or to make them float-able. You can use this to protect yourself against unintended changes.

Pressing the Set Panel Visibility button will open a dialog that allows you to control the visibility for each of the function panel tabs available in the application. You can also hide any of the panels by selecting it and then clicking the little “X” to the right of the tab panel header as shown in the adjacent example. To bring the panel back you can use the above mentioned dialog and click the checkbox next to the name of the hidden panel.

When you make changes to the layout the new layout will be restored when you startup the application again. The Reset Layout to Default button will delete the saved layout. The next time you start the application the original layout will thus be restored.

Application Theme

Select the layout theme for XenaManager from the menu.

Stream View Settings

If you check the Stream Descr As Label option the stream description label will be used to name the stream entries in the resource treeview instead of using the default “module/port number” identification.

When defining MAC addresses in the Stream Packet Header Definitions panel you can limit the list of selectable MAC addresses to those belonging to ports marked as used by checking Only MAC for used ports.

Debug settings

This section contains settings intended for advanced users. The Show SW Upgrade Controls will unlock the manual software upgrade control in the chassis and module properties. This is as indicated only recommended for advanced users who fully understand what they are doing.

Options Menu

This menu contains various functions that affect the behavior of the application.

Set Username

The default username for the application is your Windows username. You can change this with this function.

Open Last Configuration as Start

If this option is checked the configuration file that was active when you closed down the application the last time will automatically be re-opened on the next application start.

Ask Before Relinquishing Ports

If this option is checked you will be asked to confirm if you really want to relinquish ports reserved by other users. This is also the recommended setting.

Calculate UDP checksum

For modules not supporting automatic UDP checksum calculation: Attempt to calculate UDP checksums based on a static header with all-zero payload and no TPLD.

Sync Start in Global stats

If this option is checked the Start button in the Global Statistics panel will use a synchronized port start mechanism for the ports if the chassis firmware version supports this feature.

TX Zero CheckTime

This property defines the number of seconds with no traffic on ports after you pressed Start traffic, before traffic on ports is stopped. Select 0 to disable this function.

Decode Xena TPLD

When this box is checked the XenaManager capture function will attempt to decode and show the Xena TPLD in captured packets.

Save Ethernet FCS

When this box is checked the XenaManager capture function will save Ethernet FCS when generating PCAP files.

Save Selected Sort Order

Saves the Chassis Sort Order defined for the Available Resources tree. The saved Selected Sort Order will be used when the XenaManager is re-launched.

Rearrange Chassis Tree Info

When this box is checked the chassis information in the Available Resources tree will be shown, starting with the selected Chassis Sort Order criteria.

Tools Menu

This menu contains various shortcuts to other tools.

Xena Test Applications

This section will show an icon for each of the other Xena test applications installed together with the XenaManager, such as Xena2544, Xena1564, etc. You can launch each of these application by pressing the icon button.

Support

If you click the Generate Support Archive button the application will create a compressed ZIP archive containing both the currently loaded configuration file and the content of the Logs and Settings directories. This file can then be emailed to your support representative.

Clicking the Explore Xena Data Directory will open a Windows Explorer in the data directory for the XenaManager. Here you can find configuration and settings files, log files and any support archive files you may have created.

Minimizing the Ribbon

The ribbon menu will by default be shown fully expanded. In order to free up screen space you can minimize it by clicking the arrow next to the Help icon in the menu title line as shown below to the left. You can also use the little arrow in the Quick Menu strip as shown below to the right.

_______________________________________________________________________________

Additional Features

Application Menu

The application menu can be accessed by clicking the Xena icon in the top left corner as shown below.

Using the functions in the Configurations section you can either create a new test configuration, load an existing configuration from file, or save the current configuration.

The Recent Configurations section in the middle allow you to load any recently loaded or saved configurations.

Quick Menu Toolbar

The Quick Menu toolbar at the top of the application provides easy shortcuts to the most used application-level commands.