---
title: "Add, Edit, and Duplicate Performance Sessions"
slug: "adding-editing-and-duplicating-performance-sessions"
tags: ["Performance Sessions", "Session Management", "Legacy Orchestrator"]
updated: 2026-07-07T13:55:26Z
published: 2025-02-14T16:23:23Z
canonical: "docs.crossworkassurance.cisco.com/adding-editing-and-duplicating-performance-sessions"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crossworkassurance.cisco.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add, Edit, and Duplicate Performance Sessions

This section explains how to set up a new performance session in the **Sessions** page of Legacy 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 Legacy Orchestrator command line (Appliance Monitor). For more information, see *Administrative Operations*.
- Using the Legacy Orchestrator REST API. For more information, see "Programming Interfaces".

**To add a new session**

1. Access the **Sessions** page. The **Sessions** page is displayed with a list of all currently defined sessions.
2. Click ![PLUS BUTTON.png](https://cdn.document360.io/01d1de5e-a375-4fbc-aa82-666ac04c2113/Images/Documentation/PLUS%20BUTTON%287%29.png?sv=2026-02-06&spr=https&st=2026-11-13T16%3A00%3A15Z&se=2026-11-13T17%3A00%3A15Z&sr=c&sp=r&sig=5E5jQIvv2nih09v48K2NbeNS7OGLTpFb7efw30rXlHk%3D) 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"

1. When you have completed all steps and created the new session, the session will appear in the list of sessions.
2. To start the session (immediately or later), click ▶ above the list of sessions.

**To edit an existing session**

1. Access the **Sessions** page.
2. Locate the session that you want to edit in the list.
3. Ensure that the session is stopped by selecting the row for the session and clicking ![STOP BUTTON.png](https://cdn.document360.io/01d1de5e-a375-4fbc-aa82-666ac04c2113/Images/Documentation/STOP%20BUTTON%281%29.png?sv=2026-02-06&spr=https&st=2026-11-13T16%3A00%3A15Z&se=2026-11-13T17%3A00%3A15Z&sr=c&sp=r&sig=5E5jQIvv2nih09v48K2NbeNS7OGLTpFb7efw30rXlHk%3D) above the list.
4. Click the row for the session. The session details are displayed to the right of the session list.
5. 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"

1. When you have made all the changes you want to make, click **Update** to save your changes.
2. To start the session (immediately or later), click ▶ above the list of sessions.

**To duplicate an existing session**

1. Access the **Sessions** page.
2. In the list of sessions, click on the session you want to duplicate.
3. Click the ![DUPLICATE BUTTON.png](https://cdn.document360.io/01d1de5e-a375-4fbc-aa82-666ac04c2113/Images/Documentation/DUPLICATE%20BUTTON%283%29.png?sv=2026-02-06&spr=https&st=2026-11-13T16%3A00%3A15Z&se=2026-11-13T17%3A00%3A15Z&sr=c&sp=r&sig=5E5jQIvv2nih09v48K2NbeNS7OGLTpFb7efw30rXlHk%3D) button above the list.
4. 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.
5. Click the icon for Step 4, and then click the **Create** button.

**To edit more than one existing session (Bulk Edit)**

1. Access the **Sessions** page.
2. Locate the sessions that you want to edit in the list.
3. Ensure that the sessions are stopped by selecting the rows for the sessions and clicking ![STOP BUTTON.png](https://cdn.document360.io/01d1de5e-a375-4fbc-aa82-666ac04c2113/Images/Documentation/STOP%20BUTTON%282%29.png?sv=2026-02-06&spr=https&st=2026-11-13T16%3A00%3A15Z&se=2026-11-13T17%3A00%3A15Z&sr=c&sp=r&sig=5E5jQIvv2nih09v48K2NbeNS7OGLTpFb7efw30rXlHk%3D) above the list.
4. Click the row for the sessions. The sessions details are displayed to the right of the session list.
5. Click the **Bulk Edit** ![BULLK EDIT BUTTON.png](https://cdn.document360.io/01d1de5e-a375-4fbc-aa82-666ac04c2113/Images/Documentation/BULLK%20EDIT%20BUTTON.png?sv=2026-02-06&spr=https&st=2026-11-13T16%3A00%3A15Z&se=2026-11-13T17%3A00%3A15Z&sr=c&sp=r&sig=5E5jQIvv2nih09v48K2NbeNS7OGLTpFb7efw30rXlHk%3D) 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"

1. When you have made all the changes you want to make, click **Update** to save your changes.
2. 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. ![24.09_Adding, Editing and Duplicating Performance Sessions_1.png](https://cdn.document360.io/01d1de5e-a375-4fbc-aa82-666ac04c2113/Images/Documentation/24.09_Adding,%20Editing%20and%20Duplicating%20Performance%20Sessions_1.png?sv=2026-02-06&spr=https&st=2026-11-13T16%3A00%3A15Z&se=2026-11-13T17%3A00%3A15Z&sr=c&sp=r&sig=5E5jQIvv2nih09v48K2NbeNS7OGLTpFb7efw30rXlHk%3D)

**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. Legacy 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 Legacy Orchestrator by including a label in the query. Points to note about user-defined labels: - You can enter multiple labels (up to 12). - Labels can contain spaces. - Press Enter after each label. It will be displayed beside the Label field and you will be able to add another label. |
| 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: - Echo-ICMP (Layer 3) - Echo-UDP (Layer 3) - Ethernet OAM (Layer 2) - TWAMP (Layer 3) - 2xOneWay (Layer 3). You will be prompted for more information required for the session in a later step. |

## Step 2 – Termination points

In Step 2, you select the sender and reflector termination points for the session.

---

***Note:** Sessions can be created without a Sender port. Sender port auto-assignment has a range from 14000 to 65535.* 

---

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.

d.	If you need to return to Step 1, click on the green ball beside Enter session info.

![24.09_Adding, Editing and Duplicating Performance Sessions_2.png](https://cdn.document360.io/01d1de5e-a375-4fbc-aa82-666ac04c2113/Images/Documentation/24.09_Adding,%20Editing%20and%20Duplicating%20Performance%20Sessions_2.png?sv=2026-02-06&spr=https&st=2026-11-13T16%3A00%3A15Z&se=2026-11-13T17%3A00%3A15Z&sr=c&sp=r&sig=5E5jQIvv2nih09v48K2NbeNS7OGLTpFb7efw30rXlHk%3D)

**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 Legacy Orchestrator. The device name can be changed on the device itself. Any changes will be seen on Legacy 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". |

![24.09_Adding, Editing and Duplicating Performance Sessions_3.png](https://cdn.document360.io/01d1de5e-a375-4fbc-aa82-666ac04c2113/Images/Documentation/24.09_Adding,%20Editing%20and%20Duplicating%20Performance%20Sessions_3%281%29.png?sv=2026-02-06&spr=https&st=2026-11-13T16%3A00%3A15Z&se=2026-11-13T17%3A00%3A15Z&sr=c&sp=r&sig=5E5jQIvv2nih09v48K2NbeNS7OGLTpFb7efw30rXlHk%3D)

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 Legacy 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. - twamp-rf (stateful TWAMP) - twamp-sl-rf (stateless TWAMP) Echo Sessions: - echo-udp-rf - echo-icmp-rf Ethernet OAM Sessions: - ethlb-rf - ethdm-rf - ethvs-rf To determine the reflection capabilities of Accedian devices, see "Sender and Reflector Capabilities of Accedian Devices". 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: - 2xOneWay-RF - P1404 - P2440 - P2770 - Assurance Sensor Control - Assurance Sensor SFP (1G or 10G) - Assurance Sensor Modules (1G or 10G) - Assurance Sensors: LT, LT-S, GT, LX and others The following options are suitable for third-party devices: - HeadEnd - Server - Host - Router - Switch - RBS (Radio Base Station) |

**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.

![24.09_Adding, Editing and Duplicating Performance Sessions_4.png](https://cdn.document360.io/01d1de5e-a375-4fbc-aa82-666ac04c2113/Images/Documentation/24.09_Adding,%20Editing%20and%20Duplicating%20Performance%20Sessions_4.png?sv=2026-02-06&spr=https&st=2026-11-13T16%3A00%3A15Z&se=2026-11-13T17%3A00%3A15Z&sr=c&sp=r&sig=5E5jQIvv2nih09v48K2NbeNS7OGLTpFb7efw30rXlHk%3D)

**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: - For a Assurance Sensor Control: 80 K pkts/s - For a Sylight sensor: module: 40 K pkts/s - For an individual session: 8 K pkts/s Default: 10 pkts/s |
| 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 |
| 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: - TWAMP - TWAMP-SL - ETH-DM - ETH-VS - 2xOneWay |
| 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: - TWAMP - TWAMP-SL - ETH-DM - ETH-VS - 2xOneWay 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. ![24.09_Adding, Editing and Duplicating Performance Sessions_5.png](https://cdn.document360.io/01d1de5e-a375-4fbc-aa82-666ac04c2113/Images/Documentation/24.09_Adding,%20Editing%20and%20Duplicating%20Performance%20Sessions_5.png?sv=2026-02-06&spr=https&st=2026-11-13T16%3A00%3A15Z&se=2026-11-13T17%3A00%3A15Z&sr=c&sp=r&sig=5E5jQIvv2nih09v48K2NbeNS7OGLTpFb7efw30rXlHk%3D)

**© 2026 Cisco and/or its affiliates. All rights reserved.** For more information about trademarks, please visit: [Cisco trademarks](https://www.cisco.com/c/en/us/about/legal/trademarks.html)[](https://www.cisco.com/c/en/us/about/legal/trademarks.html) For more information about legal terms, please visit: [Cisco legal terms](https://www.cisco.com/c/en/us/about/legal/terms-conditions.html)