- Print
- PDF
Adding, Editing and Duplicating Performance Sessions
This section explains how to set up a new performance session in the Sessions page of Skylight orchestrator. A four-step wizard makes it easy to add (or edit) a session.
The procedures provided in this section apply to all types of sessions. Tables provide detailed information about how to complete the fields in each of the steps.
For more information that can help you set up sessions, see:
- "Guidelines for Setting Up Performance Sessions"
- "Performance Session Types"
- "Managing Reflectors" - Explains how to add reflectors in advance in the (Devices ▶
Reflectors page).
It is also possible to set up sessions in bulk (rather than one session at a time in the Sessions
page). You can create sessions in bulk in two ways:
- From the Skylight orchestrator command line (Appliance Monitor). For more information, see the Skylight orchestrator Administration Guide.
- Using the Skylight orchestrator REST API. For more information, see "Programming
Interfaces".
To add a new session
Access the Sessions page.
The Sessions page is displayed with a list of all currently defined sessions.Click above the list to add a new session.
The New Session wizard is displayed on Step 1. For help on the steps in the wizard, see:
- "Step 1 – Enter session info"
- "Step 2 – Termination points"
- "Step 3 – Session profile"
- "Step 4 – Summary"
- When you have completed all steps and created the new session, the session will appear in the list of sessions.
- To start the session (immediately or later), click ▶ above the list of sessions.
To edit an existing session
Access the Sessions page.
Locate the session that you want to edit in the list.
Ensure that the session is stopped by selecting the row for the session and clicking above the list.
Click the row for the session.
The session details are displayed to the right of the session list.Click the Edit button.
The Update Session wizard is displayed on Step 1. For help on the steps in the wizard, see:
- "Step 1 – Enter session info"
- "Step 2 – Termination points"
- "Step 3 – Session profile"
- "Step 4 – Summary"
- When you have made all the changes you want to make, click Update to save your changes.
- To start the session (immediately or later), click ▶ above the list of sessions.
To duplicate an existing session
Access the Sessions page.
In the list of sessions, click on the session you want to duplicate.
Click the button above the list.
In the Duplicate session wizard that displays, click on the icons for steps 1, 2, 3, and 4 to access the settings in each step. You may modify any information that needs to be changed.
Click the icon for Step 4, and then click the Create button.
To edit more than one existing session (Bulk Edit)
Access the Sessions page.
Locate the sessions that you want to edit in the list.
Ensure that the sessions are stopped by selecting the rows for the sessions and clicking above the list.
Click the row for the sessions.
The sessions details are displayed to the right of the session list.Click the Bulk Edit button.
The Update Session wizard is displayed on Step 1. For help on the steps in the wizard, see:
- "Step 1 – Enter session info"
- "Step 2 – Termination points"
- "Step 3 – Session profile"
- "Step 4 – Summary"
When you have made all the changes you want to make, click Update to save your changes.
To start the session (immediately or later), click ▶ above the list of sessions.
Step 1 – Enter session info
The New Session dialog opens on Step 1. In this step, you enter basic information about the session.
a. The image below highlights what you must do in Step 1.
b. For more information about the fields in Step 1, see the table after this procedure.
c. After you complete this step, Step 2 will be displayed.
Step 1 - Session info – Description of fields
Column | Description |
---|---|
Name | Name of the session. |
Labels | User-defined labels that will be associated with the session. Skylight orchestrator allows users to associate labels with various entities (sessions, devices and so on). Labels can be used to group entities. You can filter various lists in Skylight orchestrator by including a label in the query. Points to note about user-defined labels:
|
Description | Enter a description that indicates the purpose of the session and will help you and others identify the session. |
Session type | Click on one of the available session types:
|
Step 2 – Termination points
In Step 2, you select the sender and reflector termination points for the session.
a. The image below highlights what you must do in Step 2.
b. For more information about the fields in Step 2, see the table after this procedure.
c. If the device you select as the Reflector is not already in the system list of reflectors (in the Devices ▶ Reflectors page), the Create reflector dialog is displayed.
- See the image below that highlights what you must do in the Create reflector dialog.
- For more information, see the table that describes the fields in the Create reflector dialog.
Step 2 - Termination points – Field descriptions
Sender and Reflector sections include the following parameters
Column | Descriptioin |
---|---|
Name | Click in this field to open the Choose a sender dialog (or the Choose a reflector dialog). The dialog displays a list of devices that are suitable for use as a sender (or reflector). After you have selected an interface in the dialog, the Name field is filled in with the name read from the device. The device name cannot be changed from Skylight orchestrator. The device name can be changed on the device itself. Any changes will be seen on Skylight orchestrator after it synchronizes with the device. |
MAC address | Note: The MAC address field is only displayed if you selected Ethernet-OAM in Step 1 (since Ethernet-OAM sessions take place on Layer 2). After you have selected a device in the Choose a sender or Choose a reflector dialog, the Mac address field is filled in with the MAC address of the interface (read from the device). |
Interface | Note: The Interface field is displayed if you selected one of the Layer 3 session types in Step 1 (Echo-ICMP, Echo-UDP, TWAMP, 2xOneWay). After you have selected an interface (of a device) in the Choose a sender or Choose a reflector dialog, the Interface field is filled in with the interface you selected. A logical interface configured on the device. Read from the device. |
Port | Note: The Port field is only enabled if you selected one of the Layer 3 session types in Step 1 (Echo-UDP, TWAMP, 2xOneWay). The number of the network port. Typically, the port number depends on the encapsulation used for the session. To find the port numbers and protocols typically used for each session type, see "Ports and Protocols per Session Type". |
If the device you selected is not in the Devices Reflectors list, you must create a reflector. IP address and MAC address are read from the device and cannot be changed. See table for descriptions of fields and how to complete them. When fields are complete, click Create.
Step 2 - Create reflector dialog – Field descriptions
Parameter | Description |
---|---|
Name | Name of the device to be used as a reflector. Read from the device. |
Label | User-defined label. Labels can be used to group devices. You can filter various lists in Skylight orchestrator by including a label in the query. |
Description | A free-form text that you can use as you wish. |
IP address | IP address of the interface to be used as a reflector. |
MAC address | MAC address of the interface. Read from the interface. |
Capabilities | Indicates the types of session for which the interface can act as a reflector. Check all the reflection capabilities that apply to the device. TWAMP Sessions: Only check one of the TWAMP options. If you check both options, you will not be able to create the reflector.
To determine the reflection capabilities of third party devices, see the manufacturer’s documentation. |
Product | Indicates the product category of the device. The following options are suitable for Accedian devices:
|
TWAMP control (only enabled if one of the TWAMP options is selected for Capabilities)
Parameter | Description |
---|---|
Enable | Enables use of the TWAMP-Control protocol. TWAMP-Control can be used with stateful and stateless reflectors. For more information about TWAMP sessions and the TWAMP- Control protocol, see "TWAMP Sessions". |
IP address | The IP address of the TWAMP-Control Server. Typically, the TWAMP- Control Server resides on the reflector. If this field is left blank, TWAMP-Control messages will be sent to the management IP address of the reflector. If you specify a different IP address for the TWAMP-Control server, the TWAMP-Control messages will be sent to the specified address. |
Port | The number of the UDP port to be used on the TWAMP-Control Server for control messages. The default port is 862. |
DSCP | Sets the traffic classification method to use when transmitting TWAMP-Control messages. |
VLAN priority | Sets the VLAN priority to use when transmitting TWAMP-Control messages. The default VLAN priority is 0. |
Legacy Mode | Check this box if the reflector does not accept current Time-of-Day as the STARTTIME parameter in the TWAMP-Control protocol setup. |
Step 3 – Session profile
In Step 3, you configure session parameters.
a. The image below highlights what you must do in this step.
b. For more information about the fields in Step 3, see the table.
c. If you need to return to a previous step, click on the green ball beside the step.
Step 3 - Session profile – Field descriptions
Sender and Reflector sections include these parameters
Column | Description |
---|---|
Payload size (bytes) | Size of the packet in the session stream. Maximum value: 1472 Default: 82 bytes |
Packet rate (pkts/s) | Rate at which packets will be transmitted for the session. Packet rate must be determined in conjunction with the interval to ensure the resulting number of packets falls in this range: 10 packets ≤ Packet rate x Interval ≤ 250,000 packets Maximum rate:
|
Interval(s) | The interval over which packets will be collected and for which performance metrics will be calculated. Possible values: 1 to 900 seconds Default: 30 seconds |
Vlan priority | The VLAN priority bits to use for the session. Possible values: 0 to 7 Default: 0 |
DSCP | Indicator of service category. Possible values: 00 (000000) - 63 (111111) Default: 0 |
Time to live | The number of hops that a session packet can travel before being discarded. Possible values: 1 to 255 Default: 255 Note: For users of Skylight sensor: control release 21.12 and earlier, this value is fixed to 64 for TCP. |
Type | The type of payload for the session. |
Round trip delay | This checkbox enables or disables Round trip delay values. If enabled, this flag will be sent to device via XML message when starting a session. Default: Disable The following performance session types will be supported for Round trip delay:
|
Reflector time subtraction | This checkbox enables or disables reflector time subtraction. If enabled or disabled, this flag will be sent to device via XML message when starting a session. The following performance session types will be supported for Reflector time subtraction:
Also supports one-way delay RRs and round-trip delay RRs. Default: Enable |
Step 4 – Summary
In Step 4, you check the session configuration and actually create the session.
a. The image below highlights what you must do in Step 4.
b. If you need to return to a previous step, click on the green ball beside the step.
c. After you create the session, it is added to the list in the Sessions page. The session is not started automatically. The Status column indicates that the new session is Stopped.
d. To start the session (immediately or later), click ▶ above the list of sessions.
© 2024 Cisco and/or its affiliates. All rights reserved.
For more information about trademarks, please visit: Cisco trademarks
For more information about legal terms, please visit: Cisco legal terms
For legal information about Accedian Skylight products, please visit: Accedian legal terms and tradmarks